© 2013 Thorlabs GmbH
4 Programming (SDK)
233
4.3.35 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.
Return values
Not enough memory allocated for the
UC480_CAMERA_LIST structure
An attempt to initialize or select the camera failed (no
camera connected or initialization error).
One of the submitted parameters is outside the valid
range or is not supported for this sensor or is not
available in this mode.
249