Home > C: Programming > Function Descriptions > | History back Previous chapter Next chapter Print |
is_SetBlCompensation |
uEye Camera Manual Version 3.80
is_SetBlCompensation
USB 2.0 GigE |
USB 2.0 GigE |
Syntax
INT is_SetBlCompensation (HIDS hCam,
INT nEnable, INT offset, INT reserved)
Description
is_SetBlCompensation() enables the black level correction function which might improve the image quality under certain circumstances. By default, the sensor adjusts the black level value for each pixel automatically. If the environment is very bright, it can be necessary to adjust the black level manually.
UI-112x / UI-512x only: On models with HDR sensor the function is_SetBlCompensation() controls the black level when a contrast adjustment is performed.
![]() Figure 149: Black level correction - Auto |
![]() Figure 150: Black level correction - Auto + offset |
![]() Figure 151: Schwarzwert-Korrektur nur Offset |
Input Parameters
hCam |
Camera handle |
nEnable |
|
IS_BL_COMPENSATION_DISABLE |
Disables automatic black level correction. The offset value is used as black level instead. This mode is only supported by sensors of the UI-154x/554x series. |
IS_BL_COMPENSATION_ENABLE |
Enables automatic black level correction. The offset value is added to the automatic black level value. |
IS_GET_BL_COMPENSATION |
Returns the current mode. |
IS_GET_BL_OFFSET |
Returns the currently set value for offset. |
IS_GET_BL_DEFAULT_MODE |
Returns the default mode. |
IS_GET_BL_DEFAULT_OFFSET |
Returns the default value for offset. |
IS_GET_BL_SUPPORTED_MODE |
Returns the supported modes. Possible values: IS_BL_COMPENSATION_ENABLE IS_BL_COMPENSATION_OFFSET |
IS_IGNORE_PARAMETER |
The nEnable parameter is ignored. |
offset |
Contains the offset value used for compensation. Valid values are between 0 and 255. |
IS_IGNORE_PARAMETER |
The offset parameter is ignored. |
reserved |
Reserved. 0 must be passed. |
Return Values
IS_SUCCESS |
Function executed successfully |
IS_NO_SUCCESS |
General error message |
Supported modes when used together with IS_GET_BL_SUPPORTED_MODE |
|
Current mode |
|
Current offset |