com.esri.arcgis.geometry
Interface IProjectiveTransformation2DGEN

All Superinterfaces:

Serializable

All Known Implementing Classes:

ProjectiveTransformation2D

public interface IProjectiveTransformation2DGEN
extends Serializable

Provides access to members that define and manipulate projective transformations. IProjectiveTransformation2DGEN is generic version of IProjectiveTransformation.

Product Availability

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

Method Summary

void	defineFromControlPoints(IPoint[] fromPoints, IPoint[] toPoints) Defines the best projective transformation between two sets of points.
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.
ISpatialReference	getSpatialReference() The spatial reference in which this transformation is meaningful.
void	project(ISpatialReference newSpatialReference) Moves this transformation into another spatial reference.
void	queryTransformationParameters(int direction, double[][] params) Returns the eight parameters which define the two dimensional projective transformation.
void	reset() Resets the tranformation.
void	setSpatialReferenceByRef(ISpatialReference sR) The spatial reference in which this transformation is meaningful.
void	setTransformationParameters(int direction, double[] params) Sets the eight parameters which define the two dimensional projective transformation.
void	transformMeasuresFF(int direction, double[] inMeasures, double[][] outMeasures) Transforms floating point measures to floating point measures (or do the inverse).
void	transformMeasuresFI(int direction, double[] inMeasures, int[][] outMeasures) Transforms floating point measures to integer measures (or do the inverse).
void	transformMeasuresIF(int direction, int[] inMeasures, double[][] outMeasures) Transforms integer measures to floating point measures (or do the inverse).
void	transformMeasuresII(int direction, int[] inMeasures, int[][] outMeasures) Transforms integer measures to integer measures (or do the inverse).
void	transformPointsFF(int direction, double[] inPoints, double[][] outPoints) Transforms floating point points to floating point points (or do the inverse).
void	transformPointsFI(int direction, double[] inPoints, int[][] outPoints) Transforms floating point points to integer points (or do the inverse).
void	transformPointsIF(int direction, int[] inPoints, double[][] outPoints) Transforms integer points to floating point points (or do the inverse).
void	transformPointsII(int direction, int[] inPoints, int[][] outPoints) Transforms integer points to integer points (or do the inverse).

Method Detail

transformMeasuresFF

void transformMeasuresFF(int direction,
                         double[] inMeasures,
                         double[][] outMeasures)
                         throws IOException,
                                AutomationException

Transforms floating point measures to floating point measures (or do the inverse).

Product Availability

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

Parameters:

direction - A com.esri.arcgis.geometry.esriTransformDirection constant (in)

inMeasures - The inMeasures (in)

outMeasures - The outMeasures (in/out: use single element array)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

transformMeasuresFI

void transformMeasuresFI(int direction,
                         double[] inMeasures,
                         int[][] outMeasures)
                         throws IOException,
                                AutomationException

Transforms floating point measures to integer measures (or do the inverse).

Product Availability

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

Parameters:

direction - A com.esri.arcgis.geometry.esriTransformDirection constant (in)

inMeasures - The inMeasures (in)

outMeasures - The outMeasures (in/out: use single element array)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

transformMeasuresIF

void transformMeasuresIF(int direction,
                         int[] inMeasures,
                         double[][] outMeasures)
                         throws IOException,
                                AutomationException

Transforms integer measures to floating point measures (or do the inverse).

Product Availability

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

Parameters:

direction - A com.esri.arcgis.geometry.esriTransformDirection constant (in)

inMeasures - The inMeasures (in)

outMeasures - The outMeasures (in/out: use single element array)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

transformMeasuresII

void transformMeasuresII(int direction,
                         int[] inMeasures,
                         int[][] outMeasures)
                         throws IOException,
                                AutomationException

Transforms integer measures to integer measures (or do the inverse).

Product Availability

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

Parameters:

direction - A com.esri.arcgis.geometry.esriTransformDirection constant (in)

inMeasures - The inMeasures (in)

outMeasures - The outMeasures (in/out: use single element array)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

transformPointsFF

void transformPointsFF(int direction,
                       double[] inPoints,
                       double[][] outPoints)
                       throws IOException,
                              AutomationException

Transforms floating point points to floating point points (or do the inverse).

Product Availability

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

Parameters:

direction - A com.esri.arcgis.geometry.esriTransformDirection constant (in)

inPoints - The inPoints (in)

outPoints - The outPoints (in/out: use single element array)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

transformPointsFI

void transformPointsFI(int direction,
                       double[] inPoints,
                       int[][] outPoints)
                       throws IOException,
                              AutomationException

Transforms floating point points to integer points (or do the inverse).

Product Availability

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

Parameters:

direction - A com.esri.arcgis.geometry.esriTransformDirection constant (in)

inPoints - The inPoints (in)

outPoints - The outPoints (in/out: use single element array)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

transformPointsIF

void transformPointsIF(int direction,
                       int[] inPoints,
                       double[][] outPoints)
                       throws IOException,
                              AutomationException

Transforms integer points to floating point points (or do the inverse).

Product Availability

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

Parameters:

direction - A com.esri.arcgis.geometry.esriTransformDirection constant (in)

inPoints - The inPoints (in)

outPoints - The outPoints (in/out: use single element array)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

transformPointsII

void transformPointsII(int direction,
                       int[] inPoints,
                       int[][] outPoints)
                       throws IOException,
                              AutomationException

Transforms integer points to integer points (or do the inverse).

Product Availability

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

Parameters:

direction - A com.esri.arcgis.geometry.esriTransformDirection constant (in)

inPoints - The inPoints (in)

outPoints - The outPoints (in/out: use single element array)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setSpatialReferenceByRef

void setSpatialReferenceByRef(ISpatialReference sR)
                              throws IOException,
                                     AutomationException

The spatial reference in which this transformation is meaningful.

Product Availability

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

Parameters:

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

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getSpatialReference

ISpatialReference getSpatialReference()
                                      throws IOException,
                                             AutomationException

The spatial reference in which this transformation is meaningful.

Product Availability

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

Returns:

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

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

reset

void reset()
           throws IOException,
                  AutomationException

Resets the tranformation.

Product Availability

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

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

defineFromControlPoints

void defineFromControlPoints(IPoint[] fromPoints,
                             IPoint[] toPoints)
                             throws IOException,
                                    AutomationException

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

Product Availability

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

Parameters:

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

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

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getRMSError

void getRMSError(double[] fromError,
                 double[] toError)
                 throws 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.

Product Availability

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

Parameters:

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

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

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getControlPointError

void getControlPointError(int i,
                          double[] fromError,
                          double[] toError)
                          throws 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.

Product Availability

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

Parameters:

i - The i (in)

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

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

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

project

void project(ISpatialReference newSpatialReference)
             throws 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.

Product Availability

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

Parameters:

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

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

queryTransformationParameters

void queryTransformationParameters(int direction,
                                   double[][] params)
                                   throws IOException,
                                          AutomationException

Returns the eight parameters which define the two dimensional projective transformation.

Product Availability

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

Parameters:

direction - A com.esri.arcgis.geometry.esriTransformDirection constant (in)

params - The params (in/out: use single element array)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setTransformationParameters

void setTransformationParameters(int direction,
                                 double[] params)
                                 throws IOException,
                                        AutomationException

Sets the eight parameters which define the two dimensional projective transformation. The size of the incoming parameter array needs to be 8.

Product Availability

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

Parameters:

direction - A com.esri.arcgis.geometry.esriTransformDirection constant (in)

params - The params (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.