CogPMAlignPattern.GrainLimitAutoSelect Property

CogPMAlignPattern GrainLimitAutoSelect Property

Cognex VisionPro 9.10

If true then PMAlign will automatically generate grain limits during training. If false then the values stored in the pattern prior to training will be used.

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

Syntax

C++

Copy to Clipboard Print

public bool GrainLimitAutoSelect { get; set; }

public bool GrainLimitAutoSelect { get; set; }

Public Property GrainLimitAutoSelect As Boolean 
	Get 
	Set

Public Property GrainLimitAutoSelect As Boolean 
	Get 
	Set

public:
property bool GrainLimitAutoSelect {
	bool get ();
	void set (bool value);
}

public:
property bool GrainLimitAutoSelect {
	bool get ();
	void set (bool value);
}

Property Value

Type: Boolean

Events

Event Type	Reason
CogPMAlignPattern Changed	Fires when the value of this property changes. The following state flag may be affected: SfGrainLimitAutoSelect
CogPMAlignPattern Changed	Fires when the value of this property changes and the pattern was untrained. The following state flags may be affected: SfGrainLimitAutoSelect SfGrainLimitCoarse SfGrainLimitFine 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:

SfGrainLimitAutoSelect

CogPMAlignPattern Changed

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

The following state flags may be affected:

Remarks

If true then PMAlign will automatically generate grain limits during training. If false then the values stored in the pattern prior to training will be used.

The granularity limits control the size of features detected by PMAlign. For more information, see GrainLimitCoarse and GrainLimitFine.

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

Default Value: True

Examples

Copy to Clipboard Print

Imports Cognex.VisionPro
Imports Cognex.VisionPro.PMAlign

Private myPattern As CogPMAlignPattern
Private myParams As CogPMAlignRunParams
Private myResults As CogPMAlignResults

Private Sub doTrain()

  myPattern = New CogPMAlignPattern
  myParams = New CogPMAlignRunParams
  myResults = New CogPMAlignResults

  myPattern.TrainAlgorithm = CogPMAlignTrainAlgorithmConstants.PatMaxAndPatQuick
  myPattern.TrainMode = CogPMAlignTrainModeConstants.Image

  myPattern.TrainImage = anImage
  myPattern.TrainRegion = trainRect
  myPattern.TrainRegionMode = CogRegionModeConstants.PixelAlignedBoundingBox
  myPattern.Origin.TranslationX = trainRect.CenterX
  myPattern.Origin.TranslationY = trainRect.CenterY

  myPattern.GrainLimitAutoSelect = True
  myPattern.GrainLimitCoarse = 6.1
  myPattern.GrainLimitFine = 1.5


  myPattern.Train()
end sub

Imports Cognex.VisionPro
Imports Cognex.VisionPro.PMAlign

Private myPattern As CogPMAlignPattern
Private myParams As CogPMAlignRunParams
Private myResults As CogPMAlignResults

Private Sub doTrain()

  myPattern = New CogPMAlignPattern
  myParams = New CogPMAlignRunParams
  myResults = New CogPMAlignResults

  myPattern.TrainAlgorithm = CogPMAlignTrainAlgorithmConstants.PatMaxAndPatQuick
  myPattern.TrainMode = CogPMAlignTrainModeConstants.Image

  myPattern.TrainImage = anImage
  myPattern.TrainRegion = trainRect
  myPattern.TrainRegionMode = CogRegionModeConstants.PixelAlignedBoundingBox
  myPattern.Origin.TranslationX = trainRect.CenterX
  myPattern.Origin.TranslationY = trainRect.CenterY

  myPattern.GrainLimitAutoSelect = True
  myPattern.GrainLimitCoarse = 6.1
  myPattern.GrainLimitFine = 1.5


  myPattern.Train()
end sub

C++

Copy to Clipboard Print

using Cognex.VisionPro;
using Cognex.VisionPro.PMAlign;

private CogPMAlignPattern myPattern;
private CogPMAlignRunParams myParams;
private CogPMAlignResults myResults;

private void doTrain()
{
  myPattern = new CogPMAlignPattern();
  myParams = new CogPMAlignRunParams();
  myResults =new CogPMAlignResults();

  myPattern.TrainAlgorithm = CogPMAlignTrainAlgorithmConstants.PatMaxAndPatQuick;
  myPattern.TrainMode = CogPMAlignTrainModeConstants.Image;

  myPattern.TrainImage = anImage;
  myPattern.TrainRegion = trainRect;
  myPattern.TrainRegionMode = CogRegionModeConstants.PixelAlignedBoundingBox;
  myPattern.Origin.TranslationX = trainRect.CenterX;
  myPattern.Origin.TranslationY = trainRect.CenterY;

  myPattern.GrainLimitAutoSelect = true;
  myPattern.GrainLimitCoarse = 6.1;
  myPattern.GrainLimitFine = 1.5;

  myPattern.Train();
}

using Cognex.VisionPro;
using Cognex.VisionPro.PMAlign;

private CogPMAlignPattern myPattern;
private CogPMAlignRunParams myParams;
private CogPMAlignResults myResults;

private void doTrain()
{
  myPattern = new CogPMAlignPattern();
  myParams = new CogPMAlignRunParams();
  myResults =new CogPMAlignResults();

  myPattern.TrainAlgorithm = CogPMAlignTrainAlgorithmConstants.PatMaxAndPatQuick;
  myPattern.TrainMode = CogPMAlignTrainModeConstants.Image;

  myPattern.TrainImage = anImage;
  myPattern.TrainRegion = trainRect;
  myPattern.TrainRegionMode = CogRegionModeConstants.PixelAlignedBoundingBox;
  myPattern.Origin.TranslationX = trainRect.CenterX;
  myPattern.Origin.TranslationY = trainRect.CenterY;

  myPattern.GrainLimitAutoSelect = true;
  myPattern.GrainLimitCoarse = 6.1;
  myPattern.GrainLimitFine = 1.5;

  myPattern.Train();
}