ICogAcqProfileCamera.Binning Property

ICogAcqProfileCamera Binning Property

Cognex VisionPro 9.8

Reads or sets whether to enable camera binning. When binning is enabled, the resolution of an L4000 camera is reduced, but it can acquire images more quickly.

Namespace: Cognex.VisionPro
Assembly: Cognex.VisionPro.Core (in Cognex.VisionPro.Core.dll) Version: 75.1.0.0

Syntax

C++

Copy to Clipboard Print

bool Binning { get; set; }

bool Binning { get; set; }

Property Binning As Boolean 
	Get 
	Set

Property Binning As Boolean 
	Get 
	Set

property bool Binning {
	bool get ();
	void set (bool value);
}

property bool Binning {
	bool get ();
	void set (bool value);
}

Property Value

Type: Boolean
Default value is 'false'.

Events

Event Type	Reason
ICogChangedEvent Changed	Fires when this property changes. The following state flag may be affected: SfBinning

Exceptions

Exception	Condition
ArgumentException	If value is 'true' and your camera is not a member of the L4000 family.

Remarks

When this property is 'false', an L4000 camera will acquire image data using the full resolution of the sensor. The returned 2D intensity image will be 1920 pixels wide and 1464 pixels high.

When this property is 'true', each 2x2 block of pixels on the L4000 sensor will be treated as a single pixel. This halves the effective resolution of the sensor in each dimension, producing a 2D intensity image that is 960 pixels wide and 732 pixels high.

The size of the returned range image is unaffected by binning but the 3D data in the range image will be less detailed when Binning is 'true'.

Setting Binning to 'true' on an L4000 allows you to use shorter exposure values, and to acquire images more quickly. It also makes those images approximately the same resolution as those of a DS1000 camera.

For a DS1000 camera, the 2D intensity image always has a width of 1024 pixels and a height of 768 pixels. Binning is unavailable. It is an error to set Binning to 'true' on a DS1000 camera.