24
C
AMERA
S
UPPORT
L
IBRARY
C
AM
L
IB
The flags parameter indicates whether the gain and/or image integration time (exposure) are allowed to
be adjusted, and whether the new values should be applied to the camera immediately after taking the
current image or postponed until and applied upon the next image acquisition. Note that in the snapshot
mode adjustment of the image integration time is not allowed regardless of the flags parameter.
By default, the automatic brightness adjustment is disabled.
The most optimal values of gain and exposure are calculated within their allowed ranges, see functions
camSetAutoGainRange_db() and camSetAutoExpoRange() for details.
Prototype:
int camSetAutoBrightnessControl(int cam_handle, unsigned long flags);
Parameters:
cam_handle - [in] handle to the camera device returned by the camOpen function.
flags - [in] bit-combinatory value specifying whether the gain and/or image integration
time (exposure) can be adjusted, and whether the new values should be applied to
the camera immediately after taking the current image or postponed until and
applied upon the next image acquisition. The individual bit values are:
• CAM_AUTOGAIN, gain can be adjusted
• CAM_AUTOEXPO, image integration time can be adjusted
• CAM_APPLY_INSTANTLY, new values should be applied immediately
after taking the image.
Return Value:
0: Success; -1: Failure
camGetAutoBrightnessControl This function returns the current status of the automatic brightness adjustment.
Prototype:
int camGetAutoBrightnessControl(int cam_handle, unsigned long *flags);
Parameters:
cam_handle - [in] handle to the camera device returned by the camOpen function.
flags - [out] bit-combinatory value specifying whether the gain and/or image integration
time (exposure) can be adjusted, and whether the new values are applied to the
camera immediately after taking the current image or postponed until and applied
upon the next image acquisition. The individual bit values are:
• CAM_AUTOGAIN, gain can be adjusted
• CAM_AUTOEXPO, image integration time can be adjusted
• CAM_APPLY_INSTANTLY, new values are applied immediately after
taking the image.
Return Value:
0: Success; -1: Failure