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

is_SetBlCompensation

uEye Camera Manual Version 3.80

is_SetBlCompensation

Windows_Logo

Linux_Logo

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 149: Black level correction - Auto

Figure 150: Black level correction - Auto + offset

Figure 150: Black level correction - Auto + offset

Figure 151: Schwarzwert-Korrektur nur 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
The sensor supports automatic black level correction.

IS_BL_COMPENSATION_OFFSET
For the sensor used, it is also possible to set the offset manual.

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
when used together with IS_GET_BL_COMPENSATION


Current offset
when used together with IS_GET_BL_OFFSET



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