231SDK (Software development Kit)
© 2010 Thorlabs
7.3.73
is_SetBinning
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 Specifications: Sensors chapter.
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.
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_SetExposureTime()
If you are using the DCx camera's flash function: is_SetFlashStrobe()
402
259
251
257