# :DISK:SIMage:FNAMe

:DISK Screen Image Commands

- :DISK Subsystem
- :DISK:SIMage:FNAMe
- :DISK:SIMage:FNAMe:AUPDate
- :DISK:SIMage:FNAMe:USTandard
- :DISK:SIMage:FTYPe?
- :DISK:SIMage:IMETadata
- :DISK:SIMage:INVert
- :DISK:SIMage:MONochrome
- :DISK:SIMage:SAVE
- :DISK:SIMage:SINClude
- :DISK:SIMage:WINDow

## Command Syntax

    :DISK:SIMage:FNAMe "<path substitution string>\subfolder\filename.extension"

Where:

- "<path substitution string> is a string that expands into a specific file path. For example, %USER_DATA_DIR%.
- "subfolder" is an optional path folder. For example, \Screen Images.
- "filename.extension" is a string with the filename and extension.

## Query Syntax

    :DISK:SIMage:FNAMe?

## Description

Specifies the file's path, name, and extension when using the `:DISK:SIMage:SAVE` command to save a screen image file. This command supports the `DEFault` common child command. The filename that you specify must include a file-name extension which determines the image format of the saved file. The following filename extensions can be used:

(missing or bad snippet)

### Default User Folder

The default folder for storing image files is in `%USER_DATA_DIR%\Screen Images` as shown in this picture. It is good practice to include a path substitution string with the filename. For example, `%USER_DATA_DIR%\Screen Images\filename`.

File names must include a path when using the child `:FNAMe` command. The `:FNAMe` command is not affected by a Default Setup or Factory Default.

Specifying a path using a path substitution string in the filename ensures that the file will be saved in (or loaded from) the standard user-data folder. Failure to use a path substitution string may result either in a file created in an parent folder or a file error.

### Autonumbers with Standard and Custom File Names

You can enter a custom file name or select to use the standard file name.

#### Standard File Names

Standard names automatically include file type, the current date, and an autonumber in this form:

    <type_><YYYY-MM-DD><_autonumber>.<extension>

For example, Screen_2020-10-23_1.jpg. There is nothing to enter in order to use a standard name. Instead, select standard names by sending the `:DISK:SIMage:FNAMe:USTandard` command. When sent, the `:USTandard` command also clears the `:DISK:SIMage:FNAMe` command to an empty string.

Saving a file with the `:DISK:SIMage:SAVE` parent command does not increment the autonumber; you must use the `:DISK:SIMage:FNAMe:AUPDate` command. Otherwise, the next file saved will have the same name as the last file saved.

If want to start using a custom file names, simply enter a custom name with the `:DISK:SIMage:FNAMe` command. The autonumbers for custom and standard names are independent. For example, switching to custom names then back to using standard names does not reset or change the current autonumber for Standard names.

To reset the autonumber for standard file names, remove all previously saved standard files from the user data folder and send the `:DISK:SIMage:FNAMe:USTandard` command. A Default Setup or Factory Default does not reset the autonumber.

When an autonumbered file is saved, if a file already exists with the autonumber, the autonumber is automatically incremented to the next available number.

#### Custom File Names

Custom names are entered using the `:DISK:SIMage:FNAMe` command. Do not add a file name extension as Infiniium 2026 automatically adds it. For example,

`My_DUT`

You can add an optional autonumber by appending an underscore character followed by an integer (_1) to the end of the file name. For example,

`My_DUT_1`

An autonumber, if used, must be appended to the end of the file name. The integer sets the starting number for the first file saved. To increment an autonumber after a file is saved, you must send the `:DISK:SIMage:FNAMe:AUPDate` command. There is no date variable to append, so if you want to include a date you will have to type it in.

Example File Names
Name | Type | Autonumber
--- | --- | ---
Screen_2020-10-23_1.jpg | standard | yes
DUT.xxx | custom | no
DUT23.xxx | custom | no
DUT_23.xxx | custom | yes

## Example Command Sequence

    :DISK:SIMage:FNAMe "%USER_DATA_DIR%\Screen Images\myfile"
    :DISK:SIMage:SAVE