7 Save/Recall/Print
7.3 Save
Sending screen image commands more rapidly than twice per second is not
advised.
The default path for State Files is:
My Documents\<mode name>\screen
where <mode name> is the parameter used to select the mode with :INST:SEL, for
example, SA for Spectrum Analyzer Mode.
Screen Image files have extension .png. The default filename is Screen_0000.png,
where the 4-digit number is the lowest number that does not conflict with any
filename in the current directory.
After you have completed the save, the Quick Save front-panel key lets you quickly
repeat the last save performed, using an auto-named file, with new current screen
data.
Remote
Command
:MMEMory:STORe:SCReen <filename>
Example Store the current screen image in the file MyScreenFile.png in the default directory:
:MMEM:STOR:SCR "myScreen.png"
Backwards
Compatibility
SCPI
:HCOPy:SDUMp:DATA?
returns the screen image in a <DEFINITE LENGTH ARBITRARY RESPONSE DATA> element.
The response data is IEEE Block format; the controlling computer can strip the header and store the
result as a .png file
Blocking Screen Capture (Remote Command Only)
This command works only when the measurement is in Single mode (see
"Sweep/Measure" on page 1722). When the command is sent, it blocks the SCPI
client, waits for the current refresh to complete, then captures the screen shot and
saves it. In some instances, a single measurement is taken, and a screen shot of that
measurement is captured.
This command ensures that the last-measured data is refreshed on the screen
before it is captured, by blocking the command and waiting for refresh to complete.
The command may time out, in which case it must be re-sent.
If timeout occurs, or if the active measurement is in Continuous mode, an error is
returned.
Remote
Command
:MMEMory:STORe:SCReen:BLOCked <filename>
Example Wait for the current screen refresh to complete before capturing the screen shot, then store the current
screen image in the file MyScreenFile.png in the default directory:
:MMEM:STOR:SCR:BLOC "myScreen.png"
Short Range Comms & IoT Mode User's &Programmer's Reference 2301