# :DISK:SIMage:SAVE

:DISK Screen Image Commands

- :DISK Subsystem
- :DISK:SIMage:FNAMe
- :DISK:SIMage:FNAMe:AUPDate
- :DISK:SIMage:FNAMe:USTandard
- :DISK:SIMage:FTYPe?
- :DISK:SIMage:IMETadata
- :DISK:SIMage:INVert
- :DISK:SIMage:MONochrome
- :DISK:SIMage:SAVE
- :DISK:SIMage:SINClude
- :DISK:SIMage:WINDow

## 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"