com.esri.arcgis.geometry
Interface ISpatialReference2

All Superinterfaces:

ISpatialReference, ISpatialReferenceInfo, Serializable

All Known Subinterfaces:

ISpatialReference3

All Known Implementing Classes:

GeographicCoordinateSystem, ProjectedCoordinateSystem, UnknownCoordinateSystem

Deprecated. This interface uses C style arrays which are not supported in the ArcGIS API for Java. It is replaced by ISpatialReference2GEN. You can use the GEN interface proxy's Object-constructor to cast an instance of this interface to its GEN equivalent. Any ArcGIS class that implements this interface also implements the GEN interface.

public interface ISpatialReference2
extends ISpatialReference, Serializable

Provides access to additional members that control a SpatialReference.

Superseded By

ISpatialReference3

Description

Extends the ISpatialReference interface by adding functions to compare precision (resolution) of two spatial references, and round off coordinate data to the current resolution.

Product Availability

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

Method Summary

void	applyPrecision(int cPoints, _WKSPoint points, double[] ms, double[] zs) Deprecated. Applies the measure and z value precisions.
void	applyXYPrecision(int cPoints, _WKSPoint points) Deprecated. Applies the XY precision.
boolean	isMPrecisionEqual(ISpatialReference otherSR) Deprecated. Returns true if the measure precisions of the two spatial references are the same.
boolean	isXYPrecisionEqual(ISpatialReference otherSR) Deprecated. Returns true if the XY precisions of the two spatial references are the same.
boolean	isZPrecisionEqual(ISpatialReference otherSR) Deprecated. Returns true if the Z precisions of the two spatial references are the same.

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

isXYPrecisionEqual

boolean isXYPrecisionEqual(ISpatialReference otherSR)
                           throws IOException,
                                  AutomationException

Deprecated.

Returns true if the XY precisions of the two spatial references are the same.

Description

Compares the X and Y precision (resolution) values. Both spatial references must be of the same type (both GCS, both PCS, etc).

Remarks

The IClone::IsEqual method for PCSs and GCSs compares only the projection information (projection, spheroid, projected units, etc.). It does not compare any properties related to the coordinate grid definition for the spatial references.

Use the ISpatialReference2.IsXY/Z/MPrecisionEqual methods to compare coordinate grid information.

Use the ISpatialReferenceTolerance.IsXY/Z/MToleranceEqual methods to compare the various cluster tolerances for the spatial references.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

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

Returns:

The isXYPrecisionEqual

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

isMPrecisionEqual

boolean isMPrecisionEqual(ISpatialReference otherSR)
                          throws IOException,
                                 AutomationException

Deprecated.

Returns true if the measure precisions of the two spatial references are the same.

Description

Compares the measure precisions (resolutions) . Both spatial references must be of the same type (both PCS, both GCS, etc).

Remarks

The IClone::IsEqual method for PCSs and GCSs compares only the projection information (projection, spheroid, projected units, etc.). It does not compare any properties related to the coordinate grid definition for the spatial references.

Use the ISpatialReference2.IsXY/Z/MPrecisionEqual methods to compare coordinate grid information.

Use the ISpatialReferenceTolerance.IsXY/Z/MToleranceEqual methods to compare the various cluster tolerances for the spatial references.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

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

Returns:

The isMPrecisionEqual

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

isZPrecisionEqual

boolean isZPrecisionEqual(ISpatialReference otherSR)
                          throws IOException,
                                 AutomationException

Deprecated.

Returns true if the Z precisions of the two spatial references are the same.

Description

Compares the Z precisions (resolutions). Both srs must be of the same type (both GCS, both PCS, etc).

Remarks

The IClone::IsEqual method for PCSs and GCSs compares only the projection information (projection, spheroid, projected units, etc.). It does not compare any properties related to the coordinate grid definition for the spatial references.

Use the ISpatialReference2.IsXY/Z/MPrecisionEqual methods to compare coordinate grid information.

Use the ISpatialReferenceTolerance.IsXY/Z/MToleranceEqual methods to compare the various cluster tolerances for the spatial references.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

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

Returns:

The isZPrecisionEqual

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

applyXYPrecision

void applyXYPrecision(int cPoints,
                      _WKSPoint points)
                      throws IOException,
                             AutomationException

Deprecated.

Applies the XY precision.

Description

The ApplyXYPrecision method snaps XY coordinate values to the spatial reference's coordinate grid. Normally, the geodatabase calls this method when appropriate, however you may need to use it when comparing locally generated coordinates against features coming from a geodatabase.

Remarks

The cPoints value is the number of points to which you wish to apply the XY precision (1/resolution). A WKSPoint is a structure that contains the X and Y values of a coordinate pair.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

cPoints - The cPoints (in)

points - A Structure: com.esri.arcgis.system._WKSPoint (A com.esri.arcgis.system._WKSPoint COM typedef) (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

applyPrecision

void applyPrecision(int cPoints,
                    _WKSPoint points,
                    double[] ms,
                    double[] zs)
                    throws IOException,
                           AutomationException

Deprecated.

Applies the measure and z value precisions.

Description

The ApplyPrecision method snaps measure or z values to the spatial reference grid. Each SpatialReference has an extent and a resolution (1/precision) for the xy, z, and measure values. You can set this information with the SetZDomain, SetMDomain, SetZFalseOriginAndUnits or the SetMFalseOriginAndUnits methods. If you use a Domain method, the resolution (1/precision) is calculated from the given extent. The FalseOriginAndUnits methods sets the lower bound of the extent and explicitly defines the precision (units, or 1/resolution) of the spatial reference.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

cPoints - The cPoints (in)

points - A Structure: com.esri.arcgis.system._WKSPoint (A com.esri.arcgis.system._WKSPoint COM typedef) (in)

ms - The ms (in)

zs - The zs (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.