Falcon™ 4-CLHS Series Operational Reference 81
Extracting Metadata Stored in a Sapera Buffer
For Sapera LT developers, the SapMetadata class can be used to access metadata. The metadata
location is always the beginning of the last line of the image.
Metadata is ordered as follows:
The Chunk ID, Chunk Size and Chunk Availability fields are always present in the metadata; all the
other fields are optional.
Metadata Structure
The metadata currently contains the following values, in this order.
Type Value Description Available Bit
unsigned int Chunk ID The Chunk ID is hardcoded to 0xCD000002
when pixels are read in reverse order (3 – 0).
Always available.
unsigned int Chunk Size The Chunk Size is currently 400. This value is
hardcoded in pixel 7.
Always available.
unsigned long long Chunk Availability Determines the availability of metadata.
For bits [1:31]:
0: Metadata not available.
1: Metadata available.
Refer to the Metadata Availability section for
information on the bit field structure.
Always available
(bit 0 not used)
unsigned long long Exposure Time Exposure time, in µs. 1
unsigned long long Cycling Current Set Cycling current set. 2
unsigned long long Line Status All
The line status for available lines is represented
as a bitfield, with 0 = low and 1 = high.
bit0: GPIO
bit1: GPI1
6