CogTransform2DPerspectiveAndRadial Class

Cognex VisionPro 9.8

A CogTransform2DPerspectiveAndRadial transform is a planar perspective transform, followed by a radial transform, followed by a linear transform without rotation. This can be used to correct for common non-linear effects in a camera setup.

Inheritance Hierarchy

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

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

Syntax

C++

Copy to Clipboard Print

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

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

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

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

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

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

The CogTransform2DPerspectiveAndRadial type exposes the following members.

Constructors

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

Top

Methods

	Name	Description
	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 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.)
	GetObjectData
	GetPerspectiveRadialLinearParams	Extract the named parameters from this transform. Skew is in radians.
	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.)
	Invert	Returns a new 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.
	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.
	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.
	SetPerspectiveRadialLinearParams	Set this transform from the given parameters. Skew is in radians.
	Singular	Returns True if the specified point is within the given Tolerance (i.e., radius) of a singular point in the transform.
	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

Fields

	Name	Description
	SfInverted	This bit will be set in the EventArgs of a Changed event every time the value returned by Inverted 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.
	SfLinearAspect	This bit will be set in the EventArgs of a Changed event every time the value returned by LinearAspect may have changed.
	SfLinearScaling	This bit will be set in the EventArgs of a Changed event every time the value returned by LinearScaling may have changed.
	SfLinearSkew	This bit will be set in the EventArgs of a Changed event every time the value returned by LinearSkew may have changed.
	SfLinearTranslationX	This bit will be set in the EventArgs of a Changed event every time the value returned by LinearTranslationX may have changed.
	SfLinearTranslationY	This bit will be set in the EventArgs of a Changed event every time the value returned by LinearTranslationY may have changed.
	SfPerspectiveDX	This bit will be set in the EventArgs of a Changed event every time the value returned by PerspectiveDX may have changed.
	SfPerspectiveDY	This bit will be set in the EventArgs of a Changed event every time the value returned by PerspectiveDY may have changed.
	SfPerspectiveXC	This bit will be set in the EventArgs of a Changed event every time the value returned by PerspectiveXC may have changed.
	SfPerspectiveXX	This bit will be set in the EventArgs of a Changed event every time the value returned by PerspectiveXX may have changed.
	SfPerspectiveXY	This bit will be set in the EventArgs of a Changed event every time the value returned by PerspectiveXY may have changed.
	SfPerspectiveYC	This bit will be set in the EventArgs of a Changed event every time the value returned by PerspectiveYC may have changed.
	SfPerspectiveYX	This bit will be set in the EventArgs of a Changed event every time the value returned by PerspectiveYX may have changed.
	SfPerspectiveYY	This bit will be set in the EventArgs of a Changed event every time the value returned by PerspectiveYY may have changed.
	SfRadialK	This bit will be set in the EventArgs of a Changed event every time the value returned by RadialK may have changed.

Top

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.
	HasChanged	If true, the serializable state of this object has changed since the last time it was serialized.
	Inverted	Returns false if this transform represents the forward perspective and radial transform specified by its properties. Returns true if this transform represents the inverse of the forward transform specified by the properties.
	Linear	Returns true if this is a linear transform.
	LinearAspect	Returns/sets the aspect of this transform. Aspect is the ratio of scaling along the y axis over scaling along the x axis.
	LinearScaling	Returns/sets the scaling of this transform.
	LinearSkew	Returns/sets the skew of this transform (in radians).
	LinearTranslationX	Returns/sets the x component of the translation vector.
	LinearTranslationY	Returns/sets the y component of the translation vector.
	PerspectiveDX	Returns/sets the planar perspective coefficient PDX. This controls perspective in the unmapped X direction. Zero means no X perspective, positive value tilts plane away with increasing unmapped X, negative tilts plane away with decreasing unmapped X.
	PerspectiveDY	Returns/sets the planar perspective coefficient PDY. This controls perspective in the unmapped Y direction. Zero means no Y perspective, positive value tilts plane away with increasing unmapped Y, negative tilts plane away with decreasing unmapped Y.
	PerspectiveXC	Returns/sets the planar perspective coefficient PXC, as applied in: Xp = (PXXX + PXYY + PXC)/(PDXX + PDYY +1) where X and Y are unmapped coordinates. Defines the X coordinate for the center of radial distortion needed in the subsequent step.
	PerspectiveXX	Returns/sets the planar perspective coefficient PXX, as applied in: Xp = (PXXX + PXYY + PXC)/(PDXX + PDYY +1), where X and Y are unmapped coordinates.
	PerspectiveXY	Returns/sets the planar perspective coefficient PXY, as applied in: Xp = (PXXX + PXYY + PXC)/(PDXX + PDYY +1) where X and Y are unmapped coordinates.
	PerspectiveYC	Returns/sets the planar perspective coefficient PYC, as applied in: Yp = (PYXX + PYYY + PYC)/(PDXX + PDYY +1) where X and Y are unmapped coordinates. Defines the Y coordinate for the center of radial distortion needed in the subsequent step.
	PerspectiveYX	Returns/sets the planar perspective coefficient PYX, as applied in: Yp = (PYXX + PYYY + PYC)/(PDXX + PDYY +1) where X and Y are unmapped coordinates.
	PerspectiveYY	Returns/sets the planar perspective coefficient PYY, as applied in: Yp = (PYXX + PYYY + PYC)/(PDXX + PDYY +1) where X and Y are unmapped coordinates.
	RadialK	Returns/sets the radial coefficient of distortion. Zero indicates no radial distortion, positive value causes a scale and pin cushion effect on a grid, negative value causes a negative scale and barrel effect.

Top

Events

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

Top

Remarks

A comprises a planar perspective transform, followed by a radial transform, followed by a linear transform (without rotation). It can be used to correct for common nonlinear effects in a camera setup.