# :LTESt:LLINe:SIMage:STATe

: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:STATe {ON | OFF}

## Query Syntax

    :LTESt:LLINe:SIMage:STATe?

## Description

Turns on or off the reporting action of saving a screen image to a file upon the completion of limit testing for a limit line test. Use the commands shown in the following table to configure the output file. To turn on or off limit testing for a specified limit line test, use the `:LTESt:LLINe:TEST{N}:STATe` command. The default folder for saving screen images is %USER_DATA_DIR%\Screen Images. If limit testing is running and not completed, you can force a screen image save at any time using the `:LTESt:LLINe:SIMage:SAVE` command.

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

Screen Capture Sibling Commands
Command | Description
--- | ---
`:LTESt:LLINe:SIMage:FNAMe` | Specify the filename for saved screen images.
`:LTESt:LLINe:SIMage:FTYPe?` | Specify the graphics file type for saved screen images.
`: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:IMETadata` | Include metadata in jpg and tiff files.
`:LTESt:LLINe:SIMage:SAVE` | Manually save a screen capture at any time during 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

                    //  Load and start limit line test.
    :LLINe1:LOAD:FNAMe "%USER_DATA_DIR%\Limit Lines\Golden Test.lltx"
    :LLINe1:SOURce CHANnel1_1
    :LLINe1:DISPlay ON
    :ACQuire:STOP
    :ACQuire:CDISplay

    //  Configure "Save Screen Image" reporting using default file name.
    :LTESt:LLINe:SIMage:FNAMe "%USER_DATA_DIR%\Screen Images\image.png"  //  Image file name.
    :LTESt:LLINe:SIMage:WINDow TIME1  //  Capture only Waveform content window.
    :LTESt:LLINe:SIMage:SINClude CHAN1_1  //  Capture only connection 1 channel 1. Hide all other waveforms.
    :LTESt:LLINe:SIMage:INVert ON  //  Color waveforms on white graticule background.
    :LTESt:LLINe:SIMage:STATe ON  //  Enable screen waveform save.
                    //  Run limit testing.
    :LTESt:LLINe:TEST1:MODE SOFailure  //  Stop limit testing on fail condition.
    :LTESt:LLINe:TEST1:STATe ON  //  Enable limit testing.
    :ACQuire:RUN  //  Enable data acquisition.