:SYSTem:MPButton:FUNCtion

Command Syntax

:SYSTem:MPButton:FUNCtion {NONE | SSCReen | RSCRipt | LSETup | SDWFile}

Query Syntax

:SYSTem:MPButton:FUNCtion?

Description

Assigns one of four possible actions to the oscilloscope's front-panel Multi-Purpose button according to the arguments NONE, SSCReen, RSCRipt, and LSETup. A default setup (:SYSTem:DEFault) will not reset this setting but a factory default (:SYSTem:FACTory) does reset it to NONE. The following arguments can be used:

NONE

The Multi-Purpose button is disabled. This is the factory default setting.

SSCReen

Configures the Multi-Purpose button to save a screen image to a file. The factory default filename for the saved image is QuickScreenSave.jpg. An integer is appended to the file name and is incremented each time a screen is saved.

Screen Image Information
Infiniium Installed	Screen Captured	Default File Location
On oscilloscope	oscilloscope	oscilloscope
PC (connected to oscilloscope)	Infiniium on PC	PC
PC (not connected to oscilloscope)	Infiniium on PC	PC

Configuration Commands for Screen Images
Command	Description	Setting Reset By
Command	Description	Default Setup	Factory Default
:SYSTem:MPButton:SIMage:BFName	Change the default path and filename for saving screens images.		♦
:SYSTem:MPButton:SIMage:IMETadata	Turns on and off the saving of metadata for jpg and tiff files.	♦	♦
:SYSTem:MPButton:SIMage:INVert	Turns on and off the inversion the graticule area's background color.	♦	♦
:SYSTem:MPButton:SIMage:MONochrome	Turns monochrome screen capture on and off.	♦	♦
:SYSTem:MPButton:SIMage:SAVE	Saves a screen image.	—	—

Example Command Sequence

:SYSTem:MPButton:SIMage:BFName "ProtoWaveform.png"  //  Assign a base filename
:SYSTem:MPButton:SIMage:INVert ON
:SYSTem:MPButton:FUNCtion SSCReen  //  Assign saving a screen image to Multi-Purpose button

RSCRipt

Configures the Multi-Purpose button to run a SCPI script. The factory default scripts are named in the following table.

Configuration Commands for Running Scripts
Command	Description	Setting Reset By
Command	Description	Default Setup	Factory Default
:SYSTem:MPButton:QSPBack:FNAMe	Specifies the script to run. The default script is MultiPurpose Scope.scpi.		♦

Example Command Sequence

:SYSTem:MPButton:QSPBack:FNAMe "ScopeScript.scpi"
:SYSTem:MPButton:FUNCtion RSCRipt  //  Assign running s script to Multi-Purpose button

LSETup

Configures the Multi-Purpose button to run an instrument setup file.

Configuration Commands for Running Instrument Setups
Command	Description	Setting Reset By
Command	Description	Default Setup	Factory Default
:SYSTem:MPButton:QSETup:FNAMe	Loads and runs an instrument setup file. The default script is MultiPurpose.seti.		♦

Example Command Sequence

:SYSTem:MPButton:QSETup:FNAMe "EyeModeSetup.seti"
:SYSTem:MPButton:FUNCtion LSETup

SDWFile

Configures the Multi-Purpose button to save a documentation wizard file. To specify the name of the saved file, use the :SYSTem:MPButton:DOCWizard:BFName command. To select the contents for the documentation wizard file, use the :DWIZard commands that are located in the :DISK subsystem, as described in :DISK:DWIZard:SAVE command.

Configuration Commands for Saving a Documentation Wizard File
Command	Description	Setting Reset By
Command	Description	Default Setup	Factory Default
:SYSTem:MPButton:QSETup:FNAMe	Save a documentation wizard file. The default script is QuickDocWizardSave.zip.		♦

Example Command Sequence

:SYSTem:MPButton:DOCWizard:BFName "%USER_DATA_DIR%\Documentation Results\DocWizard.zip"
:SYSTem:MPButton:FUNCtion SDWFile