Syntax
LONG SetCameraLUT (ULONG Mode, ULONG NumberOfEntries,
DOUBLE* pRed_Grey,
DOUBLE* pGreen,
DOUBLE* pBlue)
Description
Using 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 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.
|
|
Parameters
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).
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
Suggestion for improvement? Send us your short Feedback on this chapter.
Thank you very much!
For technical questions please contact you local distributor or use the support form on our website.