© 2016 Thorlabs Scientific Imaging228
DCx Camera Functional Description and SDK Manual
4.3.36 is_GetCameraList
Syntax
INT is_GetCameraList (UC480_CAMERA_LIST* pucl)
Description
Using is_GetCameraList(), you can query information about the connected cameras. To get all
information that is available, you need to adjust the field size to the number of connected cameras.
The following tables explain the structures used for that purpose.
Input parameters
Handle to the UC480_CAMERA_LIST structure
Contents of the UC480_CAMERA_LIST Structure
Has to be initialized with the number of cameras
connected to the system.
This value can be read out with
is_GetNumberOfCameras().
Placeholder for 1 … n UC480_CAMERA_INFO
structures
Contents of the UC480_CAMERA_LIST::UC480_CAMERA_INFO Structure
Customizable camera ID. This ID is stored in the
camera and is persistent.
Internal device ID. This ID is generated by the
driver depending on order of connection and
camera type. The device ID is not persistent.
1 = camera is being used.
0 = camera is not being used.
Serial number of the camera
Information for the status of the camera
Note
The serial number or model name should not be used to find a specific camera (e.g. in order to
control this specific camera). If you use the serial number, the software may not find the serial
number after exchanging the camera. The model name can be changed when updating the camera
driver.
Instead, we recommend identifying a camera by a fixed camera ID, the camera type or by the
sensor ID. The advantage of the camera ID is that you can set it manually. That means if you
exchange a camera, you can set the same camera ID for the new camera.