CogBlobSegmentationParams.SoftRelativeThresholdLow Property

CogBlobSegmentationParams SoftRelativeThresholdLow Property

Cognex VisionPro 9.5

This relative threshold specifies a percentage of the distance between the low and high tail grey scale pixel values. The grey scale pixel value determined by this relative percentage is then used as a soft, fixed threshold.

Namespace: Cognex.VisionPro.Blob
Assembly: Cognex.VisionPro.Blob (in Cognex.VisionPro.Blob.dll) Version: 69.0.0.0

Syntax

C++

Copy to Clipboard Print

public int SoftRelativeThresholdLow { get; set; }

public int SoftRelativeThresholdLow { get; set; }

Public Property SoftRelativeThresholdLow As Integer 
	Get 
	Set

Public Property SoftRelativeThresholdLow As Integer 
	Get 
	Set

public:
property int SoftRelativeThresholdLow {
	int get ();
	void set (int value);
}

public:
property int SoftRelativeThresholdLow {
	int get ();
	void set (int value);
}

Property Value

Type: Int32
The default is 40.

Events

Event Type	Reason
[Cognex.VisionPro.ICogChangedEvent.Changed]	Fires when the value of this property changes. The following state flag may be affected: SfSoftRelativeThresholdLow
[Cognex.VisionPro.ICogChangedEvent.Changed]	Fires when the both the low and high threshold percentages are changed. The following state flags may be affected: SfSoftRelativeThresholdLow SfSoftRelativeThresholdHigh

Event Type

Reason

[Cognex.VisionPro.ICogChangedEvent.Changed]

Fires when the value of this property changes.

The following state flag may be affected:

SfSoftRelativeThresholdLow

[Cognex.VisionPro.ICogChangedEvent.Changed]

Fires when the both the low and high threshold percentages are changed.

The following state flags may be affected:

Exceptions

Exception	Condition
[System.ArgumentException]	The supplied value is less than 0 or greater than 100.

Remarks

Soft relative thresholding computes a low soft threshold value by determining the pixel value which lies at the specified percentage of the distance between the low tail pixel value and the high tail pixel value. Pixel values that are less than the computed low threshold are assigned a blob weight of 0 when Polarity indicates light blobs. Pixel values that are less than the computed low threshold are assigned a blob weight of 1 when Polarity indicates dark blobs.

The low threshold must be less than or equal to the high threshold. If a value is supplied such that this requirement is not met, both thresholds are adjusted.