Interface IAffineTransformation2D2

Namespace
ESRI.ArcGIS.Geometry
Assembly
ESRI.Server.Geometry.dll

Provides access to members that define and manipulate affine transformations.

[Guid("8BEDCE87-6CEE-4E7B-9D17-73B3562E9AE6")]
[InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
public interface IAffineTransformation2D2 : IAffineTransformation2D, ITransformation

Properties

IsReflective

bool IsReflective { get; }

Property Value

bool

MoveOrigin

IPoint MoveOrigin { set; }

Property Value

IPoint

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.

AffineTransformation2D Example

For an AffineTransformation2D to be projected, its MoveOrigin should be set so that it is within the horizons of the new projection.

MoveOrigin_2

The origin of accumulated transformations used when projecting an affine transformation to a different spatial reference system.

IPoint MoveOrigin_2 { get; }

Property Value

IPoint

Rotation

double Rotation { get; }

Property Value

double

SpatialReference

ISpatialReference SpatialReference { get; set; }

Property Value

ISpatialReference

XScale

double XScale { get; }

Property Value

double

XTranslation

double XTranslation { get; }

Property Value

double

YScale

double YScale { get; }

Property Value

double

YTranslation

double YTranslation { get; }

Property Value

double

Methods

DefineFromControlPoints(int, ref IPoint, ref IPoint)

void DefineFromControlPoints(int numPoints, ref IPoint fromPoints, ref IPoint toPoints)

Parameters

numPoints int
fromPoints IPoint
toPoints IPoint

DefineFromControlPointsEx(int, ref WKSPoint, ref WKSPoint)

void DefineFromControlPointsEx(int numPoints, ref WKSPoint fromPoints, ref WKSPoint toPoints)

Parameters

numPoints int
fromPoints WKSPoint
toPoints WKSPoint

DefineFromEnvelopes(IEnvelope, IEnvelope)

void DefineFromEnvelopes(IEnvelope from, IEnvelope to)

Parameters

from IEnvelope
to IEnvelope

DefineFromEnvelopesEx(IEnvelope, IEnvelope, IEnvelope, bool, bool, bool)

void DefineFromEnvelopesEx(IEnvelope from, IEnvelope to, IEnvelope outFrom, bool assumeFalseOrigin, bool keepAspect, bool flipIt)

Parameters

from IEnvelope
to IEnvelope
outFrom IEnvelope
assumeFalseOrigin bool
keepAspect bool
flipIt bool

DefineReflection(ILine)

void DefineReflection(ILine l)

Parameters

l ILine

GetControlPointError(int, out double, out double)

void GetControlPointError(int i, out double fromError, out double toError)

Parameters

i int
fromError double
toError double

GetRMSError(out double, out double)

void GetRMSError(out double fromError, out double toError)

Parameters

fromError double
toError double

Move(double, double)

void Move(double dx, double dy)

Parameters

dx double
dy double

MoveVector(ILine)

void MoveVector(ILine movementVector)

Parameters

movementVector ILine

PostMultiply(IAffineTransformation2D)

void PostMultiply(IAffineTransformation2D postTransform)

Parameters

postTransform IAffineTransformation2D

PreMultiply(IAffineTransformation2D)

void PreMultiply(IAffineTransformation2D preTransform)

Parameters

preTransform IAffineTransformation2D

Project(ISpatialReference)

void Project(ISpatialReference newSpatialReference)

Parameters

newSpatialReference ISpatialReference

Reset()

void Reset()

Rotate(double)

void Rotate(double da)

Parameters

da double

Scale(double, double)

void Scale(double dx, double dy)

Parameters

dx double
dy double

TransformMeasuresFF(esriTransformDirection, int, ref double, ref double)

void TransformMeasuresFF(esriTransformDirection Direction, int cMeasures, ref double inMeasures, ref double outMeasures)

Parameters

Direction esriTransformDirection
cMeasures int
inMeasures double
outMeasures double

TransformMeasuresFI(esriTransformDirection, int, ref double, ref int)

void TransformMeasuresFI(esriTransformDirection Direction, int cMeasures, ref double inMeasures, ref int outMeasures)

Parameters

Direction esriTransformDirection
cMeasures int
inMeasures double
outMeasures int

TransformMeasuresIF(esriTransformDirection, int, ref int, ref double)

void TransformMeasuresIF(esriTransformDirection Direction, int cMeasures, ref int inMeasures, ref double outMeasures)

Parameters

Direction esriTransformDirection
cMeasures int
inMeasures int
outMeasures double

TransformMeasuresII(esriTransformDirection, int, ref int, ref int)

void TransformMeasuresII(esriTransformDirection Direction, int cMeasures, ref int inMeasures, ref int outMeasures)

Parameters

Direction esriTransformDirection
cMeasures int
inMeasures int
outMeasures int

TransformPointsFF(esriTransformDirection, int, ref double, ref double)

void TransformPointsFF(esriTransformDirection Direction, int cPoints, ref double inPoints, ref double outPoints)

Parameters

Direction esriTransformDirection
cPoints int
inPoints double
outPoints double

TransformPointsFI(esriTransformDirection, int, ref double, ref int)

void TransformPointsFI(esriTransformDirection Direction, int cPoints, ref double inPoints, ref int outPoints)

Parameters

Direction esriTransformDirection
cPoints int
inPoints double
outPoints int

TransformPointsIF(esriTransformDirection, int, ref int, ref double)

void TransformPointsIF(esriTransformDirection Direction, int cPoints, ref int inPoints, ref double outPoints)

Parameters

Direction esriTransformDirection
cPoints int
inPoints int
outPoints double

TransformPointsII(esriTransformDirection, int, ref int, ref int)

void TransformPointsII(esriTransformDirection Direction, int cPoints, ref int inPoints, ref int outPoints)

Parameters

Direction esriTransformDirection
cPoints int
inPoints int
outPoints int