Metrologic Instruments IS4910 Series - Manual (Page 19)

13
C
AMERA
S
UPPORT
L
IBRARY
C
AM
L
IB
camGetImageSize
This function returns the size of the window of interest (WOI).
Prototype:
int camGetImageSize (int cam_handle, int *img_width, int *img_height, int *num_bytes_per_row);
Parameters:
cam_handle - [in] handle to the camera device returned by the camOpen function.
img_width
- [out] image width, in pixels.
img_height - [out] image height, in rows.
num_bytes_per_row - [out] If not NULL, number of bytes in one row of pixels.
Return Value:
0: Success; -1: Failure
Gain
The analog gain is a camera parameter allowing amplification of the video signal before its digitization.
By default, if not specified otherwise in the IS4910 device driver initialization file VuQuest2D.ini, the gain
is set to 0 dB (no gain).
For the purposes of automatic brightness adjustments, an application can specify the minimum and
maximum boundaries for the gain value. By default, the minimum gain is set to 0 dB (no gain) and the
maximum gain is set to 24 dB.
If the camera is running in the video mode, it must be stopped or paused before changing the gain
property. To change the boundaries for the gain value, the camera must be stopped.
camSetGain_db
This function sets the camera’s gain, in decibels (dB).
Prototype:
int camSetGain_db (int cam_handle, float gain);
Parameters:
cam_handle - [in] handle to the camera device returned by the camOpen function.
gain
- [in] the gain value, in dB. Can be in the range from 0 to 24 dB.
Return Value:
0: Success; -1: Failure
camGetGain_db
This function returns the current value of camera’s gain, in decibels (dB).
Prototype:
int camSetGain_db (int cam_handle, float *gain);