CogTransform2DLinear Class

Cognex VisionPro 9.21

Linear 2D coordinate transform.

Inheritance Hierarchy

System Object
  System MarshalByRefObject
    Cognex.VisionPro.Implementation CogObjectBase
      Cognex.VisionPro CogTransform2DLinear

Namespace: Cognex.VisionPro
Assembly: Cognex.VisionPro.Core (in Cognex.VisionPro.Core.dll) Version: 83.0.0.0

Syntax

C++

Copy to Clipboard Print

[SerializableAttribute]
public class CogTransform2DLinear : CogObjectBase, 
	ICogNetInternal, IDisposable, ICogTransform2D, ICloneable, ISerializable, 
	ICogHasChanged, ICogChangedEvent

[SerializableAttribute]
public class CogTransform2DLinear : CogObjectBase, 
	ICogNetInternal, IDisposable, ICogTransform2D, ICloneable, ISerializable, 
	ICogHasChanged, ICogChangedEvent

<SerializableAttribute>
Public Class CogTransform2DLinear 
	Inherits CogObjectBase 
	Implements ICogNetInternal, IDisposable, ICogTransform2D, ICloneable, 
	ISerializable, ICogHasChanged, ICogChangedEvent

<SerializableAttribute>
Public Class CogTransform2DLinear 
	Inherits CogObjectBase 
	Implements ICogNetInternal, IDisposable, ICogTransform2D, ICloneable, 
	ISerializable, ICogHasChanged, ICogChangedEvent

[SerializableAttribute]
public ref class CogTransform2DLinear : public CogObjectBase, 
	ICogNetInternal, IDisposable, ICogTransform2D, ICloneable, ISerializable, 
	ICogHasChanged, ICogChangedEvent

[SerializableAttribute]
public ref class CogTransform2DLinear : public CogObjectBase, 
	ICogNetInternal, IDisposable, ICogTransform2D, ICloneable, ISerializable, 
	ICogHasChanged, ICogChangedEvent

The CogTransform2DLinear type exposes the following members.

Constructors

	Name	Description
	CogTransform2DLinear	Constructs a new instance of this class.
	CogTransform2DLinear(IntPtr)	Constructs a new instance of this class using com pointer.
	CogTransform2DLinear(CogTransform2DLinear)	Constructs a new instance of this class as a deep copy of the given instance.

Top

Methods

	Name	Description
	attachCom
	BestFitLinearTransform	Returns a new linear transform which best describes this transform over the given set of points. The points must be expressed in 'from' coordinates.
	Clone	Returns a deep copy of this class instance. Derived classes that implement Clone should override this method; other clients who wish to clone this instance should call ICloneable.Clone. See also CogSerializer.DeepCopyObject
	Compose	Returns a new linear transform which is the composition of the given transform (on the right side) and this one (on the left side).
	ComposeBase	Returns a new transform which is the composition of the given transform (on the right side) and this one (on the left side).
	Copy	Returns a new copy of this transform.
	CopyBase	Returns a new copy of this transform.
	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	Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
	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.)
	GetMatrixElement	Access the selected element of the 2-by-2 matrix in this transform.
	GetMatrixElementsTranslation	Extract the named parameters from this transform.
	GetObjectData
	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.)
	GetScalingAspectRotationSkewTranslation	Extract the named parameters from this transform. Rotation and Skew are in radians.
	GetScalingsRotationsTranslation	Extract the named parameters from this transform. RotationX and RotationY are in radians.
	GetType	Gets the Type of the current instance. (Inherited from Object.)
	Identity
	InitializeLifetimeService	Obtains a lifetime service object to control the lifetime policy for this instance. (Inherited from MarshalByRefObject.)
	Invert	Returns a new linear transform which is the inverse of this one.
	InvertBase	Returns a new transform which is the inverse of this one.
	LinearTransform	Returns a new linear transform which best describes this transform at the given point. The point must be expressed in 'from' coordinates.
	MapAngle	Maps the given angle (in radians) through this transform and returns the result (in radians).
	MapArea	Maps the given area through this transform and returns the result.
	MapPoint	Maps the given x,y point through this transform, filling in the mapped x,y coordinates.
	MapPoints	Map the supplied points through this transform.
	MapVector	Maps the given x,y vector through this transform, filling in the mapped x,y vector components.
	MatrixIdentity	Returns true if the 2-by-2 matrix in this transform is an identity mapping within the given tolerance. The tolerance is applied to each matrix element.
	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.)
	ResumeAndRaiseChangedEvent	Re-enables raising of the Changed event after SuspendChangedEvent has been called. Also 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.
	SetMatrixElement	Access the selected element of the 2-by-2 matrix in this transform.
	SetMatrixElementsTranslation	Set this transform from the given parameters.
	SetScalingAspectRotationSkewTranslation	Set this transform from the given parameters. Rotation and Skew are in radians.
	SetScalingsRotationsTranslation	Set this transform from the given parameters. RotationX and RotationY are in radians.
	Singular	Returns true if this transform is singular. A transform is singular if the matrix determinant equals zero within the given tolerance.
	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.
	ToString	Returns a String that represents the current Object. (Inherited from Object.)

Top

Operators

	Name	Description
	Multiply

Top

Fields

	Name	Description
	__com
	__disposed
	__factory
	Creator
	SfAspect	This bit will be set in the EventArgs of a Changed event every time the value returned by Aspect may have changed.
	SfGetMatrixElement	This bit will be set in the EventArgs of a Changed event every time the value returned by GetMatrixElement may have changed.
	SfLinear	This bit will be set in the EventArgs of a Changed event every time the value returned by Linear may have changed.
	SfMatrixDeterminant	This bit will be set in the EventArgs of a Changed event every time the value returned by MatrixDeterminant may have changed.
	SfRotation	This bit will be set in the EventArgs of a Changed event every time the value returned by Rotation may have changed.
	SfRotationX	This bit will be set in the EventArgs of a Changed event every time the value returned by RotationX may have changed.
	SfRotationY	This bit will be set in the EventArgs of a Changed event every time the value returned by RotationY may have changed.
	SfScaling	This bit will be set in the EventArgs of a Changed event every time the value returned by Scaling may have changed.
	SfScalingX	This bit will be set in the EventArgs of a Changed event every time the value returned by ScalingX may have changed.
	SfScalingY	This bit will be set in the EventArgs of a Changed event every time the value returned by ScalingY may have changed.
	SfSkew	This bit will be set in the EventArgs of a Changed event every time the value returned by Skew may have changed.
	SfTranslationX	This bit will be set in the EventArgs of a Changed event every time the value returned by TranslationX may have changed.
	SfTranslationY	This bit will be set in the EventArgs of a Changed event every time the value returned by TranslationY may have changed.

Top

Properties

	Name	Description
	Aspect	Returns/sets the aspect of this transform. Aspect is the ratio of scaling along the y axis over scaling along the x axis. When aspect is set the rotation, skew, and scaling remain unchanged.
	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.
	HasChanged	If true, the serializable state of this object has changed since the last time it was serialized.
	Linear	Returns true if this is a linear transform.
	MatrixDeterminant	Returns the determinant of the 2-by-2 matrix in this transformation.
	Rotation	Returns/sets the rotation of this transform (in radians). When rotation is set the skew, scaling, and aspect remain unchanged.
	RotationX	Returns the x-axis rotation of this transform (in radians). When set, RotationY, ScalingX, and ScalingY remain unchanged.
	RotationY	Returns the y-axis rotation of this transform (in radians). When set, RotationX, ScalingX, and ScalingY remain unchanged.
	Scaling	Returns/sets the scaling of this transform. When scaling is set the rotation, skew, and aspect remain unchanged.
	ScalingX	Returns the x-axis scaling of this transform. When set, RotationX, RotationY, and ScalingY remain unchanged.
	ScalingY	Returns the y-axis scaling of this transform. When set, RotationX, RotationY, and ScalingX remain unchanged.
	Skew	Returns/sets the skew of this transform (in radians). When skew is set the rotation, scaling, and aspect remain unchanged.
	TranslationX	Returns/sets the x component of the translation vector.
	TranslationY	Returns/sets the y component of the translation vector.

Top

Events

	Name	Description
	Changed	Occurs when one or more parts of the object's state may have changed.

Top

Remarks

CogTransform2DLinear represents a two-dimensional linear transformation between two coordinate spaces. It enables you to map points from the from coordinate space to the to coordinate space. It defaults to the identity transform.

CogTransform2DLinear represents a linear transformation as a (2x2) matrix and a translation vector. There are three different parameterization methods for the matrix, each based on the following general 2-d linear transformation:

Where (xA, yA) is the input point, (Tx, Ty) is the translation vector, and the rest is the (2x2) matrix that represents the scaling and rotation.