com.esri.arcgis.geometry
Interface IProjectedCoordinateSystem

All Superinterfaces:
ISpatialReference, ISpatialReferenceInfo, Serializable
All Known Subinterfaces:
IProjectedCoordinateSystem2, IProjectedCoordinateSystem3, IProjectedCoordinateSystem4, IProjectedCoordinateSystem5
All Known Implementing Classes:
ProjectedCoordinateSystem

public interface IProjectedCoordinateSystem
extends ISpatialReference, Serializable

Provides access to members that control the properties and methods for all projected coordinate systems.

Superseded By

IProjectedCoordinateSystem5

Product Availability

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


Method Summary
 void forward(int count, _WKSPoint points)
          Projects points from geographic to planar coordinates.
 double getAzimuth()
          The azimuth of a projected coordinate system.
 double getCentralMeridian(boolean inDegrees)
          The central meridian (Lambda0) of a projected coordinate system.
 double getCentralParallel()
          The central parallel (Phi 0) of a projected coordinate system.
 ILinearUnit getCoordinateUnit()
          The linear unit of a projected coordinate system.
 double getFalseEasting()
          The false easting (X0) of a projected coordinate system.
 double getFalseNorthing()
          The false northing (Y0) of a projected coordinate system.
 IGeographicCoordinateSystem getGeographicCoordinateSystem()
          The geographic coordinate system of a projected coordinate system.
 esriSRHorizon getHorizon(int horizonIndex)
          The mathematical limits of a projected coordinate system.
 int getHorizonCount()
          The number of shapes that describe the limits of a ProjCS.
 double getLatitudeOf1st()
          The latitude of the first point (Phi 1) of a projected coordinate system.
 double getLatitudeOf2nd()
          The latitude of the second point (Phi 2) of a projected coordinate system.
 double getLongitudeOf1st()
          The longitude of the first point (Lambda 1) of a projected coordinate system.
 double getLongitudeOf2nd()
          The longitude of the second point (Lambda 2) of a projected coordinate system.
 double getLongitudeOfOrigin()
          The longitude of origin (Lambda0) of a projected coordinate system.
 void getParameters(IParameter[] parameters)
          Deprecated. This method uses C style arrays which is not supported in the Java API for ArcObjects. It is replaced by IProjectedCoordinateSystem4GEN.getParameters(com.esri.arcgis.geometry.IParameter[][]).
 IProjection getProjection()
          The map projection of a projected coordinate system.
 double getScaleFactor()
          The scale factor (K0) of a projected coordinate system.
 double getStandardParallel1()
          The first parallel (Phi 1) of a projected coordinate system.
 double getStandardParallel2()
          The second parallel (Phi 2) of a projected coordinate system.
 String getUsage()
          The usage notes of a projected coordinate system.
 void inverse(int count, _WKSPoint points)
          Projects points from planar to geographic coordinates.
 void setAzimuth(double azimuth)
          The azimuth of a projected coordinate system.
 void setCentralMeridian(boolean inDegrees, double centralMeridian)
          The central meridian (Lambda0) of a projected coordinate system.
 void setCentralParallel(double centralParallel)
          The central parallel (Phi 0) of a projected coordinate system.
 void setFalseEasting(double falseEasting)
          The false easting (X0) of a projected coordinate system.
 void setFalseNorthing(double falseNorthing)
          The false northing (Y0) of a projected coordinate system.
 void setLatitudeOf1st(double standardLongitude1)
          The latitude of the first point (Phi 1) of a projected coordinate system.
 void setLatitudeOf2nd(double latitudeOf2nd)
          The latitude of the second point (Phi 2) of a projected coordinate system.
 void setLongitudeOf1st(double longitudeOf1st)
          The longitude of the first point (Lambda 1) of a projected coordinate system.
 void setLongitudeOf2nd(double longitudeOf2nd)
          The longitude of the second point (Lambda 2) of a projected coordinate system.
 void setLongitudeOfOrigin(double longitudeOfOrigin)
          The longitude of origin (Lambda0) of a projected coordinate system.
 void setScaleFactor(double scaleFactor)
          The scale factor (K0) of a projected coordinate system.
 void setStandardParallel1(double standardParallel1)
          The first parallel (Phi 1) of a projected coordinate system.
 void setStandardParallel2(double standardParallel2)
          The second parallel (Phi 2) of a projected coordinate system.
 
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

getUsage

String getUsage()
                throws IOException,
                       AutomationException
The usage notes of a projected coordinate system.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:
The usage
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getGeographicCoordinateSystem

IGeographicCoordinateSystem getGeographicCoordinateSystem()
                                                          throws IOException,
                                                                 AutomationException
The geographic coordinate system of a projected coordinate system.

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.IGeographicCoordinateSystem
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getProjection

IProjection getProjection()
                          throws IOException,
                                 AutomationException
The map projection of a projected coordinate system.

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.IProjection
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getParameters

void getParameters(IParameter[] parameters)
                   throws IOException,
                          AutomationException
Deprecated. This method uses C style arrays which is not supported in the Java API for ArcObjects. It is replaced by IProjectedCoordinateSystem4GEN.getParameters(com.esri.arcgis.geometry.IParameter[][]).

Gets the map projection parameters of a projected coordinate system.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:
parameters - A reference to a com.esri.arcgis.geometry.IParameter (out: use single element array)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getCoordinateUnit

ILinearUnit getCoordinateUnit()
                              throws IOException,
                                     AutomationException
The linear unit of a projected coordinate system.

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.ILinearUnit
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

forward

void forward(int count,
             _WKSPoint points)
             throws IOException,
                    AutomationException
Projects points from geographic to planar coordinates.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:
count - The count (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.

inverse

void inverse(int count,
             _WKSPoint points)
             throws IOException,
                    AutomationException
Projects points from planar to geographic coordinates.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:
count - The count (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.

getHorizonCount

int getHorizonCount()
                    throws IOException,
                           AutomationException
The number of shapes that describe the limits of a ProjCS.

Description

Returns 1 if the horizon is an envelope.

Remarks

Obsolete. Use IProjectedCoordinateSystem2::GetHorizon.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:
The horizonCount
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getHorizon

esriSRHorizon getHorizon(int horizonIndex)
                         throws IOException,
                                AutomationException
The mathematical limits of a projected coordinate system.

Product Availability

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

Parameters:
horizonIndex - The horizonIndex (in)
Returns:
A Structure: com.esri.arcgis.geometry.esriSRHorizon
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getCentralMeridian

double getCentralMeridian(boolean inDegrees)
                          throws IOException,
                                 AutomationException
The central meridian (Lambda0) of a projected coordinate system.

Product Availability

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

Parameters:
inDegrees - The inDegrees (in)
Returns:
The centralMeridian
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setCentralMeridian

void setCentralMeridian(boolean inDegrees,
                        double centralMeridian)
                        throws IOException,
                               AutomationException
The central meridian (Lambda0) of a projected coordinate system.

Product Availability

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

Parameters:
inDegrees - The inDegrees (in)
centralMeridian - The centralMeridian (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getLongitudeOfOrigin

double getLongitudeOfOrigin()
                            throws IOException,
                                   AutomationException
The longitude of origin (Lambda0) of a projected coordinate system.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:
The longitudeOfOrigin
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setLongitudeOfOrigin

void setLongitudeOfOrigin(double longitudeOfOrigin)
                          throws IOException,
                                 AutomationException
The longitude of origin (Lambda0) of a projected coordinate system.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:
longitudeOfOrigin - The longitudeOfOrigin (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getLatitudeOf1st

double getLatitudeOf1st()
                        throws IOException,
                               AutomationException
The latitude of the first point (Phi 1) of a projected coordinate system.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:
The standardLongitude1
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setLatitudeOf1st

void setLatitudeOf1st(double standardLongitude1)
                      throws IOException,
                             AutomationException
The latitude of the first point (Phi 1) of a projected coordinate system.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:
standardLongitude1 - The standardLongitude1 (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getLatitudeOf2nd

double getLatitudeOf2nd()
                        throws IOException,
                               AutomationException
The latitude of the second point (Phi 2) of a projected coordinate system.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:
The latitudeOf2nd
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setLatitudeOf2nd

void setLatitudeOf2nd(double latitudeOf2nd)
                      throws IOException,
                             AutomationException
The latitude of the second point (Phi 2) of a projected coordinate system.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:
latitudeOf2nd - The latitudeOf2nd (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getFalseEasting

double getFalseEasting()
                       throws IOException,
                              AutomationException
The false easting (X0) of a projected coordinate system.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:
The falseEasting
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setFalseEasting

void setFalseEasting(double falseEasting)
                     throws IOException,
                            AutomationException
The false easting (X0) of a projected coordinate system.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:
falseEasting - The falseEasting (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getFalseNorthing

double getFalseNorthing()
                        throws IOException,
                               AutomationException
The false northing (Y0) of a projected coordinate system.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:
The falseNorthing
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setFalseNorthing

void setFalseNorthing(double falseNorthing)
                      throws IOException,
                             AutomationException
The false northing (Y0) of a projected coordinate system.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:
falseNorthing - The falseNorthing (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getCentralParallel

double getCentralParallel()
                          throws IOException,
                                 AutomationException
The central parallel (Phi 0) of a projected coordinate system.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:
The centralParallel
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setCentralParallel

void setCentralParallel(double centralParallel)
                        throws IOException,
                               AutomationException
The central parallel (Phi 0) of a projected coordinate system.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:
centralParallel - The centralParallel (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getStandardParallel1

double getStandardParallel1()
                            throws IOException,
                                   AutomationException
The first parallel (Phi 1) of a projected coordinate system.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:
The standardParallel1
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setStandardParallel1

void setStandardParallel1(double standardParallel1)
                          throws IOException,
                                 AutomationException
The first parallel (Phi 1) of a projected coordinate system.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:
standardParallel1 - The standardParallel1 (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getStandardParallel2

double getStandardParallel2()
                            throws IOException,
                                   AutomationException
The second parallel (Phi 2) of a projected coordinate system.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:
The standardParallel2
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setStandardParallel2

void setStandardParallel2(double standardParallel2)
                          throws IOException,
                                 AutomationException
The second parallel (Phi 2) of a projected coordinate system.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:
standardParallel2 - The standardParallel2 (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getLongitudeOf1st

double getLongitudeOf1st()
                         throws IOException,
                                AutomationException
The longitude of the first point (Lambda 1) of a projected coordinate system.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:
The longitudeOf1st
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setLongitudeOf1st

void setLongitudeOf1st(double longitudeOf1st)
                       throws IOException,
                              AutomationException
The longitude of the first point (Lambda 1) of a projected coordinate system.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:
longitudeOf1st - The longitudeOf1st (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getLongitudeOf2nd

double getLongitudeOf2nd()
                         throws IOException,
                                AutomationException
The longitude of the second point (Lambda 2) of a projected coordinate system.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:
The longitudeOf2nd
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setLongitudeOf2nd

void setLongitudeOf2nd(double longitudeOf2nd)
                       throws IOException,
                              AutomationException
The longitude of the second point (Lambda 2) of a projected coordinate system.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:
longitudeOf2nd - The longitudeOf2nd (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getScaleFactor

double getScaleFactor()
                      throws IOException,
                             AutomationException
The scale factor (K0) of a projected coordinate system.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:
The scaleFactor
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setScaleFactor

void setScaleFactor(double scaleFactor)
                    throws IOException,
                           AutomationException
The scale factor (K0) of a projected coordinate system.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:
scaleFactor - The scaleFactor (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getAzimuth

double getAzimuth()
                  throws IOException,
                         AutomationException
The azimuth of a projected coordinate system.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:
The azimuth
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setAzimuth

void setAzimuth(double azimuth)
                throws IOException,
                       AutomationException
The azimuth of a projected coordinate system.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:
azimuth - The azimuth (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.