com.esri.arcgis.geometry
Interface ICoordinateFrameTransformation

All Superinterfaces:
IGeoTransformation, ITransformation, Serializable
All Known Implementing Classes:
CoordinateFrameTransformation

public interface ICoordinateFrameTransformation
extends IGeoTransformation, Serializable

Provides access to members that control the 3D frame transformation with rotation, translation and scaling.

Description

The Coordinate Frame transformation converts data between geographic coordinate systems. It uses seven parameters including three translations, three rotations, and a scale factor.

The translations are in meters, the rotations are in arc seconds, and the scale factor is in parts per million.

The transformation is done in a XYZ system.

Remarks

The rotation values are defined as clockwise as you look towards the origin of the XYZ system.

The Coordinate Frame transformation defines the rotations in the opposite direction. If you change the signs of the rotations for either method, you can apply them to other method.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Supported Platforms

Windows, Solaris, Linux


Method Summary
 void getParameters(double[] dx, double[] dy, double[] dz, double[] rx, double[] ry, double[] rz, double[] s)
          Returns translation, rotation and scale values of the transformation.
 void putParameters(double dx, double dy, double dz, double rx, double ry, double rz, double s)
          Sets translation, rotation and scale values for the transformation.
 
Methods inherited from interface com.esri.arcgis.geometry.IGeoTransformation
getName, getSpatialReferences, putSpatialReferences, setName
 
Methods inherited from interface com.esri.arcgis.geometry.ITransformation
transformMeasuresFF, transformMeasuresFI, transformMeasuresIF, transformMeasuresII, transformPointsFF, transformPointsFI, transformPointsIF, transformPointsII
 

Method Detail

putParameters

void putParameters(double dx,
                   double dy,
                   double dz,
                   double rx,
                   double ry,
                   double rz,
                   double s)
                   throws IOException,
                          AutomationException
Sets translation, rotation and scale values for the transformation.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Supported Platforms

Windows, Solaris, Linux

Parameters:
dx - The dx (in)
dy - The dy (in)
dz - The dz (in)
rx - The rx (in)
ry - The ry (in)
rz - The rz (in)
s - The s (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getParameters

void getParameters(double[] dx,
                   double[] dy,
                   double[] dz,
                   double[] rx,
                   double[] ry,
                   double[] rz,
                   double[] s)
                   throws IOException,
                          AutomationException
Returns translation, rotation and scale values of the transformation.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Supported Platforms

Windows, Solaris, Linux

Parameters:
dx - The dx (out: use single element array)
dy - The dy (out: use single element array)
dz - The dz (out: use single element array)
rx - The rx (out: use single element array)
ry - The ry (out: use single element array)
rz - The rz (out: use single element array)
s - The s (out: use single element array)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.