Get

Three commands are used in conjunction with the Get extended Native Mode command to receive information from the In-Sight vision system and its spreadsheet.

Syntax: Get [command]

Note: A space is needed between Get and the command, as well as between the command and any input parameters.

Get Connections

Returns current connection information for the In-Sight vision system.

Get Connections Inputs

Syntax: Get Connections

Get Connections Outputs

Returns:

A status code followed by the number of characters, and the name or cell reference of the cell. The status codes are:

Status Codes	Description
1	The command was executed successfully.
0	Unrecognized command.
-1	The cell ID is invalid.
-2	The command could not be executed.
-6	User does not have Full Access to execute the command. For more information, see User Access Settings Dialog.

The number of users currently logged onto the vision system.
The names of the users that are currently logged on to the vision system.

A hexadecimal representation of each user's FTP Read/Write permissions, Access level and Java applet connections. The FTP Read/Write permissions, Access levels and Java applet connections are:

Hexadecimal Values	Description
0x01	Read
0x02	Write
0x08	Users with a Protected access level are restricted from switching the vision system between its Online and Offline modes of operation.
0x10	Full
0x20	Protected
0x40	Locked
0x80	Java applet connection

The Host Name and IP address (as a hexadecimal number) of each user's vision system.

Get Connections Example

To retrieve the vision system's connection settings, issue the following command: Get Connections

The In-Sight vision system initially responds with the status code (1), followed by the number of users currently logged in to the In-Sight vision system (2). Next, the connection information is presented for each user. The first user, admin, has a hexadecimal access representation of 0x13; this representation is obtained by summing the FTP Read/Write permissions and Access level that applies to the user (see preceding table). In this case, admin has Full access (0x10) + FTP Read permission (0x01) + FTP Write permission (0x02) = 0x13. The user admin is currently connected from the IP address of 10.25.80.73; represented in hexadecimal, this address becomes 0A195049.

Connection information for the second user (monitor) is presented similarly on the following line.

Get Expr

Returns the parameters or value stored in the cell specified by the column and row address, as well as the state of that cell.

Note: If the specified cell is empty, the two output lines after the status code will be blank.

Get Expr Inputs

Syntax: Get Expr [Column][Row]

Parameter	Description
Column	The column letter of the cell value to set (A to Z).
Row	The row number of the cell value to set. The row number must consist of three digits (000 to 399).

Get Expr Outputs

A status code. The status codes are:

Status Code	Description
1	The command was executed successfully.
0	Unrecognized command.
-1	The cell ID is invalid or has exceeded 15 bytes in length.
-2	The command could not be executed.

The parameters or values that are stored in the specified cell.

The state of the specified cell. For more information, see Cell State Dialog.

State of the Specified Cell	Description
0	The cell is disabled.
1	The cell is enabled.

Get Expr Example

To retrieve the parameters returned by AcquireImage that is stored in cell A0, issue the following command: Get Expr A000

After issuing the command Get Expr A000, the In-Sight vision system responds with a status code (1), followed by the expression contained within cell A0. Finally, the cell state (1) is displayed.

Get Filelist

Returns the number of files stored in memory, and the name of each file in memory on the In-Sight vision system.

Note:

If a RAM Disk folder is enabled on the vision system, the "RAMDisk" folder name is included in the Get Filelist output.
It is not possible to get the file list from a RAM Disk folder using the Get Filelist Native Mode command. In order to obtain the file list of a RAM Disk folder, use the FTP protocol instead. Note that the CD (change directory) FTP command is not supported.

Get Filelist Inputs

Syntax: Get Filelist

Get Filelist Outputs

A status code, followed by the number of files stored in memory, followed by the name of each file in memory. The status codes are:

Status Codes	Description
1	The command was executed successfully.
0	Unrecognized command.
-1	The input is invalid or has exceeded 15 bytes in length.
-2	The command could not be executed.

Get Filelist Example

To retrieve a count and list of files that are stored on the In-Sight vision system, issue the following command: Get Filelist

After issuing the command Get Filelist, the In-Sight vision system responds with a status code (1), followed by the number of files present in memory (13). Finally, the individual name of each file is displayed.