© 2016 Thorlabs Scientific Imaging
4 Programming (SDK)
133
4.3.5 is_Blacklevel
Syntax
INT is_Blacklevel(HIDS hCam, UINT nCommand, void* pParam, UINT cbSizeOfParam)
Beschreibung
is_Blacklevel() controls the black level correction of the camera 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.
Black level correction - Auto
Black level correction - Auto +
offset
Black level correction with
offset only
The nCommand input parameter is used to select the function mode. The pParam input parameter
depends on the selected function mode. If you select functions for setting or returning a value,
pParam contains a pointer to a variable of the UINT type. The size of the memory area to which
pParam refers is specified in the cbSizeOfParam input parameter.
Input parameters
IS_BLACKLEVEL_CMD_GET_CAPS
Returns the black level feature of the camera
(Example 1):
IS_BLACKLEVEL_CAP_SET_AUTO_BLACKLEVEL: The
state of the automatic black level can be changed.
The flag does not indicate whether the camera is
running with auto black level by default or not. For
this purpose, use
IS_BLACKLEVEL_CMD_GET_MODE_DEFAULT.
IS_BLACKLEVEL_CAP_SET_OFFSET: The offset can be
changed. The flag does not indicate whether the
camera has set an offset by default or not. For this
purpose, use
IS_BLACKLEVEL_CMD_GET_OFFSET_DEFAULT.
IS_BLACKLEVEL_CMD_GET_MODE_DEFAULT
Returns the default black level mode (Example2)
IS_BLACKLEVEL_CMD_GET_MODE
Returns the current black level mode (Example2)
IS_BLACKLEVEL_CMD_SET_MODE
Sets the black level mode (Example 2)
IS_AUTO_BLACKLEVEL_OFF: The automatic black
level mode is switched off.