This class is for executing 3D camera calibration for one or multiple cameras.
Inheritance Hierarchy
System MarshalByRefObject
Cognex.VisionPro.Implementation CogObjectBase
Cognex.VisionPro.Implementation CogSerializableObjectBase
Cognex.VisionPro3D Cog3DCameraCalibrator
Namespace: Cognex.VisionPro3D
Assembly: Cognex.VisionPro3D (in Cognex.VisionPro3D.dll) Version: 73.0.0.0
Syntax
The Cog3DCameraCalibrator type exposes the following members.
Constructors
| Name | Description | |
|---|---|---|
| Cog3DCameraCalibrator |
Construct this default Cog3DCameraCalibrator. Note that the default distortion model is
Cog3DCameraCalibrationDistortionModelConstants.e3ParamRadial.
| |
| Cog3DCameraCalibrator(Cog3DCameraCalibrator) | ||
| Cog3DCameraCalibrator(SerializationInfo, StreamingContext) |
Methods
| Name | Description | |
|---|---|---|
| CreateObjRef | Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object. (Inherited from MarshalByRefObject.) | |
| Dispose | ||
| Dispose(Boolean) | ||
| Equals | (Inherited from Object.) | |
| Execute(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.
| |
| Execute(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.
| |
| Execute(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.
| |
| Execute(List List ICogImage , ICog3DCalibrationFeatureExtractor, List Cog3DTransformRigid , List Cog3DCalibrationPlatePoseTypeConstants ) |
Overload method of Computing the 3D camera calibration from the given images and calibration plate poses.
| |
| Execute(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.
| |
| Execute(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.
| |
| Finalize | (Overrides Object Finalize .) | |
| GetAttributes |
Implements the corresponding member of the ICustomTypeDescriptor interface.
May be overridden in derived classes to provide custom type information.
(Inherited from CogObjectBase.) | |
| GetClassName |
Implements the corresponding member of the ICustomTypeDescriptor interface.
May be overridden in derived classes to provide custom type information.
(Inherited from CogObjectBase.) | |
| GetComponentName |
Implements the corresponding member of the ICustomTypeDescriptor interface.
May be overridden in derived classes to provide custom type information.
(Inherited from CogObjectBase.) | |
| GetConverter |
Implements the corresponding member of the ICustomTypeDescriptor interface.
May be overridden in derived classes to provide custom type information.
(Inherited from CogObjectBase.) | |
| GetDefaultEvent |
Implements the corresponding member of the ICustomTypeDescriptor interface.
May be overridden in derived classes to provide custom type information.
(Inherited from CogObjectBase.) | |
| GetDefaultProperty |
Implements the corresponding member of the ICustomTypeDescriptor interface.
May be overridden in derived classes to provide custom type information.
(Inherited from CogObjectBase.) | |
| GetEditor |
Implements the corresponding member of the ICustomTypeDescriptor interface.
May be overridden in derived classes to provide custom type information.
(Inherited from CogObjectBase.) | |
| GetEvents |
Implements the corresponding member of the ICustomTypeDescriptor interface.
May be overridden in derived classes to provide custom type information.
(Inherited from CogObjectBase.) | |
| GetEvents( Attribute ) |
Implements the corresponding member of the ICustomTypeDescriptor interface.
May be overridden in derived classes to provide custom type information.
(Inherited from CogObjectBase.) | |
| GetHashCode | Serves as a hash function for a particular type. (Inherited from Object.) | |
| GetLifetimeService | Retrieves the current lifetime service object that controls the lifetime policy for this instance. (Inherited from MarshalByRefObject.) | |
| GetObjectData | (Overrides CogSerializableObjectBase GetObjectData(SerializationInfo, StreamingContext).) | |
| GetProperties |
Implements the corresponding member of the ICustomTypeDescriptor interface.
May be overridden in derived classes to provide custom type information.
(Inherited from CogObjectBase.) | |
| GetProperties( Attribute ) |
Implements the corresponding member of the ICustomTypeDescriptor interface.
May be overridden in derived classes to provide custom type information.
(Inherited from CogObjectBase.) | |
| GetPropertyOwner |
Implements the corresponding member of the ICustomTypeDescriptor interface.
May be overridden in derived classes to provide custom type information.
(Inherited from CogObjectBase.) | |
| GetType | Gets the Type of the current instance. (Inherited from Object.) | |
| InitializeLifetimeService | Obtains a lifetime service object to control the lifetime policy for this instance. (Inherited from MarshalByRefObject.) | |
| MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) | |
| MemberwiseClone(Boolean) | Creates a shallow copy of the current MarshalByRefObject object. (Inherited from MarshalByRefObject.) | |
| OnCameraCalibrationProgress |
Method to support calibration progress event.
| |
| ToString | (Overrides Object ToString .) |
Properties
| Name | Description | |
|---|---|---|
| DistortionModel |
Gets/sets the distortion model parameter.
| |
| TelecentricPhys3DFromCamera3DZs |
Gets/sets the approximate cameras' positions
with respect to the calibration plate (for telecentric cameras).
|
Events
| Name | Description | |
|---|---|---|
| CameraCalibrationProgress |
Camera calibration progress event.
|
Remarks
- 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.
- 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