The Binning class provides methods for using the binning mode. 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. In order to simultaneously enable horizontal and vertical binning, the horizontal and vertical binning parameters can by linked by a logical OR. Depending on the sensor used, the sensitivity or the frame rate can be increased while binning is enabled.
|
Note that binning or subsampling cannot be activated if the AOI size is set to the minimum value. |
The adjustable binning factors of each sensor are listed in the "Camera and sensor data" chapter in the uEye manual.
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.
|
This function is currently not supported by the following camera models: •UI-1007XS |
Changes to the image geometry or pixel clock affect the value ranges of the frame rate and exposure time. After executing Set(), calling the following methods is recommended in order to keep the defined camera settings:
•Set the frame rate via Set()
•If you are using the uEye camera's flash function: IO
|
Note on camera models UI-124x/UI-324x/UI-524x, UI-125x/UI-325x/UI-525x and UI-155x/UI-555x For these models, you can use binning only combined for the horizontal and the vertical direction. Please see also the information in chapters "UI-124x/UI-324x/UI-524x application notes", "UI-125x/UI-325x/UI-525x application notes" and "UI-155x/UI-555x application notes" in the uEye manual. |
Methods
Method |
Description |
|---|---|
Returns the current setting. |
|
Returns the horizontal binning factor. |
|
Returns the vertical binning factor. |
|
Returns the supported binning modes. |
|
Indicates whether the camera uses color-proof binning or not. |
|
Enables/disables binning. |
Example
// Get horizontal binning mode
int horMode;
hCam.Size.Binning.GetFactorHorizontal(out horMode);
// Get vertical binning mode
int verMode;
hCam.Size.Binning.GetFactorVertical(out verMode);
// Get supported binning modes
uEye.Defines.BinningMode supportedModes;
hCam.Size.Binning.GetSupported(out supportedModes);
// Get current binning mode
uEye.Defines.BinningMode modes;
hCam.Size.Binning.Get(out modes);
// Set binning mode
hCam.Size.Binning.Set(uEye.Defines.BinningMode.Vertical2X | uEye.Defines.BinningMode.Horizontal2X);
