# :SYSTem:MPButton:FUNCtion

Multi-Purpose Commands

- :SYSTem Multi-Purpose Button Commands
- :SYSTem:MPButton:DOCWizard:BFName
- :SYSTem:MPButton:FUNCtion
- :SYSTem:MPButton:QSETup:FNAMe
- :SYSTem:MPButton:QSPBack:FNAMe
- :SYSTem:MPButton:SIMage:BFName
- :SYSTem:MPButton:SIMage:FTYPe?
- :SYSTem:MPButton:SIMage:IMETadata
- :SYSTem:MPButton:SIMage:INVert
- :SYSTem:MPButton:SIMage:MONochrome
- :SYSTem:MPButton:SIMage:SAVE

## 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
  --- | --- | ---
  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
  --- | --- | ---
  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
  --- | --- | ---
  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
  --- | --- | ---
  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