# Read BMP

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

## Read BMP Inputs

Syntax: RB

## Read BMP 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 vision system is out of memory.
-6 | User does not have Full Access to execute the command.

The lines of image data are:

Parameter | Description
--- | ---
Size | The second line contains an integer value in bytes for the size 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 BMP Example

To read the current image in ASCII hexadecimal format from an In-Sight vision system, issue the following command: RB

The In-Sight vision system initially responds with 1, indicating that the execution of the Read BMP command was successful. The next line contains the size (3848) in bytes, and 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.