:LTESt:MTESt:SIMage:FNAMe:AUPDate

Command Syntax

:LTESt:MTESt:SIMage:FNAMe:AUPDate

Where identifies a specific mask and must be a value from 1 to 16 {1:16}. For example, :MTESt2: selects mask 2.

Description

Appends an autonumber to the file name (:LTESt:MTESt:SIMage:FNAMe) and increments the number for the next save. The autonumber takes the form "_1", which is appended to the file name before the file name extension. Appending an automatically generated number prevents the accidental writing over of an existing file. Use the :LTESt:MTESt:SIMage:STATe command to enable and disable screen-capture reporting. The following rules apply:

• A file names not ending in a number gets the autonumber appended starting at 1.
• A file name that ends with an underscore character followed by a number (for example, my_file_123) is recognized as an autonumber. The number is interpreted as the starting number. In this example, sending :AUPDate results in the next saved file being my_file_124.
• A file name that ends in a number but without a preceding underscore character is not interpreted as an autonumber. An autonumber is appended at the end of the file name. For example, my_file123 becomes my_file123_01.

Saving a file with screen-capture reporting does not increment the autonumber. Send the :LTESt:MTESt:SIMage:FNAMe:AUPDate command to increment the number. To use autonumbering, include the autonumber in the file name for the first file that is saved as shown in the Example Command Sequence below.

Example Command Sequence

:ACQuire:SINGle
:LTESt:MTESt:SIMage:FTYPe PNG
:LTESt:MTESt:SIMage:FNAMe "my_file_1"
:LTESt:MTESt:SIMage:STATe ON  //  Enable screen capture reporting
:LTESt:MTESt:MRESult1;STATe ON  //  Turn limit test on
:ACQuire:RUN;*OPC?  #  my_file_1.png
…
…
:ACQuire:CDISplay
:LTESt:MTESt:SIMage:FNAMe:AUPDate
:ACQuire:RUN;*OPC?  #  my_file_2.png