Metrologic IS4910 Series, Руководство программиста

Страница: 16 / 42

10
C
AMERA
S
UPPORT
L
IBRARY
C
AM
L
IB
camOpen
This function establishes communication with the specified camera device.
Note: The target OS must support the MultiByteToWideChar function in order for the camera support
library to open the device driver properly.
Prototype:
int camOpen (char *
device_name , char * ctl_bus_name , int * p_dev_type );
Parameters:
device_name - [in] must be a valid IS4910 camera device name registered in the operating
system. The default name is “VUQ1:”, where “1” is the default device index
specified in VuQuest2D.ini configuration file.
ctl_bus_name - [in] should be NULL.
p_dev_type - [out] (optional) pointer to the location where the function returns the type of image
sensor used in the camera. Currently, this value can only be
CAM_IMG_SENSOR_VC5602 (or CAM_IMG_SENSOR_UNKNOWN if the sensor
type could not be automatically identified).
Return Value:
If positive – handle to the camera device, or (-1) in case of error. The handle must be used in all
consequent calls to CamLib APIs to identify the camera device on which an operation is requested
to be performed.
camClose
This function closes communication with the specified camera device.
Prototype:
int camClose (int
cam_handle );
Parameters:
cam_handle [in] handle to the camera device returned by the camOpen function.
Return Value:
0: Success; -1: Failure
Camera Properties APIs
The IS4910 camera has a set of properties, which an application can change for the purposes of
satisfying the application’s specific requirements.
Note: In order to change camera’s properties, the camera must be in fully power state (D0) or
in standby state (D2).
The camera must not be busy taking images when an application attempts to change any of the
properties. In order to change camera’s properties when the camera is in the video mode, it must be
stopped or paused. If the camera’s video mode is paused, only image sensor gain and image integration
time properties can be changed. If the camera’s video mode is stopped, any of the properties can be
changed.
The default values for most of the properties can be specified in the IS4910 device driver initialization file
VuQuest2D.ini.