ilog.views.maps.projection

Class IlvEquidistantCylindricalProjection

java.lang.Object

ilog.views.maps.projection.IlvProjection

ilog.views.maps.projection.IlvEquidistantCylindricalProjection

All Implemented Interfaces:

IlvPersistentObject, Serializable

public class IlvEquidistantCylindricalProjection
extends IlvProjection

This class defines the Equidistant Cylindrical projection. A cylindrical projection is obtained by wrapping a large, flat plane around the globe to form a cylinder. The Equidistant Cylindrical projection simply multiplies the latitudes and longitudes by a scale factor. The latitude of the true scale can be specified.

Equidistant Cylindrical projections are also known as:

• EquiRectangular Projection
• Plate Caree

This type of projection does not support non-spherical ellipsoids and is neither Conformal nor Equal Area.

See Also:

Serialized Form

Field Summary

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

CONFORMAL, EQUAL_AREA, NONE

Constructor Summary

Constructors

Constructor and Description
IlvEquidistantCylindricalProjection() Creates an instance of the class IlvEquidistantCylindricalProjection
IlvEquidistantCylindricalProjection(IlvEquidistantCylindricalProjection source) Creates a new IlvCylindricalEqualAreaProjection by copying an existing one.
IlvEquidistantCylindricalProjection(IlvInputStream stream) Reads the object from an IlvInputStream.

Method Summary

Modifier and Type	Method and Description
IlvProjection	copy() Copies the projection.
double	getLatitudeOfTrueScale() Returns the latitude of the true scale.
void	setLatitudeOfTrueScale(double latitudeOfTrueScale) Sets the latitude of the true scale.
protected void	sForward(IlvCoordinate ll) Implements the projection for a sphere.
protected void	sInverse(IlvCoordinate xy) Implements the inverse projection for a sphere.
String	toString() Converts the projection to a string with Evenden's format.
void	write(IlvOutputStream stream) Writes the object to an IlvOutputStream.

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

addDescription, adjustLongitude, 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

Methods inherited from class java.lang.Object

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

Constructor Detail

IlvEquidistantCylindricalProjection

public IlvEquidistantCylindricalProjection()

Creates an instance of the class IlvEquidistantCylindricalProjection

IlvEquidistantCylindricalProjection

public IlvEquidistantCylindricalProjection(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

IlvEquidistantCylindricalProjection

public IlvEquidistantCylindricalProjection(IlvEquidistantCylindricalProjection source)

Creates a new IlvCylindricalEqualAreaProjection by copying an existing one.

Parameters:

source - the projection that is copied.

Since:

JViews 3.0

Method Detail

copy

public IlvProjection copy()

Copies the projection.

Specified by:

copy in class IlvProjection

Returns:

a copy of the projection.

Since:

JViews 3.0

sForward

protected void sForward(IlvCoordinate ll)

Implements the projection for a sphere.

Specified by:

sForward in class IlvProjection

Parameters:

ll - the longitude/latitude coordinates in radians (x = longitude, y = latitude)

sInverse

protected void sInverse(IlvCoordinate xy)

Implements the inverse projection for a sphere.

Overrides:

sInverse in class IlvProjection

Parameters:

xy - the Cartesian coordinates.

See Also:

IlvProjection.inverse(ilog.views.IlvPoint), IlvProjection.isInverseEnabled()

setLatitudeOfTrueScale

public void setLatitudeOfTrueScale(double latitudeOfTrueScale)

Sets the latitude of the true scale.

Parameters:

latitudeOfTrueScale - the latitude in radians

getLatitudeOfTrueScale

public final double getLatitudeOfTrueScale()

Returns the latitude of the true scale.

Returns:

the latitude of the true scale in radians.

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

toString

public String toString()

Converts the projection to a string with Evenden's format.

Overrides:

toString in class Object