Please enable JavaScript to view this site.

IDS peak 2.10.0 / uEye+ firmware 3.34

IDS Peak comfortSDK, genericSDK, IPL, and AFL developer manuals are external documents. Please contact us if you need them.

Chunks are additional information transferred in the image payload, e.g. exposure time during image capture, image size, etc.The available chunks depend on the respective camera model. For example, ChunkPtpStatus is only supported by GigE Vision cameras. Chunks are organized in blocks, i.e. certain chunks are transferred together and thus cannot be enabled separately.

Chunk block

Chunk name

Type

Refers to

Name in ChunkSelector

Description

Auto features

ChunkBalanceWhiteAutoStatus

Enumeration

Camera

BalanceWhiteAutoStatus

Status of the automatic white balance (BalanceWhiteAuto).

ChunkBrightnessAutoStatus

Enumeration

Camera

BrightnessAutoStatus

Status of the automatic exposure (ExposureAuto, GainAuto)

Counter

ChunkCounterStatus

Enumeration

Camera

CounterStatus

Status of the selected counter (CounterStatus). The counter is selected via ChunkCounterSelector.

ChunkCounterValue

Integer

Camera

CounterValue

Value of the selected counter (CounterValue). The counter is selected via ChunkCounterSelector.

Exposure

ChunkExposureTime

Float

image

ExposureTime

Exposure time of the image (ExposureTime)

“ExposureStart” trigger signal

ChunkExposureTriggerTimestamp

Integer

Camera

ExposureTriggerTimestamp

Timestamp of the "ExposureStart" trigger signal

Gain

ChunkGain

Float

image

Gain

Image gain (Gain). The desired gain is selected via ChunkGainSelector.

Image information

ChunkHeight

Integer

image

Height

Image height (Height)

ChunkWidth

Integer

image

Width

Image width (Width)

ChunkOffsetX

Integer

image

OffsetX

X position of the image (OffsetX)

ChunkOffsetY

Integer

image

OffsetY

Y position of the image (OffsetY)

ChunkPixelFormat

Enumeration

image

PixelFormat

Pixel format of the image (PixelFormat)

PTP

ChunkPtpStatus

Enumeration

Cameras

PtpStatus

Status of the PTP clock (PtpStatus)

Sequencer

ChunkSequencerSetActive

Integer

image

SequencerSetActive

Sequencer set index which was used for image acquisition (SequencerSetActive).

Timestamp

ChunkTimestamp

Integer

image

Timestamp

Image timestamp

Status of the line signals

ChunkLineStatusAll

Integer

Camera

LineStatusAll

Status of all available line signals at the time of the selected latch trigger event (LineStatusAll). The latch trigger event is selected by ChunkLatchTriggerSource.

For more information, see ChunkDataControl.

Switching on chunks

You can activate chunks via the following nodes:

genericC++

// Activate chunk data in the payload of the image
nodemapRemoteDevice->FindNode<peak::core::nodes::BooleanNode>("ChunkModeActive")->SetValue(true);
 
// Enable exposure time chunk
nodemapRemoteDevice->FindNode<peak::core::nodes::EnumerationNode>("ChunkSelector")->SetCurrentEntry("ExposureTime");
nodemapRemoteDevice->FindNode<peak::core::nodes::BooleanNode>("ChunkEnable")->SetValue(true);

hint_info

By activating chunks, the required memory size for each buffer changes and thus the PayloadSize (see Preparing image acquisition: create buffer). This means the buffers have to be created or recreated afterwards.

If chunks are activated, the access to the properties of the buffer object (Width, Height etc.) is not possible. Alternatively, you can use the corresponding camera nodes in this case. Note, however, that these nodes always display the current settings and not exactly the settings of a previously captured image (frame).

Querying if a buffer has chunks

genericC++

bool hasChunks = imageBuffer->HasChunks();

Entering the chunk values of the image into the XML tree

If a buffer has chunks, then the values can be automatically entered by IDS peak into the XML tree and are available there via the corresponding nodes.

genericC++

nodeMapRemoteDevice->UpdateChunkNodes(imageBuffer);

Querying a chunk value from the XML tree (e.g. ExposureTime)

genericC++

auto chunkValue = nodemapRemoteDevice->FindNode<peak::core::nodes::FloatNode>("ChunkExposureTime")->Value();

Complete example

© 2024 IDS Imaging Development Systems GmbH