Dalsa Xtium-CL MX4 - Metadata: Theory of Operation; Metadata Data Structure

66 • Xtium-CL MX4 Reference Xtium-CL MX4 User's Manual
Metadata: Theory of Operation
The following provides additional details on the Metadata implementation.
Metadata Data Structure
The Xtium-CL MX4 supports metadata at the end of each line when enabled through the parameter
CORACQ_PRM_META_DATA. The metadata consists of 64 bytes. The content of the metadata
represents a snapshot of the state of the frame grabber at the beginning of each LVAL received.
typedef struct
{
ULONGLONG shaftEncoderCount;
ULONGLONG lineCount;
ULONGLONG lineTriggerCount;
ULONGLONG timeStamp;
ULONG frameCounter;
UCHAR generalInputs;
UCHAR generalOutputs;
UCHAR biDirectionalIOs;
UCHAR reserved[25];
} MX4_METADATA, *PMX4_METADATA;
 shaftEncoderCount: 64-bit counter of pulses received on the shaft encoder. This is a ‘machine
counter’ that increments in one direction (forward) and decrements (reverse) in the opposite
direction.
 lineCount: 64-bit counter of line valid (LVAL) received.
 lineTriggerCount: 64-bit counter of line triggers sent to the camera.
 timeStamp: 64-bit counter of the frame grabber on-board timestamp. See also
CORACQ_PRM_TIME_STAMP_BASE and CORACQ_PRM_TIME_STAMP.
 frameCounter: 32-bit counter of frames received. This represents the frame number that the
line belongs to.
 generalInputs: status of the general inputs (for example, Low, bit = 0 or High, bit = 1).
 generalOutputs: status of the general outputs (for example, Low, bit =0 or High, bit = 1).
 biDirectionalIOs: status of the bi-directional I/Os (for example, Low, bit = 0 or High, bit = 1).
 reserved: 25 bytes reserved for future usage.
For a demo application showing this feature, please contact Teledyne DALSA technical support.