THORLABS DCU223x User Manual

© 2013 Thorlabs GmbH170
DCx Cameras
4.3.5 is_Blacklevel
USB 2.0
USB 3.0
USB 2.0
USB 3.0
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
hCam
Camera handle
nCommand
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.
IS_AUTO_BLACKLEVEL_ON: The automatic black level
mode is switched on.
IS_BLACKLEVEL_CMD_GET_OFFSET_DEFAULT
Returns the default offset (Example 3 )
IS_BLACKLEVEL_CMD_GET_OFFSET_RANGE
Returns the range of the offset (Example 3 )
IS_BLACKLEVEL_CMD_GET_OFFSET
Returns the current offset (Example 3 )
IS_BLACKLEVEL_CMD_SET_OFFSET
Sets the offset (Example 3 )
pParam
Pointer to a function parameter, whose function depends on nCommand.
cbSizeOfParam
Size (in bytes) of the memory area to which pParam refers.
171
171
171
171
171
171
171
171

THORLABS DCU223x Specifications

General

Brand	THORLABS
Model	DCU223x
Category	Security Camera
Language	English