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.
