Home > C: Programming > Function Descriptions > | History back Previous chapter Next chapter Print |
is_SetCameraLUT |
uEye Camera Manual Version 3.80
is_SetCameraLUT
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.
|
|
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
Code Sample
//Enable the latest LUT set INT nRet; nRet = is_SetCameraLUT (hCam,
//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, |