CogSearchMaxZoneScale.Overlap Property

CogSearchMaxZoneScale Overlap Property

Cognex VisionPro 9.23

Gets or sets the overlap threshold for scale degree of freedom zone.

Namespace: Cognex.VisionPro.SearchMax
Assembly: Cognex.VisionPro.SearchMax (in Cognex.VisionPro.SearchMax.dll) Version: 91.0.0.0

Syntax

C++

Copy to Clipboard Print

public double Overlap { get; set; }

public double Overlap { get; set; }

Public Property Overlap As Double 
	Get 
	Set

Public Property Overlap As Double 
	Get 
	Set

public:
property double Overlap {
	double get ();
	void set (double value);
}

public:
property double Overlap {
	double get ();
	void set (double value);
}

Property Value

Type: Double
The scale overlap threshold. Default value is 1.4.

Events

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

Event Type

Reason

ICogChangedEvent Changed

Fires when this property changes.

The following state flag may be affected:

SfOverlap

Exceptions

Exception	Condition
ArgumentOutOfRangeException	Thrown when you attempt to set this to a value less than 1.0.

Remarks

Result candidates overlap for the scale degree of freedom if the ratio of the results' scale values is less than or equal to the Overlap value you specify. SearchMax discards the weaker pattern instance when two pattern instances overlap for all degrees of freedom as well as area.

The scale overlap threshold is expressed as the ratio of the scale of the instance with a larger scale to the scale of the instance with the smaller scale. Therefore, the overlap threshold must be greater than or equal to one. instances had scales of 1.25 and 2.50, they would not meet the overlap threshold because the ratio of 2.5 to 1.25 (2.0) is greater than the threshold value (1.2).