com.esri.arcgis.geometry
Interface ISpatialReferenceFactory2

All Superinterfaces:
ISpatialReferenceFactory, Serializable
All Known Subinterfaces:
ISpatialReferenceFactory3, ISpatialReferenceFactory4
All Known Implementing Classes:
SpatialReferenceEnvironment

public interface ISpatialReferenceFactory2
extends ISpatialReferenceFactory, Serializable

Provides access to members that create different kinds of spatial reference components.

Superseded By

ISpatialReferenceFactory3

Description

ISpatialReferenceFactory2 extends the ISpatialReferenceFactory interface and provides methods for accessing a variety of predefined geographic (datum) transformations and creating any kind of spatial reference (PCS or GCS) from its factory code.

Remarks

The CreatePredefinedGeographicTransformations and the GetPredefinedGeographicTransformations methods both return an ISet of all the possible geotransformations that ArcObjects can create. The SpatialReferenceEnvironment maintains ownership of the set returned by GetPredefinedGeographicTransformations. Neither this set nor its elements should be modified. The Set and transformation elements returned by CreatePredefinedGeographicTransformations can be modified.

Product Availability

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


Method Summary
 ISet createPredefinedGeographicTransformations()
          Creates a list of predefined geographic transformations.
 ISpatialReference createSpatialReference(int srID)
          Creates a predefined spatial reference from an srID.
 IGeoTransformationOperationSet getGeoTransformationDefaults()
          Creates a list of default geographic transformations.
 ISet getPredefinedGeographicTransformations()
          Returns a list of predefined geographic transformations.
 
Methods inherited from interface com.esri.arcgis.geometry.ISpatialReferenceFactory
createDatum, createESRISpatialReference, createESRISpatialReferenceFromPRJ, createESRISpatialReferenceFromPRJFile, createGeographicCoordinateSystem, createGeoTransformation, createParameter, createPredefinedAngularUnits, createPredefinedDatums, createPredefinedLinearUnits, createPredefinedPrimeMeridians, createPredefinedProjections, createPredefinedSpheroids, createPrimeMeridian, createProjectedCoordinateSystem, createProjection, createSpheroid, createUnit, exportESRISpatialReferenceToPRJFile
 

Method Detail

createPredefinedGeographicTransformations

ISet createPredefinedGeographicTransformations()
                                               throws IOException,
                                                      AutomationException
Creates a list of predefined geographic transformations.

Description

Returns a list of all predefined geographic (datum) transformations. The list has two columns: the factory code and the name.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:
A reference to a com.esri.arcgis.system.ISet
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

createSpatialReference

ISpatialReference createSpatialReference(int srID)
                                         throws IOException,
                                                AutomationException
Creates a predefined spatial reference from an srID.

Description

Use a srID from the esriSRProjCSType or esriSRGeoCSType enumerations to create a particular predefined spatial reference.

Remarks

The CreateSpatialReference method creates a valid SpatialReference, either a projected or geographic coordinate system, depending on the supplied FactoryCode (here called an srID). The method returns an ISpatialReference. The example code illustrates how to test for what type of SpatialReference has been created. This method will raise an error (E_INVALIDARG) if the FactoryCode number supplied is not valid.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:
srID - The srID (in)
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.

getGeoTransformationDefaults

IGeoTransformationOperationSet getGeoTransformationDefaults()
                                                            throws IOException,
                                                                   AutomationException
Creates a list of default geographic transformations.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:
A reference to a com.esri.arcgis.geometry.IGeoTransformationOperationSet
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getPredefinedGeographicTransformations

ISet getPredefinedGeographicTransformations()
                                            throws IOException,
                                                   AutomationException
Returns a list of predefined geographic transformations.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:
A reference to a com.esri.arcgis.system.ISet
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.