Class AffineTransformation2DClass
[ClassInterface(ClassInterfaceType.None)]
[Guid("6FA1A8D6-D264-11D2-9F29-00C04F6BDD7F")]
public class AffineTransformation2DClass : AffineTransformation2D, ITransformationGEN, IAffineTransformation2D3GEN, IAffineTransformation2D3, IAffineTransformation2D2, IAffineTransformation2D, ITransformation, IClone, ISupportErrorInfo, IZShift
- Inheritance
-
AffineTransformation2DClass
- Implements
- Inherited Members
Constructors
AffineTransformation2DClass()
public AffineTransformation2DClass()
Explicit Interface Implementations
Assign(IClone)
Assigns the properties of src to the receiver.
virtual void Assign(IClone src)
Parameters
srcIClone
Clone()
Clones the receiver and assigns the result to *clone.
virtual IClone Clone()
Returns
DefineConformalFromControlPoints(ref IPoint[], ref IPoint[])
Defines the best conformal affine transformation between two sets of points. Can be used to register paper maps on a digitizer.
virtual void DefineConformalFromControlPoints(ref IPoint[] fromPoints, ref IPoint[] toPoints)
Parameters
DefineConformalFromControlPoints(int, ref IPoint, ref IPoint)
Defines the best conformal affine transformation between two sets of points. Can be used to register paper maps on a digitizer.
virtual void DefineConformalFromControlPoints(int numPoints, ref IPoint fromPoints, ref IPoint toPoints)
Parameters
DefineConformalFromControlPointsEx(int, ref WKSPoint, ref WKSPoint)
Defines the best conformal affine transformation between two sets of points. Can be used to register paper maps on a digitizer.
virtual void DefineConformalFromControlPointsEx(int numPoints, ref WKSPoint fromPoints, ref WKSPoint toPoints)
Parameters
DefineFromControlPoints(ref IPoint[], ref IPoint[])
Defines the best affine transformation between two sets of points. Can be used to register paper maps on a digitizer.
virtual void DefineFromControlPoints(ref IPoint[] fromPoints, ref IPoint[] toPoints)
Parameters
DefineFromControlPoints(int, ref IPoint, ref IPoint)
Defines the best affine transformation between two sets of points. Can be used to register paper maps on a digitizer.
virtual void DefineFromControlPoints(int numPoints, ref IPoint fromPoints, ref IPoint toPoints)
Parameters
DefineFromControlPointsEx(int, ref WKSPoint, ref WKSPoint)
Defines the best affine transformation between two sets of points. Can be used to register paper maps on a digitizer.
virtual void DefineFromControlPointsEx(int numPoints, ref WKSPoint fromPoints, ref WKSPoint toPoints)
Parameters
DefineFromEnvelopes(IEnvelope, IEnvelope)
Defines a transformation that maps a point relative to one envelope to a similar position relative to another envelope.
virtual void DefineFromEnvelopes(IEnvelope from, IEnvelope to)
Parameters
DefineFromEnvelopesEx(IEnvelope, IEnvelope, IEnvelope, bool, bool, bool)
Defines a transformation that maps a point relative to one envelope to a similar position relative to another envelope.
virtual void DefineFromEnvelopesEx(IEnvelope from, IEnvelope to, IEnvelope outFrom, bool assumeFalseOrigin, bool keepAspect, bool flipIt)
Parameters
DefineReflection(ILine)
Defines a transformation that can perform a reflection about the line l.
virtual void DefineReflection(ILine l)
Parameters
lILine
GetControlPointError(int, ref double, ref double)
Returns the errors involved in moving control point i from the 'from' to 'to' system. These error terms are valid after using DefineFromControlPoints/Ex to define the transformation.
virtual void GetControlPointError(int i, ref double fromError, ref double toError)
Parameters
GetRMSError(ref double, ref double)
RMS (Root Mean Square) error expressed relative to the 'from' and 'to' points defining the transformation. These error terms are valid after using DefineFromControlPoints/Ex to define the transformation.
virtual void GetRMSError(ref double fromError, ref double toError)
Parameters
GetZShift(out double, out double)
The shift in the Z direction.
virtual void GetZShift(out double zOrigin, out double zOffset)
Parameters
IAffineTransformation2D2_DefineFromControlPoints(int, ref IPoint, ref IPoint)
virtual void IAffineTransformation2D2_DefineFromControlPoints(int numPoints, ref IPoint fromPoints, ref IPoint toPoints)
Parameters
IAffineTransformation2D2_DefineFromControlPointsEx(int, ref WKSPoint, ref WKSPoint)
virtual void IAffineTransformation2D2_DefineFromControlPointsEx(int numPoints, ref WKSPoint fromPoints, ref WKSPoint toPoints)
Parameters
IAffineTransformation2D2_DefineFromEnvelopes(IEnvelope, IEnvelope)
virtual void IAffineTransformation2D2_DefineFromEnvelopes(IEnvelope from, IEnvelope to)
Parameters
IAffineTransformation2D2_DefineFromEnvelopesEx(IEnvelope, IEnvelope, IEnvelope, bool, bool, bool)
virtual void IAffineTransformation2D2_DefineFromEnvelopesEx(IEnvelope from, IEnvelope to, IEnvelope outFrom, bool assumeFalseOrigin, bool keepAspect, bool flipIt)
Parameters
IAffineTransformation2D2_DefineReflection(ILine)
virtual void IAffineTransformation2D2_DefineReflection(ILine l)
Parameters
lILine
IAffineTransformation2D2_GetControlPointError(int, out double, out double)
virtual void IAffineTransformation2D2_GetControlPointError(int i, out double fromError, out double toError)
Parameters
IAffineTransformation2D2_GetRMSError(out double, out double)
virtual void IAffineTransformation2D2_GetRMSError(out double fromError, out double toError)
Parameters
IAffineTransformation2D2_IsReflective
virtual bool IAffineTransformation2D2_IsReflective { get; }
Returns
IAffineTransformation2D2_Move(double, double)
virtual void IAffineTransformation2D2_Move(double dx, double dy)
Parameters
IAffineTransformation2D2_MoveOrigin
virtual IPoint IAffineTransformation2D2_MoveOrigin { set; }
Returns
Remarks
Projecting a distance from one spatial reference to another is meaningless without specifying where the distance is measured. A line that is one unit in length in one spatial reference can map to a varying number of units on another spatial reference depending upon the location of the end points. For this reason, when your AffineTransformation2D has a translation (i.e., a Move), it is important to specify a point as the Origin for this move. This is done using the MoveOrigin property.
When the AffineTransformation2D you are projecting has a rotation, specifying a MoveOrigin is not necessary as the origin (or center) of the rotation is considered to be the origin of any translations as well.
Using a MoveOrigin that is closest to the geometry that you are projecting results in a more accurate transformation. In the following illustration, a point P1 is transformed by an AffineTransformation2D to the point P2. Both P1 and the Affine Transformation have the same spatial reference. P2 when projected to another spatial reference results in PP2.
If you project P1 and the Affine Transformation into PP2's spatial reference, and transform the projected point PP1 using the projected transformation, you will get the point PP2 provided you set the MoveOrigin of the AffineTransformation to P1 before projecting it. The results of this transformation will be more accurate when the MoveOrigin is closer to P1.
For the code illustrating this, see the example for this topic.

For an AffineTransformation2D to be projected, its MoveOrigin should be set so that it is within the horizons of the new projection.
IAffineTransformation2D2_MoveOrigin_2
The origin of accumulated transformations used when projecting an affine transformation to a different spatial reference system.
virtual IPoint IAffineTransformation2D2_MoveOrigin_2 { get; }
Returns
IAffineTransformation2D2_MoveVector(ILine)
virtual void IAffineTransformation2D2_MoveVector(ILine movementVector)
Parameters
movementVectorILine
IAffineTransformation2D2_PostMultiply(IAffineTransformation2D)
virtual void IAffineTransformation2D2_PostMultiply(IAffineTransformation2D postTransform)
Parameters
postTransformIAffineTransformation2D
IAffineTransformation2D2_PreMultiply(IAffineTransformation2D)
virtual void IAffineTransformation2D2_PreMultiply(IAffineTransformation2D preTransform)
Parameters
preTransformIAffineTransformation2D
IAffineTransformation2D2_Project(ISpatialReference)
virtual void IAffineTransformation2D2_Project(ISpatialReference newSpatialReference)
Parameters
newSpatialReferenceISpatialReference
IAffineTransformation2D2_Reset()
virtual void IAffineTransformation2D2_Reset()
IAffineTransformation2D2_Rotate(double)
virtual void IAffineTransformation2D2_Rotate(double da)
Parameters
dadouble
IAffineTransformation2D2_Rotation
virtual double IAffineTransformation2D2_Rotation { get; }
Returns
IAffineTransformation2D2_Scale(double, double)
virtual void IAffineTransformation2D2_Scale(double dx, double dy)
Parameters
IAffineTransformation2D2_SpatialReference
virtual ISpatialReference IAffineTransformation2D2_SpatialReference { get; set; }
Returns
IAffineTransformation2D2_TransformMeasuresFF(esriTransformDirection, int, ref double, ref double)
virtual void IAffineTransformation2D2_TransformMeasuresFF(esriTransformDirection Direction, int cMeasures, ref double inMeasures, ref double outMeasures)
Parameters
DirectionesriTransformDirectioncMeasuresintinMeasuresdoubleoutMeasuresdouble
IAffineTransformation2D2_TransformMeasuresFI(esriTransformDirection, int, ref double, ref int)
virtual void IAffineTransformation2D2_TransformMeasuresFI(esriTransformDirection Direction, int cMeasures, ref double inMeasures, ref int outMeasures)
Parameters
DirectionesriTransformDirectioncMeasuresintinMeasuresdoubleoutMeasuresint
IAffineTransformation2D2_TransformMeasuresIF(esriTransformDirection, int, ref int, ref double)
virtual void IAffineTransformation2D2_TransformMeasuresIF(esriTransformDirection Direction, int cMeasures, ref int inMeasures, ref double outMeasures)
Parameters
DirectionesriTransformDirectioncMeasuresintinMeasuresintoutMeasuresdouble
IAffineTransformation2D2_TransformMeasuresII(esriTransformDirection, int, ref int, ref int)
virtual void IAffineTransformation2D2_TransformMeasuresII(esriTransformDirection Direction, int cMeasures, ref int inMeasures, ref int outMeasures)
Parameters
DirectionesriTransformDirectioncMeasuresintinMeasuresintoutMeasuresint
IAffineTransformation2D2_TransformPointsFF(esriTransformDirection, int, ref double, ref double)
virtual void IAffineTransformation2D2_TransformPointsFF(esriTransformDirection Direction, int cPoints, ref double inPoints, ref double outPoints)
Parameters
DirectionesriTransformDirectioncPointsintinPointsdoubleoutPointsdouble
IAffineTransformation2D2_TransformPointsFI(esriTransformDirection, int, ref double, ref int)
virtual void IAffineTransformation2D2_TransformPointsFI(esriTransformDirection Direction, int cPoints, ref double inPoints, ref int outPoints)
Parameters
DirectionesriTransformDirectioncPointsintinPointsdoubleoutPointsint
IAffineTransformation2D2_TransformPointsIF(esriTransformDirection, int, ref int, ref double)
virtual void IAffineTransformation2D2_TransformPointsIF(esriTransformDirection Direction, int cPoints, ref int inPoints, ref double outPoints)
Parameters
DirectionesriTransformDirectioncPointsintinPointsintoutPointsdouble
IAffineTransformation2D2_TransformPointsII(esriTransformDirection, int, ref int, ref int)
virtual void IAffineTransformation2D2_TransformPointsII(esriTransformDirection Direction, int cPoints, ref int inPoints, ref int outPoints)
Parameters
DirectionesriTransformDirectioncPointsintinPointsintoutPointsint
IAffineTransformation2D2_XScale
virtual double IAffineTransformation2D2_XScale { get; }
Returns
IAffineTransformation2D2_XTranslation
virtual double IAffineTransformation2D2_XTranslation { get; }
Returns
IAffineTransformation2D2_YScale
virtual double IAffineTransformation2D2_YScale { get; }
Returns
IAffineTransformation2D2_YTranslation
virtual double IAffineTransformation2D2_YTranslation { get; }
Returns
IAffineTransformation2D3GEN_TransformMeasuresFF(esriTransformDirection, ref double[], ref double[])
Transforms floating point measures to floating point measures (or do the inverse).
virtual void IAffineTransformation2D3GEN_TransformMeasuresFF(esriTransformDirection Direction, ref double[] inMeasures, ref double[] outMeasures)
Parameters
DirectionesriTransformDirectioninMeasuresdouble[]outMeasuresdouble[]
IAffineTransformation2D3GEN_TransformMeasuresFI(esriTransformDirection, ref double[], ref int[])
Transforms floating point measures to integer measures (or do the inverse).
virtual void IAffineTransformation2D3GEN_TransformMeasuresFI(esriTransformDirection Direction, ref double[] inMeasures, ref int[] outMeasures)
Parameters
DirectionesriTransformDirectioninMeasuresdouble[]outMeasuresint[]
IAffineTransformation2D3GEN_TransformMeasuresIF(esriTransformDirection, ref int[], ref double[])
Transforms integer measures to floating point measures (or do the inverse).
virtual void IAffineTransformation2D3GEN_TransformMeasuresIF(esriTransformDirection Direction, ref int[] inMeasures, ref double[] outMeasures)
Parameters
DirectionesriTransformDirectioninMeasuresint[]outMeasuresdouble[]
IAffineTransformation2D3GEN_TransformMeasuresII(esriTransformDirection, ref int[], ref int[])
Transforms integer measures to integer measures (or do the inverse).
virtual void IAffineTransformation2D3GEN_TransformMeasuresII(esriTransformDirection Direction, ref int[] inMeasures, ref int[] outMeasures)
Parameters
DirectionesriTransformDirectioninMeasuresint[]outMeasuresint[]
IAffineTransformation2D3GEN_TransformPointsFF(esriTransformDirection, ref double[], ref double[])
Transforms floating point points to floating point points (or do the inverse).
virtual void IAffineTransformation2D3GEN_TransformPointsFF(esriTransformDirection Direction, ref double[] inPoints, ref double[] outPoints)
Parameters
DirectionesriTransformDirectioninPointsdouble[]outPointsdouble[]
IAffineTransformation2D3GEN_TransformPointsFI(esriTransformDirection, ref double[], ref int[])
Transforms floating point points to integer points (or do the inverse).
virtual void IAffineTransformation2D3GEN_TransformPointsFI(esriTransformDirection Direction, ref double[] inPoints, ref int[] outPoints)
Parameters
DirectionesriTransformDirectioninPointsdouble[]outPointsint[]
IAffineTransformation2D3GEN_TransformPointsIF(esriTransformDirection, ref int[], ref double[])
Transforms integer points to floating point points (or do the inverse).
virtual void IAffineTransformation2D3GEN_TransformPointsIF(esriTransformDirection Direction, ref int[] inPoints, ref double[] outPoints)
Parameters
DirectionesriTransformDirectioninPointsint[]outPointsdouble[]
IAffineTransformation2D3GEN_TransformPointsII(esriTransformDirection, ref int[], ref int[])
Transforms integer points to integer points (or do the inverse).
virtual void IAffineTransformation2D3GEN_TransformPointsII(esriTransformDirection Direction, ref int[] inPoints, ref int[] outPoints)
Parameters
DirectionesriTransformDirectioninPointsint[]outPointsint[]
IAffineTransformation2D3_DefineFromControlPoints(int, ref IPoint, ref IPoint)
virtual void IAffineTransformation2D3_DefineFromControlPoints(int numPoints, ref IPoint fromPoints, ref IPoint toPoints)
Parameters
IAffineTransformation2D3_DefineFromControlPointsEx(int, ref WKSPoint, ref WKSPoint)
virtual void IAffineTransformation2D3_DefineFromControlPointsEx(int numPoints, ref WKSPoint fromPoints, ref WKSPoint toPoints)
Parameters
IAffineTransformation2D3_DefineFromEnvelopes(IEnvelope, IEnvelope)
virtual void IAffineTransformation2D3_DefineFromEnvelopes(IEnvelope from, IEnvelope to)
Parameters
IAffineTransformation2D3_DefineFromEnvelopesEx(IEnvelope, IEnvelope, IEnvelope, bool, bool, bool)
virtual void IAffineTransformation2D3_DefineFromEnvelopesEx(IEnvelope from, IEnvelope to, IEnvelope outFrom, bool assumeFalseOrigin, bool keepAspect, bool flipIt)
Parameters
IAffineTransformation2D3_DefineReflection(ILine)
virtual void IAffineTransformation2D3_DefineReflection(ILine l)
Parameters
lILine
IAffineTransformation2D3_GetControlPointError(int, out double, out double)
virtual void IAffineTransformation2D3_GetControlPointError(int i, out double fromError, out double toError)
Parameters
IAffineTransformation2D3_GetRMSError(out double, out double)
virtual void IAffineTransformation2D3_GetRMSError(out double fromError, out double toError)
Parameters
IAffineTransformation2D3_IsReflective
virtual bool IAffineTransformation2D3_IsReflective { get; }
Returns
IAffineTransformation2D3_Move(double, double)
virtual void IAffineTransformation2D3_Move(double dx, double dy)
Parameters
IAffineTransformation2D3_MoveOrigin
virtual IPoint IAffineTransformation2D3_MoveOrigin { set; }
Returns
IAffineTransformation2D3_MoveOrigin_2
virtual IPoint IAffineTransformation2D3_MoveOrigin_2 { get; }
Returns
IAffineTransformation2D3_MoveVector(ILine)
virtual void IAffineTransformation2D3_MoveVector(ILine movementVector)
Parameters
movementVectorILine
IAffineTransformation2D3_PostMultiply(IAffineTransformation2D)
virtual void IAffineTransformation2D3_PostMultiply(IAffineTransformation2D postTransform)
Parameters
postTransformIAffineTransformation2D
IAffineTransformation2D3_PreMultiply(IAffineTransformation2D)
virtual void IAffineTransformation2D3_PreMultiply(IAffineTransformation2D preTransform)
Parameters
preTransformIAffineTransformation2D
IAffineTransformation2D3_Project(ISpatialReference)
virtual void IAffineTransformation2D3_Project(ISpatialReference newSpatialReference)
Parameters
newSpatialReferenceISpatialReference
IAffineTransformation2D3_Reset()
virtual void IAffineTransformation2D3_Reset()
IAffineTransformation2D3_Rotate(double)
virtual void IAffineTransformation2D3_Rotate(double da)
Parameters
dadouble
IAffineTransformation2D3_Rotation
virtual double IAffineTransformation2D3_Rotation { get; }
Returns
IAffineTransformation2D3_Scale(double, double)
virtual void IAffineTransformation2D3_Scale(double dx, double dy)
Parameters
IAffineTransformation2D3_SpatialReference
virtual ISpatialReference IAffineTransformation2D3_SpatialReference { get; set; }
Returns
IAffineTransformation2D3_TransformMeasuresFF(esriTransformDirection, int, ref double, ref double)
virtual void IAffineTransformation2D3_TransformMeasuresFF(esriTransformDirection Direction, int cMeasures, ref double inMeasures, ref double outMeasures)
Parameters
DirectionesriTransformDirectioncMeasuresintinMeasuresdoubleoutMeasuresdouble
IAffineTransformation2D3_TransformMeasuresFI(esriTransformDirection, int, ref double, ref int)
virtual void IAffineTransformation2D3_TransformMeasuresFI(esriTransformDirection Direction, int cMeasures, ref double inMeasures, ref int outMeasures)
Parameters
DirectionesriTransformDirectioncMeasuresintinMeasuresdoubleoutMeasuresint
IAffineTransformation2D3_TransformMeasuresIF(esriTransformDirection, int, ref int, ref double)
virtual void IAffineTransformation2D3_TransformMeasuresIF(esriTransformDirection Direction, int cMeasures, ref int inMeasures, ref double outMeasures)
Parameters
DirectionesriTransformDirectioncMeasuresintinMeasuresintoutMeasuresdouble
IAffineTransformation2D3_TransformMeasuresII(esriTransformDirection, int, ref int, ref int)
virtual void IAffineTransformation2D3_TransformMeasuresII(esriTransformDirection Direction, int cMeasures, ref int inMeasures, ref int outMeasures)
Parameters
DirectionesriTransformDirectioncMeasuresintinMeasuresintoutMeasuresint
IAffineTransformation2D3_TransformPointsFF(esriTransformDirection, int, ref double, ref double)
virtual void IAffineTransformation2D3_TransformPointsFF(esriTransformDirection Direction, int cPoints, ref double inPoints, ref double outPoints)
Parameters
DirectionesriTransformDirectioncPointsintinPointsdoubleoutPointsdouble
IAffineTransformation2D3_TransformPointsFI(esriTransformDirection, int, ref double, ref int)
virtual void IAffineTransformation2D3_TransformPointsFI(esriTransformDirection Direction, int cPoints, ref double inPoints, ref int outPoints)
Parameters
DirectionesriTransformDirectioncPointsintinPointsdoubleoutPointsint
IAffineTransformation2D3_TransformPointsIF(esriTransformDirection, int, ref int, ref double)
virtual void IAffineTransformation2D3_TransformPointsIF(esriTransformDirection Direction, int cPoints, ref int inPoints, ref double outPoints)
Parameters
DirectionesriTransformDirectioncPointsintinPointsintoutPointsdouble
IAffineTransformation2D3_TransformPointsII(esriTransformDirection, int, ref int, ref int)
virtual void IAffineTransformation2D3_TransformPointsII(esriTransformDirection Direction, int cPoints, ref int inPoints, ref int outPoints)
Parameters
DirectionesriTransformDirectioncPointsintinPointsintoutPointsint
IAffineTransformation2D3_XScale
virtual double IAffineTransformation2D3_XScale { get; }
Returns
IAffineTransformation2D3_XTranslation
virtual double IAffineTransformation2D3_XTranslation { get; }
Returns
IAffineTransformation2D3_YScale
virtual double IAffineTransformation2D3_YScale { get; }
Returns
IAffineTransformation2D3_YTranslation
virtual double IAffineTransformation2D3_YTranslation { get; }
Returns
IAffineTransformation2D_DefineFromEnvelopes(IEnvelope, IEnvelope)
Defines a transformation that maps a point relative to one envelope to a similar position relative to another envelope.
virtual void IAffineTransformation2D_DefineFromEnvelopes(IEnvelope from, IEnvelope to)
Parameters
IAffineTransformation2D_DefineFromEnvelopesEx(IEnvelope, IEnvelope, IEnvelope, bool, bool, bool)
Defines a transformation that maps a point relative to one envelope to a similar position relative to another envelope.
virtual void IAffineTransformation2D_DefineFromEnvelopesEx(IEnvelope from, IEnvelope to, IEnvelope outFrom, bool assumeFalseOrigin, bool keepAspect, bool flipIt)
Parameters
Remarks
Parameters:
from: Input IEnvelope object that represents an envelope in the origin space
to: Input IEnvelope object that represents an envelope in the destination space
outFrom: Output IEnvelope object. If provided (can be nothing) this envelope is populated with a from envelope having the same aspect ratio as the to envelope.
assumeFalseOrigin: If assumeFalseOrigin is TRUE, then the transform will assume that an input point with coordinates (0, 0) is actually located at (from.xmin, from.ymin). Otherwise, the transform will include elements that shift each point by (-from.xmin, -from .ymin) before scaling.
keepAspect: Input Boolean value if TRUE the transformation will have the same XScale and YScale.
flipIt: Input Boolean value if TRUE, the transformation will contain an horizontal reflection.
IAffineTransformation2D_DefineReflection(ILine)
Defines a transformation that can perform a reflection about the line l.
virtual void IAffineTransformation2D_DefineReflection(ILine l)
Parameters
lILine
Remarks

IAffineTransformation2D_GetControlPointError(int, out double, out double)
Returns the errors involved in moving control point i from the 'from' to 'to' system. These error terms are valid after using DefineFromControlPoints/Ex to define the transformation.
virtual void IAffineTransformation2D_GetControlPointError(int i, out double fromError, out double toError)
Parameters
Remarks
Note: The from error is in 'from' space units, and the to error is in 'to' space units.
IAffineTransformation2D_GetRMSError(out double, out double)
RMS (Root Mean Square) error expressed relative to the 'from' and 'to' points defining the transformation. These error terms are valid after using DefineFromControlPoints/Ex to define the transformation.
virtual void IAffineTransformation2D_GetRMSError(out double fromError, out double toError)
Parameters
Remarks
Note: The fromError is in the units of the from space, and the toError is in the units of the 'to' space.
IAffineTransformation2D_IsReflective
Indicates if the transformation contains a reflection (determinant is negative).
virtual bool IAffineTransformation2D_IsReflective { get; }
Returns
Remarks

IAffineTransformation2D_Move(double, double)
Incorporates a translation factor into the transformation.
virtual void IAffineTransformation2D_Move(double dx, double dy)
Parameters
Remarks
Note: The Move, Scale, and Rotate transformations are cumulative they add the transformation specified to any existing transformation in an AffineTransformation2D object.
IAffineTransformation2D_MoveOrigin
The origin of accumulated transformations used when projecting an affine transformation to a different spatial reference system.
virtual IPoint IAffineTransformation2D_MoveOrigin { set; }
Returns
Remarks
Projecting a distance from one spatial reference to another is meaningless without specifying where the distance is measured. A line that is one unit in length in one spatial reference can map to a varying number of units on another spatial reference depending upon the location of the end points. For this reason, when your AffineTransformation2D has a translation (i.e., a Move), it is important to specify a point as the Origin for this move. This is done using the MoveOrigin property.
When the AffineTransformation2D you are projecting has a rotation, specifying a MoveOrigin is not necessary as the origin (or center) of the rotation is considered to be the origin of any translations as well.
Using a MoveOrigin that is closest to the geometry that you are projecting results in a more accurate transformation. In the following illustration, a point P1 is transformed by an AffineTransformation2D to the point P2. Both P1 and the Affine Transformation have the same spatial reference. P2 when projected to another spatial reference results in PP2.
If you project P1 and the Affine Transformation into PP2's spatial reference, and transform the projected point PP1 using the projected transformation, you will get the point PP2 provided you set the MoveOrigin of the AffineTransformation to P1 before projecting it. The results of this transformation will be more accurate when the MoveOrigin is closer to P1.
For the code illustrating this, see the example for this topic.

For an AffineTransformation2D to be projected, its MoveOrigin should be set so that it is within the horizons of the new projection.
IAffineTransformation2D_MoveVector(ILine)
Performs an X and Y translation defined by a 2D vector.
virtual void IAffineTransformation2D_MoveVector(ILine movementVector)
Parameters
movementVectorILine
IAffineTransformation2D_Project(ISpatialReference)
Moves this transformation into another spatial reference. If the transformations contains only translations, then use the MoveOrigin property to define an equivalent translation in the new spatial reference.
virtual void IAffineTransformation2D_Project(ISpatialReference newSpatialReference)
Parameters
newSpatialReferenceISpatialReference
Remarks
Projecting a distance from one spatial reference to another is meaningless without specifying where the distance is measured. A line that is one unit in length in one spatial reference can map to a varying number of units on another spatial reference depending upon the location of the end points. For this reason, when your AffineTransformation2D has a translation (i.e., a Move), it is important to specify a point as the Origin for this move. This is done using the MoveOrigin property.
When the AffineTransformation2D you are projecting has a rotation, specifying a MoveOrigin is not necessary as the origin (or center) of the rotation is considered to be the origin of any translations as well.
Using a MoveOrigin that is closest to the geometry that you are projecting results in a more accurate transformation. In the following illustration, a point P1 is transformed by an AffineTransformation2D to the point P2. Both P1 and the Affine Transformation have the same spatial reference. P2 when projected to another spatial reference results in PP2.
If you project P1 and the Affine Transformation into PP2's spatial reference, and transform the projected point PP1 using the projected transformation, you will get the point PP2 provided you set the MoveOrigin of the AffineTransformation to P1 before projecting it. The results of this transformation will be more accurate when the MoveOrigin is closer to P1.
For the code illustrating this, see the example for this topic.

When the scaling is not uniform on the X and the Y axes, no projection takes place.
For an AffineTransformation2D to be projected, its MoveOrigin should be set so that it is within the horizons of the new projection. As the default MoveOrigin of (0,0) might not be within the horizons of the new projection, it is important to explicitly set MoveOrigin before you project.
IAffineTransformation2D_Reset()
Resets the tranformation.
virtual void IAffineTransformation2D_Reset()
IAffineTransformation2D_Rotate(double)
Incorporates a rotation (in radians) into the transformation.
virtual void IAffineTransformation2D_Rotate(double da)
Parameters
dadouble
Remarks
Note: The Move, Scale, and Rotate transformations are cumulative they add the transformation specified to any existing transformation in an AffineTransformation2D object.
private void RotateAroundPoint()
{
//Point to be rotated
IPoint rotatePoint = new ESRI.ArcGIS.Geometry.Point();
rotatePoint.PutCoords(2, 2);
//Point around which to rotate
IPoint centerPoint = new ESRI.ArcGIS.Geometry.Point();
centerPoint.PutCoords(1, 1);
//Rotation Angle
double angle = 45 * Math.PI / 180.0;
//Rotate Around pCenter
IAffineTransformation2D3GEN affineTransformation = new AffineTransformation2D() as IAffineTransformation2D3GEN;
affineTransformation.Move(-centerPoint.X, -centerPoint.Y);
affineTransformation.Rotate(angle);
affineTransformation.Move(centerPoint.X, centerPoint.Y);
ITransform2D transformator = rotatePoint as ITransform2D;
transformator.Transform(esriTransformDirection.esriTransformForward, affineTransformation as ITransformation);
//Set up Comparison Point
//This is the point the transformation should result in
IPoint comparePoint = new ESRI.ArcGIS.Geometry.Point();
comparePoint.PutCoords(2, 2);
transformator = comparePoint as ITransform2D;
transformator.Rotate(centerPoint, angle);
System.Windows.Forms.MessageBox.Show(
"Using IAffineTransformation2D.Rotate: Point X:" + rotatePoint.X + ", Y:" + rotatePoint.Y + "\n" +
"Using IAffineTransformation2D::Rotate, Point X:" + rotatePoint.X + ", Y:" + rotatePoint.Y + "\n" +
"Using ITransform2D::Rotate, Point X: " + comparePoint.X + ", Y:" + comparePoint.Y + "\n" +
"Did X coordinates match? " + (rotatePoint.X == comparePoint.X) + "\n" +
"Did Y coordinates match? " + (rotatePoint.Y == comparePoint.Y)
);
}
Private Sub RotateAroundPoint()
'Point to be rotated
Dim pPt As IPoint
pPt = New Point
pPt.PutCoords(2, 2)
'Point around which to rotate
Dim pCenter As IPoint
pCenter = New Point
pCenter.PutCoords(1, 1)
'Rotation Angle
Dim dAngle As Double
Dim dPi As Double
dPi = 4 * Math.Atan(1)
dAngle = 45 * dPi / 180
'Rotate Around pCenter
Dim pA2D As IAffineTransformation2D
pA2D = New AffineTransformation2D
pA2D.Move(-pCenter.x, -pCenter.y)
pA2D.Rotate(dAngle)
pA2D.Move(pCenter.x, pCenter.y)
Dim pT2D As ITransform2D
pT2D = pPt
pT2D.Transform(esriTransformDirection.esriTransformForward, pA2D)
'Set up Comparison Point
'This is the point the transformation should result in
Dim pComparePt As IPoint
pComparePt = New Point
pComparePt.PutCoords(2, 2)
pT2D = pComparePt
pT2D.Rotate(pCenter, dAngle)
Debug.Print("Using IAffineTransformation2D::Rotate, Point X:" & pPt.x & ", Y:" & pPt.y)
Debug.Print("Using ITransform2D::Rotate, Point X:" & pComparePt.x & ", Y:" & pComparePt.y)
Debug.Print("Did X coordinates match? " & (pPt.x = pComparePt.x))
Debug.Print("Did Y coordinates match? " & (pPt.y = pComparePt.y))
End Sub
IAffineTransformation2D_Rotation
The rotation angle. Will not be able if different x/y scale factors have been incorporated into the transformation.
virtual double IAffineTransformation2D_Rotation { get; }
Returns
IAffineTransformation2D_Scale(double, double)
Incorporates scale factors into the transformation.
virtual void IAffineTransformation2D_Scale(double dx, double dy)
Parameters
Remarks
Note: The Move, Scale, and Rotate transformations are cumulative they add the transformation specified to any existing transformation in an AffineTransformation2D object.
IAffineTransformation2D_SpatialReference
The spatial reference in which this transformation is meaningful.
virtual ISpatialReference IAffineTransformation2D_SpatialReference { get; set; }
Returns
IAffineTransformation2D_TransformMeasuresFF(esriTransformDirection, int, ref double, ref double)
virtual void IAffineTransformation2D_TransformMeasuresFF(esriTransformDirection Direction, int cMeasures, ref double inMeasures, ref double outMeasures)
Parameters
DirectionesriTransformDirectioncMeasuresintinMeasuresdoubleoutMeasuresdouble
IAffineTransformation2D_TransformMeasuresFI(esriTransformDirection, int, ref double, ref int)
virtual void IAffineTransformation2D_TransformMeasuresFI(esriTransformDirection Direction, int cMeasures, ref double inMeasures, ref int outMeasures)
Parameters
DirectionesriTransformDirectioncMeasuresintinMeasuresdoubleoutMeasuresint
IAffineTransformation2D_TransformMeasuresIF(esriTransformDirection, int, ref int, ref double)
virtual void IAffineTransformation2D_TransformMeasuresIF(esriTransformDirection Direction, int cMeasures, ref int inMeasures, ref double outMeasures)
Parameters
DirectionesriTransformDirectioncMeasuresintinMeasuresintoutMeasuresdouble
IAffineTransformation2D_TransformMeasuresII(esriTransformDirection, int, ref int, ref int)
virtual void IAffineTransformation2D_TransformMeasuresII(esriTransformDirection Direction, int cMeasures, ref int inMeasures, ref int outMeasures)
Parameters
DirectionesriTransformDirectioncMeasuresintinMeasuresintoutMeasuresint
IAffineTransformation2D_TransformPointsFF(esriTransformDirection, int, ref double, ref double)
virtual void IAffineTransformation2D_TransformPointsFF(esriTransformDirection Direction, int cPoints, ref double inPoints, ref double outPoints)
Parameters
DirectionesriTransformDirectioncPointsintinPointsdoubleoutPointsdouble
IAffineTransformation2D_TransformPointsFI(esriTransformDirection, int, ref double, ref int)
virtual void IAffineTransformation2D_TransformPointsFI(esriTransformDirection Direction, int cPoints, ref double inPoints, ref int outPoints)
Parameters
DirectionesriTransformDirectioncPointsintinPointsdoubleoutPointsint
IAffineTransformation2D_TransformPointsIF(esriTransformDirection, int, ref int, ref double)
virtual void IAffineTransformation2D_TransformPointsIF(esriTransformDirection Direction, int cPoints, ref int inPoints, ref double outPoints)
Parameters
DirectionesriTransformDirectioncPointsintinPointsintoutPointsdouble
IAffineTransformation2D_TransformPointsII(esriTransformDirection, int, ref int, ref int)
virtual void IAffineTransformation2D_TransformPointsII(esriTransformDirection Direction, int cPoints, ref int inPoints, ref int outPoints)
Parameters
DirectionesriTransformDirectioncPointsintinPointsintoutPointsint
IAffineTransformation2D_XScale
The scale along the X axis.
virtual double IAffineTransformation2D_XScale { get; }
Returns
IAffineTransformation2D_XTranslation
The translation along the X axis.
virtual double IAffineTransformation2D_XTranslation { get; }
Returns
IAffineTransformation2D_YScale
The scale along the Y axis.
virtual double IAffineTransformation2D_YScale { get; }
Returns
IAffineTransformation2D_YTranslation
The translation along the Y axis.
virtual double IAffineTransformation2D_YTranslation { get; }
Returns
InterfaceSupportsErrorInfo(ref Guid)
virtual void InterfaceSupportsErrorInfo(ref Guid riid)
Parameters
riidGuid
IsEqual(IClone)
Indicates if the receiver and other have the same properties.
virtual bool IsEqual(IClone other)
Parameters
otherIClone
Returns
IsIdentical(IClone)
Indicates if the receiver and other are the same object.
virtual bool IsIdentical(IClone other)
Parameters
otherIClone
Returns
IsReflective
Indicates if the transformation contains a reflection (determinant is negative).
virtual bool IsReflective { get; }
Returns
Move(double, double)
Incorporates a translation factor into the transformation.
virtual void Move(double dx, double dy)
Parameters
MoveOrigin
The origin of accumulated transformations used when projecting an affine transformation to a different spatial reference system.
virtual IPoint MoveOrigin { get; set; }
Returns
MoveVector(ILine)
Performs an X and Y translation defined by a 2D vector.
virtual void MoveVector(ILine movementVector)
Parameters
movementVectorILine
PostMultiply(IAffineTransformation2D)
Post-multiplies the transformation by another transformation.
virtual void PostMultiply(IAffineTransformation2D postTransform)
Parameters
postTransformIAffineTransformation2D
PostMultiply(IAffineTransformation2D3GEN)
Post-multiplies the transformation by another transformation.
virtual void PostMultiply(IAffineTransformation2D3GEN postTransform)
Parameters
postTransformIAffineTransformation2D3GEN
PreMultiply(IAffineTransformation2D)
Pre-multiplies the transformation by another transformation.
virtual void PreMultiply(IAffineTransformation2D preTransform)
Parameters
preTransformIAffineTransformation2D
PreMultiply(IAffineTransformation2D3GEN)
Pre-multiplies the transformation by another transformation.
virtual void PreMultiply(IAffineTransformation2D3GEN preTransform)
Parameters
preTransformIAffineTransformation2D3GEN
Project(ISpatialReference)
Moves this transformation into another spatial reference. If the transformations contains only translations, then use the MoveOrigin property to define an equivalent translation in the new spatial reference.
virtual void Project(ISpatialReference newSpatialReference)
Parameters
newSpatialReferenceISpatialReference
PutZShift(double, double)
The shift in the Z direction.
virtual void PutZShift(double zOrigin, double zOffset)
Parameters
QueryLinearCoefficients(esriTransformDirection, ref double)
Returns the linear coefficients which define the two dimensional affine transformation.
virtual void QueryLinearCoefficients(esriTransformDirection Direction, ref double params_6_elements)
Parameters
DirectionesriTransformDirectionparams_6_elementsdouble
QueryLinearCoefficients(esriTransformDirection, ref double[])
Returns the linear coefficients which define the two dimensional affine transformation. The array size of the incoming parameters needs to be 6.
virtual void QueryLinearCoefficients(esriTransformDirection Direction, ref double[] @params)
Parameters
DirectionesriTransformDirectionparamsdouble[]
Reset()
Resets the tranformation.
virtual void Reset()
Rotate(double)
Incorporates a rotation (in radians) into the transformation.
virtual void Rotate(double da)
Parameters
dadouble
Rotation
The rotation angle. Will not be able if different x/y scale factors have been incorporated into the transformation.
virtual double Rotation { get; }
Returns
Scale(double, double)
Incorporates scale factors into the transformation.
virtual void Scale(double dx, double dy)
Parameters
SetLinearCoefficients(esriTransformDirection, ref double)
Sets the linear coefficients which define the two dimensional affine transformation.
virtual void SetLinearCoefficients(esriTransformDirection Direction, ref double params_6_elements)
Parameters
DirectionesriTransformDirectionparams_6_elementsdouble
SetLinearCoefficients(esriTransformDirection, ref double[])
Sets the linear coefficients which define the two dimensional affine transformation. The array size of the incoming parameters needs to be 6.
virtual void SetLinearCoefficients(esriTransformDirection Direction, ref double[] @params)
Parameters
DirectionesriTransformDirectionparamsdouble[]
SpatialReference
The spatial reference in which this transformation is meaningful.
virtual ISpatialReference SpatialReference { get; set; }
Returns
TransformMeasuresFF(esriTransformDirection, ref double[], ref double[])
Transforms floating point measures to floating point measures (or do the inverse).
virtual void TransformMeasuresFF(esriTransformDirection Direction, ref double[] inMeasures, ref double[] outMeasures)
Parameters
DirectionesriTransformDirectioninMeasuresdouble[]outMeasuresdouble[]
TransformMeasuresFF(esriTransformDirection, int, ref double, ref double)
Transforms floating point measures to floating point measures (or do the inverse).
virtual void TransformMeasuresFF(esriTransformDirection Direction, int cMeasures, ref double inMeasures, ref double outMeasures)
Parameters
DirectionesriTransformDirectioncMeasuresintinMeasuresdoubleoutMeasuresdouble
TransformMeasuresFI(esriTransformDirection, ref double[], ref int[])
Transforms floating point measures to integer measures (or do the inverse).
virtual void TransformMeasuresFI(esriTransformDirection Direction, ref double[] inMeasures, ref int[] outMeasures)
Parameters
DirectionesriTransformDirectioninMeasuresdouble[]outMeasuresint[]
TransformMeasuresFI(esriTransformDirection, int, ref double, ref int)
Transforms floating point measures to integer measures (or do the inverse).
virtual void TransformMeasuresFI(esriTransformDirection Direction, int cMeasures, ref double inMeasures, ref int outMeasures)
Parameters
DirectionesriTransformDirectioncMeasuresintinMeasuresdoubleoutMeasuresint
TransformMeasuresIF(esriTransformDirection, int, ref int, ref double)
Transforms integer measures to floating point measures (or do the inverse).
virtual void TransformMeasuresIF(esriTransformDirection Direction, int cMeasures, ref int inMeasures, ref double outMeasures)
Parameters
DirectionesriTransformDirectioncMeasuresintinMeasuresintoutMeasuresdouble
TransformMeasuresIF(esriTransformDirection, ref int[], ref double[])
Transforms integer measures to floating point measures (or do the inverse).
virtual void TransformMeasuresIF(esriTransformDirection Direction, ref int[] inMeasures, ref double[] outMeasures)
Parameters
DirectionesriTransformDirectioninMeasuresint[]outMeasuresdouble[]
TransformMeasuresII(esriTransformDirection, int, ref int, ref int)
Transforms integer measures to integer measures (or do the inverse).
virtual void TransformMeasuresII(esriTransformDirection Direction, int cMeasures, ref int inMeasures, ref int outMeasures)
Parameters
DirectionesriTransformDirectioncMeasuresintinMeasuresintoutMeasuresint
TransformMeasuresII(esriTransformDirection, ref int[], ref int[])
Transforms integer measures to integer measures (or do the inverse).
virtual void TransformMeasuresII(esriTransformDirection Direction, ref int[] inMeasures, ref int[] outMeasures)
Parameters
DirectionesriTransformDirectioninMeasuresint[]outMeasuresint[]
TransformPointsFF(esriTransformDirection, ref double[], ref double[])
Transforms floating point points to floating point points (or do the inverse).
virtual void TransformPointsFF(esriTransformDirection Direction, ref double[] inPoints, ref double[] outPoints)
Parameters
DirectionesriTransformDirectioninPointsdouble[]outPointsdouble[]
TransformPointsFF(esriTransformDirection, int, ref double, ref double)
Transforms floating point points to floating point points (or do the inverse).
virtual void TransformPointsFF(esriTransformDirection Direction, int cPoints, ref double inPoints, ref double outPoints)
Parameters
DirectionesriTransformDirectioncPointsintinPointsdoubleoutPointsdouble
Remarks
The cPoints parameter is the number of points you wish to transform. inPoints and outPoints are one-dimensional arrays so you must interleave coordinate pairs into the arrays.
The cPoints parameter is the number of points you wish to transform. inPoints and outPoints are one-dimensional arrays so you must interleave coordinate pairs into the arrays. This code is a shift of the points to the east and north.
IAffineTransformation2D transform = new AffineTransformation2D() as IAffineTransformation2D;
//Sets the type of transformation moving the values 10 degrees East and 20 degrees North
transform.Move(10, 20);
//Create two single dimensioned arrays for the inPoints and OutPoints
double[] inPoints = new double[4];
double[] outPoints = new double[4];
//Interleave the Longitude and Latitude value for two points 1.1E 5.2N, 2.3E 6.4N
inPoints[0]=1.1; //Longitude point 1
inPoints[1]=5.2; //Latitude point 1
inPoints[2]=2.3; //Longitude point 2
inPoints[3] = 6.4; //Latitude point 2
transform.TransformPointsFF(0,2,ref inPoints[0],ref outPoints[0]);
Debug.Print(outPoints[0].ToString()); //11.1
Debug.Print(outPoints[1].ToString()); //25.2
Debug.Print(outPoints[2].ToString()); //12.3
Debug.Print(outPoints[3].ToString()); //26.4
TransformPointsFI(esriTransformDirection, ref double[], ref int[])
Transforms floating point points to integer points (or do the inverse).
virtual void TransformPointsFI(esriTransformDirection Direction, ref double[] inPoints, ref int[] outPoints)
Parameters
DirectionesriTransformDirectioninPointsdouble[]outPointsint[]
TransformPointsFI(esriTransformDirection, int, ref double, ref int)
Transforms floating point points to integer points (or do the inverse).
virtual void TransformPointsFI(esriTransformDirection Direction, int cPoints, ref double inPoints, ref int outPoints)
Parameters
DirectionesriTransformDirectioncPointsintinPointsdoubleoutPointsint
Remarks
The cPoints parameter is the number of points you wish to transform. inPoints and outPoints are one-dimensional arrays so you must interleave coordinate pairs into the arrays.
TransformPointsIF(esriTransformDirection, int, ref int, ref double)
Transforms integer points to floating point points (or do the inverse).
virtual void TransformPointsIF(esriTransformDirection Direction, int cPoints, ref int inPoints, ref double outPoints)
Parameters
DirectionesriTransformDirectioncPointsintinPointsintoutPointsdouble
Remarks
The cPoints parameter is the number of points you wish to transform. inPoints and outPoints are one-dimensional arrays so you must interleave coordinate pairs into the arrays.
TransformPointsIF(esriTransformDirection, ref int[], ref double[])
Transforms integer points to floating point points (or do the inverse).
virtual void TransformPointsIF(esriTransformDirection Direction, ref int[] inPoints, ref double[] outPoints)
Parameters
DirectionesriTransformDirectioninPointsint[]outPointsdouble[]
TransformPointsII(esriTransformDirection, int, ref int, ref int)
Transforms integer points to integer points (or do the inverse).
virtual void TransformPointsII(esriTransformDirection Direction, int cPoints, ref int inPoints, ref int outPoints)
Parameters
DirectionesriTransformDirectioncPointsintinPointsintoutPointsint
Remarks
The cPoints parameter is the number of points you wish to transform. inPoints and outPoints are one-dimensional arrays so you must interleave coordinate pairs into the arrays.
TransformPointsII(esriTransformDirection, ref int[], ref int[])
Transforms integer points to integer points (or do the inverse).
virtual void TransformPointsII(esriTransformDirection Direction, ref int[] inPoints, ref int[] outPoints)
Parameters
DirectionesriTransformDirectioninPointsint[]outPointsint[]
XScale
The scale along the X axis.
virtual double XScale { get; }
Returns
XTranslation
The translation along the X axis.
virtual double XTranslation { get; }
Returns
YScale
The scale along the Y axis.
virtual double YScale { get; }
Returns
YTranslation
The translation along the Y axis.
virtual double YTranslation { get; }