Cog3DAlignPattern.TrainRegion Property

Cog3DAlignPattern TrainRegion Property

Cognex VisionPro

Gets or sets the train region. Only the portion of the 3D train image that lies within this region is trained by 3DAlign. If the supplied region object is null, the entire 3D image is trained.

Namespace: Cognex.VisionPro3D
Assembly: Cognex.VisionPro3D (in Cognex.VisionPro3D.dll) Version: 65.1.0.0

Syntax

C++

Copy to Clipboard Print

public ICog3DShape TrainRegion { get; set; }

public ICog3DShape TrainRegion { get; set; }

Public Property TrainRegion As ICog3DShape 
	Get 
	Set

Public Property TrainRegion As ICog3DShape 
	Get 
	Set

public:
property ICog3DShape^ TrainRegion {
	ICog3DShape^ get ();
	void set (ICog3DShape^ value);
}

public:
property ICog3DShape^ TrainRegion {
	ICog3DShape^ get ();
	void set (ICog3DShape^ value);
}

Property Value

Type: ICog3DShape
The train region. Default value is a Cog3DBox that is centered at (0, 0, 75) with a size of (100, 100, 150) and no rotation.

Events

Event Type	Reason
ICogChangedEvent Changed	Fires when this property changes. The following state flags may be affected: SfTrainRegion SfTrained SfTrainedAlgorithm SfGetTrainedBoundingBox SfGetTrainedVisionData

Remarks

You can use a train region to specify what part of the 3D image is incorporated into the pattern at training time. 3DAlign will only train 3D data points that fall inside the 3D shape specified by the TrainRegion property. If this train region is null, the entire image will be trained.

The only allowed shape for the train region is a Cog3DBox. The 3DAlign training algorithm will completely ignore any 3D points that fall outside of the specified box.

If you change this value on a trained pattern object, the pattern will become untrained.