CogCenterPointsToLines ClassCognex VisionPro
This class finds a 2D linear transform between points and lines, centering the lines with respect to the points.
Inheritance Hierarchy

System Object
  System MarshalByRefObject
    Cognex.VisionPro.Implementation CogObjectBase
      Cognex.VisionPro.Implementation CogSerializableObjectBase
        Cognex.VisionPro.Implementation CogSerializableChangedEventBase
          Cognex.VisionPro.Implementation CogSerializableCollectionBase CogCenterPointsToLinesCorrespondence 
            Cognex.VisionPro CogCenterPointsToLines

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

[SerializableAttribute]
public class CogCenterPointsToLines : CogSerializableCollectionBase<CogCenterPointsToLinesCorrespondence>

The CogCenterPointsToLines type exposes the following members.

Constructors

  NameDescription
Public methodCogCenterPointsToLines 
Default construct a CogCenterPointsToLines.
Public methodCogCenterPointsToLines(CogCenterPointsToLines)
Copy constructs a CogCenterPointsToLines object. This is a deep copy.
Protected methodCogCenterPointsToLines(SerializationInfo, StreamingContext)
Serialization construct a CogCenterPointsToLines object.
Top
Methods

  NameDescription
Public methodAdd
Adds value to the end of the collection.
(Inherited from CogSerializableCollectionBase T .)
Public methodClear
Removes all objects from the collection.
(Inherited from CogSerializableCollectionBase T .)
Public methodContains
Returns true if value is in the collection
(Inherited from CogSerializableCollectionBase T .)
Public methodCopyTo
Copies the collection to an array
(Inherited from CogSerializableCollectionBase T .)
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
Perform point to line centering.
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 methodIndexOf
Returns the index of value in the collection, or -1 if value is not in the collection.
(Inherited from CogSerializableCollectionBase T .)
Public methodInitializeLifetimeService
Obtains a lifetime service object to control the lifetime policy for this instance.
(Inherited from MarshalByRefObject.)
Public methodInsert
Inserts the value at the specified index of the collection
(Inherited from CogSerializableCollectionBase T .)
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.)
Public methodMove
Moves an item from one position to another.
(Inherited from CogSerializableCollectionBase T .)
Protected methodOnChanged(Int64)
This method should be called internally whenever the object's state may have changed.
(Inherited from CogSerializableChangedEventBase.)
Protected methodOnChanged(CogChangedEventArgs)
This method may be called internally whenever a derived object's state may have changed and the derived object expresses this change via a derived CogChangedEventArgs class.
(Inherited from CogSerializableChangedEventBase.)
Protected methodOnCleared
Raises the Cleared event.
(Inherited from CogSerializableCollectionBase T .)
Protected methodOnClearing
Raises the Clearing event.
(Inherited from CogSerializableCollectionBase T .)
Protected methodOnInsertedItem
Raises the InsertedItem event.
(Inherited from CogSerializableCollectionBase T .)
Protected methodOnInsertingItem
Raises the InsertingItem event.
(Inherited from CogSerializableCollectionBase T .)
Protected methodOnMovedItem
Raises the MovedItem event.
(Inherited from CogSerializableCollectionBase T .)
Protected methodOnMovingItem
Raises the MovingItem event.
(Inherited from CogSerializableCollectionBase T .)
Protected methodOnRemovedItem
Raises the RemovedItem event.
(Inherited from CogSerializableCollectionBase T .)
Protected methodOnRemovingItem
Raises the RemovingItem event.
(Inherited from CogSerializableCollectionBase T .)
Protected methodOnReplacedItem
Raises the ReplacedItem event.
(Inherited from CogSerializableCollectionBase T .)
Protected methodOnReplacingItem
Raises the ReplacingItem event.
(Inherited from CogSerializableCollectionBase T .)
Public methodRemove
Removes value from the collection
(Inherited from CogSerializableCollectionBase T .)
Public methodRemoveAt
Removes the element at the specified index.
(Inherited from CogSerializableCollectionBase T .)
Public methodResumeAndRaiseChangedEvent
Re-enables raising of the Changed event after SuspendChangedEvent has been called, and raises the Changed event if the ChangedEventSuspended count is reduced to zero and any changes were made while events were suspended. Must be called once for each call to SuspendChangedEvent.
(Inherited from CogSerializableChangedEventBase.)
Public methodSuspendChangedEvent
Temporarily suspends the raising of the Changed event. May be called more than once, and a corresponding call to ResumeAndRaiseChangedEvent must be made for each call to SuspendChangedEvent.
(Inherited from CogSerializableChangedEventBase.)
Public methodToString
Returns a String that represents the current Object.
(Inherited from Object.)
Top
Fields

  NameDescription
Public fieldStatic memberSfMode
This bit will be set in the EventArgs of a Changed event every time the value returned by Mode may have been changed.
Protected fieldStatic memberSfNextSf
Public fieldStatic memberSfNormalDirectionInferenceMethod
This bit will be set in the EventArgs of a Changed event every time the value returned by NormalDirectionInferenceMethod may have been changed.
Public fieldStatic memberSfSearchAngleMax
This bit will be set in the EventArgs of a Changed event every time the value returned by SearchAngleMax may have been changed.
Public fieldStatic memberSfSearchAngleMin
This bit will be set in the EventArgs of a Changed event every time the value returned by SearchAngleMin may have been changed.
Public fieldStatic memberSfTimeout
This bit will be set in the EventArgs of a Changed event every time the value returned by Timeout may have been changed.
Public fieldStatic memberSfTimeoutEnabled
This bit will be set in the EventArgs of a Changed event every time the value returned by TimeoutEnabled may have been changed.
Top
Properties

  NameDescription
Public propertyChangedEventSuspended
If nonzero, indicates that the raising of the Changed event has been suspended. This value is incremented when SuspendChangedEvent is called and decremented when ResumeAndRaiseChangedEvent is called.
(Inherited from CogSerializableChangedEventBase.)
Public propertyCount
Gets the number of elements contained in the collection.
(Inherited from CogSerializableCollectionBase T .)
Public propertyHasChanged (Inherited from CogSerializableChangedEventBase.)
Protected propertyInnerList
Gets the internal List containing the list of elements.
(Inherited from CogSerializableCollectionBase T .)
Public propertyIsFixedSize
returns false
(Inherited from CogSerializableCollectionBase T .)
Public propertyIsReadOnly
Returns true if this collection is ReadOnly
(Inherited from CogSerializableCollectionBase T .)
Public propertyIsSynchronized (Inherited from CogSerializableCollectionBase T .)
Public propertyItem
Returns the T at index
(Inherited from CogSerializableCollectionBase T .)
Protected propertyList
Gets an the IList interface of this collection.
(Inherited from CogSerializableCollectionBase T .)
Public propertyMode
How this class will perform fitting. May be either point to line fit ("Single"), or point pair to line pair fit ("Pair").
Public propertyNormalDirectionInferenceMethod
How this class will infer the normal direction of the line segments.
Public propertySearchAngleMax
The upper bound of the search angle range, in radians. This parameter limits the rotation angle of the result transform.
Public propertySearchAngleMin
The lower bound of the search angle range, in radians. This parameter limits the rotation angle of the result transform.
Public propertyStateFlags
Returns the complete set of state flags supported on this object. The flags may be indexed by name as shown in the following C# code snippet: if (changedObject.StateFlags["Color"] & eventArgs.StateFlags) { ... }
(Inherited from CogSerializableChangedEventBase.)
Public propertySyncRoot (Inherited from CogSerializableCollectionBase T .)
Public propertyTimeout
The maximum number of milliseconds that may elapse while running the Execute method. This is only enforced if TimeoutEnabled is true.
Public propertyTimeoutEnabled
Whether the Execute method should be stopped after Timeout milliseconds.
Top
Events

  NameDescription
Public eventChanged
This event is raised when one or more parts of the object's state may have changed.
(Inherited from CogSerializableChangedEventBase.)
Public eventCleared
Raised after the collection is cleared.
(Inherited from CogSerializableCollectionBase T .)
Public eventClearing
Raised before the collection is cleared.
(Inherited from CogSerializableCollectionBase T .)
Public eventInsertedItem
Raised after an item is inserted.
(Inherited from CogSerializableCollectionBase T .)
Public eventInsertingItem
Raised before an item is inserted.
(Inherited from CogSerializableCollectionBase T .)
Public eventMovedItem
Raised after an item is moved to a new index.
(Inherited from CogSerializableCollectionBase T .)
Public eventMovingItem
Raised before an item is moved to a new index.
(Inherited from CogSerializableCollectionBase T .)
Public eventRemovedItem
Raised after an item is removed.
(Inherited from CogSerializableCollectionBase T .)
Public eventRemovingItem
Raised before an item is removed.
(Inherited from CogSerializableCollectionBase T .)
Public eventReplacedItem
Raised after an item is replaced.
(Inherited from CogSerializableCollectionBase T .)
Public eventReplacingItem
Raised before an item is replaced.
(Inherited from CogSerializableCollectionBase T .)
Top
Remarks

This class supports two modes of fitting:

  • Point to line fit ("Single"). The feature correspondences are between individual points and lines. The class will minimize the variance in the point to line signed distance across all point to line correspondences. The class tries to make all of the point to line distances the same.
  • Point pair to line pair fit ("Pair"). The feature correspondences are between point pairs and line pairs. The class will minimize the variation in the point to line signed distance differences, across all point pair line pair correspondences. The point to line distance difference for a given point pair line pair correspondence is the difference between the point to line distance for the first point and the point to line distance for the second point in the point pair. The class tries to make the two point to line signed distances in each point pair line pair correspondence the same. Signed distances are measured in the direction of the normal to the line.

This class uses line segments to specify lines, but the centering is performed between points and lines (or point-pairs and line-pairs). In other words, the point to line distances are not affected by the end points of the line segments.

See Also