# :LTESt:LLINe:SIMage:SAVE

:LTESt Limit Line Commands

- :LTESt:LLINe:TEST{N}:MODE
- :LTESt:LLINe:TEST{N}:STATe
- :LTESt:LLINe:SIMage:FNAMe
- :LTESt:LLINe:SIMage:FNAMe:AUPDate
- :LTESt:LLINe:SIMage:FNAMe:USTandard
- :LTESt:LLINe:SIMage:FTYPe?
- :LTESt:LLINe:SIMage:IMETadata
- :LTESt:LLINe:SIMage:INVert
- :LTESt:LLINe:SIMage:MONochrome
- :LTESt:LLINe:SIMage:SAVE
- :LTESt:LLINe:SIMage:SINClude
- :LTESt:LLINe:SIMage:STATe
- :LTESt:LLINe:SIMage:WINDow
- :LTESt:LLINe:SSUMmary:FNAMe
- :LTESt:LLINe:SSUMmary:STATe
- :LTESt:LLINe:SWAVeform:CHANnel{N}:FNAMe
- :LTESt:LLINe:SWAVeform:CHANnel:FTYPe
- :LTESt:LLINe:SWAVeform:CHANnel{N}:STATe
- :LTESt:LLINe:SWAVeform:CHANnel{N}:WMEMory
- :LTESt:LLINe:SWAVeform:CMODe{N}:FNAMe
- :LTESt:LLINe:SWAVeform:CMODe:FTYPe
- :LTESt:LLINe:SWAVeform:CMODe{N}:STATe
- :LTESt:LLINe:SWAVeform:CMODe{N}:WMEMory
- :LTESt:LLINe:SWAVeform:DIFF{N}:FNAMe
- :LTESt:LLINe:SWAVeform:DIFF:FTYPe
- :LTESt:LLINe:SWAVeform:DIFF{N}:STATe
- :LTESt:LLINe:SWAVeform:DIFF{N}:WMEMory
- :LTESt:LLINe:SWAVeform:FUNCtion{N}:FNAMe
- :LTESt:LLINe:SWAVeform:FUNCtion{N}:STATe
- :LTESt:LLINe:SWAVeform:FUNCtion{N}:WMEMory
- :LTESt:LLINe:SWAVeform:RESet

## Command Syntax

    :LTESt:LLINe:SIMage:SAVE

## Description

Use this command to capture a screen image graphics file any time during limit testing for a limit line test. The test can still be running having with data being acquired. To capture a screen image file upon completion of limit testing, use the `:LTESt:LLINe:SIMage:STATe` command. Performs a screen capture of the Infiniium window and saves the image to a file specified using the `:LTESt:LLINe:SIMage:FNAMe` command. The default folder is %USER_DATA_DIR%\Screen Images. The file name extension determines the graphic format: .bmp, .png, .jpg, .gif, or .tif. The example located at the end of this topic shows how to return the image file to a computer.

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.

Several screen-capture options are available using the sibling commands listed in the following table.

Screen Capture Sibling Commands
Command | Description
--- | ---
`:LTESt:LLINe:SIMage:MONochrome` | Saves the screen as a black and white image. This selection automatically selects inverts the graticule area's background color.
`:LTESt:LLINe:SIMage:INVert` | Saves the entire application window but colors 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.
`:LTESt:LLINe:SIMage:WINDow` | Selects to save the entire display or a waveform content window: Waveform, Decibels (Hz), Degrees (Hz), or Delay. This screen capture shows the entire display captured.
`:DISK:SIMage:SINClude` | If a specific waveform content window is selected (`:LTESt:LLINe:SIMage:WINDow`) and the window has multiple waveforms, use this command to select to show only one waveform within the selected window.
`:LTESt:LLINe:SIMage:STATe` | Automatically saves a screen capture at the completion of limit testing on a limit line test. Use the `:LTESt:LLINe:SIMage:FNAMe` command to specify the name and location of the captured screen image.

## Example

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

    :LTESt:LLINe:SIMage:FNAMe "D:\User Files\Screen Images\filename.png"
    :LTESt:LLINe:SIMage:SAVE