SLASetDigitalCameraParameters_t Struct Reference

Description

Dynamically adjust a 10 to 16 bit digital camera input to an 8 bit image.

typedef struct {
  u8 cameraIndex;
  u8 mode;
  u16 agHoldmax;
  u16 agHoldmin;
  u8 rowROIPct;
  u8 colROIPct;
  u8 highROIPct;
  u8 wideROIPct;
  u16 minAGRange;
  u8 agRate8;
  u8 minExp;
  u8 maxExp;
  u8 rejectDarkTail;
  u8 rejectBrightTail;
} SLASetDigitalCameraParameters_t;

• AGC (Automatic Gain Control) is applied to the capture image before all other processing. agRate8 determines the smoothing filter time constant and minAGRange prevents excessive changes.
• ROI (Region Of Interest) is used to indicate a part of image over which to perform autogain statistics . This ROI is defined as an offset from the relevant edge as a percentage of the full width / height of image.

To get the current values, use SLAGetParameters_t. This will return a SLACurrentDigitalCameraParameters_t.

Note

Setting both `Autogain Max value' and `Autogain Min Value' to 0 will result in these parameters being ignored.

See also

SLASetADCParameters_t to set the brightness (offset) and contrast (gain) used for AGC.

SLASetOverlayMode_t to enable histogram overlays for Capture & Display images.

EAN-Infrared-Temperature for more information.

Message ID 0x70

Byte Offset	Name	Description
4	cameraIndex	Camera Index 1500: only applies to camera index 2
5	mode	Mode for automatic and manual gain/exposure control. See Sensor Controls and Gain Modes Value Description 0 High bit depth automatic gain control (for 10 to 16 bit image conversion to 8 bits) 1 Manual gain and exposure control - set agHoldmax/agHoldmin for high bit depth imagers or set sensor Exposure and Gains if available in SLASetADCParameters_t 2 SightLine automatic exposure and gain control (SLA auto gain algorithm adjusts parameter registers on the sensor, see SLASetADCParameters_t) 4000/17XX only, New 3.1 3 Camera automatic exposure and gain control (camera controls its gain and exposure, see SLASetADCParameters_t) 4000/17XX only, New 3.6 255 Unknown - state after reset or after setting up a new camera model in SLASetAcquisitionParameters_t 4000/17XX only, New 3.6
6-7	agHoldmax	Autogain Max value used with Manual Gain mode control for high bit depth images (max value maps to 255 in 8 bit output)
8-9	agHoldmin	Autogain Min Value with Manual Gain mode control for high bit depth images (min value maps to 0 in 8 bit output)
10	rowROIPct	Row ROI for Autogain stats. Row Offset in % of image height (255=100%); Full image(default) = 0
11	colROIPct	Col ROI for Autogain stats. Col Offset in % of image width (255=100%); Full image(default) = 0
12	highROIPct	High ROI for Autogain stats. Height in % of image height (255=100%); Full image(default) = 255
13	wideROIPct	Wide ROI for Autogain stats. Width in % of image width (255=100%); Full image(default) = 255
14-15	minAGRange	High Bit Depth Autogain mode: Minimum spread of auto gain. 0 = does nothing, 200 = max - min scale range must be at least 200. Prevents over-gaining of flat scenes. New 3.0 SightLine Auto Gain Mode mode: Difference limit for updates. 0 = does nothing, 10 = if image average is within 10 of target Brightness, don't update exposure and gain. Prevents image flashing and excessive setting of sensor registers. New 3.1
16	agRate8	Auto gain update rate. 1 = minimum rate, 255 = maximum rate, 32 = default. New 3.0 Use Manual mode to stop AGC updates
17	minExp	Minimum exposure or integration time 0 to 255. Default(0) = ignored. For cameras that support exposure control, see SLASetADCParameters_t. New 3.2
18	maxExp	Maximum exposure or integration time 0 to 255. Default(0) = ignored. For cameras that support exposure control, see SLASetADCParameters_t. New 3.2
19	rejectDarkTail	Reject or ignore this percent/10 of the left/dark side of the histogram when calculating Autogain. 0 = reject none, 10 = reject 1.0%, 255 = reject 25.5%. Useful when there are a small number of very dark pixels in a scene. New 3.4
20	rejectBrightTail	Reject or ignore this percent/10 of the right/bright side of the histogram when calculating Autogain. 0 = reject none, 10 = reject 1.0%, 255 = reject 25.5%. Useful when there are a small number of very bright pixels in a scene. New 3.4