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.