CogPMAlignPattern GrainLimitAutoSelect Property Cognex VisionPro
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: 65.1.0.0
Syntax
Copy to ClipboardPrint
public bool GrainLimitAutoSelect { get; set; }

Property Value

Type: Boolean
Events
Event TypeReason
CogPMAlignPattern Changed

Fires when the value of this property changes.

The following state flag may be affected:

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 ClipboardPrint
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
Copy to ClipboardPrint
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();
}
See Also
CogPMAlignPattern Class
Cognex.VisionPro.PMAlign Namespace