Description

Set parameters for the digital video SightLine protocol parser.

typedef struct {
  u8 cameraIndex;
  u8 enabled;
  u8 flags;
  u8 oneMessagePerImage;
  u8 usePixelValue;
} SLADigitalVideoParserParameters_t;

This function provides the ability to manipulate the video frames to encode SightLine protocol messages on the two lines immediately following the valid video window defined in SLASetAcquisitionParameters_t. The first pixel for encoding in the Luma (Y) buffer is either:

((Valid_ROI_Row)+(ROI_Height))*(Image_Width), if bit 1 of flags is set to false, (first line after ROI window)
(Image_Height)*(Image_Width), if bit 1 of flags is set to true (first line after acquired window).

The maximum number of pixels for encoding is Image_Width*2 in either case.

Performance Notes:

If flags Bit 0 is zero, parsing may take more time, as the entire buffer is scanned for SLA protocol message(s).
If oneMessagePerImage is zero, parsing may take more time, as more SLA protocol messages are looked for after any successful parsing.
Setting usePixelValue to false may be required in the unlikely case that the exact value of the pixel cannot be guaranteed.

Also sent in response to SLAGetParameters_t().

Message ID 0x91

Byte Offset

Name

Description

4

cameraIndex

Camera Index

5

enabled

Enable parsing (0 = disable, 1 = enable). Default is disable.

6

flags

Bit	Description
0	SLA protocol message is expected to start at first pixel (0 = false, 1 = true ) default is true
1	SLA protocol message is encoded beginning at first line right after Acquired window. (1 = true, 0 = false: the message is embedded right after the ROI window, as defined in SLASetAcquisitionParameters_t).

7

oneMessagePerImage

0 - Multiple protocol message may be present in the frame
1 - a single SLA protocol message is expected per frame

8

usePixelValue

Interpret pixel value.

Value	Description
0	Each pixel will be interpreted as a bit (any value less than 128 translates to 0, any value 128 and above translates to 1)
1 (default)	Each pixel will be interprested as a byte