SightLine Applications Command, Control, and Script API  v3.6
List of all members
SLACurrentDigitalCameraParameters_t Struct Reference

Description

Return parameters of currently selected digital camera – similar to SLASetDigitalCameraParameters_t.

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

Sent in response to SLAGetParameters_t().

Message ID 0x71

Byte Offset Name Description
4modeMode 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
5-6agHoldmaxAutogain Max value used with Manual Gain mode control for high bit depth images (max value maps to 255 in 8 bit output)
7-8agHoldminAutogain Min Value with Manual Gain mode control for high bit depth images (min value maps to 0 in 8 bit output)
9rowROIPctRow ROI for Autogain stats. Row Offset in % of image height (255=100%); Full image(default) = 0
10colROIPctCol ROI for Autogain stats. Col Offset in % of image width (255=100%); Full image(default) = 0
11highROIPctHigh ROI for Autogain stats. Height in % of image height (255=100%); Full image(default) = 255
12wideROIPctWide ROI for Autogain stats. Width in % of image width (255=100%); Full image(default) = 255
13cameraIndexCamera Index
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