SightLine Applications Inc.
SightLine Applications Command, Control, and Script API  v3.7
List of all members
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;
u8 midpoint;

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
4cameraIndexCamera Index
5modeMode 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-7agHoldmaxAutogain Max value used with Manual Gain mode control for high bit depth images (max value maps to 255 in 8 bit output)
8-9agHoldminAutogain Min Value with Manual Gain mode control for high bit depth images (min value maps to 0 in 8 bit output)
10rowROIPctRow ROI for Autogain stats. Row Offset in % of image height (255=100%); Full image(default) = 0
11colROIPctCol ROI for Autogain stats. Col Offset in % of image width (255=100%); Full image(default) = 0
12highROIPctHigh ROI for Autogain stats. Height in % of image height (255=100%); Full image(default) = 255
13wideROIPctWide ROI for Autogain stats. Width in % of image width (255=100%); Full image(default) = 255
14-15minAGRangeHigh 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
16agRate8Auto gain update rate. 1 = minimum rate, 255 = maximum rate, 32 = default. New 3.0
Use Manual mode to stop AGC updates
17minExpMinimum exposure or integration time 0 to 255. Default(0) = ignored. For cameras that support exposure control, see SLASetADCParameters_t. New 3.2
18maxExpMaximum exposure or integration time 0 to 255. Default(0) = ignored. For cameras that support exposure control, see SLASetADCParameters_t. New 3.2
19rejectDarkTailReject 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
20rejectBrightTailReject 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
21midpointAutogain Central value used for high bit depth images. Adjusts which input value corresponds to central output value. New 3.7
0 = Black pixels convert to gray, 128 = pixels (legacy behvaior), 255 = White pixels convert to gray.