Metadata; Related Gige Vision Features - Dalsa CALIBIR 640 GigE User Manual

Metadata

Along with each image, the Calibir camera can output metadata associated to that image. Metadata
is appended to the image data.
The current implementation sets the value of chunkDataType feature to IncreaseImageDataSize to
indicate that the metadata is appended to the image data.
Metadata includes pixel statistics located within a measurement ROI, as well as statistics for the
whole image. By default, the measurement ROI is a 31x31 region with top-left corner located at
(305,225) (in the current implementation, the ROI position cannot be changed).
The metadata contains the following values:
Type Value
UINT64 reserved1;
UINT32 reserved2;
UINT64 trigTimestamp;
UINT16 imageWidth;
UINT16 imageHeight;
UINT64 frameTimestamp;
UINT16 roiX;
UINT16 roiY;
UINT16 roiW;
UINT16 roiH;
UINT16 roiStatsMax;
UINT16 roiStatsMin;
UINT16 roiStatsAvg;
UINT16 imgStatsMax;
UINT16 imgStatsMin;
UINT16 imgStatsAvg;
The installation MetadataDemo directory contains a modified version of Sapera LT's
GigeCameraDemo (with executables and source code) that illustrates how to work with the Sapera
LT API to receive and use the Calibir's metadata. It demonstrates how extra lines are added to the
host buffer to append the metadata and how to extract the metadata values.

Related GigE Vision Features

To enable metadate, the ChunkModeActive feature must be set to ON.
The feature chunkDataType indicates how that data is transferred on the Ethernet link. These
features are part of the Metadata Controls Category category.
32 • Features and Configuration Options
Description
Reserved for future use.
Reserved for future use.
value of the camera's internal clock (increments every microsecond) at
the moment where an external trigger is received. Only valid when the
camera is configured for external frame triggers.
Width of the image, in pixels.
Height of the image, in pixels.
Value of the camera's internal clock (increments every microsecond) at
the moment where the sensor started outputting an image.
X-coordinate of the top-left corner of the ROI.
Y-coordinate of the top-left corner of the ROI.
ROI width, in pixels.
ROI height, in pixels.
Maximum pixel value in the measurement ROI.
Minimum pixel value in the measurement ROI.
Average pixel value in the measurement ROI.
Maximum pixel value in the image.
Minimum pixel value in the image.
Average pixel value in the image.
Calibir 640 GigE IR Camera User's Manual