Measurement Screen Commands¶

:SCReen:INSTRuments:OUTputchannel:STARt¶

Syntax	:SCReen:INSTRuments:OUTputchannel:STARt
Description	Start streaming to analog out channels
Parameter	None
Explanation	Starts streaming on the default stream output instrument if it is in the Paused or Stopped states. The default instrument is the oldest output channel instrument instance, on the measurement screen with the lowest index, that is configured for replay mode.
Example	-> :SCReen:INSTRuments:OUTputchannel:STARt

:SCReen:INSTRuments:OUTputchannel:PAUSE¶

Syntax	:SCReen:INSTRuments:OUTputchannel:PAUSE
Description	Start streaming to analog out channels
Parameter	None
Explanation	Stop sending data on the default stream output instrument that is in the Started state.
Example	-> :SCReen:INSTRuments:OUTputchannel:PAUSE

:SCReen:INSTRuments:OUTputchannel:STOP¶

Syntax	:SCReen:INSTRuments:OUTputchannel:STOP
Description	Start streaming to analog out channels
Parameter	None
Explanation	Stop sending data on the default stream output instrument that is in the Started state. Then reset the playback cursor to the start position
Example	-> :SCReen:INSTRuments:OUTputchannel:STOP

:SCReen:INSTRuments:OUTputchannel:STATe?¶

Syntax	:SCReen:INSTRuments:OUTputchannel:STATe?
Description	Query the current state of the output channel instrument.
Parameter	None
Explanation	Returns the instrument state as a string: Not_found (no stream output instrument found on the measurement screens) Configuration_error (instrument is not correctly set up and cannot be used) Blocked (another instrument instance is currently playing) Started (the instrument is streaming dmd data) Paused (the instrument does not stream) Stopped (the instrument does not stream, stream will start at the beginning) Active (the instrument continuously sends data; not used for stream output) Error
Return format	<String>
Example	-> :SCReen:INSTRuments:OUTputchannel:STARt -> :SCReen:INSTRuments:OUTputchannel:STATe? <- Started

:SCReen:SAVE “PATH”¶

Syntax

::SCReen:SAVE [<path>]

Description

Save the current screen to a png file

Parameter

Name	Type	Range	Default
<path>	String	A valid filename of the png file. If no absolute path is specified, the file is stored in the oxygen export folder	A file starting with “screenshot” and with screen number and the current timestamp is generated in the oxygen export folder

Explanation

Saves the current oxygen instruments screen to a png file.

Example

-> :SCReen:SAVE               //stores the current screen with number to file (e.g. "c:/export/screenshot_1_20230713_120948.png")
...
-> :SCReen:SAVE "xyz"         //stores the current screen to file (e.g. "c:/export/xyz.png")
...
-> :SCReen:SAVE "c:/temp/xyz" //stores the current screen to "c:/temp/xyz.png"

:SCReen:ITEM<ScreenNumber>:SAVE “PATH”¶

Syntax

::SCReen:ITEM<ScreenNumber>:SAVE [<path>]

Description

Save screen to a png file

Parameter

Name	Type	Range	Default
<path>	String	A valid filename of the png file. If no absolute path is specified, the file is stored in the oxygen export folder	A file starting with “screenshot” and with the <ScreenNumber> and the current timestamp is generated in the oxygen export folder

Explanation

Saves the oxygen instruments screen with the given <ScreenNumber> to a png file. The <ScreenNumber> should be a valid oxygen instrument screen (1 - 32768)

Example

-> :SCReen:ITEM1:SAVE               //stores screen number 1 to file (e.g. "c:/export/screenshot_1_20230713_120948.png")
...
-> :SCReen:ITEM2:SAVE "xyz"         //stores screen number 2 to file (e.g. "c:/export/xyz.png")
...
-> :SCReen:ITEM3:SAVE "c:/temp/xyz" //stores screen number 3 to "c:/temp/xyz.png"