Cog3DCalibrationFeatureExtractorBase ClassCognex VisionPro 9.20
This class is the abstract base class for 3D calibration feature extractors.

Clients that are using a Cognex checkerboard calibration plate can use the Cog3DCheckerboardFeatureExtractor class to perform calibration feature extraction. These clients do not need to be concerned with this base class.

Clients that are not using a Cognex checkerboard calibration plate must implement their own calibration feature extractor class capable of extracting calibration features from images of the special calibration object. One way to implement such a custom calibration feature extractor class, is to derive the custom calibration feature extraction class from this base class. The derived calibration feature extraction class can then be passed into the Cog3DCameraCalibrator.Execute() overloads that require an ICog3DCalibrationFeatureExtractor.

This abstract base class provides an implementation of the ICog3DCalibrationFeatureExtractor.Execute(List< List< ICogImage > >) method. This implementation calls derived class' ICog3DCalibrationFeatureExtractor.Execute( ICogImage ) and will make the calls on multiple threads if the derived class' ICog3DCalibrationFeatureExtractor.IsThreadSave property is true. The provided implementation supports feature extraction progress events as well - the FeaturesExtracted event is fired as soon as feature extraction is completed on each calibration image.

Derived classes must: implement an override of the ICog3DCalibrationFeatureExtractor.Execute( ICogImage ) method as well as implement the IsThreadSafe property which specifies whether the override of Execute() is thread-safe or not.

Inheritance Hierarchy

System Object
  System MarshalByRefObject
    Cognex.VisionPro.Implementation CogObjectBase
      Cognex.VisionPro.Implementation CogSerializableObjectBase
        Cognex.VisionPro3D Cog3DCalibrationFeatureExtractorBase
          Cognex.VisionPro3D Cog3DCheckerboardFeatureExtractor

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

[SerializableAttribute]
public abstract class Cog3DCalibrationFeatureExtractorBase : CogSerializableObjectBase, 
	ICog3DCalibrationFeatureExtractor

The Cog3DCalibrationFeatureExtractorBase type exposes the following members.

Constructors

  NameDescription
Protected methodCog3DCalibrationFeatureExtractorBase 
Default constructor.
Protected methodCog3DCalibrationFeatureExtractorBase(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 methodEquals
Determines whether the specified Object is equal to the current Object.
(Inherited from Object.)
Public methodExecute(ICogImage)
Extract features from a calibration image.
Public methodExecute(List List ICogImage  )
Extract features from a set of calibration images, acquired from one or multiple cameras over different calibration plate poses. The images are organized in a List, indexed by calibration plate pose. Each item in the list is a List of images, indexed by camera. It is expected that the fiducial defining the calibration plate's origin is within the field of view. The feature extraction is done by calling the Execute( ICogImage ) method for each calibration image. The Execute( ICogImage ) method will be invoked on multiple threads if the IsThreadSafe property is true. The FeaturesExtracted event is fired after the featues are extracted from each image.
Protected methodFinalize
Allows an Object to attempt to free resources and perform other cleanup operations before the Object is reclaimed by garbage collection.
(Inherited from Object.)
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
Implements the GetObjectData method of the ISerializable interface.
(Inherited from CogSerializableObjectBase.)
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 methodOnFeaturesExtracted
Method to support feature extraction progress event.
Public methodToString
Returns a String that represents the current Object.
(Inherited from Object.)
Top
Properties

  NameDescription
Public propertyIsThreadSafe
Gets whether the implementation of the Execute(ICogImage) method is thread-safe. thread-safety is required to allow multithreading within implementations of the Execute(List< List< ICogImage > >) method.
Top
Events

  NameDescription
Public eventFeaturesExtracted
Feature extraction progress event.
Top
See Also