com.esri.arcgis.geometry
Interface IGeoTransformationOperationSet

All Superinterfaces:

Serializable

All Known Implementing Classes:

GeoTransformationOperationSet

public interface IGeoTransformationOperationSet
extends Serializable

Provides access to members that control a set of geographic transformation operators (GT + direction).

Description

Use the GeotransformationOperationSet to project geometries having different geographic coordinate systems using the IGeometry::Project method. Use the IGeotransformationOperationSet methods to cache a set of Geotransformations in memory. This set is used by the software when projecting a geometry using the IGeometry::Project . If the geographic coordinate systems of the from/to spatial reference are different then the system looks in the GeoTranformationOperationSet to find a matching geotransformation. If no appropriate geotransformation is found, no geotransformation is applied.

When To Use

Useful when working with datasets that have multiple spatial references. Used in ArcCatalog to store any necessary transformations.

Product Availability

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

See Also:

IMapGeographicTransformations

Method Summary

boolean	find(int direction, IGeoTransformation gT) Check a geographic transformation and a direction to see if it exists in the set.
void	get(IGeographicCoordinateSystem pFromGCS, IGeographicCoordinateSystem pToGCS, int[] direction, IGeoTransformation[] transformation) Returns a default geographic transformation.
int	getCount() The number of geographic transformations in the set.
void	next(int[] direction, IGeoTransformation[] gT) Retrieves the next geographic transformation in the set.
void	remove(int direction, IGeoTransformation transformation) Deletes a particular geographic transformation.
void	removeAll() Deletes all geographic transformations in the set.
void	removeByKey(IGeographicCoordinateSystem pFromGCS, IGeographicCoordinateSystem pToGCS) Deletes a particular geographic transformation by its from and to GeoCS.
void	reset() Reinitializes the geographic transformation set.
void	set(int direction, IGeoTransformation transformation) Sets a default geographic transformation.

Method Detail

set

void set(int direction,
         IGeoTransformation transformation)
         throws IOException,
                AutomationException

Sets a default geographic transformation.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

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

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

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

get

void get(IGeographicCoordinateSystem pFromGCS,
         IGeographicCoordinateSystem pToGCS,
         int[] direction,
         IGeoTransformation[] transformation)
         throws IOException,
                AutomationException

Returns a default geographic transformation.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

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

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

direction - A com.esri.arcgis.geometry.esriTransformDirection constant (out: use single element array)

transformation - A reference to a com.esri.arcgis.geometry.IGeoTransformation (out: use single element array)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

find

boolean find(int direction,
             IGeoTransformation gT)
             throws IOException,
                    AutomationException

Check a geographic transformation and a direction to see if it exists in the set.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

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

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

Returns:

The found

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

remove

void remove(int direction,
            IGeoTransformation transformation)
            throws IOException,
                   AutomationException

Deletes a particular geographic transformation.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

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

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

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

removeByKey

void removeByKey(IGeographicCoordinateSystem pFromGCS,
                 IGeographicCoordinateSystem pToGCS)
                 throws IOException,
                        AutomationException

Deletes a particular geographic transformation by its from and to GeoCS.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

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

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

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

next

void next(int[] direction,
          IGeoTransformation[] gT)
          throws IOException,
                 AutomationException

Retrieves the next geographic transformation in the set.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

direction - A com.esri.arcgis.geometry.esriTransformDirection constant (out: use single element array)

gT - A reference to a com.esri.arcgis.geometry.IGeoTransformation (out: use single element array)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

reset

void reset()
           throws IOException,
                  AutomationException

Reinitializes the geographic transformation set.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

removeAll

void removeAll()
               throws IOException,
                      AutomationException

Deletes all geographic transformations in the set.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getCount

int getCount()
             throws IOException,
                    AutomationException

The number of geographic transformations in the set.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:

The gtCount

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.