THORLABS DCU22 Series User Manual

© 2013 Thorlabs GmbH
4 Programming (SDK)
347
4.3.95 is_SetSubSampling
USB 2.0
USB 3.0
USB 2.0
USB 3.0
Syntax
INT is_SetSubSampling (HIDS hCam, INT mode)
Description
Using is_SetSubSampling(), you can enable sub-sampling mode both in horizontal and in vertical directions.
This allows you to reduce the image size in the sub-sampling direction without scaling down the area of interest. In
order to simultaneously enable horizontal and vertical sub-sampling, the horizontal and vertical sub-sampling
parameters can by linked by a logical OR.
Some monochrome sensors are limited by their design to mere color sub-sampling. In case of fine image
structures, this can result in slight artifacts.
The adjustable sub-sampling factors of each sensor are listed in Camera and sensor data chapter.
Note
Some sensors allow a higher pixel clock setting when binning or subsampling is activated. If you set a higher pixel
clock and then reduce the binning/subsampling factors again, the driver will automatically select the highest
possible pixel clock for the new settings.
Attention
Changes to the image geometry or pixel clock affect the value ranges of the frame rate and exposure time. After
executing is_SetSubSampling(), calling the following functions is recommended in order to keep the defined
camera settings:
is_SetFrameRate()
is_Exposure()
If you are using the DCx Camera's flash function: is_IO()
Input parameters
hCam
Camera handle
mode
IS_SUBSAMPLING_DISABLE
Disables sub-sampling.
IS_SUBSAMPLING_2X_VERTICAL
Enables vertical sub-sampling with factor 2.
IS_SUBSAMPLING_3X_VERTICAL
Enables vertical sub-sampling with factor 3.
IS_SUBSAMPLING_4X_VERTICAL
Enables vertical sub-sampling with factor 4.
IS_SUBSAMPLING_5X_VERTICAL
Enables vertical sub-sampling with factor 5.
IS_SUBSAMPLING_6X_VERTICAL
Enables vertical sub-sampling with factor 6.
IS_SUBSAMPLING_8X_VERTICAL
Enables vertical sub-sampling with factor 8.
IS_SUBSAMPLING_16X_VERTICAL
Enables vertical sub-sampling with factor 16.
IS_SUBSAMPLING_2X_HORIZONTAL
Enables horizontal sub-sampling with factor 2.
IS_SUBSAMPLING_3X_HORIZONTAL
Enables horizontal sub-sampling with factor 3.
IS_SUBSAMPLING_4X_HORIZONTAL
Enables horizontal sub-sampling with factor 4.
IS_SUBSAMPLING_5X_HORIZONTAL
Enables horizontal sub-sampling with factor 5.
IS_SUBSAMPLING_6X_HORIZONTAL
Enables horizontal sub-sampling with factor 6.
IS_SUBSAMPLING_8X_HORIZONTAL
Enables horizontal sub-sampling with factor 8.
IS_SUBSAMPLING_16X_HORIZONTAL
Enables horizontal sub-sampling with factor 16.
IS_GET_SUBSAMPLING
Returns the current setting.
IS_GET_SUBSAMPLING_FACTOR_VERTICAL
Returns the vertical sub-sampling factor
460
329
216
280

THORLABS DCU22 Series Specifications

General

Brand	THORLABS
Model	DCU22 Series
Category	Security Camera
Language	English