Cog3DCameraCalibrator.Execute Method (List(List(ICogImage)), ICog3DCalibrationFeatureExtractor, Cog3DScalarCollection, List(Cog3DCalibrationPlatePoseTypeConstants))

Cog3DCameraCalibrator Execute Method (List List ICogImage , ICog3DCalibrationFeatureExtractor, Cog3DScalarCollection, List Cog3DCalibrationPlatePoseTypeConstants )

Cognex VisionPro

Compute the 3D camera calibration from the given images and z height information of the calibration plate poses.

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

Syntax

C++

Copy to Clipboard Print

public Cog3DCameraCalibrationResult Execute(
	List<List<ICogImage>> images,
	ICog3DCalibrationFeatureExtractor featureExtractor,
	Cog3DScalarCollection zHeightsPhys3D,
	List<Cog3DCalibrationPlatePoseTypeConstants> poseTypes
)

public Cog3DCameraCalibrationResult Execute(
	List<List<ICogImage>> images,
	ICog3DCalibrationFeatureExtractor featureExtractor,
	Cog3DScalarCollection zHeightsPhys3D,
	List<Cog3DCalibrationPlatePoseTypeConstants> poseTypes
)

Public Function Execute ( 
	images As List(Of List(Of ICogImage)),
	featureExtractor As ICog3DCalibrationFeatureExtractor,
	zHeightsPhys3D As Cog3DScalarCollection,
	poseTypes As List(Of Cog3DCalibrationPlatePoseTypeConstants)
) As Cog3DCameraCalibrationResult

Public Function Execute ( 
	images As List(Of List(Of ICogImage)),
	featureExtractor As ICog3DCalibrationFeatureExtractor,
	zHeightsPhys3D As Cog3DScalarCollection,
	poseTypes As List(Of Cog3DCalibrationPlatePoseTypeConstants)
) As Cog3DCameraCalibrationResult

public:
Cog3DCameraCalibrationResult^ Execute(
	List<List<ICogImage^>^>^ images, 
	ICog3DCalibrationFeatureExtractor^ featureExtractor, 
	Cog3DScalarCollection^ zHeightsPhys3D, 
	List<Cog3DCalibrationPlatePoseTypeConstants>^ poseTypes
)

public:
Cog3DCameraCalibrationResult^ Execute(
	List<List<ICogImage^>^>^ images, 
	ICog3DCalibrationFeatureExtractor^ featureExtractor, 
	Cog3DScalarCollection^ zHeightsPhys3D, 
	List<Cog3DCalibrationPlatePoseTypeConstants>^ poseTypes
)

Parameters

images: Type: System.Collections.Generic List List ICogImage
Two-dimensional list of images from the cameras viewing the calibration plate. The images are indexed first by the calibration plate pose, then by camera. images[i][j] corresponds to the ith calibration plate pose and the jth camera. May not be null.

featureExtractor: Type: Cognex.VisionPro3D ICog3DCalibrationFeatureExtractor
The feature extractor operator to be used. A Cog3DCheckerboardFeatureExtractor should be used if using Cognex checkerboard calibration plate. May not be null.

zHeightsPhys3D

Type: Cognex.VisionPro3D Cog3DScalarCollection
The z positions of the calibration plate for different calibration plate poses. zHeightsPhys3D[i] corresponds to the ith calibration plate pose. The requirement is as follows:

The z positions corresponding to pose types of PoseElevated must be valid/appropriate;
The z position corresponding to pose type of PoseDefineWorldCoord must be 0;
The z positions corresponding to pose types of PoseTilted will be ignored;
The z positions corresponding to pose types of PoseSpecified require that the calibration plate is a pure translation in Z from the PoseDefineWorldCoord poseType. Thus, a Z value is all that is required.

May not be null.

poseTypes: Type: System.Collections.Generic List Cog3DCalibrationPlatePoseTypeConstants
The list of calibration plate pose types. poseTypes[i] corresponds to the ith calibration plate pose type. It should have the same length as zHeightsPhys3D. May not be null.

Return Value

Type: Cog3DCameraCalibrationResult
The 3D camera calibration result.

Exceptions

Exception	Condition
ArgumentNullException	If any input argument is null or any input argument includes null item.
ArgumentException	If input arguments do not match, e.g. If images, zHeightsPhys3D, and poseTypes are not the same length; If images[i] does not have the same length as images[j] (i and j are inside [0, images.Count-1]); If images is empty or images[0] is empty.
Cog3DOperationCancelledByUserException	If the operation is cancelled by user via the event handler.