Get Luminance Image
This message is used to get the image from the camera module. The image is received in chunks. The size of the
chunks and the number of necessary chunks is determined by the client (the camera module in the framework). The
image must to be packed. The number of chunks to request is indicated by the total chunks field in the response.
The upload sequence can be restarted at any time by sending a new Get Luminance Image command with the
chunk index set to 1. When not in Sensor mode, the host must quickly request the remaining chunks to avoid data
corruption. In Smart Camera mode and in Configuration mode, sending a Get Luminance Image command with
chunk index set to 1 initiates a new capture.
The response timeout for this command must be set to two times the inverse of the frame rate.
Every chunk must contain an integer number of pixels. However, the size of the last chunk can be different. The
chunk size must indicate the size of the transmitted chunk. Image is transmitted first row first.
There are two versions of this message that are implemented. The first version is the legacy one, the second is the
new one which includes a time tag.
C++ API:
void SnapSensor::SensorConnection::CameraModule::GetLuminanceImage (Image
dstImage, SNAP_UINT32 *frameIndex, TimeSpan *frameTime)
Table 7-96:
Get Luminance Image Command - Header
Field Name
Type
Notes
Module ID
U1
0x10
Reserved1
U1
0
Command ID
U2
0x11
Version
U4
1
Reserved2
U4
0
Payload Size
U4
2
Reserved3
U4
0
Table 7-97:
Get Luminance Image Command - Payload
Field Name
Type
Notes
Chunk Index
U4
1 – Total Chunks
Table 7-98:
Get Luminance Image Response - Header
Field Name
Type
Notes
Module ID
U1
0x10
Reserved1
U1
0
Camera Module Messages
7–38
ADIS1700x Vision-Sensing Camera Module User Guide
