Please enable JavaScript to view this site.

IDS Software Suite 4.96.1

Windows_Logo
Linux_Logo

USB 2.0

USB 3.x

GigE

USB 2.0

USB 3.x

GigE

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, while hardware conversion (USB 3 uEye CP/LE/ML) is done in the camera. 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.

hint_info

Hardware debayering is currently supported by the following models:

uEye SE USB 3.1 Gen 1

USB 3 uEye CP Rev. 2

USB 3 uEye CP

USB 3 uEye LE

USB 3 uEye ML.

The uEye LE USB 3.1 Gen 1 camera family does not support hardware debayering.

hint_info

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.

hmtoggle_plus0ConvertMode: Conversion mode selection

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 first.

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 available in this mode.

IS_IO_REQUEST_FAILED

An IO request from the uEye driver failed. Possibly the versions of the ueye_api.dll (API) and the driver file (ueye_usb.sys or ueye_eth.sys) do not match.

IS_NO_IR_FILTER

No IR filter available

IS_NO_SUCCESS

General error message

IS_NOT_SUPPORTED

The camera model used here does not support this function or setting.

IS_OUT_OF_MEMORY

No memory could be allocated.

IS_SUCCESS

Function executed successfully

Related functions

is_GetColorConverter()

is_SetColorMode()

is_Convert()

© 2022 IDS Imaging Development Systems GmbH