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

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

Cognex VisionPro

Overload method of Computing the 3D camera calibration from the given images and 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,
	List<Cog3DTransformRigid> world3DFromCalPlate3Ds,
	List<Cog3DCalibrationPlatePoseTypeConstants> poseTypes
)

public Cog3DCameraCalibrationResult Execute(
	List<List<ICogImage>> images,
	ICog3DCalibrationFeatureExtractor featureExtractor,
	List<Cog3DTransformRigid> world3DFromCalPlate3Ds,
	List<Cog3DCalibrationPlatePoseTypeConstants> poseTypes
)

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

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

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

public:
Cog3DCameraCalibrationResult^ Execute(
	List<List<ICogImage^>^>^ images, 
	ICog3DCalibrationFeatureExtractor^ featureExtractor, 
	List<Cog3DTransformRigid^>^ world3DFromCalPlate3Ds, 
	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.

world3DFromCalPlate3Ds

Type: System.Collections.Generic List Cog3DTransformRigid
The list of poses of the calibration plate (with respect to the calibration plate pose defining the world coordinate system). world3DFromCalPlate3Ds[i] corresponds to the ith calibration plate pose. Calibration plate pose does not need to be specified exactly for pose types of PoseElevated or PoseTilted. The requirement is as follows:

The poses for pose types of PoseSpecified must be valid/appropriate;
The poses for pose types of PoseTilted will be ignored;
The poses for pose types of PoseElevated will be used to set the z height information of the calibration plate (only pose.Translation.Z will be used);
The pose for pose type of PoseDefineWorldCoord must be identity.

poseTypes: Type: System.Collections.Generic List Cog3DCalibrationPlatePoseTypeConstants
The list of calibration plate pose types. It should have the same length as world3DFromCalPlate3Ds. 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, world3DFromCalPlate3Ds, 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.