Cog3DPatMaxPattern.Execute Method

Cog3DPatMaxPattern Execute Method

Cognex VisionPro 9.10

Searchs the given inputVisionData for instances of this pattern. The search is performed using the supplied runParams within the given region.

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

Syntax

public Cog3DPatMaxResults Execute(
	ICogVisionData inputVisionData,
	ICog3DShape region,
	Cog3DPatMaxRunParams runParams
)

public Cog3DPatMaxResults Execute(
	ICogVisionData inputVisionData,
	ICog3DShape region,
	Cog3DPatMaxRunParams runParams
)

Public Function Execute ( 
	inputVisionData As ICogVisionData,
	region As ICog3DShape,
	runParams As Cog3DPatMaxRunParams
) As Cog3DPatMaxResults

Public Function Execute ( 
	inputVisionData As ICogVisionData,
	region As ICog3DShape,
	runParams As Cog3DPatMaxRunParams
) As Cog3DPatMaxResults

public:
Cog3DPatMaxResults^ Execute(
	ICogVisionData^ inputVisionData, 
	ICog3DShape^ region, 
	Cog3DPatMaxRunParams^ runParams
)

public:
Cog3DPatMaxResults^ Execute(
	ICogVisionData^ inputVisionData, 
	ICog3DShape^ region, 
	Cog3DPatMaxRunParams^ runParams
)

inputVisionData: Type: Cognex.VisionPro ICogVisionData
The 3D input vision data to be searched.
3D vision data can be stored in a single CogImage16Range or stored in a CogVisionDataContainer as a matched pair, with one CogImage16Range holding the 3D data and one CogImage16Grey holding corresponding grey-level information or stored in a Cog3DPointCloudMesh. Either style of input is acceptable. All objects are referred to by the term "vision data" and all support the ICogVisionData interface.

region: Type: Cognex.VisionPro3D ICog3DShape
An optional region of interest. It must be a Cog3DBox. The function only matches the pattern to 3D data points that fall inside this box. If you specify a null region, the entire input vision data is searched.

runParams: Type: Cognex.VisionPro3D Cog3DPatMaxRunParams
The parameters that specify how to run this 3DPatMax search.

Type: Cog3DPatMaxResults
The 3DPatMax results that were found. Results are sorted in order of decreasing score.

Exceptions

Exception	Condition
ArgumentNullException	inputVisionData is null.
ArgumentNullException	runParams is null.
CogSecurityViolationException	Licensing for this operation cannot be confirmed. See Understanding VisionPro Security for more information.
CogOperatorNotTrainedException	This pattern operator is not trained.
ArgumentOutOfRangeException	The inputVisionData is not a valid source of 3D vision data. 3D vision data can be stored in a single CogImage16Range or stored in a CogVisionDataContainer as a matched pair, with one CogImage16Range holding the 3D data and one CogImage16Grey holding corresponding grey-level information or stored in a Cog3DPointCloudMesh. Either style of input is acceptable. All objects are referred to by the term "vision data" and all support the ICogVisionData interface.
InvalidOperationException	The region contains too few 3D points to allow searching. This might occur because the region falls completely outside of the inputVisionData, or has an invalid SelectedSpaceName3D.
CogTimeoutExpiredException	The pattern search took longer than the enabled Timeout value.