Cog3DCameraCalibrator ClassCognex VisionPro
This class is for executing 3D camera calibration for one or multiple cameras.
Inheritance Hierarchy

System Object
  System MarshalByRefObject
    Cognex.VisionPro.Implementation CogObjectBase
      Cognex.VisionPro.Implementation CogSerializableObjectBase
        Cognex.VisionPro3D Cog3DCameraCalibrator

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

[SerializableAttribute]
public class Cog3DCameraCalibrator : CogSerializableObjectBase, 
	IDisposable

The Cog3DCameraCalibrator type exposes the following members.

Constructors

  NameDescription
Public methodCog3DCameraCalibrator 
Construct this default Cog3DCameraCalibrator. Note that the default distortion model is Cog3DCameraCalibrationDistortionModelConstants.e3ParamRadial.
Public methodCog3DCameraCalibrator(Cog3DCameraCalibrator)
Protected methodCog3DCameraCalibrator(SerializationInfo, StreamingContext)
Top
Methods

  NameDescription
Public methodCreateObjRef
Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.
(Inherited from MarshalByRefObject.)
Public methodDispose 
Protected methodDispose(Boolean)
Public methodEquals
Determines whether the specified Object is equal to the current Object.
(Inherited from Object.)
Public methodExecute(List Rectangle , List List Cog3DCrspFeaturesCollection  , Cog3DScalarCollection, List Cog3DCalibrationPlatePoseTypeConstants )
Overload for computing the 3D camera calibration from the given feature correspondences, and z height information of the calibration plate poses.
Public methodExecute(List Rectangle , List List Cog3DCrspFeaturesCollection  , List Cog3DTransformRigid , List Cog3DCalibrationPlatePoseTypeConstants )
Overload for computing the 3D camera calibration from the given feature correspondences, and calibration plate poses.
Public methodExecute(List List ICogImage  , ICog3DCalibrationFeatureExtractor, Cog3DScalarCollection, List Cog3DCalibrationPlatePoseTypeConstants )
Compute the 3D camera calibration from the given images and z height information of the calibration plate poses.
Public methodExecute(List List ICogImage  , ICog3DCalibrationFeatureExtractor, List Cog3DTransformRigid , List Cog3DCalibrationPlatePoseTypeConstants )
Overload method of Computing the 3D camera calibration from the given images and calibration plate poses.
Public methodExecute(List Rectangle , List List Cog3DCrspFeaturesCollection  , List Cog3DCameraCalibrationIntrinsics , Cog3DScalarCollection, List Cog3DCalibrationPlatePoseTypeConstants )
Overload for computing the 3D camera calibration from the given feature correspondences and camera intrinsic parameters, and z height information of the calibration plate poses. Note that DistortionModel inside this Cog3DCameraCalibrator will be ignored, and the ones inside raw2DFromCamera2Ds will be used instead.
Public methodExecute(List Rectangle , List List Cog3DCrspFeaturesCollection  , List Cog3DCameraCalibrationIntrinsics , List Cog3DTransformRigid , List Cog3DCalibrationPlatePoseTypeConstants )
Overload for computing the 3D camera calibration from the given feature correspondences, camera intrinsic parameters, and calibration plate poses. Note that DistortionModel inside this Cog3DCameraCalibrator will be ignored, and the ones inside raw2DFromCamera2Ds will be used instead.
Protected methodFinalize (Overrides Object Finalize .)
Protected methodGetAttributes
Implements the corresponding member of the ICustomTypeDescriptor interface. May be overridden in derived classes to provide custom type information.
(Inherited from CogObjectBase.)
Protected methodGetClassName
Implements the corresponding member of the ICustomTypeDescriptor interface. May be overridden in derived classes to provide custom type information.
(Inherited from CogObjectBase.)
Protected methodGetComponentName
Implements the corresponding member of the ICustomTypeDescriptor interface. May be overridden in derived classes to provide custom type information.
(Inherited from CogObjectBase.)
Protected methodGetConverter
Implements the corresponding member of the ICustomTypeDescriptor interface. May be overridden in derived classes to provide custom type information.
(Inherited from CogObjectBase.)
Protected methodGetDefaultEvent
Implements the corresponding member of the ICustomTypeDescriptor interface. May be overridden in derived classes to provide custom type information.
(Inherited from CogObjectBase.)
Protected methodGetDefaultProperty
Implements the corresponding member of the ICustomTypeDescriptor interface. May be overridden in derived classes to provide custom type information.
(Inherited from CogObjectBase.)
Protected methodGetEditor
Implements the corresponding member of the ICustomTypeDescriptor interface. May be overridden in derived classes to provide custom type information.
(Inherited from CogObjectBase.)
Protected methodGetEvents 
Implements the corresponding member of the ICustomTypeDescriptor interface. May be overridden in derived classes to provide custom type information.
(Inherited from CogObjectBase.)
Protected methodGetEvents( Attribute )
Implements the corresponding member of the ICustomTypeDescriptor interface. May be overridden in derived classes to provide custom type information.
(Inherited from CogObjectBase.)
Public methodGetHashCode
Serves as a hash function for a particular type.
(Inherited from Object.)
Public methodGetLifetimeService
Retrieves the current lifetime service object that controls the lifetime policy for this instance.
(Inherited from MarshalByRefObject.)
Protected methodGetObjectData (Overrides CogSerializableObjectBase GetObjectData(SerializationInfo, StreamingContext).)
Protected methodGetProperties 
Implements the corresponding member of the ICustomTypeDescriptor interface. May be overridden in derived classes to provide custom type information.
(Inherited from CogObjectBase.)
Protected methodGetProperties( Attribute )
Implements the corresponding member of the ICustomTypeDescriptor interface. May be overridden in derived classes to provide custom type information.
(Inherited from CogObjectBase.)
Protected methodGetPropertyOwner
Implements the corresponding member of the ICustomTypeDescriptor interface. May be overridden in derived classes to provide custom type information.
(Inherited from CogObjectBase.)
Public methodGetType
Gets the Type of the current instance.
(Inherited from Object.)
Public methodInitializeLifetimeService
Obtains a lifetime service object to control the lifetime policy for this instance.
(Inherited from MarshalByRefObject.)
Protected methodMemberwiseClone 
Creates a shallow copy of the current Object.
(Inherited from Object.)
Protected methodMemberwiseClone(Boolean)
Creates a shallow copy of the current MarshalByRefObject object.
(Inherited from MarshalByRefObject.)
Protected methodOnCameraCalibrationProgress
Method to support calibration progress event.
Public methodToString (Overrides Object ToString .)
Top
Properties

  NameDescription
Public propertyDistortionModel
Gets/sets the distortion model parameter.
Public propertyTelecentricPhys3DFromCamera3DZs
Gets/sets the approximate cameras' positions with respect to the calibration plate (for telecentric cameras).
Top
Events

  NameDescription
Public eventCameraCalibrationProgress
Camera calibration progress event.
Top
Remarks

Cognex 3D camera calibration tool requires:
  • All of the images/features correspond to the same set of stationary cameras, and the optical paths associated with each camera are unchanged.
  • All of the images/features correspond to the same calibration plate.
Notes:
  • The tool can tolerate it if the plate pose defining world coordinates does not include features for some of the cameras - as long as the camera poses can be induced from other images.
  • The tool may take a relatively long time to run, and supports progress event.
  • The tool can handle cameras of different camera intrinsics, such as different resolutions and cameras with different focal length lenses.
  • The calibration computation minimizes the sum squared error in image coordinates. Therefore, if different cameras have different pixel resolutions, then the calibration may be dominated by the higher resolution cameras. Consequently, this tool is most useful when all cameras have similar pixel resolutions.
  • Cognex strongly recommends performing a camera calibration validation after you perform camera calibration. This camera calibration validation establishes a baseline that can be used in the future to determine if your cameras are still calibrated. See the Cog3DCameraCalibrationValidator class for details.
See Also