|
|
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 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.
For further information on LUTs, please refer to the LUT properties section.
|
|
|
|
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 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).
GigE uEye SE/RE/CP 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_INVALID_CAMERA_HANDLE |
Invalid camera handle |
IS_NO_SUCCESS |
General error message |
IS_NOT_SUPPORTED |
The camera model used here does not support this function or setting. |
IS_SUCCESS |
Function executed successfully |
Related functions
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);
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.