USB 2.0 USB 3.x GigE |
USB 2.0 USB 3.x GigE |
Syntax
INT is_SetColorCorrection (HIDS hCam, INT nEnable, double* factors)
Description
For color cameras, is_SetColorCorrection() enables color correction in the uEye driver. This enhances the rendering of colors for cameras with color sensors. Color correction is a digital correction based on a color matrix which is adjusted individually for each sensor.
This function is currently not supported by the following camera models: •UI-1007XS |
If you perform Bayer conversion for USB 3 uEye CPLE/ML color cameras in the camera itself, color conversion will automatically also take place in the camera.
After changing this parameter, perform manual or automatic white balancing in order to obtain correct color rendering (see also is_SetAutoParameter()). |
Input parameters
hCam |
Camera handle |
factors |
Sets the strength of the color correction between 0.0 (no correction) and 1.0 (strong correction). |
Return values
When used together with |
Current setting |
When used together with |
When used for color cameras and together with IS_GET_SUPPORTED_CCOR_MODE, this parameter returns the supported values linked by a logical OR: •IS_CCOR_ENABLE_NORMAL •IS_CCOR_ENABLE_BG40_ENHANCED •IS_CCOR_ENABLE_HQ_ENHANCED When used for monochrome cameras, the system returns 0. |
When used together with |
When used for color cameras and together with IS_GET_DEFAULT_CCOR_MODE, this parameter returns the default color correction mode: •IS_CCOR_ENABLE_NORMAL •IS_CCOR_ENABLE_HQ_ENHANCED When used for monochrome cameras, the system returns 0. |
When used together with |
When used for color cameras, this parameter returns the supported values linked by a logical OR: •IS_CCOR_ENABLE_NORMAL | IS_CCOR_FACTOR •IS_CCOR_ENABLE_BG40_ENHANCED | IS_CCOR_FACTOR •IS_CCOR_ENABLE_HQ_ENHANCED | IS_CCOR_FACTOR When used for monochrome cameras, the system returns 0. |
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_INVALID_CAMERA_HANDLE |
Invalid camera handle |
IS_INVALID_MODE |
Camera is in standby mode, function not allowed |
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_SUCCESS |
Function executed successfully |
Related functions