com.esri.arcgis.geometry

Class SpatialReferenceEnvironment

java.lang.Object

com.esri.arcgis.geometry.SpatialReferenceEnvironment

All Implemented Interfaces:

IClassFactory, ISpatialReferenceFactory, ISpatialReferenceFactory2, ISpatialReferenceFactory3, ISpatialReferenceFactory4, ISpatialReferenceFactory5, ISpatialReferenceFactory6, ISpatialReferenceSingletonManager, com.esri.arcgis.interop.RemoteObjRef, ISupportErrorInfo, java.io.Serializable

public class SpatialReferenceEnvironment
extends java.lang.Object
implements com.esri.arcgis.interop.RemoteObjRef, ISpatialReferenceFactory, ISpatialReferenceFactory2, ISpatialReferenceFactory3, ISpatialReferenceFactory4, ISpatialReferenceFactory5, ISpatialReferenceFactory6, ISpatialReferenceSingletonManager, IClassFactory, ISupportErrorInfo

COM Class 'SpatialReferenceEnvironment'. Generated 5/5/2025 2:28:33 PM from 'X:\ArcGIS\com\server\esriGeometry.tlb'

Description 'Creates various spatial reference objects.' Generator Options: PromptForTypeLibraries = False ClashPrefix = esri_ LowerCaseMemberNames = True IDispatchOnly = False RetryOnReject = False AwtForOcxs = True ArraysAsObjects = False DontRenameSameMethods = False ImplementConflictingInterfaces = True ReuseMethods = True RenameConflictingInterfaceMethods = True GenBeanInfo = True GenerateJavadoc =

See Also:

Serialized Form

Field Summary

Fields inherited from interface com.esri.arcgis.geometry.ISpatialReferenceFactory6

IID, IID049ca1d5_cee1_4c4d_b718_b465aa3a08f3, xxDummy

Fields inherited from interface com.esri.arcgis.geometry.ISpatialReferenceFactory5

IID68d7afce_9129_4569_acf6_32c7a8da077f

Fields inherited from interface com.esri.arcgis.geometry.ISpatialReferenceFactory4

IIDd383f512_5377_4dd6_8fcd_5bf05203577d

Fields inherited from interface com.esri.arcgis.geometry.ISpatialReferenceFactory3

IID59025a77_2cf9_4ef6_992a_1ea18f0012f0

Fields inherited from interface com.esri.arcgis.geometry.ISpatialReferenceFactory2

IID1f050200_da7f_11d3_9f60_00c04f6bdd7f

Fields inherited from interface com.esri.arcgis.geometry.ISpatialReferenceFactory

IID6cd10b60_c4f6_11d1_bc92_0000f875bcce

Fields inherited from interface com.esri.arcgis.geometry.ISpatialReferenceSingletonManager

IID, IID58ab2690_5981_11d2_bcda_0000f875bcce, xxDummy

Fields inherited from interface com.esri.arcgis.geometry.IClassFactory

IID, IID00000001_0000_0000_c000_000000000046, xxDummy

Fields inherited from interface com.esri.arcgis.system.ISupportErrorInfo

IID, IIDdf0b3d60_548f_101b_8e65_08002b2bd119, xxDummy

Constructor Summary

Constructors

Constructor and Description
SpatialReferenceEnvironment() Constructs a SpatialReferenceEnvironment using ArcGIS Engine.
SpatialReferenceEnvironment(java.lang.Object obj) Deprecated. As of ArcGIS 9.2, replaced by normal Java casts. SpatialReferenceEnvironment theSpatialReferenceEnvironment = (SpatialReferenceEnvironment) obj;

Method Summary

Modifier and Type	Method and Description
IGeoTransformationOperationSet	cloneGeoTransformationDefaults() Returns a clone of the geotransformation defaults.
void	commitIdentity(long[] ppInOutCoordSys) Ensures that no copy of pCS exists in the system.
ISpatialReference	constructHighPrecisionSpatialReference(ISpatialReference inSR, int xyDoubler, int zDoubler, int mDoubler) Constructs a high precision spatial reference based on an existing spatial reference.
ISpatialReference	constructLowPrecisionSpatialReference(boolean bMatchPrecision, ISpatialReference inSR, IEnvelope dataExtent) Construct a low precision spatial reference with the same scale factor as the high precision input, but with a different domain extent.
IDatum	createDatum(int datumType) Creates a predefined datum.
void	createESRISpatialReference(java.lang.String spatRefInfo, ISpatialReference[] spatialReference, int[] cBytesRead) Creates a spatial reference system and defines it from the specified ESRISpatialReference buffer.
ISpatialReference	createESRISpatialReferenceFromPRJ(java.lang.String prj) Creates a spatial reference from a PRJ string.
ISpatialReference	createESRISpatialReferenceFromPRJFile(java.lang.String prjFile) Creates a spatial reference from a PRJ file.
void	createESRISpatialReferenceInfo(java.lang.String spatRefInfo, ISpatialReferenceInfo[] spatialReference, int[] cBytesRead) Creates a spatial reference system and defines it from the specified ESRISpatialReference buffer.
ISpatialReferenceInfo	createESRISpatialReferenceInfoFromPRJ(java.lang.String prj) Creates a spatial reference from a PRJ string.
ISpatialReferenceInfo	createESRISpatialReferenceInfoFromPRJFile(java.lang.String prjFile) Creates a spatial reference from a PRJ file.
ISpatialReferenceInfo	createFromAreaName(java.lang.String areaName, int typeFilter) Creates a coordinate system from the human-readable 'area name' of the coordinate system.
IGeographicCoordinateSystem	createGeographicCoordinateSystem(int gcsType) Creates a predefined geographic coordinate system.
ITransformation	createGeoTransformation(int gTransformationType) Creates a predefined transformation between geographic coordinate systems.
void	createOwnedCS(long[] ppInOutCoordSys) Replaces ppInOutCoordSys with an exact, deep copy.
IParameter	createParameter(int parameterType) Creates a predefined parameter.
ISet	createPredefinedAngularUnits() Creates a list of predefined angular units.
ISet	createPredefinedDatums() Creates a list of a list of predefined datums.
ISet	createPredefinedGeographicTransformations() Creates a list of predefined geographic transformations.
ISet	createPredefinedLinearUnits() Creates a list of predefined linear units.
ISet	createPredefinedPrimeMeridians() Creates a list of predefined prime meridians.
ISet	createPredefinedProjections() Creates a list of predefined projections.
ISet	createPredefinedSpheroids() Creates a list of predefined spheroids.
ISet	createPredefinedVerticalCoordinateSystems() Creates a list of predefined vertical coordinate systems.
ISet	createPredefinedVerticalDatums() Creates a list of predefined vertical datums.
IPrimeMeridian	createPrimeMeridian(int primeMeridianType) Creates a predefined prime meridian.
IProjectedCoordinateSystem	createProjectedCoordinateSystem(int pcsType) Creates a predefined projected coordinate system.
IProjection	createProjection(int projectionType) Creates a predefined projection.
ISpatialReference	createSpatialReference(int srID) Creates a predefined spatial reference from an srID.
ISpheroid	createSpheroid(int spheroidType) Creates a predefined spheroid.
IUnit	createUnit(int unitType) Creates a predefined unit of measure.
IVerticalCoordinateSystem	createVerticalCoordinateSystem(int vcsID) Creates a predefined vertical coordinate system from an enumeration or ID code.
IVerticalCoordinateSystem	createVerticalCoordinateSystemFromESRISpatialReference(java.lang.String srInfo) Creates a vertical coordinate system from its string format.
IVerticalDatum	createVerticalDatum(int vdID) Creates a predefined vertical datum from an enumeration or ID code.
boolean	equals(java.lang.Object o) Compare this object with another
void	exportESRISpatialReferenceInfoToPRJFile(java.lang.String prjFile, ISpatialReferenceInfo spatialReference) Exports a spatial reference to a PRJ file.
void	exportESRISpatialReferenceToPRJFile(java.lang.String prjFile, ISpatialReference spatialReference) Exports a spatial reference to a PRJ file.
void	findFactoryCS(int factoryCSCode, long[] ppOutCoordSys) Finds or manufactures a pre-defined coordinate system.
void	findTransformation(boolean findHVTransform, ISpatialReference pFromSR, ISpatialReference pToSR, IEnvelope pExtentS, ITransformation[] pTransform, int[] direction) Returns a suitable geotransformation for a given pair of GCS.
IArray	findTransformations(boolean findHVTransform, ISpatialReference pFromSR, ISpatialReference pToSR, IEnvelope pExtent, int numResults) Returns suitable geotransformations for a given pair of GCS.
IPropertySet	getAreaNames(int typeFilter, java.lang.String nameFilter, boolean returnCategorizedNames, boolean hydrateSR) Returns a set of predefined coordinate system names, and optionally the coordinate systems themselves.
static java.lang.String	getClsid() getClsid.
IGeoTransformationOperationSet	getGeoTransformationDefaults() Returns a list of default geographic transformations.
com.esri.arcgis.interop.Dispatch	getJintegraDispatch() Gets a reference to a com.esri.arcgis.interop.Dispatch which can be used to access the COM object that support for this interface indicates the implementing class references.
ISet	getPredefinedGeographicTransformations() Returns a list of predefined geographic transformations.
int	hashCode() the hashcode for this object
void	interfaceSupportsErrorInfo(GUID riid) interfaceSupportsErrorInfo
boolean	isGeoTransformationFallback() Enables/disables the geographic transformations fallback mechanism.
boolean	isUseShapePreservingProject() Enables/disables shape preserving project.
void	release() Release this COM object reference
void	releaseCoordSys(long pInCoordSys) Decrements the ref count of the extended coord sys and possibly removes it.
void	remoteCreateInstance(GUID riid, java.lang.Object[] ppvObject) remoteCreateInstance
void	remoteLockServer(int fLock) remoteLockServer
void	replaceGeoTransformationDefaults(IGeoTransformationOperationSet pSource) Replaces content of the existing list of default transformations with the content from pSource.
void	setGeoTransformationFallback(boolean vbYesNo) Enables/disables the geographic transformations fallback mechanism.
void	setUseShapePreservingProject(boolean vbYesNo) Enables/disables shape preserving project.
void	setUseShapePreservingProjectEx(boolean vbYesNo, double minSegmentLengthInDegrees, double rhs3) Enables/disables shape preserving project using the input minimum segment length and maximum deviation parameters for convergence.

Methods inherited from class java.lang.Object

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

Constructor Detail

SpatialReferenceEnvironment

public SpatialReferenceEnvironment()
                            throws java.io.IOException,
                                   java.net.UnknownHostException

Constructs a SpatialReferenceEnvironment using ArcGIS Engine.

Throws:

java.io.IOException - if there are interop problems

java.net.UnknownHostException - if there are interop problems

SpatialReferenceEnvironment

public SpatialReferenceEnvironment(java.lang.Object obj)
                            throws java.io.IOException

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

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

Parameters:

obj - an object returned from ArcGIS Engine or Server

Throws:

java.io.IOException - if there are interop problems

Method Detail

getClsid

public static java.lang.String getClsid()

getClsid.

equals

public boolean equals(java.lang.Object o)

Compare this object with another

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

the hashcode for this object

Overrides:

hashCode in class java.lang.Object

getJintegraDispatch

public com.esri.arcgis.interop.Dispatch getJintegraDispatch()

Gets a reference to a com.esri.arcgis.interop.Dispatch which can be used to access the COM object that support for this interface indicates the implementing class references.

Specified by:

getJintegraDispatch in interface com.esri.arcgis.interop.RemoteObjRef

Returns:

the COM object reference

release

public void release()

Release this COM object reference

Specified by:

release in interface com.esri.arcgis.interop.RemoteObjRef

createESRISpatialReference

public void createESRISpatialReference(java.lang.String spatRefInfo,
                                       ISpatialReference[] spatialReference,
                                       int[] cBytesRead)
                                throws java.io.IOException,
                                       AutomationException

Creates a spatial reference system and defines it from the specified ESRISpatialReference buffer.

Specified by:

createESRISpatialReference in interface ISpatialReferenceFactory

Parameters:

spatRefInfo - The spatRefInfo (in)

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

cBytesRead - The cBytesRead (out: use single element array)

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

createESRISpatialReferenceFromPRJ

public ISpatialReference createESRISpatialReferenceFromPRJ(java.lang.String prj)
                                                    throws java.io.IOException,
                                                           AutomationException

Creates a spatial reference from a PRJ string.

Specified by:

createESRISpatialReferenceFromPRJ in interface ISpatialReferenceFactory

Parameters:

prj - The prj (in)

Returns:

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

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

createESRISpatialReferenceFromPRJFile

public ISpatialReference createESRISpatialReferenceFromPRJFile(java.lang.String prjFile)
                                                        throws java.io.IOException,
                                                               AutomationException

Creates a spatial reference from a PRJ file.

Specified by:

createESRISpatialReferenceFromPRJFile in interface ISpatialReferenceFactory

Parameters:

prjFile - The prjFile (in)

Returns:

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

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

exportESRISpatialReferenceToPRJFile

public void exportESRISpatialReferenceToPRJFile(java.lang.String prjFile,
                                                ISpatialReference spatialReference)
                                         throws java.io.IOException,
                                                AutomationException

Exports a spatial reference to a PRJ file.

Specified by:

exportESRISpatialReferenceToPRJFile in interface ISpatialReferenceFactory

Parameters:

prjFile - The prjFile (in)

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

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

createUnit

public IUnit createUnit(int unitType)
                 throws java.io.IOException,
                        AutomationException

Creates a predefined unit of measure.

Specified by:

createUnit in interface ISpatialReferenceFactory

Parameters:

unitType - The unitType (in)

Returns:

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

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

createSpheroid

public ISpheroid createSpheroid(int spheroidType)
                         throws java.io.IOException,
                                AutomationException

Creates a predefined spheroid.

Specified by:

createSpheroid in interface ISpatialReferenceFactory

Parameters:

spheroidType - The spheroidType (in)

Returns:

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

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

createDatum

public IDatum createDatum(int datumType)
                   throws java.io.IOException,
                          AutomationException

Creates a predefined datum.

Specified by:

createDatum in interface ISpatialReferenceFactory

Parameters:

datumType - The datumType (in)

Returns:

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

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

createPrimeMeridian

public IPrimeMeridian createPrimeMeridian(int primeMeridianType)
                                   throws java.io.IOException,
                                          AutomationException

Creates a predefined prime meridian.

Specified by:

createPrimeMeridian in interface ISpatialReferenceFactory

Parameters:

primeMeridianType - The primeMeridianType (in)

Returns:

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

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

createProjection

public IProjection createProjection(int projectionType)
                             throws java.io.IOException,
                                    AutomationException

Creates a predefined projection.

Specified by:

createProjection in interface ISpatialReferenceFactory

Parameters:

projectionType - The projectionType (in)

Returns:

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

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

createParameter

public IParameter createParameter(int parameterType)
                           throws java.io.IOException,
                                  AutomationException

Creates a predefined parameter.

Specified by:

createParameter in interface ISpatialReferenceFactory

Parameters:

parameterType - The parameterType (in)

Returns:

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

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

createProjectedCoordinateSystem

public IProjectedCoordinateSystem createProjectedCoordinateSystem(int pcsType)
                                                           throws java.io.IOException,
                                                                  AutomationException

Creates a predefined projected coordinate system.

Specified by:

createProjectedCoordinateSystem in interface ISpatialReferenceFactory

Parameters:

pcsType - The pcsType (in)

Returns:

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

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

createGeographicCoordinateSystem

public IGeographicCoordinateSystem createGeographicCoordinateSystem(int gcsType)
                                                             throws java.io.IOException,
                                                                    AutomationException

Creates a predefined geographic coordinate system.

Specified by:

createGeographicCoordinateSystem in interface ISpatialReferenceFactory

Parameters:

gcsType - The gcsType (in)

Returns:

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

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

createGeoTransformation

public ITransformation createGeoTransformation(int gTransformationType)
                                        throws java.io.IOException,
                                               AutomationException

Creates a predefined transformation between geographic coordinate systems.

Specified by:

createGeoTransformation in interface ISpatialReferenceFactory

Parameters:

gTransformationType - The gTransformationType (in)

Returns:

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

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

createPredefinedProjections

public ISet createPredefinedProjections()
                                 throws java.io.IOException,
                                        AutomationException

Creates a list of predefined projections.

Specified by:

createPredefinedProjections in interface ISpatialReferenceFactory

Returns:

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

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

createPredefinedLinearUnits

public ISet createPredefinedLinearUnits()
                                 throws java.io.IOException,
                                        AutomationException

Creates a list of predefined linear units.

Specified by:

createPredefinedLinearUnits in interface ISpatialReferenceFactory

Returns:

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

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

createPredefinedDatums

public ISet createPredefinedDatums()
                            throws java.io.IOException,
                                   AutomationException

Creates a list of a list of predefined datums.

Specified by:

createPredefinedDatums in interface ISpatialReferenceFactory

Returns:

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

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

createPredefinedAngularUnits

public ISet createPredefinedAngularUnits()
                                  throws java.io.IOException,
                                         AutomationException

Creates a list of predefined angular units.

Specified by:

createPredefinedAngularUnits in interface ISpatialReferenceFactory

Returns:

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

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

createPredefinedPrimeMeridians

public ISet createPredefinedPrimeMeridians()
                                    throws java.io.IOException,
                                           AutomationException

Creates a list of predefined prime meridians.

Specified by:

createPredefinedPrimeMeridians in interface ISpatialReferenceFactory

Returns:

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

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

createPredefinedSpheroids

public ISet createPredefinedSpheroids()
                               throws java.io.IOException,
                                      AutomationException

Creates a list of predefined spheroids.

Specified by:

createPredefinedSpheroids in interface ISpatialReferenceFactory

Returns:

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

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

createPredefinedGeographicTransformations

public ISet createPredefinedGeographicTransformations()
                                               throws java.io.IOException,
                                                      AutomationException

Creates a list of predefined geographic transformations.

Specified by:

createPredefinedGeographicTransformations in interface ISpatialReferenceFactory2

Returns:

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

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

createSpatialReference

public ISpatialReference createSpatialReference(int srID)
                                         throws java.io.IOException,
                                                AutomationException

Creates a predefined spatial reference from an srID.

Specified by:

createSpatialReference in interface ISpatialReferenceFactory2

Parameters:

srID - The srID (in)

Returns:

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

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getGeoTransformationDefaults

public IGeoTransformationOperationSet getGeoTransformationDefaults()
                                                            throws java.io.IOException,
                                                                   AutomationException

Returns a list of default geographic transformations.

Specified by:

getGeoTransformationDefaults in interface ISpatialReferenceFactory2

Returns:

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

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getPredefinedGeographicTransformations

public ISet getPredefinedGeographicTransformations()
                                            throws java.io.IOException,
                                                   AutomationException

Returns a list of predefined geographic transformations.

Specified by:

getPredefinedGeographicTransformations in interface ISpatialReferenceFactory2

Returns:

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

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

createVerticalCoordinateSystem

public IVerticalCoordinateSystem createVerticalCoordinateSystem(int vcsID)
                                                         throws java.io.IOException,
                                                                AutomationException

Creates a predefined vertical coordinate system from an enumeration or ID code.

Specified by:

createVerticalCoordinateSystem in interface ISpatialReferenceFactory3

Parameters:

vcsID - The vcsID (in)

Returns:

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

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

createVerticalDatum

public IVerticalDatum createVerticalDatum(int vdID)
                                   throws java.io.IOException,
                                          AutomationException

Creates a predefined vertical datum from an enumeration or ID code.

Specified by:

createVerticalDatum in interface ISpatialReferenceFactory3

Parameters:

vdID - The vdID (in)

Returns:

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

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

createPredefinedVerticalDatums

public ISet createPredefinedVerticalDatums()
                                    throws java.io.IOException,
                                           AutomationException

Creates a list of predefined vertical datums.

Specified by:

createPredefinedVerticalDatums in interface ISpatialReferenceFactory3

Returns:

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

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

createPredefinedVerticalCoordinateSystems

public ISet createPredefinedVerticalCoordinateSystems()
                                               throws java.io.IOException,
                                                      AutomationException

Creates a list of predefined vertical coordinate systems.

Specified by:

createPredefinedVerticalCoordinateSystems in interface ISpatialReferenceFactory3

Returns:

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

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

createVerticalCoordinateSystemFromESRISpatialReference

public IVerticalCoordinateSystem createVerticalCoordinateSystemFromESRISpatialReference(java.lang.String srInfo)
                                                                                 throws java.io.IOException,
                                                                                        AutomationException

Creates a vertical coordinate system from its string format.

Specified by:

createVerticalCoordinateSystemFromESRISpatialReference in interface ISpatialReferenceFactory3

Parameters:

srInfo - The srInfo (in)

Returns:

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

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

createESRISpatialReferenceInfo

public void createESRISpatialReferenceInfo(java.lang.String spatRefInfo,
                                           ISpatialReferenceInfo[] spatialReference,
                                           int[] cBytesRead)
                                    throws java.io.IOException,
                                           AutomationException

Creates a spatial reference system and defines it from the specified ESRISpatialReference buffer.

Specified by:

createESRISpatialReferenceInfo in interface ISpatialReferenceFactory3

Parameters:

spatRefInfo - The spatRefInfo (in)

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

cBytesRead - The cBytesRead (out: use single element array)

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

createESRISpatialReferenceInfoFromPRJ

public ISpatialReferenceInfo createESRISpatialReferenceInfoFromPRJ(java.lang.String prj)
                                                            throws java.io.IOException,
                                                                   AutomationException

Creates a spatial reference from a PRJ string.

Specified by:

createESRISpatialReferenceInfoFromPRJ in interface ISpatialReferenceFactory3

Parameters:

prj - The prj (in)

Returns:

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

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

createESRISpatialReferenceInfoFromPRJFile

public ISpatialReferenceInfo createESRISpatialReferenceInfoFromPRJFile(java.lang.String prjFile)
                                                                throws java.io.IOException,
                                                                       AutomationException

Creates a spatial reference from a PRJ file.

Specified by:

createESRISpatialReferenceInfoFromPRJFile in interface ISpatialReferenceFactory3

Parameters:

prjFile - The prjFile (in)

Returns:

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

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

exportESRISpatialReferenceInfoToPRJFile

public void exportESRISpatialReferenceInfoToPRJFile(java.lang.String prjFile,
                                                    ISpatialReferenceInfo spatialReference)
                                             throws java.io.IOException,
                                                    AutomationException

Exports a spatial reference to a PRJ file.

Specified by:

exportESRISpatialReferenceInfoToPRJFile in interface ISpatialReferenceFactory3

Parameters:

prjFile - The prjFile (in)

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

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

constructHighPrecisionSpatialReference

public ISpatialReference constructHighPrecisionSpatialReference(ISpatialReference inSR,
                                                                int xyDoubler,
                                                                int zDoubler,
                                                                int mDoubler)
                                                         throws java.io.IOException,
                                                                AutomationException

Constructs a high precision spatial reference based on an existing spatial reference. xy/z/mDoubler is the number of times the respective precision is to be doubled. A value of zero will find the maximum doubling for that precision.

Specified by:

constructHighPrecisionSpatialReference in interface ISpatialReferenceFactory3

Parameters:

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

xyDoubler - The xyDoubler (in)

zDoubler - The zDoubler (in)

mDoubler - The mDoubler (in)

Returns:

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

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

constructLowPrecisionSpatialReference

public ISpatialReference constructLowPrecisionSpatialReference(boolean bMatchPrecision,
                                                               ISpatialReference inSR,
                                                               IEnvelope dataExtent)
                                                        throws java.io.IOException,
                                                               AutomationException

Construct a low precision spatial reference with the same scale factor as the high precision input, but with a different domain extent. If the calculated domain extent cannot cover the specified data extent, an error is returned.

Specified by:

constructLowPrecisionSpatialReference in interface ISpatialReferenceFactory3

Parameters:

bMatchPrecision - The bMatchPrecision (in)

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

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

Returns:

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

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getAreaNames

public IPropertySet getAreaNames(int typeFilter,
                                 java.lang.String nameFilter,
                                 boolean returnCategorizedNames,
                                 boolean hydrateSR)
                          throws java.io.IOException,
                                 AutomationException

Returns a set of predefined coordinate system names, and optionally the coordinate systems themselves.

Specified by:

getAreaNames in interface ISpatialReferenceFactory4

Parameters:

typeFilter - A com.esri.arcgis.geometry.esriCoordinateSystemFilter constant (in)

nameFilter - The nameFilter (in)

returnCategorizedNames - The returnCategorizedNames (in)

hydrateSR - The hydrateSR (in)

Returns:

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

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

createFromAreaName

public ISpatialReferenceInfo createFromAreaName(java.lang.String areaName,
                                                int typeFilter)
                                         throws java.io.IOException,
                                                AutomationException

Creates a coordinate system from the human-readable 'area name' of the coordinate system.

Specified by:

createFromAreaName in interface ISpatialReferenceFactory4

Parameters:

areaName - The areaName (in)

typeFilter - A com.esri.arcgis.geometry.esriCoordinateSystemFilter constant (in)

Returns:

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

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

isGeoTransformationFallback

public boolean isGeoTransformationFallback()
                                    throws java.io.IOException,
                                           AutomationException

Enables/disables the geographic transformations fallback mechanism. Default is False.

Specified by:

isGeoTransformationFallback in interface ISpatialReferenceFactory5

Returns:

The vbYesNo

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setGeoTransformationFallback

public void setGeoTransformationFallback(boolean vbYesNo)
                                  throws java.io.IOException,
                                         AutomationException

Enables/disables the geographic transformations fallback mechanism. Default is False.

Specified by:

setGeoTransformationFallback in interface ISpatialReferenceFactory5

Parameters:

vbYesNo - The vbYesNo (in)

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

findTransformation

public void findTransformation(boolean findHVTransform,
                               ISpatialReference pFromSR,
                               ISpatialReference pToSR,
                               IEnvelope pExtentS,
                               ITransformation[] pTransform,
                               int[] direction)
                        throws java.io.IOException,
                               AutomationException

Returns a suitable geotransformation for a given pair of GCS. The extent is not used presently.

Specified by:

findTransformation in interface ISpatialReferenceFactory6

Parameters:

findHVTransform - The findHVTransform (in)

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

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

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

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

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

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

cloneGeoTransformationDefaults

public IGeoTransformationOperationSet cloneGeoTransformationDefaults()
                                                              throws java.io.IOException,
                                                                     AutomationException

Returns a clone of the geotransformation defaults.

Specified by:

cloneGeoTransformationDefaults in interface ISpatialReferenceFactory6

Returns:

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

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

replaceGeoTransformationDefaults

public void replaceGeoTransformationDefaults(IGeoTransformationOperationSet pSource)
                                      throws java.io.IOException,
                                             AutomationException

Replaces content of the existing list of default transformations with the content from pSource.

Specified by:

replaceGeoTransformationDefaults in interface ISpatialReferenceFactory6

Parameters:

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

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

findTransformations

public IArray findTransformations(boolean findHVTransform,
                                  ISpatialReference pFromSR,
                                  ISpatialReference pToSR,
                                  IEnvelope pExtent,
                                  int numResults)
                           throws java.io.IOException,
                                  AutomationException

Returns suitable geotransformations for a given pair of GCS.

Specified by:

findTransformations in interface ISpatialReferenceFactory6

Parameters:

findHVTransform - The findHVTransform (in)

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

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

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

numResults - The numResults (in)

Returns:

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

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

isUseShapePreservingProject

public boolean isUseShapePreservingProject()
                                    throws java.io.IOException,
                                           AutomationException

Enables/disables shape preserving project. Default is False.

Specified by:

isUseShapePreservingProject in interface ISpatialReferenceFactory6

Returns:

The vbYesNo

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setUseShapePreservingProject

public void setUseShapePreservingProject(boolean vbYesNo)
                                  throws java.io.IOException,
                                         AutomationException

Enables/disables shape preserving project. Default is False.

Specified by:

setUseShapePreservingProject in interface ISpatialReferenceFactory6

Parameters:

vbYesNo - The vbYesNo (in)

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setUseShapePreservingProjectEx

public void setUseShapePreservingProjectEx(boolean vbYesNo,
                                           double minSegmentLengthInDegrees,
                                           double rhs3)
                                    throws java.io.IOException,
                                           AutomationException

Enables/disables shape preserving project using the input minimum segment length and maximum deviation parameters for convergence. Default is False.

Specified by:

setUseShapePreservingProjectEx in interface ISpatialReferenceFactory6

Parameters:

vbYesNo - The vbYesNo (in)

minSegmentLengthInDegrees - The minSegmentLengthInDegrees (in)

rhs3 - The rhs3 (in)

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

createOwnedCS

public void createOwnedCS(long[] ppInOutCoordSys)
                   throws java.io.IOException,
                          AutomationException

Replaces ppInOutCoordSys with an exact, deep copy.

Specified by:

createOwnedCS in interface ISpatialReferenceSingletonManager

Parameters:

ppInOutCoordSys - Signed 64-bit int (A COM typedef) (A COM typedef) (in/out: use single element array)

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

commitIdentity

public void commitIdentity(long[] ppInOutCoordSys)
                    throws java.io.IOException,
                           AutomationException

Ensures that no copy of pCS exists in the system.

Specified by:

commitIdentity in interface ISpatialReferenceSingletonManager

Parameters:

ppInOutCoordSys - Signed 64-bit int (A COM typedef) (A COM typedef) (in/out: use single element array)

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

findFactoryCS

public void findFactoryCS(int factoryCSCode,
                          long[] ppOutCoordSys)
                   throws java.io.IOException,
                          AutomationException

Finds or manufactures a pre-defined coordinate system.

Specified by:

findFactoryCS in interface ISpatialReferenceSingletonManager

Parameters:

factoryCSCode - The factoryCSCode (in)

ppOutCoordSys - Signed 64-bit int (A COM typedef) (A COM typedef) (out: use single element array)

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

releaseCoordSys

public void releaseCoordSys(long pInCoordSys)
                     throws java.io.IOException,
                            AutomationException

Decrements the ref count of the extended coord sys and possibly removes it.

Specified by:

releaseCoordSys in interface ISpatialReferenceSingletonManager

Parameters:

pInCoordSys - Signed 64-bit int (A COM typedef) (A COM typedef) (in)

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

remoteCreateInstance

public void remoteCreateInstance(GUID riid,
                                 java.lang.Object[] ppvObject)
                          throws java.io.IOException,
                                 AutomationException

remoteCreateInstance

Specified by:

remoteCreateInstance in interface IClassFactory

Parameters:

riid - A Structure: com.esri.arcgis.support.ms.stdole.GUID (in)

ppvObject - A reference to another Object (IUnknown) (out: use single element array)

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

remoteLockServer

public void remoteLockServer(int fLock)
                      throws java.io.IOException,
                             AutomationException

remoteLockServer

Specified by:

remoteLockServer in interface IClassFactory

Parameters:

fLock - The fLock (in)

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

interfaceSupportsErrorInfo

public void interfaceSupportsErrorInfo(GUID riid)
                                throws java.io.IOException,
                                       AutomationException

interfaceSupportsErrorInfo

Specified by:

interfaceSupportsErrorInfo in interface ISupportErrorInfo

Parameters:

riid - A Structure: com.esri.arcgis.support.ms.stdole.GUID (in)

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.