com.esri.arcgis.geometry
Interface IPRJSpatialReference

All Superinterfaces:

Serializable

All Known Implementing Classes:

GeographicCoordinateSystem, ProjectedCoordinateSystem

public interface IPRJSpatialReference
extends Serializable

Provides access to members that control the import/export operations components of a spatial reference system. IPRJSpatialReference has been deprecated and IPRJSpatialReferenceGEN should be used.

Superseded By

IPRJSpatialReferenceGEN

Product Availability

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

Method Summary

void	exportSpatialReferenceToPRJ(String[] str, int[] cBytesWrote) Exports the spatial reference to a buffer.
int	getPRJSpatialReferenceSize() The number of bytes required to hold the persistant representation of the spatial reference.
void	importSpatialReferenceFromPRJ(String str, int[] cBytesRead) Defines the spatial reference from the specified ESRISpatialReference buffer.

Method Detail

getPRJSpatialReferenceSize

int getPRJSpatialReferenceSize()
                               throws IOException,
                                      AutomationException

The number of bytes required to hold the persistant representation of the spatial reference.

Description

Returns the size in bytes needed for a string representation of a PRJ file. A sample represetation (reformatted for display) is below.

Projection    UTM   

Zone          10  

Datum         NAD83     

Zunits        NO     

Units         METERS     

Spheroid      GRS1980     

Xshift        0.0000000000     

Yshift        0.0000000000  

Parameters    

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:

The cBytes

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

importSpatialReferenceFromPRJ

void importSpatialReferenceFromPRJ(String str,
                                   int[] cBytesRead)
                                   throws IOException,
                                          AutomationException

Defines the spatial reference from the specified ESRISpatialReference buffer.

Description

Converts a PRJ file into a spatial reference object. A PRJ file stores the coordinate system information for a coverage, GRID, or TIN.

A sample represetation (reformatted for display) is below.

Projection    UTM   

Zone          10  

Datum         NAD83     

Zunits        NO     

Units         METERS     

Spheroid      GRS1980     

Xshift        0.0000000000     

Yshift        0.0000000000  

Parameters    

Remarks

Not implemented for the GeographicCoordinateSystem or ProjectedCoordinateSystem coclasses. Use the ISpatialReferenceFactory:CreateESRISpatialReferenceFromPRJ method instead.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

str - The str (in)

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

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

exportSpatialReferenceToPRJ

void exportSpatialReferenceToPRJ(String[] str,
                                 int[] cBytesWrote)
                                 throws IOException,
                                        AutomationException

Exports the spatial reference to a buffer.

Description

Converts a spatial reference object into a PRJ file. A PRJ file stores the coordinate system information for a coverage, GRID, or TIN.

A sample representation (reformatted for display) is below.

Projection    UTM   

Zone          10  

Datum         NAD83     

Zunits        NO     

Units         METERS     

Spheroid      GRS1980     

Xshift        0.0000000000     

Yshift        0.0000000000  

Parameters    

If the spatial reference cannot be represented with the workstation PRJ format, E_SPATIALREFERENCE_CANTDEFINESR is returned.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

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

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

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.