Read Image

Sends the current image, in ASCII hexadecimal format (formatted to 80 characters per line), from an In-Sight sensor out to a remote device. When converted to binary, the resulting data is in standard BMP image format.

Note: Executing the Read Image command is the equivalent of executing the Read BMP command.

Read Image Inputs

Syntax: RI

Read Image Outputs

Returns a status code, followed by a line terminator, followed by lines of image data.

  • The status codes are:

    Status Codes Description
    1

    The command was executed successfully.
    0

    Unrecognized command.
    -4

    The In-Sight sensor is out of memory.
    -6

    User does not have Full Access to execute the command. For more information, see User Access Settings Dialog.

  • The lines of image data are:

    Size

    The second line contains an integer value for the size, in bytes, of the image.

    Image

    The actual image data is encoded as ASCII hexadecimal values formatted to 80 characters per line. Each line ends with a terminating character.

    CheckSum

    The last line contains four ASCII hexadecimal bytes that are a checksum of the image data.

Read Image Example

To read the current image (in ASCII hexadecimal format) from an In-Sight sensor, issue the following command: RI

The In-Sight sensor initially responds with 1, indicating the command was successfully executed. The next line contains the data size (3314) in bytes, followed by the image data (in ASCII hexadecimal format.)

Note: Most of the actual image data has been omitted from the preceding graphic for clarity.

Finally, the four-byte ASCII hexadecimal checksum (611E) is returned.