Features AW00123402000
246 Basler ace USB 3.0
8.17.3.4 Counter Value Chunk
The counter value chunk feature numbers items sequentially as they occur. When the feature is
enabled, a chunk is added to each image containing the value of the counter.
The counter value used for the chunk is taken from the currently active counter and relates to the
currently active counter event source. So far, only Counter 1 is implemented as counter and the
Frame Start trigger as counter event source.
The Counter 1 value is a 32 bit number. The counter starts at 0 and increments by 1 for each frame
start trigger. The counter counts up to 4294967295 unless it is reset before (see below). After
reaching the maximum value, the counter will reset to 0 and then continue counting.
Be aware that, if the camera is acquiring frame start triggers continuously and continuous capture
is stopped, several numbers in the counting sequence can be skipped. This happens due to the
internal buffering scheme of image data used in the camera.
1. Use the chunk selector to select the counter value chunk.
2. Use the Chunk Enable parameter to set the value of the chunk to true.
Once the counter value chunk is enabled and Chunk Mode Active is enabled, the camera will add
a counter value chunk to each acquired image.
After an image with an appended chunk has been received by your PC the chunk must be retrieved.
For information about retrieving data chunks, see Section 8.17.4 on page 250.
You can set the Chunk Selector and Chunk Enable parameter value from within your application
software by using the Basler pylon API. The following code snippet illustrates using the API to
activate the chunk mode, and enable the counter value chunk:
// make chunk mode active and enable Counter Value chunk
camera.ChunkSelector.SetValue(ChunkSelector_CounterValue);
camera.ChunkEnable.SetValue(true);
You can also use the Basler pylon Viewer application to easily set the parameters.
For more information about the pylon API and the pylon Viewer, see Section 3.1 on page 37.
To enable the counter value chunk: