com.esri.arcgis.datasourcesraster
Class GeoTransformationHelper

java.lang.Object
  com.esri.arcgis.datasourcesraster.GeoTransformationHelper

All Implemented Interfaces:

IGeoTransformationHelper, com.esri.arcgis.interop.RemoteObjRef, Serializable

public class GeoTransformationHelper
extends Object
implements com.esri.arcgis.interop.RemoteObjRef, IGeoTransformationHelper

The geograpgic transformation (datum conversion) helper class.

Product Availability

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

See Also:

Serialized Form

Constructor Summary

GeoTransformationHelper()
Constructs a GeoTransformationHelper using ArcGIS Engine.

GeoTransformationHelper(Object obj)
Deprecated. As of ArcGIS 9.2, replaced by normal Java casts.
GeoTransformationHelper theGeoTransformationHelper = (GeoTransformationHelper) obj;

Method Summary

boolean	equals(Object o) Compare this object with another
static String	getClsid() getClsid.
IArray	getDefaultTargetCoordinateSystems() The collection of ISpatialReference objects used as default target coordinate systems by the 'Install' method if the 'pTargetSR' argument is not specified.
int	hashCode() the hashcode for this object
void	init(IGeoTransformationOperationSet pGTs, IGeographicCoordinateSystem pCompositionGCS) Initializes the object given a primary set of geographic transformation operators (GT + direction).
void	install(ISpatialReference pSourceSR, ISpatialReference pTargetSR, boolean bAddNew) Sets the system default geographic transformation on the primary operation set if missing.
void	removeAll() All previously installed geotransformation methods are removed from the system.
void	set(int direction, IGeoTransformation pGT, boolean bAddNew) Sets the system default geographic transformation on the primary operation set if missing.
void	setDefaultTargetCoordinateSystemsByRef(IArray ppDefaultTargetCoordinateSystems) The collection of ISpatialReference objects used as default target coordinate systems by the 'Install' method if the 'pTargetSR' argument is not specified.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.esri.arcgis.interop.RemoteObjRef

getJintegraDispatch, release

Constructor Detail

GeoTransformationHelper

public GeoTransformationHelper()
                        throws IOException,
                               UnknownHostException

Constructs a GeoTransformationHelper using ArcGIS Engine.

Throws:

IOException - if there are interop problems

UnknownHostException - if there are interop problems

GeoTransformationHelper

public GeoTransformationHelper(Object obj)
                        throws IOException

Deprecated. As of ArcGIS 9.2, replaced by normal Java casts.
GeoTransformationHelper theGeoTransformationHelper = (GeoTransformationHelper) obj;

Construct a GeoTransformationHelper using a reference to such an object returned from ArcGIS Engine or Server. This is semantically equivalent to casting obj to GeoTransformationHelper.

Parameters:

obj - an object returned from ArcGIS Engine or Server

Throws:

IOException - if there are interop problems

Method Detail

getClsid

public static String getClsid()

getClsid.

equals

public boolean equals(Object o)

Compare this object with another

Overrides:

equals in class Object

hashCode

public int hashCode()

the hashcode for this object

Overrides:

hashCode in class Object

init

public void init(IGeoTransformationOperationSet pGTs,
                 IGeographicCoordinateSystem pCompositionGCS)
          throws IOException,
                 AutomationException

Initializes the object given a primary set of geographic transformation operators (GT + direction). Previously installed geotransformation methods are removed from the system.

Product Availability

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

Specified by:

init in interface IGeoTransformationHelper

Parameters:

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

pCompositionGCS - 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.

install

public void install(ISpatialReference pSourceSR,
                    ISpatialReference pTargetSR,
                    boolean bAddNew)
             throws IOException,
                    AutomationException

Sets the system default geographic transformation on the primary operation set if missing.

Product Availability

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

Specified by:

install in interface IGeoTransformationHelper

Parameters:

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

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

bAddNew - The bAddNew (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

removeAll

public void removeAll()
               throws IOException,
                      AutomationException

All previously installed geotransformation methods are removed from the system.

Product Availability

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

Specified by:

removeAll in interface IGeoTransformationHelper

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setDefaultTargetCoordinateSystemsByRef

public void setDefaultTargetCoordinateSystemsByRef(IArray ppDefaultTargetCoordinateSystems)
                                            throws IOException,
                                                   AutomationException

The collection of ISpatialReference objects used as default target coordinate systems by the 'Install' method if the 'pTargetSR' argument is not specified.

Product Availability

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

Specified by:

setDefaultTargetCoordinateSystemsByRef in interface IGeoTransformationHelper

Parameters:

ppDefaultTargetCoordinateSystems - A reference to a com.esri.arcgis.system.IArray (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getDefaultTargetCoordinateSystems

public IArray getDefaultTargetCoordinateSystems()
                                         throws IOException,
                                                AutomationException

The collection of ISpatialReference objects used as default target coordinate systems by the 'Install' method if the 'pTargetSR' argument is not specified.

Product Availability

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

Specified by:

getDefaultTargetCoordinateSystems in interface IGeoTransformationHelper

Returns:

A reference to a com.esri.arcgis.system.IArray

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

set

public void set(int direction,
                IGeoTransformation pGT,
                boolean bAddNew)
         throws IOException,
                AutomationException

Sets the system default geographic transformation on the primary operation set if missing.

Product Availability

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

Specified by:

set in interface IGeoTransformationHelper

Parameters:

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

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

bAddNew - The bAddNew (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.