Is_Setbinning - THORLABS DCU223x Operation Manual And Sdk

DCx Cameras

4.3.75 is_SetBinning

USB 2.0
USB 3.0
Syntax
INT is_SetBinning (HIDS hCam, INT mode)
Description
Using is_SetBinning(), you can enable the binning mode both in horizontal and in vertical direction. This way,
the image size in the binning direction can be reduced without scaling down the area of interest. Depending on the
sensor used, the sensitivity or the frame rate can be increased while binning is enabled.
To enable horizontal and vertical binning at the same time, you can link the horizontal and vertical binning
parameters by a logical OR.
The adjustable binning factors of each sensor are listed in the
Note
Some sensors allow a higher pixel clock setting if binning or subsampling has been 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_SetBinning(), calling the following functions is recommended in order to keep the defined
camera settings:
is_SetFrameRate()
is_Exposure()
216
If you are using the DCx Camera's flash function:
Note
For the models DCC1240x Binning can be used only combined for the horizontal and the vertical direction. Please
see also the information in section
Input parameters
hCam
mode
IS_BINNING_DISABLE
IS_BINNING_2X_VERTICAL
IS_BINNING_3X_VERTICAL
IS_BINNING_4X_VERTICAL
IS_BINNING_5X_VERTICAL
IS_BINNING_6X_VERTICAL
IS_BINNING_8X_VERTICAL
IS_BINNING_16X_VERTICAL
IS_BINNING_2X_HORIZONTAL
IS_BINNING_3X_HORIZONTAL
IS_BINNING_4X_HORIZONTAL
IS_BINNING_5X_HORIZONTAL
IS_BINNING_6X_HORIZONTAL
IS_BINNING_8X_HORIZONTAL
310
USB 2.0
USB 3.0
329
DCC1240x / DCC3240x Application Notes
Camera and sensor data
is_IO()
280
Camera handle
Disables binning.
Enables vertical binning with factor 2.
Enables vertical binning with factor 3.
Enables vertical binning with factor 4.
Enables vertical binning with factor 5.
Enables vertical binning with factor 6.
Enables vertical binning with factor 8.
Enables vertical binning with factor 16.
Enables horizontal binning with factor 2.
Enables horizontal binning with factor 3.
Enables horizontal binning with factor 4.
Enables horizontal binning with factor 5.
Enables horizontal binning with factor 6.
Enables horizontal binning with factor 8.
chapter.
460
.
63
© 2013 Thorlabs GmbH