THORLABS DCU22 Series User Manual

© 2013 Thorlabs GmbH
4 Programming (SDK)
315
4.3.77 is_SetColorConverter
USB 2.0
USB 3.0
USB 2.0
USB 3.0
Syntax
INT is_SetColorConverter (HIDS hCam, INT ColorMode, INT ConvertMode)
Description
Using is_SetColorConverter(), you can select the type of Bayer conversion for color cameras. Software
conversion is done on the PC. The use of a larger filter mask results in a higher image quality, but increases the
computational load. For further information, please refer to the Camera basics: Color filters chapter.
Note
Software conversion with the large filter mask should only be used for sensors whose green pixels have the same
sensitivity. This applies to all DCU22xX CCD cameras.
For all other sensors, we recommend using the standard filter mask.
Attention
While free run mode is active, you cannot change the color conversion type. To do so, you must first stop the
capturing process using is_StopLiveVideo() or set the camera to trigger mode (see
is_SetExternalTrigger() ).
Input parameters
hCam
Camera handle
ColorMode
Color mode for which the converter is to be set.
For a list of all available color formats and the
associated input parameters, see the Appendix: Color
and memory formats section.
ConvertMode
Conversion mode selection
IS_CONV_MODE_NONE
No conversion
IS_CONV_MODE_SOFTWARE
Only for monochrome cameras, if you want to add a
gamma
IS_CONV_MODE_SOFTWARE_3X3
Software conversion using the standard filter mask
(default)
IS_CONV_MODE_SOFTWARE_5X5
Software conversion using a large filter mask
IS_CONV_MODE_HARDWARE_3X3
(Not applicable to DCx Cameras)
IS_CONV_MODE_OPENCL_3X3
Software conversion using the standard filter mask, but
conversion is done on the graphic board
IS_CONV_MODE_OPENCL_5X5
(Not applicable to DCx Cameras)
Return values
IS_INVALID_COLOR_FORMAT
Parameter ColorMode invalid or not supported
IS_CANT_COMMUNICATE_WITH_DRIVER
Communication with the driver failed because no driver
has been loaded.
IS_CANT_OPEN_DEVICE
An attempt to initialize or select the camera failed (no
camera connected or initialization error).
IS_CAPTURE_RUNNING
A capturing operation is in progress and must be
terminated before you can start another one.
IS_INVALID_COLOR_FORMAT
Invalid color format
IS_INVALID_CAMERA_HANDLE
Invalid camera handle
IS_INVALID_PARAMETER
One of the submitted parameters is outside the valid
range or is not supported for this sensor or is not
26
353
327
502

THORLABS DCU22 Series Specifications

General

Brand	THORLABS
Model	DCU22 Series
Category	Security Camera
Language	English