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

is_SetCameraLUT

uEye Camera Manual Version 3.80

is_SetCameraLUT

Windows_Logo

Linux_Logo

GigE

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 GigE uEye HE 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 look-up 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.

For further information on LUTs, please refer to the LUT properties section of the uEye Demo chapter.

 

Hinweis

The is_SetCameraLUT() function is only supported by cameras of the GigE uEye series.

Achtung

To be able to use is_SetCameraLUT() you have to set the Bayer conversion mode to IS_CONV_MODE_HARDWARE_3X3 by using theis_SetColorConverter()  function.

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 greyscale 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 greyscale 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 Knee Point Arrays

The Red_Grey, Green and Blue 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). For monochrome cameras, the Green and Blue parameters are ignored.

The GigE uEye SE color and monochrome cameras ignore the Green and Blue parameters.

GigE uEye HE cameras use all three parameters: Red_Grey, Green and Blue. 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

IS_SUCCESS

Function executed successfully

IS_NO_SUCCESS

General error message

IS_NOT_SUPPORTED

This function is not supported by the current camera.

Related Functions

is_GetCameraLUT()

Code Sample


//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);


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


© 2010 IDS Imaging Development Systems GmbH
http://www.ids-imaging.com