ilog.views.maps.projection

Class IlvConicProjection

java.lang.Object

ilog.views.maps.projection.IlvProjection

ilog.views.maps.projection.IlvConicProjection

All Implemented Interfaces:

IlvPersistentObject, Serializable

Direct Known Subclasses:

IlvAlbersEqualAreaProjection, IlvLambertConformalConicProjection

public abstract class IlvConicProjection
extends IlvProjection

This is the base class for all the conic projections in the package. A conic projection transfers the image of the globe to a cone, either secant or tangent, to the surface of the earth. The latitudes at which the cone intersects with the globe can be specified with the function setSecantLatitudes(IlvCoordinate secant). The secant parameter is a vector that contains two values: secant.x, which represents the first latitude lat1, and secant.y, which represents the second latitude lat2. When the cone is tangent to the earth, lat1 equals lat2.

The cylindrical (lat1 = -lat2) or azimuthal (lat1 = lat2 = 90 degrees) limiting forms of the conic projections should not be used.

See Also:

Serialized Form

Field Summary

Fields inherited from class ilog.views.maps.projection.IlvProjection

CONFORMAL, EQUAL_AREA, NONE

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	IlvConicProjection(boolean ellipsoidEnabled, boolean inverseEnabled, int property) Creates a new instance of the class IlvConicProjection.
protected	IlvConicProjection(IlvConicProjection source) Creates a new IlvConicProjection by copying an existing one.
protected	IlvConicProjection(IlvInputStream stream) Reads the object from an IlvInputStream.

Method Summary

Modifier and Type	Method and Description
protected void	addDescription(StringBuffer buffer) Converts the projection into a String (Evenden's format).
double	getSecantLatitude1() Returns the first latitude at which the cone intersects with the earth.
double	getSecantLatitude2() Returns the second latitude at which the cone intersects with the earth.
IlvCoordinate	getSecantLatitudes() Returns a new IlvCoordinate that contains the latitudes at which the cone intersects with the earth.
void	setSecantLatitude1(double secantLat1) Sets the first latitude at which the cone intersects with the earth.
void	setSecantLatitude2(double secantLat2) Sets the second latitude at which the cone intersects with the earth.
void	setSecantLatitudes(IlvCoordinate secant) Sets the latitudes at which the cone intersects with the earth.
void	write(IlvOutputStream stream) Writes the object to an IlvOutputStream.

Methods inherited from class ilog.views.maps.projection.IlvProjection

adjustLongitude, copy, eForward, eInverse, equals, forward, forward, getCentralMeridian, getCentralParallel, getDatum, getEllipsoid, getFalseEasting, getFalseNorthing, GetProjection, getProperty, getUnit, getXYOffset, inverse, inverse, inverse, isEllipsoidEnabled, isGeocentric, isInverseEnabled, isUsingLongitudeReduction, setCentralMeridian, setCentralParallel, setDatum, setEllipsoid, setFalseEasting, setFalseNorthing, setGeocentric, setLLCenter, setUnit, setUsingLongitudeReduction, setXYOffset, sForward, sInverse

Methods inherited from class java.lang.Object

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

Constructor Detail

IlvConicProjection

protected IlvConicProjection(boolean ellipsoidEnabled,
                             boolean inverseEnabled,
                             int property)

Creates a new instance of the class IlvConicProjection.

Parameters:

ellipsoidEnabled - true if non-spherical ellipsoids can be used for the projection. Projections supporting non-spherical ellipsoids should implement the eForward function.

inverseEnabled - true if the projection implements an inverse function. Projections implementing an inverse function should implement the sInverse and the eInverse functions if ellipsoids are supported.

property - the property of the projection (NONE, CONFORMAL, EQUAL_AREA)

IlvConicProjection

protected IlvConicProjection(IlvInputStream stream)
                      throws IlvReadFileException

Reads the object from an IlvInputStream.

Parameters:

stream - the input stream.

Throws:

IlvReadFileException - if the format is not correct.

Since:

JViews 3.0

IlvConicProjection

protected IlvConicProjection(IlvConicProjection source)

Creates a new IlvConicProjection by copying an existing one.

Parameters:

source - the graphic object that is copied.

Since:

JViews 3.0

Method Detail

setSecantLatitudes

public void setSecantLatitudes(IlvCoordinate secant)
                        throws IlvBadProjectionParameter

Sets the latitudes at which the cone intersects with the earth.

Parameters:

secant - vector containing two values: secant.x for the first latitude and secant.y for the second latitude. Both these values are expressed in radians.

Throws:

IlvBadProjectionParameter - if the latitudes specify a limiting form, that is, secant.x = -secant.y or secant.x = secant.y = PI/2

setSecantLatitude1

public void setSecantLatitude1(double secantLat1)
                        throws IlvBadProjectionParameter

Sets the first latitude at which the cone intersects with the earth.

Parameters:

secantLat1 - the secant latitude expressed in radians.

Throws:

IlvBadProjectionParameter - if the secant latitude specifies a limiting form of the conic projection.

See Also:

setSecantLatitudes(ilog.views.maps.IlvCoordinate)

setSecantLatitude2

public void setSecantLatitude2(double secantLat2)
                        throws IlvBadProjectionParameter

Sets the second latitude at which the cone intersects with the earth.

Parameters:

secantLat2 - the secant latitude expressed in radians.

Throws:

IlvBadProjectionParameter - if the secant latitude specifies a limiting form of the conic projection.

See Also:

setSecantLatitudes(ilog.views.maps.IlvCoordinate)

getSecantLatitude1

public double getSecantLatitude1()

Returns the first latitude at which the cone intersects with the earth.

getSecantLatitude2

public double getSecantLatitude2()

Returns the second latitude at which the cone intersects with the earth.

getSecantLatitudes

public IlvCoordinate getSecantLatitudes()

Returns a new IlvCoordinate that contains the latitudes at which the cone intersects with the earth.

addDescription

protected void addDescription(StringBuffer buffer)

Converts the projection into a String (Evenden's format).

Overrides:

addDescription in class IlvProjection

Since:

JViews 7.5

write

public void write(IlvOutputStream stream)
           throws IOException

Writes the object to an IlvOutputStream.

Specified by:

write in interface IlvPersistentObject

Overrides:

write in class IlvProjection

Parameters:

stream - the output stream.

Throws:

IOException - thrown when an exception occurs during the write operation for this object.

Since:

JViews 3.0