:DISK:SIMage:SAVE

:DISK Screen Image Commands

Command Syntax

:DISK:SIMage:SAVE

Description

Performs a screen capture of the Infiniium 2026 window and saves the image to the specified file name and extension with the :DISK:SIMage:FNAMe command. The filename extension included in the :DISK:SIMage:FNAMe command selects the file's graphics format. The example located at the end of this topic shows how to return the image file to a computer. To increment the automatic file number index, use the :DISK:SIMage:FNAMe:AUPDate command.

If a displayed dialog box is outside Infiniium's window, it will not be included in the screen image capture. Use the Windows Print Screen function instead.

To assign the saving of a screen image file to the front-panel Multi-Purpose button, use the :SYSTem:MPButton:FUNCtion command.

Use an *OPC (Operation Complete) query to pause program execution while waiting for this command to complete.

Include in Screen Capture

Use the :DISK:SIMage:WINDow command to select the area within the application's window to save in the image. You can select the entire display or Waveform content window including Waveform, Decibels (Hz), Degrees (Hz), or Seconds (Hz) windows. If a waveform content window is selected, use :DISK:SIMage:SINClude to select a particular waveform within the selected window. The menu bar, toolbars, tables, and status bar are not included in the image file.

Monochrome

Select Monochrome (:DISK:SIMage:MONochrome command) to save a black and white image. This selection automatically selects inverts the graticule area's background color.

Invert Graticule Area Background Color

Select Invert Graticule Area Background Color (:DISK:SIMage:INVert command) to save the entire application window with the graticule black and the graticule background white. The waveform colors remain unchanged. If combined with Include in screen capture, this option is especially useful when printing a hard copy of the waveform as it saves ink or toner.

Include Metadata

Select the Include Metadata (:DISK:SIMage:IMETadata command) for .jpg and .tiff files to include oscilloscope/Infiniium metadata in the graphics file. Metadata can be read by many applications such as Window's File Explorer.

Include or Exclude Measurement Annotations

To select to include or exclude measurement annotations that are placed on a waveform, set or clear Annotations in the Results panel use the (:MEASure:ANNotations:STATe command.

Example Script

Example script for saving screen images to files with autonumbering.

Example

This example shows how to save a screen capture to a file that is located on the Infiniium system's hard drive and then return the file to a host computer.

:DISK:SIMage:FNAMe "%USER_DATA_DIR%\Screen Images\filename.png"
:DISK:SIMage:SAVE;*OPC?
:DISK:FILE:READ? "%USER_DATA_DIR%\Screen Images\filename.png"