is_SetColorConverter

USB 2.0

USB 3.0

GigE

USB 2.0

USB 3.0

GigE

Hinweis

This function cannot be used with a USB uEye XS.

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 (GigE uEye HE only) 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.

Hinweis

Hardware conversion is only supported by GigE uEye HE cameras.

Hinweis

Software conversion with the large filter mask should only be used for sensors whose green pixels have the same sensitivity. This applies to the following sensors:

•All uEye CCD sensors

•CMOS sensors of the UI-122x/UI-322x/UI-522x

For all other sensors, we recommend using the standard filter mask.

Achtung

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	Hardware conversion using the standard filter mask (GigE uEye only)
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	Hardware conversion using the standard filter mask, but conversion is done on the graphic board

Return values

IS_INVALID_COLOR_FORMAT	Parameter ColorMode ungültig oder nicht unterstützt
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 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()

Suggestion for improvement? Send us your short Feedback on this chapter. Thank you very much!

For technical questions please contact you local distributor or use the support form on our website.

Home > C: Programming > Function descriptions >	History back Previous chapter Next chapter Print
is_SetColorConverter