IDS peak 2.10.0 / uEye+ firmware 3.34

IDS Peak comfortSDK, genericSDK, IPL, and AFL developer manuals are external documents. Please contact us if you need them.

The spectral sensitivities of sensors, in combination with optical filters (e.g. IR cut-off HQ), do not correspond to the standardized color matching functions that are the basis for sRGB. If these "RAW" colors from the sensor are directly sent to an sRGB display, they look pale and unnatural. This can be adjusted by using a two-dimensional correction matrix, where each channel contributes to each final color value. Precondition: the image must be debayered, i.e. each color value must be known for each pixel. In order to get correct color values, the BlackLevel must be set to the value "0".

Fig. 106: Color checker target without color correction

Fig. 107: Color checker target with color correction

The color values are calculated with a 3x3 matrix, the so-called color correction matrix (CCM).

This can also be written as:

IDS Vision color cameras have a default CCM, that can either be used directly for color correction within the camera or for post-processing on the host side.

Configuration

Choose a PixelFormat that enables debayering within the camera.

PixelFormat = RGB8;

Now you can enable color correction by setting ColorCorrectionMode to "Auto".

ColorCorrectionMode = Auto;

The current status of color correction can be acquired with ColorCorrectionStatus.

currentCCStatus = ColorCorrectionStatus.Entry;

Alternatives and variation: Custom color correction matrix (CCM)

You can adapt the color correction matrix to your scene, e.g. by taking into account different lighting conditions or optical filters. Even if color correction is located on the host side, you can use that custom CCM to make sure that the correct correction factors are used for each camera.

1.Choose the custom CCM:
ColorCorrectionMatrix = Custom0;

2.Now store your custom parameters to the camera. Use the ColorCorrectionMatrixValueSelector to point to the CCM value that you want to change:

ColorCorrectionMatrixValueSelector = Gain00;
ColorCorrectionMatrixValue = 2.0;
ColorCorrectionMatrixValueSelector = Gain01;
ColorCorrectionMatrixValue = -1.5;
ColorCorrectionMatrixValueSelector = Gain02;
ColorCorrectionMatrixValue = 0.5;
ColorCorrectionMatrixValueSelector = Gain10;
ColorCorrectionMatrixValue = -1.5;
ColorCorrectionMatrixValueSelector = Gain11;
ColorCorrectionMatrixValue = 2.0;
ColorCorrectionMatrixValueSelector = Gain12;
ColorCorrectionMatrixValue = 0.5;
ColorCorrectionMatrixValueSelector = Gain20;
ColorCorrectionMatrixValue = -1.0;
ColorCorrectionMatrixValueSelector = Gain21;
ColorCorrectionMatrixValue = -1.0;
ColorCorrectionMatrixValueSelector = Gain22;
ColorCorrectionMatrixValue = 2.0;

3.Enable color correction:
ColorCorrectionMode = Auto;

Fig. 108: Color checker with HQ color correction

Fig. 109: Color checker with "Custom0" color correction

Additional information