CogPMAlignPattern.TrainImageMask Property

CogPMAlignPattern TrainImageMask Property

Cognex VisionPro 9.7

Mask used when training the PMAlign pattern. The mask allows the user to identify areas of the pattern as "Care" or "Don't Care". The "Don't Care" areas can also be subclassified into "Score" and "Don't Score" with regards to clutter.

Namespace: Cognex.VisionPro.PMAlign
Assembly: Cognex.VisionPro.PMAlign (in Cognex.VisionPro.PMAlign.dll) Version: 73.0.0.0

Syntax

C++

Copy to Clipboard Print

public CogImage8Grey TrainImageMask { get; set; }

public CogImage8Grey TrainImageMask { get; set; }

Public Property TrainImageMask As CogImage8Grey 
	Get 
	Set

Public Property TrainImageMask As CogImage8Grey 
	Get 
	Set

public:
property CogImage8Grey^ TrainImageMask {
	CogImage8Grey^ get ();
	void set (CogImage8Grey^ value);
}

public:
property CogImage8Grey^ TrainImageMask {
	CogImage8Grey^ get ();
	void set (CogImage8Grey^ value);
}

Property Value

Type: CogImage8Grey

Events

Event Type	Reason
CogPMAlignPattern Changed	Fires when the value of this property changes. The following state flag may be affected: SfTrainImageMask
CogPMAlignPattern Changed	Fires when the value of this property changes and the pattern was untrained. The following state flags may be affected: SfTrainImageMask SfTrainImageMaskOffsetX SfTrainImageMaskOffsetY SfGetInfoIDs SfTrained SfCreateGraphicsCoarse SfCreateGraphicsFine SfGetInfoStrings SfGetTrainedPatternImage SfGetTrainedPatternImageMask SfGetTrainedPatternShapeModels

Event Type

Reason

CogPMAlignPattern Changed

Fires when the value of this property changes.

The following state flag may be affected:

SfTrainImageMask

CogPMAlignPattern Changed

Fires when the value of this property changes and the pattern was untrained.

The following state flags may be affected:

Remarks

Mask used when training the PMAlign pattern. The pixel values in the mask image are interpreted as follows:

Greater than 191 Care pixels. Features within care pixels are included in the trained pattern.

64 through 127 Don't Care but Score. Features within these pixels are not included in the trained pattern, but when found in the run-time pattern, they are scored as clutter features.

0 through 63 Don't Care and Don't Score. Features within these pixels are not included in the trained pattern, and when found in the run-time pattern, they are not scored as clutter features.

128 through 191 Reserved for future use by Cognex.

Note: Changing this property causes this CogPMAlignPattern to become untrained.

Default Value: NULL (no mask image)