Is_Blacklevel - THORLABS DCU223x Operation Manual And Sdk

DCx Cameras

4.3.5 is_Blacklevel

USB 2.0
USB 3.0
Syntax
INT is_Blacklevel(HIDS hCam, UINT nCommand, void* pParam, UINT cbSizeOfParam)
Beschreibung
controls the black level correction of the camera which might improve the image quality under
is_Blacklevel()
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
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
nCommand
IS_BLACKLEVEL_CMD_GET_CAPS
IS_BLACKLEVEL_CMD_GET_MODE_DEFAULT
IS_BLACKLEVEL_CMD_GET_MODE
IS_BLACKLEVEL_CMD_SET_MODE
IS_BLACKLEVEL_CMD_GET_OFFSET_DEFAULT Returns the default offset
IS_BLACKLEVEL_CMD_GET_OFFSET_RANGE
IS_BLACKLEVEL_CMD_GET_OFFSET
IS_BLACKLEVEL_CMD_SET_OFFSET
pParam
cbSizeOfParam
170
USB 2.0
USB 3.0
Black level correction - Auto +
offset
Camera handle
Returns the black level feature of the camera
Returns the default black level mode
Returns the current black level mode
Sets the black level mode
Returns the range of the offset
Returns the current offset
Sets the offset
Pointer to a function parameter, whose function depends on nCommand.
Size (in bytes) of the memory area to which pParam refers.
Black level correction with
offset only
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_AUTO_BLACKLEVEL_OFF: The automatic black level
mode is switched off.
IS_AUTO_BLACKLEVEL_ON: The automatic black level
mode is switched on.
(Example 3
(Example 1
(Example2
171
(Example2
171
(Example 2 )
171
(Example 3 )
171
(Example 3 )
171
(Example 3 )
171
)
171
© 2013 Thorlabs GmbH
):
171
)
)