IDS Software Suite - obsolete functions 4.97

USB 2.0 USB 3.0 GigE	USB 2.0 USB 3.0 GigE

Syntax

INT is_SetCameraLUT (HIDS hCam, UINT Mode, UINT NumberOfEntries, double* pRed_Grey, double* pGreen, double* pBlue)

Description

Using is_SetCameraLUT(), you can enable a hardware LUT for uEye cameras. This LUT which will be applied to the image in the camera. A number of predefined LUTs are available. Alternatively, you define your own LUT. It is possible to define a LUT without enabling it at the same time. You can query the current LUT used by the camera by calling the is_GetCameraLUT() function.

Each lookup table (LUT) for the uEye contains modification values for the image brightness and contrast parameters. When a LUT is used, each brightness value in the image will be replaced by a value from the table. LUTs are typically used to enhance the image contrast or the gamma curve. The values must be in the range between 0.0 and 1.0. A linear LUT containing 64 equidistant values between 0.0 and 1.0 has no effect on the image.

Input parameters

hCam	Camera handle
Mode: These modes can be linked by a logical OR. IS_CAMERA_LUT_IDENTITY Predefined LUT, linear LUT, no image modifications IS_CAMERA_LUT_NEGATIV Predefined LUT, inverts the image. IS_CAMERA_LUT_GLOW1 Predefined LUT, false-color display of the image IS_CAMERA_LUT_GLOW2 Predefined LUT, false-color display of the image IS_CAMERA_LUT_ASTRO1 Predefined LUT, false-color display of the image IS_CAMERA_LUT_RAINBOW1 Predefined LUT, false-color display of the image IS_CAMERA_LUT_MAP1 Predefined LUT, false-color display of the image IS_CAMERA_LUT_COLD_HOT Predefined LUT, false-color display of the image IS_CAMERA_LUT_SEPIC Predefined LUT, uses sepia toning for coloring the image. IS_CAMERA_LUT_ONLY_RED Predefined LUT, shows only the red channel of the image. IS_CAMERA_LUT_ONLY_GREEN Predefined LUT, shows only the green channel of the image. IS_CAMERA_LUT_ONLY_BLUE Predefined LUT, shows only the blue channel of the image. IS_SET_CAMERA_LUT_VALUES Applies the LUT values. IS_ENABLE_CAMERA_LUT Enables the LUT. If no other LUT has been defined, the system sets the linear LUT as specified by IS_CAMERA_LUT_IDENTITY. IS_ENABLE_RGB_GRAYSCALE The camera converts a color image to a grayscale image.
NumberOfEntries: Indicates the number of knee points used. IS_CAMERA_LUT_64 Defines a LUT with 64 knee points. This results in 32 sections with a start and end point each.
pRed_Grey	Array containing the values for the LUT red channel or the LUT grayscale channel (GigE uEye SE cameras).
pGreen	Array containing the values for the LUT green channel.
pBlue	Array containing the values for the LUT blue channel.

Structure of the LUT arrays

The pRed_Grey, pGreen and pBlue arrays contain double values between 0.0 and 1.0. The array size must correspond exactly to the value predefined by NumberOfEntries (64 or 128).

GigE uEye SE/RE/LE/CP and USB 3 uEye CP color and monochrome cameras ignore the pGreen and pBlue parameters.

GigE uEye HE cameras use all three parameters: pRed_Grey, pGreen and pBlue. If you set all three parameters to the same value for GigE uEye HE monochrome cameras, the LUT curve creates a monochrome output image. Assigning different values to the three parameters will result in false-color representation.

Return values

Related functions

•is_GetCameraLUT()

Example

//Enable the latest LUT set
INT nRet;
nRet = is_SetCameraLUT (hCam, IS_ENABLE_CAMERA_LUT, IS_CAMERA_LUT_64, NULL, NULL, NULL);
 
//Set the LUT default "Glow1" and enable it
INT nRet;
double Red[IS_CAMERA_LUT_64];
double Green[IS_CAMERA_LUT_64];
double Blue[IS_CAMERA_LUT_64];
 
nRet = is_SetCameraLUT (hCam, IS_ENABLE_CAMERA_LUT | IS_SET_CAMERA_LUT_VALUES | IS_CAMERA_LUT_GLOW1, IS_CAMERA_LUT_64, Red, Green, Blue);