com.esri.arcgis.geometry
Interface ISpatialReference3

All Superinterfaces:

ISpatialReference, ISpatialReference2, ISpatialReferenceInfo, Serializable

All Known Implementing Classes:

GeographicCoordinateSystem, ProjectedCoordinateSystem

public interface ISpatialReference3
extends ISpatialReference2, Serializable

Provides access to additional members that associate a spatial reference with a vertical coordinate system.

When To Use

Use ISpatialReference3 to work with the vertical coordinate system part of a spatial reference.

Product Availability

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

Method Summary

IVerticalCoordinateSystem	getVerticalCoordinateSystem() The VCS associated with this spatial reference.
void	projectionHint(IGeometry geometry, ISpatialReference targetSR, int[] direction, ITransformation[] pXForm, int[] projectionHint) Projection hint for speeding up projections.
void	setVerticalCoordinateSystemByRef(IVerticalCoordinateSystem vcs) The VCS associated with this spatial reference.

Methods inherited from interface com.esri.arcgis.geometry.ISpatialReference2

applyPrecision, applyXYPrecision, isMPrecisionEqual, isXYPrecisionEqual, isZPrecisionEqual

Methods inherited from interface com.esri.arcgis.geometry.ISpatialReference

changed, getDomain, getFalseOriginAndUnits, getMDomain, getMFalseOriginAndUnits, getZCoordinateUnit, getZDomain, getZFalseOriginAndUnits, hasMPrecision, hasXYPrecision, hasZPrecision, isPrecisionEqual, setDomain, setFalseOriginAndUnits, setMDomain, setMFalseOriginAndUnits, setZCoordinateUnit, setZDomain, setZFalseOriginAndUnits

Methods inherited from interface com.esri.arcgis.geometry.ISpatialReferenceInfo

getAbbreviation, getAlias, getFactoryCode, getName, getRemarks

Method Detail

getVerticalCoordinateSystem

IVerticalCoordinateSystem getVerticalCoordinateSystem()
                                                      throws IOException,
                                                             AutomationException

The VCS associated with this spatial reference.

Product Availability

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

Returns:

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

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setVerticalCoordinateSystemByRef

void setVerticalCoordinateSystemByRef(IVerticalCoordinateSystem vcs)
                                      throws IOException,
                                             AutomationException

The VCS associated with this spatial reference.

Product Availability

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

Parameters:

vcs - A reference to a com.esri.arcgis.geometry.IVerticalCoordinateSystem (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

projectionHint

void projectionHint(IGeometry geometry,
                    ISpatialReference targetSR,
                    int[] direction,
                    ITransformation[] pXForm,
                    int[] projectionHint)
                    throws IOException,
                           AutomationException

Projection hint for speeding up projections.

Description

Each geographic or projected coordinate system has a horizon. The horizon defines the mathematical limits of the coordinate system. As an example, transverse Mercator is limited to longitude values that are within +/-45 degrees of the central meridian. Most projection workflows are local. That is, all geometries of a feature class are within the horizons of the input and output coordinate systems. The process of checking whether a geometry is within, crosses, or is outside a horizon takes time. You can use the projectionhint method to calculate whether the envelope or bounding geometry of a feature class is within the applicable horizons. If it is, you can add a flag to the ProjectEx5 method to omit horizon checking.

You can also have the projectionhint method check for a geographic (datum) transformation. In the SpatialReferenceEnvironment, the GeoTransformationOperationSet stores active transformations. Normally, none are loaded by default, but if you've loaded several transformations previously, you can use projection hint to return the appropriate one and in which direction to apply it for this projection operation.

The projectionhint values are:

  esriProjectionHintNoHorizonCheck        =  0,

  esriProjectionHintCheckPCSHorizon       =  1,

  esriProjectionHintCheckGCSHorizon       =  2,

  esriProjectionHintFindGeoTransformation =  4,

  esriProjectionHintDefault               =  7,

  esriProjectionHintExplore               =  8,

  esriProjectionHintDoNotProject          = 16  // useful for isEqualNoName

Product Availability

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

Parameters:

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

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

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

pXForm - A reference to a com.esri.arcgis.geometry.ITransformation (in/out: use single element array)

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

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.