com.esri.arcgis.geometry

Interface IAffineTransformation2D

All Superinterfaces:

ITransformation, java.io.Serializable

All Known Subinterfaces:

IAffineTransformation2D2, IAffineTransformation2D3

All Known Implementing Classes:

AffineTransformation2D, IAffineTransformation2D2Proxy, IAffineTransformation2D3Proxy, IAffineTransformation2DProxy

public interface IAffineTransformation2D
extends ITransformation, java.io.Serializable

COM Interface 'IAffineTransformation2D'. Generated 9/24/2024 11:01:27 AM from 'X:\ArcGIS\com\server\esriGeometry.tlb'

Description: 'Provides access to members that define and manipulate affine transformations.' Generator Options: PromptForTypeLibraries = False ClashPrefix = esri_ LowerCaseMemberNames = True IDispatchOnly = False RetryOnReject = False AwtForOcxs = True ArraysAsObjects = False DontRenameSameMethods = False ImplementConflictingInterfaces = True ReuseMethods = True RenameConflictingInterfaceMethods = True GenBeanInfo = True GenerateJavadoc =

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	IID Deprecated. Internal use only
static int	IIDd12f81b4_d263_11d2_9f29_00c04f6bdd7f
static int	xxDummy Deprecated. Internal use only

Fields inherited from interface com.esri.arcgis.geometry.ITransformation

IID6f2cf924_7e00_11d0_82f4_0000f8034032

Method Summary

Modifier and Type	Method and Description
void	defineFromControlPoints(int numPoints, IPoint fromPoints, IPoint toPoints) Defines the best affine transformation between two sets of points.
void	defineFromEnvelopes(IEnvelope from, IEnvelope to) Defines a transformation that maps a point relative to one envelope to a similar position relative to another envelope.
void	defineFromEnvelopesEx(IEnvelope from, IEnvelope to, IEnvelope outFrom, boolean assumeFalseOrigin, boolean keepAspect, boolean flipIt) Defines a transformation that maps a point relative to one envelope to a similar position relative to another envelope.
void	defineReflection(ILine l) Defines a transformation that can perform a reflection about the line l.
void	getControlPointError(int i, double[] fromError, double[] toError) Returns the errors involved in moving control point i from the 'from' to 'to' system.
void	getRMSError(double[] fromError, double[] toError) RMS (Root Mean Square) error expressed relative to the 'from' and 'to' points defining the transformation.
double	getRotation() The rotation angle.
ISpatialReference	getSpatialReference() The spatial reference in which this transformation is meaningful.
double	getXScale() The scale along the X axis.
double	getXTranslation() The translation along the X axis.
double	getYScale() The scale along the Y axis.
double	getYTranslation() The translation along the Y axis.
boolean	isReflective() Indicates if the transformation contains a reflection (determinant is negative).
void	move(double dx, double dy) Incorporates a translation factor into the transformation.
void	moveVector(ILine movementVector) Performs an X and Y translation defined by a 2D vector.
void	postMultiply(IAffineTransformation2D postTransform) Post-multiplies the transformation by another transformation.
void	preMultiply(IAffineTransformation2D preTransform) Pre-multiplies the transformation by another transformation.
void	project(ISpatialReference newSpatialReference) Moves this transformation into another spatial reference.
void	reset() Resets the tranformation.
void	rotate(double da) Incorporates a rotation (in radians) into the transformation.
void	scale(double dx, double dy) Incorporates scale factors into the transformation.
void	setMoveOrigin(IPoint rhs1) The origin of accumulated transformations used when projecting an affine transformation to a different spatial reference system.
void	setSpatialReferenceByRef(ISpatialReference sR) The spatial reference in which this transformation is meaningful.

Methods inherited from interface com.esri.arcgis.geometry.ITransformation

transformMeasuresFF, transformMeasuresFI, transformMeasuresIF, transformMeasuresII, transformPointsFF, transformPointsFI, transformPointsIF, transformPointsII

Field Detail

IIDd12f81b4_d263_11d2_9f29_00c04f6bdd7f

static final int IIDd12f81b4_d263_11d2_9f29_00c04f6bdd7f

See Also:

Constant Field Values

xxDummy

static final int xxDummy

Deprecated. Internal use only

See Also:

Constant Field Values

IID

static final java.lang.String IID

Deprecated. Internal use only

See Also:

Constant Field Values

Method Detail

setSpatialReferenceByRef

void setSpatialReferenceByRef(ISpatialReference sR)
                       throws java.io.IOException,
                              AutomationException

The spatial reference in which this transformation is meaningful.

Parameters:

sR - A reference to a com.esri.arcgis.geometry.ISpatialReference (in)

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getSpatialReference

ISpatialReference getSpatialReference()
                               throws java.io.IOException,
                                      AutomationException

The spatial reference in which this transformation is meaningful.

Returns:

A reference to a com.esri.arcgis.geometry.ISpatialReference

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

reset

void reset()
    throws java.io.IOException,
           AutomationException

Resets the tranformation.

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

defineFromControlPoints

void defineFromControlPoints(int numPoints,
                             IPoint fromPoints,
                             IPoint toPoints)
                      throws java.io.IOException,
                             AutomationException

Defines the best affine transformation between two sets of points. Can be used to register paper maps on a digitizer.

Parameters:

numPoints - The numPoints (in)

fromPoints - A reference to a com.esri.arcgis.geometry.IPoint (in)

toPoints - A reference to a com.esri.arcgis.geometry.IPoint (in)

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

defineFromEnvelopes

void defineFromEnvelopes(IEnvelope from,
                         IEnvelope to)
                  throws java.io.IOException,
                         AutomationException

Defines a transformation that maps a point relative to one envelope to a similar position relative to another envelope.

Parameters:

from - A reference to a com.esri.arcgis.geometry.IEnvelope (in)

to - A reference to a com.esri.arcgis.geometry.IEnvelope (in)

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

defineFromEnvelopesEx

void defineFromEnvelopesEx(IEnvelope from,
                           IEnvelope to,
                           IEnvelope outFrom,
                           boolean assumeFalseOrigin,
                           boolean keepAspect,
                           boolean flipIt)
                    throws java.io.IOException,
                           AutomationException

Defines a transformation that maps a point relative to one envelope to a similar position relative to another envelope.

Parameters:

from - A reference to a com.esri.arcgis.geometry.IEnvelope (in)

to - A reference to a com.esri.arcgis.geometry.IEnvelope (in)

outFrom - A reference to a com.esri.arcgis.geometry.IEnvelope (in)

assumeFalseOrigin - The assumeFalseOrigin (in)

keepAspect - The keepAspect (in)

flipIt - The flipIt (in)

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

defineReflection

void defineReflection(ILine l)
               throws java.io.IOException,
                      AutomationException

Defines a transformation that can perform a reflection about the line l.

Parameters:

l - A reference to a com.esri.arcgis.geometry.ILine (in)

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getRMSError

void getRMSError(double[] fromError,
                 double[] toError)
          throws java.io.IOException,
                 AutomationException

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.

Parameters:

fromError - The fromError (out: use single element array)

toError - The toError (out: use single element array)

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getControlPointError

void getControlPointError(int i,
                          double[] fromError,
                          double[] toError)
                   throws java.io.IOException,
                          AutomationException

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.

Parameters:

i - The i (in)

fromError - The fromError (out: use single element array)

toError - The toError (out: use single element array)

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getXScale

double getXScale()
          throws java.io.IOException,
                 AutomationException

The scale along the X axis.

Returns:

The sx

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getYScale

double getYScale()
          throws java.io.IOException,
                 AutomationException

The scale along the Y axis.

Returns:

The sy

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getXTranslation

double getXTranslation()
                throws java.io.IOException,
                       AutomationException

The translation along the X axis.

Returns:

The dx

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getYTranslation

double getYTranslation()
                throws java.io.IOException,
                       AutomationException

The translation along the Y axis.

Returns:

The dy

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getRotation

double getRotation()
            throws java.io.IOException,
                   AutomationException

The rotation angle. Will not be able if different x/y scale factors have been incorporated into the transformation.

Returns:

The r

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

scale

void scale(double dx,
           double dy)
    throws java.io.IOException,
           AutomationException

Incorporates scale factors into the transformation.

Parameters:

dx - The dx (in)

dy - The dy (in)

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setMoveOrigin

void setMoveOrigin(IPoint rhs1)
            throws java.io.IOException,
                   AutomationException

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

Parameters:

rhs1 - A reference to a com.esri.arcgis.geometry.IPoint (in)

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

moveVector

void moveVector(ILine movementVector)
         throws java.io.IOException,
                AutomationException

Performs an X and Y translation defined by a 2D vector.

Parameters:

movementVector - A reference to a com.esri.arcgis.geometry.ILine (in)

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

move

void move(double dx,
          double dy)
   throws java.io.IOException,
          AutomationException

Incorporates a translation factor into the transformation.

Parameters:

dx - The dx (in)

dy - The dy (in)

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

rotate

void rotate(double da)
     throws java.io.IOException,
            AutomationException

Incorporates a rotation (in radians) into the transformation.

Parameters:

da - The da (in)

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

postMultiply

void postMultiply(IAffineTransformation2D postTransform)
           throws java.io.IOException,
                  AutomationException

Post-multiplies the transformation by another transformation.

Parameters:

postTransform - A reference to a com.esri.arcgis.geometry.IAffineTransformation2D (in)

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

preMultiply

void preMultiply(IAffineTransformation2D preTransform)
          throws java.io.IOException,
                 AutomationException

Pre-multiplies the transformation by another transformation.

Parameters:

preTransform - A reference to a com.esri.arcgis.geometry.IAffineTransformation2D (in)

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

isReflective

boolean isReflective()
              throws java.io.IOException,
                     AutomationException

Indicates if the transformation contains a reflection (determinant is negative).

Returns:

The isReflective

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

project

void project(ISpatialReference newSpatialReference)
      throws java.io.IOException,
             AutomationException

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.

Parameters:

newSpatialReference - A reference to a com.esri.arcgis.geometry.ISpatialReference (in)

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.