AffineTransformation2DClass

A two dimensional affine transformation.

Description

The AffineTransformation2D coclass offers the ability to construct customtransformations for geometrical shapes. It is useful for creatingparticular transformations that are not supported by ITransform2D andalso for performing numerous transformations in one go.

Transformations can be done in two different ways. Firstly, and mostcommonly within the geometry model, the AffineTransformation2Dobject can be used in the ITransform2D::Transform method to transforman existing Geometry. Alternatively, the methods of ITransform canbe used to transform points or values individually.

AffineTransformation2D implements two types of transformation.Conformal Transformation (IAffineTransformation2D3::DefineConformalFromControlPoints)and Affine Tranformation (IAffineTransformation2D::DefineFromControlPoints).

CONFORMAL TRANSFORMATION

At least two points are required to define this transformation.The CONFORMAL equations use 4 parameters.

MATHEMATICAL MODEL :The transformation can be described by a set of ceofficients (a, b, c, d, e, f)of two linear equations:``

X =  ax + by + c
Y = -bx + ay + f

or in matrix form:	a	b	0
X	Y	1	=	x	y	1	-b	a	0
c	d	1

The transformation elements can be interpreted as a sequence of simple operations:

  Scaling * Rotation * Translation  = 

``

Sx	0	0	cos r	sin r	0	1	0	0
x	y	1	0	Sy	0	-sin r	cos r	0	0	1	0
0	0	1	0	0	1	Dx	Dy	1

Where :``

  S - scaling factors (can be negative)
  r  - rotation angle in radians, measured counter-clockwise from x-
  axis (-pi < r <= pi)
  Dx, Dy - translation distances in x and y direction 

``

``These elements have the following locations within the transformationmatrix by which a ROW vector {x, y, 1} is to be POST-multiplied.

Given the matrix above the equation parameters can be interpreted as :

a = S cos r 
b = S sin r 
c = Dx 
d = Dy 

AFFINE TRANSFORMATION

At least three points are required to define this transformation.The AFFINE equations use six parameters.

MATHEMATICAL MODEL :The transformation can be described by a set of ceofficients (a, b, c, d, e, f)of two linear equations:

X = a * x + b * y + c 
Y = d * x + e * y + f 

or in matrix form:

a	d	0
X	Y	1	=	x	y	1	b	e	0
c	f	1

The transformation elements can be interpreted as a sequence of simple operations:

Scaling * Shearing * Rotation * Translation = 

Sx	0	1	1	0	0	cos r	sin r	0	1	0	0
x	y	1	0	Sy	0	tan s	1	0	-sin r	cos r	0	0	1	0
0	0	1	0	0	1	0	0	1	Dx	Dy	1

Where :

Sx, Sy - scaling factors (can be negative) 
s - skew angle of shearing along x-axis, measured from y-axis (-pi/2 < s < pi/2) 
r - rotation angle in radians, measured counter-clockwise from x-axis (-pi < r <= pi) 
Dx, Dy - translation distances in x and y direction (can be negative)

``

These elements have the following locations within the transformation matrix by which a ROW vector {x, y, 1} is to be POST-multiplied.

Sx * cos r	Sx * sin r	0
(Sy / cos s) * sin (s - r)	(Sy / cos s) * cos (s - r)	0
Dx	Dy	1

Given the matrix above the equation parameters can be interpreted as : a = Sx cos r b = (Sy / cos s) sin(s - r) c = Dx d = Sx sin r e = (Sy / cos s) cos(s - r) f = Dy

Supported Platforms

Windows, Solaris, Linux

Extended Error Information

Use the ISupportErrorInfo method InterfaceSupportsErrorInfo to determine if the object supports extended error information. If the object supports extended error info, VC++ developers should use the OLE/COM IErrorInfo interface to access the ErrorInfo object. Visual Basic developers should use the global error object Err to retrieve this extended error information.

Interfaces

Interfaces	Description
IAffineTransformation2D	Provides access to members that define and manipulate affine transformations.
IAffineTransformation2D2	Provides access to members that define and manipulate affine transformations.
IAffineTransformation2D3	Provides access to members that define and manipulate affine transformations.
IAffineTransformation2D3GEN	Provides access to members that define and manipulate affine transformations. IAffineTransformation2D3GEN is generic version of IAffineTransformation2D3
IClone (esriSystem)	Provides access to members that control cloning of objects.
ISupportErrorInfo (esriSystem)
ITransformation	Provides access to members that apply a function (or its inverse) to a set of points or measures. The suffix of each method indicates the type of parameters operated on.
ITransformationGEN	Provides access to members that apply a function (or its inverse) to a set of points or measures. The suffix of each method indicates the type of parameters operated on. ITransformationGEN is generic version of ITransformation.
IZShift	Provides access to a limited 3D awareness for a 2D affine transformation.

Remarks

The skew angle is not public yet and cannot be directly get by using a method. But this angle can be calculated by first retrieveing some of the other parameters (b, d, r).

s = atan (b/d) + r

At 8.1, AffineTransformation2D does not implement the following methods:IClone::AssignIClone::IsEqualIClone::IsIdenticalITransformation::TransformMeasuresFFITransformation::TransformMeasuresFIITransformation::TransformMeasuresIFITransformation::TransformMeasuresIIITransformation::TransformPointsIFITransformation::TransformPointsII

All of these methods return an HRESULT of E_NOTIMPL in C++. In VB, this is Error 445, "Object doesn't support this action".