This class finds a 2D linear transform between points and
lines, centering the lines with respect to the points.
Inheritance Hierarchy
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: 75.1.0.0
Syntax
The CogCenterPointsToLines type exposes the following members.
Constructors
| Name | Description | |
|---|---|---|
| CogCenterPointsToLines |
Default construct a CogCenterPointsToLines.
| |
| CogCenterPointsToLines(CogCenterPointsToLines) |
Copy constructs a CogCenterPointsToLines object. This
is a deep copy.
| |
| CogCenterPointsToLines(SerializationInfo, StreamingContext) |
Serialization construct a CogCenterPointsToLines object.
|
Methods
| Name | Description | |
|---|---|---|
| Add |
Adds value to the end of the collection.
(Inherited from CogSerializableCollectionBase T .) | |
| Clear |
Removes all objects from the collection.
(Inherited from CogSerializableCollectionBase T .) | |
| Contains |
Returns true if value is in the collection
(Inherited from CogSerializableCollectionBase T .) | |
| CopyTo |
Copies the collection to an array
(Inherited from CogSerializableCollectionBase T .) | |
| 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.) | |
| Equals | (Inherited from Object.) | |
| Execute |
Perform point to line centering.
| |
| Finalize | Allows an Object to attempt to free resources and perform other cleanup operations before the Object is reclaimed by garbage collection. (Inherited from Object.) | |
| 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 |
Implements the GetObjectData method of the ISerializable interface.
(Inherited from CogSerializableObjectBase.) | |
| 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.) | |
| IndexOf |
Returns the index of value in the collection, or -1 if value
is not in the collection.
(Inherited from CogSerializableCollectionBase T .) | |
| InitializeLifetimeService | Obtains a lifetime service object to control the lifetime policy for this instance. (Inherited from MarshalByRefObject.) | |
| Insert |
Inserts the value at the specified index of the collection
(Inherited from CogSerializableCollectionBase T .) | |
| 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.) | |
| Move |
Moves an item from one position to another.
(Inherited from CogSerializableCollectionBase T .) | |
| OnChanged(Int64) |
This method should be called internally whenever the object's state may
have changed.
(Inherited from CogSerializableChangedEventBase.) | |
| OnChanged(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.) | |
| OnCleared |
Raises the Cleared event.
(Inherited from CogSerializableCollectionBase T .) | |
| OnClearing |
Raises the Clearing event.
(Inherited from CogSerializableCollectionBase T .) | |
| OnInsertedItem |
Raises the InsertedItem event.
(Inherited from CogSerializableCollectionBase T .) | |
| OnInsertingItem |
Raises the InsertingItem event.
(Inherited from CogSerializableCollectionBase T .) | |
| OnMovedItem |
Raises the MovedItem event.
(Inherited from CogSerializableCollectionBase T .) | |
| OnMovingItem |
Raises the MovingItem event.
(Inherited from CogSerializableCollectionBase T .) | |
| OnRemovedItem |
Raises the RemovedItem event.
(Inherited from CogSerializableCollectionBase T .) | |
| OnRemovingItem |
Raises the RemovingItem event.
(Inherited from CogSerializableCollectionBase T .) | |
| OnReplacedItem |
Raises the ReplacedItem event.
(Inherited from CogSerializableCollectionBase T .) | |
| OnReplacingItem |
Raises the ReplacingItem event.
(Inherited from CogSerializableCollectionBase T .) | |
| Remove |
Removes value from the collection
(Inherited from CogSerializableCollectionBase T .) | |
| RemoveAt |
Removes the element at the specified index.
(Inherited from CogSerializableCollectionBase T .) | |
| ResumeAndRaiseChangedEvent |
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.) | |
| SuspendChangedEvent |
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.) | |
| ToString | (Inherited from Object.) |
Fields
| Name | Description | |
|---|---|---|
| SfMode |
This bit will be set in the EventArgs of a Changed event
every time the value returned by Mode
may have been changed.
| |
| SfNextSf | ||
| SfNormalDirectionInferenceMethod |
This bit will be set in the EventArgs of a Changed event
every time the value returned by NormalDirectionInferenceMethod
may have been changed.
| |
| SfSearchAngleMax |
This bit will be set in the EventArgs of a Changed event
every time the value returned by SearchAngleMax
may have been changed.
| |
| SfSearchAngleMin |
This bit will be set in the EventArgs of a Changed event
every time the value returned by SearchAngleMin
may have been changed.
| |
| SfTimeout |
This bit will be set in the EventArgs of a Changed event
every time the value returned by Timeout
may have been changed.
| |
| SfTimeoutEnabled |
This bit will be set in the EventArgs of a Changed event
every time the value returned by TimeoutEnabled
may have been changed.
|
Properties
| Name | Description | |
|---|---|---|
| ChangedEventSuspended |
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.) | |
| Count |
Gets the number of elements contained in the collection.
(Inherited from CogSerializableCollectionBase T .) | |
| HasChanged | (Inherited from CogSerializableChangedEventBase.) | |
| InnerList |
Gets the internal List containing the list of elements.
(Inherited from CogSerializableCollectionBase T .) | |
| IsFixedSize |
returns false
(Inherited from CogSerializableCollectionBase T .) | |
| IsReadOnly |
Returns true if this collection is ReadOnly
(Inherited from CogSerializableCollectionBase T .) | |
| IsSynchronized | (Inherited from CogSerializableCollectionBase T .) | |
| Item |
Returns the T at index (Inherited from CogSerializableCollectionBase T .) | |
| List |
Gets an the IList interface of this collection.
(Inherited from CogSerializableCollectionBase T .) | |
| Mode |
How this class will perform fitting. May be either point to line
fit ("Single"), or point pair to line pair fit ("Pair").
| |
| NormalDirectionInferenceMethod |
How this class will infer the normal direction of the
line segments.
| |
| SearchAngleMax |
The upper bound of the search angle range, in radians. This
parameter limits the rotation angle of the result transform.
| |
| SearchAngleMin |
The lower bound of the search angle range, in radians. This
parameter limits the rotation angle of the result transform.
| |
| StateFlags |
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.) | |
| SyncRoot | (Inherited from CogSerializableCollectionBase T .) | |
| Timeout |
The maximum number of milliseconds that may elapse while running
the Execute method. This is only enforced if TimeoutEnabled is
true.
| |
| TimeoutEnabled |
Whether the Execute method should be stopped after Timeout
milliseconds.
|
Events
| Name | Description | |
|---|---|---|
| Changed |
This event is raised when one or more parts of the object's state may
have changed.
(Inherited from CogSerializableChangedEventBase.) | |
| Cleared |
Raised after the collection is cleared.
(Inherited from CogSerializableCollectionBase T .) | |
| Clearing |
Raised before the collection is cleared.
(Inherited from CogSerializableCollectionBase T .) | |
| InsertedItem |
Raised after an item is inserted.
(Inherited from CogSerializableCollectionBase T .) | |
| InsertingItem |
Raised before an item is inserted.
(Inherited from CogSerializableCollectionBase T .) | |
| MovedItem |
Raised after an item is moved to a new index.
(Inherited from CogSerializableCollectionBase T .) | |
| MovingItem |
Raised before an item is moved to a new index.
(Inherited from CogSerializableCollectionBase T .) | |
| RemovedItem |
Raised after an item is removed.
(Inherited from CogSerializableCollectionBase T .) | |
| RemovingItem |
Raised before an item is removed.
(Inherited from CogSerializableCollectionBase T .) | |
| ReplacedItem |
Raised after an item is replaced.
(Inherited from CogSerializableCollectionBase T .) | |
| ReplacingItem |
Raised before an item is replaced.
(Inherited from CogSerializableCollectionBase T .) |
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