Chunk Data Control
Chunk Data allows you the ability to send additional information with the image data. This can be helpful when debugging issues or looking at what settings have been applied to the acquired image.
Use ChunkModeActive to enable chunk data for images.
The following information is enabled by default as chunk data:
Image - enabled by default and cannot be disabled.
Image CRC - enabled by default and cannot be disabled.
Image properties available for chunk data depend on the camera's sensor, but could include image size, image format settings (gain, exposure, pixel format), timestamp, and others.
Use ChunkSelector to select a chunk then use ChunkEnable to enable or disable it. Image and ImageCRC cannot be disabled.
Once acquisition has started Chunk data can not be altered. To enable or disable chunks acquisition must be stopped.
Summary Table
| Name | Interface | Access | Visibility | Description |
|---|---|---|---|---|
| Chunk Mode Active | IBoolean | RW | Expert | Activates the inclusion of Chunk data in the payload of the image. |
| Chunk Selector | IEnumeration | RW | Expert | Selects which chunk data to enable or disable. |
| Chunk Enable [Chunk Selector] | IBoolean | RW | Expert | Enables the inclusion of the selected Chunk data in the payload of the image. |
| Chunk Image | IInteger | RO | Expert | Returns the image payload. |
| Image CRC | IInteger | RO | Expert | Returns the CRC of the image payload. |
| Chunk Frame ID | IInteger | RO | Expert | Returns the image frame ID. |
| Chunk Offset X | IInteger | RO | Expert | Returns the Offset X of the image included in the payload. |
| Chunk Offset Y | IInteger | RO | Expert | Returns the Offset Y of the image included in the payload. |
| Chunk Width | IInteger | RO | Expert | Returns the width of the image included in the payload. |
| Chunk Height | IInteger | RO | Expert | Returns the height of the image included in the payload. |
| Chunk Pixel Format | IEnumeration | Expert | Format of the pixel provided by the camera | |
| Chunk Exposure Time | IFloat | RO | Expert | Returns the exposure time used to capture the image. |
| Chunk Gain Selector | IEnumeration | Expert | Selects which gain to retrieve | |
| Chunk Gain [Chunk Gain Selector] | IFloat | RO | Expert | Returns the gain used to capture the image. |
| Chunk Black Level Selector | IEnumeration | Expert | Selects which black level to retrieve | |
| Chunk Black Level [Chunk Black Level Selector] | IFloat | RO | Expert | Returns the black level used to capture the image. |
| Chunk Timestamp | IInteger | RO | Expert | Returns the Timestamp of the image. |
| Chunk Sequencer Set Active | IInteger | RO | Expert | Returns the index of the active set of the running sequencer included in the payload. |
| Chunk Exposure End Line Status All | IInteger | RO | Expert | Returns the status of all the I/O lines at the end of exposure event. |
| Chunk Serial Data Length | IInteger | RO | Expert | Returns the length of the received serial data that was included in the payload. |
| Chunk Serial Data | IStringReg | Expert | Returns the serial data that was received. | |
| Chunk Serial Receive Overflow | IBoolean | RO | Expert | Returns the status of the chunk serial receive overflow. |
Chunk Data Control Features
Chunk Mode Active
Activates the inclusion of Chunk data in the payload of the image.
| Property | Value |
|---|---|
| Name | ChunkModeActive |
| Interface | IBoolean |
| Access | RW |
| Visibility | Expert |
Chunk Selector
Selects which chunk data to enable or disable.
| Property | Value |
|---|---|
| Name | ChunkSelector |
| Interface | IEnumeration |
| Access | RW |
| Visibility | Expert |
| Enumeration Values |
|---|
| Image |
| CRC |
| FrameID |
| OffsetX |
| OffsetY |
| Width |
| Height |
| ExposureTime |
| Gain |
| BlackLevel |
| PixelFormat |
| Timestamp |
| SequencerSetActive |
| SerialData |
| ExposureEndLineStatusAll |
Chunk Enable
Enables the inclusion of the selected Chunk data in the payload of the image.
| Property | Value |
|---|---|
| Name | ChunkEnable [Chunk Selector] |
| Interface | IBoolean |
| Access | RW |
| Visibility | Expert |
Chunk Image
Returns the image payload.
| Property | Value |
|---|---|
| Name | ChunkImage |
| Interface | IInteger |
| Access | RO |
| Unit | |
| Visibility | Expert |
Image CRC
Returns the CRC of the image payload.
| Property | Value |
|---|---|
| Name | ChunkCRC |
| Interface | IInteger |
| Access | RO |
| Unit | |
| Visibility | Expert |
Chunk Frame ID
Returns the image frame ID.
| Property | Value |
|---|---|
| Name | ChunkFrameID |
| Interface | IInteger |
| Access | RO |
| Unit | |
| Visibility | Expert |
Chunk Offset X
Returns the Offset X of the image included in the payload.
| Property | Value |
|---|---|
| Name | ChunkOffsetX |
| Interface | IInteger |
| Access | RO |
| Unit | |
| Visibility | Expert |
Chunk Offset Y
Returns the Offset Y of the image included in the payload.
| Property | Value |
|---|---|
| Name | ChunkOffsetY |
| Interface | IInteger |
| Access | RO |
| Unit | |
| Visibility | Expert |
Chunk Width
Returns the width of the image included in the payload.
| Property | Value |
|---|---|
| Name | ChunkWidth |
| Interface | IInteger |
| Access | RO |
| Unit | |
| Visibility | Expert |
Chunk Height
Returns the height of the image included in the payload.
| Property | Value |
|---|---|
| Name | ChunkHeight |
| Interface | IInteger |
| Access | RO |
| Unit | |
| Visibility | Expert |
Chunk Pixel Format
Format of the pixel provided by the camera
| Property | Value |
|---|---|
| Name | ChunkPixelFormat |
| Interface | IEnumeration |
| Access | |
| Visibility | Expert |
| Enumeration Values |
|---|
| Mono8 |
| Mono12Packed |
| Mono16 |
| RGB8Packed |
| YUV422Packed |
| BayerGR8 |
| BayerRG8 |
| BayerGB8 |
| BayerBG8 |
| YCbCr601_422_8_CbYCrY |
Chunk Exposure Time
Returns the exposure time used to capture the image.
| Property | Value |
|---|---|
| Name | ChunkExposureTime |
| Interface | IFloat |
| Access | RO |
| Unit | us |
| Visibility | Expert |
Chunk Gain Selector
Selects which gain to retrieve
| Property | Value |
|---|---|
| Name | ChunkGainSelector |
| Interface | IEnumeration |
| Access | |
| Visibility | Expert |
| Enumeration Values |
|---|
| All |
| Red |
| Green |
| Blue |
Chunk Gain
Returns the gain used to capture the image.
| Property | Value |
|---|---|
| Name | ChunkGain [Chunk Gain Selector] |
| Interface | IFloat |
| Access | RO |
| Unit | dB |
| Visibility | Expert |
Chunk Black Level Selector
Selects which black level to retrieve
| Property | Value |
|---|---|
| Name | ChunkBlackLevelSelector |
| Interface | IEnumeration |
| Access | |
| Visibility | Expert |
| Enumeration Values |
|---|
| All |
Chunk Black Level
Returns the black level used to capture the image.
| Property | Value |
|---|---|
| Name | ChunkBlackLevel [Chunk Black Level Selector] |
| Interface | IFloat |
| Access | RO |
| Unit | % |
| Visibility | Expert |
Chunk Timestamp
Returns the Timestamp of the image.
| Property | Value |
|---|---|
| Name | ChunkTimestamp |
| Interface | IInteger |
| Access | RO |
| Unit | |
| Visibility | Expert |
Chunk Sequencer Set Active
Returns the index of the active set of the running sequencer included in the payload.
| Property | Value |
|---|---|
| Name | ChunkSequencerSetActive |
| Interface | IInteger |
| Access | RO |
| Unit | |
| Visibility | Expert |
Chunk Exposure End Line Status All
Returns the status of all the I/O lines at the end of exposure event.
| Property | Value |
|---|---|
| Name | ChunkExposureEndLineStatusAll |
| Interface | IInteger |
| Access | RO |
| Unit | |
| Visibility | Expert |
Chunk Serial Data Length
Returns the length of the received serial data that was included in the payload.
| Property | Value |
|---|---|
| Name | ChunkSerialDataLength |
| Interface | IInteger |
| Access | RO |
| Unit | |
| Visibility | Expert |
Chunk Serial Data
Returns the serial data that was received.
| Property | Value |
|---|---|
| Name | ChunkSerialData |
| Interface | IStringReg |
| Access | |
| Visibility | Expert |
Chunk Serial Receive Overflow
Returns the status of the chunk serial receive overflow.
| Property | Value |
|---|---|
| Name | ChunkSerialReceiveOverflow |
| Interface | IBoolean |
| Access | RO |
| Visibility | Expert |
