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]
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.
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.
- 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.