com.esri.arcgis.geometry
Interface IProjectedCoordinateSystem2

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

public interface IProjectedCoordinateSystem2
extends IProjectedCoordinateSystem, Serializable

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

Superseded By

IProjectedCoordinateSystem5

Product Availability

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

Supported Platforms

Windows, Solaris, Linux


Method Summary
 void getGCSParams(double[] p_180, double[] pDelta)
          Returns 180 degrees and horizon delta in proper GCS units.
 IGeometry getHorizon(_WKSEnvelope[] horizonEnvelope, boolean[] inclusive)
          Returns the standard horizon polygon, its envelope, and whether it is inclusive or exclusive; the horizon polygon may be 0.
 double getLatitudeOfCenter()
          The latitude of center (Phi C) of a projected coordinate system.
 double getLatitudeOfOrigin()
          The latitude of the origin (Phi 0) of a projected coordinate system.
 double getLongitudeOfCenter()
          The longitude of center (Lam C) of a projected coordinate system.
 double getPseudoStandardParallel1()
          The latitude on an oblique spheroid that defines the oblique cone for a Krovak projected coordinate system.
 double getRotation()
          The rotation value used to change the axis directions in a Krovak projected coordinate system.
 IGeometry getShiftedHorizon(int shift)
          Returns the horizon polygon, shifted once or twice, west/east of the standard horizon for a negative/positive shift.
 double getXScaleFactor()
          The X axis scale value used to flip the axis direction in a Krovak projected coordinate system.
 double getYScaleFactor()
          The Y axis scale value used to flip the axis direction in a Krovak projected coordinate system.
 void inverseWithShift(double shift, int count, _WKSPoint points)
          Projects points from planar to geographic coordinates.
 boolean isEqualNoNames(IProjectedCoordinateSystem pOther)
          Compares to projected coordinate systems for equality but ignores their names.
 void putLinearAndAngularUnits(ILinearUnit linearUnit, IAngularUnit angularUnit)
          Modify linear unit of projected coordinates and angular unit of associated geographic coordinates.
 void setLatitudeOfCenter(double latitudeOfCenter)
          The latitude of center (Phi C) of a projected coordinate system.
 void setLatitudeOfOrigin(double latitudeOfOrigin)
          The latitude of the origin (Phi 0) of a projected coordinate system.
 void setLongitudeOfCenter(double longitudeOfCenter)
          The longitude of center (Lam C) of a projected coordinate system.
 void setPseudoStandardParallel1(double psp1)
          The latitude on an oblique spheroid that defines the oblique cone for a Krovak projected coordinate system.
 void setRotation(double r)
          The rotation value used to change the axis directions in a Krovak projected coordinate system.
 void setXScaleFactor(double xs)
          The X axis scale value used to flip the axis direction in a Krovak projected coordinate system.
 void setYScaleFactor(double ys)
          The Y axis scale value used to flip the axis direction in a Krovak projected coordinate system.
 
Methods inherited from interface com.esri.arcgis.geometry.IProjectedCoordinateSystem
forward, getAzimuth, getCentralMeridian, getCentralParallel, getCoordinateUnit, getFalseEasting, getFalseNorthing, getGeographicCoordinateSystem, getHorizon, getHorizonCount, getLatitudeOf1st, getLatitudeOf2nd, getLongitudeOf1st, getLongitudeOf2nd, getLongitudeOfOrigin, getParameters, getProjection, getScaleFactor, getStandardParallel1, getStandardParallel2, getUsage, inverse, setAzimuth, setCentralMeridian, setCentralParallel, setFalseEasting, setFalseNorthing, setLatitudeOf1st, setLatitudeOf2nd, setLongitudeOf1st, setLongitudeOf2nd, setLongitudeOfOrigin, setScaleFactor, setStandardParallel1, setStandardParallel2
 
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

getLongitudeOfCenter

double getLongitudeOfCenter()
                            throws IOException,
                                   AutomationException
The longitude of center (Lam C) of a projected coordinate system.

Remarks

The longitude of center projection parameter is used by the Hotine Oblique Mercator (Azimuth) and Krovak projections. It defines the longitude that is at the center of the projection. It is usually but not always the origin of the X values.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

setLongitudeOfCenter

void setLongitudeOfCenter(double longitudeOfCenter)
                          throws IOException,
                                 AutomationException
The longitude of center (Lam C) of a projected coordinate system.

Remarks

The longitude of center projection parameter is used by the Hotine Oblique Mercator (Azimuth) and Krovak projections. It defines the longitude that is at the center of the projection. It is usually but not always the origin of the X values.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

getLatitudeOfCenter

double getLatitudeOfCenter()
                           throws IOException,
                                  AutomationException
The latitude of center (Phi C) of a projected coordinate system.

Remarks

The latitude of center projection parameter is used by the Hotine Oblique Mercator (Azimuth) and Krovak projections. It defines the latitude that is at the center of the projection. It is usually but not always the origin of the Y values.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

setLatitudeOfCenter

void setLatitudeOfCenter(double latitudeOfCenter)
                         throws IOException,
                                AutomationException
The latitude of center (Phi C) of a projected coordinate system.

Remarks

The latitude of center projection parameter is used by the Hotine Oblique Mercator (Azimuth) and Krovak projections. It defines the latitude that is at the center of the projection. It is usually but not always the origin of the Y values.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

getGCSParams

void getGCSParams(double[] p_180,
                  double[] pDelta)
                  throws IOException,
                         AutomationException
Returns 180 degrees and horizon delta in proper GCS units.

Description

GetGCSParams calculates the edge of the horizon for a geographic coordinate system. For example, if your coordinate system is in decimal degrees, 180 is returned. If the units are in grads, 200 is returned. It also returns a delta, a small offset value, in the correct unit of measure.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:
p_180 - The p_180 (out: use single element array)
pDelta - The pDelta (out: use single element array)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getHorizon

IGeometry getHorizon(_WKSEnvelope[] horizonEnvelope,
                     boolean[] inclusive)
                     throws IOException,
                            AutomationException
Returns the standard horizon polygon, its envelope, and whether it is inclusive or exclusive; the horizon polygon may be 0.

Remarks

GetHorizon returns, in geographic coordinate system coordinates and unit of measure, the valid geometry of a projected coordinate system. The method also returns whether the geometry should be considered inclusive or exclusive, and its envelope.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:
horizonEnvelope - A Structure: com.esri.arcgis.system._WKSEnvelope (A com.esri.arcgis.system._WKSEnvelope COM typedef) (out: use single element array)
inclusive - The inclusive (out: use single element array)
Returns:
A reference to a com.esri.arcgis.geometry.IGeometry
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getShiftedHorizon

IGeometry getShiftedHorizon(int shift)
                            throws IOException,
                                   AutomationException
Returns the horizon polygon, shifted once or twice, west/east of the standard horizon for a negative/positive shift.

Remarks

The standard horizon is the valid area of a projected coordinate system, but in geographic coordinate system coordinates and unit of measure. The standard horizon usually has longitude values between +/-180 (or equivalent). If you use -2, -1, 1 or 2 for the shift value, GetShiftedHorizon will translate the horizon by 360 degrees to the left or right.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:
shift - The shift (in)
Returns:
A reference to a com.esri.arcgis.geometry.IGeometry
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getPseudoStandardParallel1

double getPseudoStandardParallel1()
                                  throws IOException,
                                         AutomationException
The latitude on an oblique spheroid that defines the oblique cone for a Krovak projected coordinate system.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

setPseudoStandardParallel1

void setPseudoStandardParallel1(double psp1)
                                throws IOException,
                                       AutomationException
The latitude on an oblique spheroid that defines the oblique cone for a Krovak projected coordinate system.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

getXScaleFactor

double getXScaleFactor()
                       throws IOException,
                              AutomationException
The X axis scale value used to flip the axis direction in a Krovak projected coordinate system.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

setXScaleFactor

void setXScaleFactor(double xs)
                     throws IOException,
                            AutomationException
The X axis scale value used to flip the axis direction in a Krovak projected coordinate system.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

getYScaleFactor

double getYScaleFactor()
                       throws IOException,
                              AutomationException
The Y axis scale value used to flip the axis direction in a Krovak projected coordinate system.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

setYScaleFactor

void setYScaleFactor(double ys)
                     throws IOException,
                            AutomationException
The Y axis scale value used to flip the axis direction in a Krovak projected coordinate system.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

getRotation

double getRotation()
                   throws IOException,
                          AutomationException
The rotation value used to change the axis directions in a Krovak projected coordinate system.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

setRotation

void setRotation(double r)
                 throws IOException,
                        AutomationException
The rotation value used to change the axis directions in a Krovak projected coordinate system.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

inverseWithShift

void inverseWithShift(double shift,
                      int count,
                      _WKSPoint points)
                      throws IOException,
                             AutomationException
Projects points from planar to geographic coordinates. Deals with geographic coordinates in ranges other than +-180.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

putLinearAndAngularUnits

void putLinearAndAngularUnits(ILinearUnit linearUnit,
                              IAngularUnit angularUnit)
                              throws IOException,
                                     AutomationException
Modify linear unit of projected coordinates and angular unit of associated geographic coordinates.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:
linearUnit - A reference to a com.esri.arcgis.geometry.ILinearUnit (in)
angularUnit - A reference to a com.esri.arcgis.geometry.IAngularUnit (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getLatitudeOfOrigin

double getLatitudeOfOrigin()
                           throws IOException,
                                  AutomationException
The latitude of the origin (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 latitudeOfOrigin
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setLatitudeOfOrigin

void setLatitudeOfOrigin(double latitudeOfOrigin)
                         throws IOException,
                                AutomationException
The latitude of the origin (Phi 0) of a projected coordinate system.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

isEqualNoNames

boolean isEqualNoNames(IProjectedCoordinateSystem pOther)
                       throws IOException,
                              AutomationException
Compares to projected coordinate systems for equality but ignores their names.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:
pOther - A reference to a com.esri.arcgis.geometry.IProjectedCoordinateSystem (in)
Returns:
The equalNoNames
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.