com.luciad.projection

LuciadFusionClass ALcdAzimuthal

java.lang.Object

com.luciad.projection.ALcdProjection

com.luciad.projection.ALcdAzimuthal

All Implemented Interfaces:

ILcdAzimuthal, ILcdProjection, ILcdPropertyChangeSource, Serializable, Cloneable

Direct Known Subclasses:

TLcdAzimuthalEquidistant, TLcdDutchStereographic, TLcdGnomonic, TLcdLambertAzimuthalEqualArea, TLcdOrthographic, TLcdStereographic

public abstract class ALcdAzimuthal
extends ALcdProjection
implements ILcdAzimuthal, Cloneable

ALcdAzimuthal projections are ILcdProjection objects that have a central point of zero distortion. This central point is the origin of the ALcdAzimuthal. The azimuth (direction) from the origin point to any other point on the map is shown correctly.

An ALcdAzimuthal has an origin which is expressed in lat-lon coordinates.

Tangent plane projections are examples of ALcdAzimuthal.

See Also:

Serialized Form

Field Summary

Fields inherited from class com.luciad.projection.ALcdProjection

fPropertyChangeDispatcher

Fields inherited from interface com.luciad.projection.ILcdProjection

EPSILON

Constructor Summary

Constructors

Constructor and Description
ALcdAzimuthal()

Method Summary

Modifier and Type	Method and Description
protected void	calculateCachedValues() Constants based on the point of origin of the projection don't have to be recalculated every time a method is called.
Object	clone() Makes a deep clone of this ILcdProjection.
boolean	equals(Object aObject) Checks if this ILcdProjection equals some other Object.
ILcdPoint	getOrigin() Origin of the projection is the ILcd2DEditablePoint that corresponds with origin (0, 0) of the cartesian coordinate system of the projection.
double	getOriginLat() Gets the latitude of the origin.
double	getOriginLon() Gets the longitude of the origin.
int	hashCode()
boolean	isContinuous() An ILcdProjection is continuous if there are no interruptions in the world coordinates.
void	loadProperties(String aPrefix, Properties aProperty) Loads the two properties of azimuthal projections.
void	setOriginLat(double aLatitude) Sets the latitude of the origin to aLatitude.
void	setOriginLon(double aLongitude) Sets the longitude of the origin to aLongitude.
void	writePropertiesSFCT(String aPrefix, Properties aPropertySFCT) Writes the two properties of azimuthal projections.

Methods inherited from class com.luciad.projection.ALcdProjection

addPropertyChangeListener, boundaryLats, boundaryLons, firePropertyChangeEvent, inWorldBoundsOnEllipsoid, lonlatheight2worldOnEllipsoidSFCT, removePropertyChangeListener, world2DEditableBoundsOnEllipsoidSFCT, world2lonlatOnEllipsoidSFCT

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.luciad.projection.ILcdProjection

boundaryLats, boundaryLons, inLonLatBounds, inWorldBoundsOnEllipsoid, inWorldBoundsOnSphere, isAllInBounds, lonlatheight2worldOnEllipsoidSFCT, lonlatheight2worldOnSphereSFCT, toString, world2DEditableBoundsOnEllipsoidSFCT, world2DEditableBoundsOnSphereSFCT, world2lonlatOnEllipsoidSFCT, world2lonlatOnSphereSFCT

Methods inherited from interface com.luciad.util.ILcdPropertyChangeSource

addPropertyChangeListener, removePropertyChangeListener

Constructor Detail

ALcdAzimuthal

public ALcdAzimuthal()

Method Detail

setOriginLat

public void setOriginLat(double aLatitude)

Description copied from interface: ILcdAzimuthal

Sets the latitude of the origin to aLatitude. Changing the origin of an azimuthal projection changes also its aspect. The normal aspect of an azimuthal projection corresponds to the origin at one of the poles. The transverse aspect corresponds to the origin on the equator. The oblique aspect corresponds to any other origin.

Specified by:

setOriginLat in interface ILcdAzimuthal

Parameters:

aLatitude - The new originLat value.

See Also:

ILcdAzimuthal.getOriginLat()

setOriginLon

public void setOriginLon(double aLongitude)

Description copied from interface: ILcdAzimuthal

Sets the longitude of the origin to aLongitude.

Specified by:

setOriginLon in interface ILcdAzimuthal

Parameters:

aLongitude - The new originLon value.

See Also:

ILcdAzimuthal.getOriginLon()

getOrigin

public ILcdPoint getOrigin()

Description copied from interface: ILcdProjection

Origin of the projection is the ILcd2DEditablePoint that corresponds with origin (0, 0) of the cartesian coordinate system of the projection.

Specified by:

getOrigin in interface ILcdProjection

Returns:

the origin of the projection.

getOriginLat

public double getOriginLat()

Description copied from interface: ILcdAzimuthal

Gets the latitude of the origin.

Specified by:

getOriginLat in interface ILcdAzimuthal

Returns:

the latitude of the origin.

See Also:

ILcdAzimuthal.setOriginLat(double)

getOriginLon

public double getOriginLon()

Description copied from interface: ILcdAzimuthal

Gets the longitude of the origin.

Specified by:

getOriginLon in interface ILcdAzimuthal

Returns:

the longitude of the origin.

See Also:

ILcdAzimuthal.setOriginLon(double)

isContinuous

public boolean isContinuous()

Description copied from interface: ILcdProjection

An ILcdProjection is continuous if there are no interruptions in the world coordinates. Most projections are continuous.

Specified by:

isContinuous in interface ILcdProjection

Returns:

true if the projection is continuous, false otherwise.

loadProperties

public void loadProperties(String aPrefix,
                           Properties aProperty)
                    throws IllegalArgumentException

Loads the two properties of azimuthal projections. The longitude and latitude of the point of origin of the projection. This method will, given aPrefix, analyze the aProperties object to set the properties of this ALcdAzimuthal. The values of following keys are retrieved:

• <aPrefix>.originLat
• <aPrefix>.originLon

Specified by:

loadProperties in interface ILcdProjection

Parameters:

aPrefix - prefix of the property names.

aProperty - Properties object containing the serialized properties.

Throws:

IllegalArgumentException - if the projection cannot be created.

writePropertiesSFCT

public void writePropertiesSFCT(String aPrefix,
                                Properties aPropertySFCT)

Writes the two properties of azimuthal projections. The longitude and latitude of the point of origin of the projection. This method will, given aPrefix, store the properties of this ALcdAzimuthal into the aPropertiesSFCT object. The values of following keys are stored:

• <aPrefix>.originLat
• <aPrefix>.originLon

Specified by:

writePropertiesSFCT in interface ILcdProjection

Parameters:

aPrefix - prefix for the property names.

aPropertySFCT - Properties object to store the serialized properties by side effect.

calculateCachedValues

protected void calculateCachedValues()

Constants based on the point of origin of the projection don't have to be recalculated every time a method is called. They only have to be calculated when the projection properties change. Within the methods the pre-calculated values then can be used in order to gain efficiency.

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object aObject)

Description copied from interface: ILcdProjection

Checks if this ILcdProjection equals some other Object.

Specified by:

equals in interface ILcdProjection

Overrides:

equals in class Object

Parameters:

aObject - Object to compare with.

Returns:

true if the Object is an instance of the same ILcdProjection class and having the same projection properties, false otherwise.

clone

public Object clone()

Description copied from interface: ILcdProjection

Makes a deep clone of this ILcdProjection.

Specified by:

clone in interface ILcdProjection

Overrides:

clone in class ALcdProjection

Returns:

deep clone of this ILcdProjection.