com.luciad.projection

LuciadFusionClass ALcdProjection

java.lang.Object

com.luciad.projection.ALcdProjection

All Implemented Interfaces:

ILcdProjection, ILcdPropertyChangeSource, Serializable, Cloneable

Direct Known Subclasses:

ALcdAzimuthal, ALcdConic, ALcdCylindrical, ALcdGeneralPerspective, ALcdObliqueCylindrical, ALcdPerspective, ALcdTransverseCylindrical, TLcdGeodetic, TLcdKrovak, TLcdOrthorectifiedProjection, TLcdPerspectiveProjection, TLcdPolarStereographic, TLcdPolyconic, TLcdRectifiedPolynomialProjection, TLcdRectifiedProjectiveProjection, TLcdRectifiedRationalProjection, TLcdRPCProjection

public abstract class ALcdProjection
extends Object
implements ILcdProjection, Cloneable

This abstract class can be used to implement an ILcdProjection.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected TLcdPropertyChangeDispatcher	fPropertyChangeDispatcher Dispatches property changes to the listeners.

Fields inherited from interface com.luciad.projection.ILcdProjection

EPSILON

Constructor Summary

Constructors

Constructor and Description
ALcdProjection()

Method Summary

Modifier and Type	Method and Description
void	addPropertyChangeListener(PropertyChangeListener aPropertyChangeListener) Registers the given PropertyChangeListener to be notified when this object's properties change.
double[][]	boundaryLats(double aLongitude) Default implementation.
double[][]	boundaryLons(double aLatitude) Default implementation.
Object	clone() Makes a deep clone of this ILcdProjection.
protected void	firePropertyChangeEvent(PropertyChangeEvent aPropertyChangeEvent) Calls all the PropertyChangeListener objects about the property change taken place.
boolean	inWorldBoundsOnEllipsoid(ILcdPoint aXYPoint, ILcdEllipsoid aEllipsoid) Default implementation calls inWorldBoundsOnSphere with aEllipsoid.getAuxRadius() as sphere radius.
void	lonlatheight2worldOnEllipsoidSFCT(ILcdPoint aLLHP, ILcdEllipsoid aEllipsoid, ILcd2DEditablePoint aXYPointSFCT) Default implementation calls lonlatheight2worldOnEllipsoidSFCT with aEllipsoid.getAuxRadius() as sphere radius.
void	removePropertyChangeListener(PropertyChangeListener aPropertyChangeListener) De-registers the given PropertyChangeListener from receiving property change events for this object.
void	world2DEditableBoundsOnEllipsoidSFCT(ILcdEllipsoid aEllipsoid, ILcd2DEditableBounds aWorldBoundsSFCT) Default implementation calls world2lonlatOnSphereSFCT with aEllipsoid.getAuxRadius() as sphere radius.
void	world2lonlatOnEllipsoidSFCT(ILcdPoint aXYPoint, ILcdEllipsoid aEllipsoid, ILcd2DEditablePoint aLLPointSFCT) Default implementation calls world2lonlatOnSphereSFCT with aEllipsoid.getAuxRadius() as sphere radius.

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.luciad.projection.ILcdProjection

equals, getOrigin, inLonLatBounds, inWorldBoundsOnSphere, isAllInBounds, isContinuous, loadProperties, lonlatheight2worldOnSphereSFCT, toString, world2DEditableBoundsOnSphereSFCT, world2lonlatOnSphereSFCT, writePropertiesSFCT

Field Detail

fPropertyChangeDispatcher

protected TLcdPropertyChangeDispatcher fPropertyChangeDispatcher

Dispatches property changes to the listeners.

Constructor Detail

ALcdProjection

public ALcdProjection()

Method Detail

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener aPropertyChangeListener)

Description copied from interface: ILcdPropertyChangeSource

Registers the given PropertyChangeListener to be notified when this object's properties change.

In case you need to register a listener which keeps a reference to an object with a shorter life-time than this change source, you can use a ALcdWeakPropertyChangeListener instance as property change listener.

Specified by:

addPropertyChangeListener in interface ILcdPropertyChangeSource

Parameters:

aPropertyChangeListener - The listener to be notified

See Also:

ALcdWeakPropertyChangeListener, ILcdPropertyChangeSource.removePropertyChangeListener(java.beans.PropertyChangeListener)

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener aPropertyChangeListener)

Description copied from interface: ILcdPropertyChangeSource

De-registers the given PropertyChangeListener from receiving property change events for this object.

If the listener was added more than once, it will be notified one less time after being removed. If the listener is null, or was never added, no exception is thrown and no action is taken.

Specified by:

removePropertyChangeListener in interface ILcdPropertyChangeSource

Parameters:

aPropertyChangeListener - the listener that should no longer be notified of changes of this object's properties

See Also:

ILcdPropertyChangeSource.addPropertyChangeListener(java.beans.PropertyChangeListener)

lonlatheight2worldOnEllipsoidSFCT

public void lonlatheight2worldOnEllipsoidSFCT(ILcdPoint aLLHP,
                                              ILcdEllipsoid aEllipsoid,
                                              ILcd2DEditablePoint aXYPointSFCT)
                                       throws TLcdOutOfBoundsException

Default implementation calls lonlatheight2worldOnEllipsoidSFCT with aEllipsoid.getAuxRadius() as sphere radius.

Specified by:

lonlatheight2worldOnEllipsoidSFCT in interface ILcdProjection

Parameters:

aLLHP - point to be projected.

aEllipsoid - ellipsoid on which the point is defined.

aXYPointSFCT - projected point as side effect.

Throws:

TLcdOutOfBoundsException - If the ILcdPoint aLLHP is not within the valid area of the projection (visible area), then this exception is thrown.

world2lonlatOnEllipsoidSFCT

public void world2lonlatOnEllipsoidSFCT(ILcdPoint aXYPoint,
                                        ILcdEllipsoid aEllipsoid,
                                        ILcd2DEditablePoint aLLPointSFCT)
                                 throws TLcdOutOfBoundsException

Default implementation calls world2lonlatOnSphereSFCT with aEllipsoid.getAuxRadius() as sphere radius.

Specified by:

world2lonlatOnEllipsoidSFCT in interface ILcdProjection

Parameters:

aXYPoint - projected point for which the corresponding geodetic point is sought.

aEllipsoid - ellipsoid on which the geodetic coordinate is defined.

aLLPointSFCT - resulting geodetic coordinate as side effect.

Throws:

TLcdOutOfBoundsException - If the ILcdPoint aXYPoint is not within the valid area of the projection (visible area), then this exception is thrown.

world2DEditableBoundsOnEllipsoidSFCT

public void world2DEditableBoundsOnEllipsoidSFCT(ILcdEllipsoid aEllipsoid,
                                                 ILcd2DEditableBounds aWorldBoundsSFCT)

Default implementation calls world2lonlatOnSphereSFCT with aEllipsoid.getAuxRadius() as sphere radius.

Specified by:

world2DEditableBoundsOnEllipsoidSFCT in interface ILcdProjection

Parameters:

aEllipsoid - ellipsoid considered.

aWorldBoundsSFCT - the bounds of the projection in world coordinates as side effect.

inWorldBoundsOnEllipsoid

public boolean inWorldBoundsOnEllipsoid(ILcdPoint aXYPoint,
                                        ILcdEllipsoid aEllipsoid)

Default implementation calls inWorldBoundsOnSphere with aEllipsoid.getAuxRadius() as sphere radius.

Specified by:

inWorldBoundsOnEllipsoid in interface ILcdProjection

Parameters:

aXYPoint - point to be checked upon.

aEllipsoid - ellipsoid on which the geodetic coordinate is defined.

Returns:

true if valid, false if invalid.

See Also:

ILcdProjection.inWorldBoundsOnSphere(com.luciad.shape.ILcdPoint, double)

boundaryLons

public double[][] boundaryLons(double aLatitude)

Default implementation. To be redefined for specific projections.

Specified by:

boundaryLons in interface ILcdProjection

Parameters:

aLatitude - latitude in decimal degrees and -90.0 <= aLat<= 90.0.

Returns:

the array of pairs of longitudes[0] and longitudes[1], where the closed interval longitudes[0] -> longitudes[1] is in visible area and -180.0 <= lon[i] <= 180.0.

boundaryLats

public double[][] boundaryLats(double aLongitude)

Default implementation. To be redefined for specific projections.

Specified by:

boundaryLats in interface ILcdProjection

Parameters:

aLongitude - longitude in decimal degrees -180.0 <= lon <= 180.0 .

Returns:

the array of pairs of latitudes lats[0] and lats[1], where the closed interval lats[0] -> lats[1] is in visible area and -90.0 <= lats[i] <= 90.0 .

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 Object

Returns:

deep clone of this ILcdProjection.

firePropertyChangeEvent

protected void firePropertyChangeEvent(PropertyChangeEvent aPropertyChangeEvent)

Calls all the PropertyChangeListener objects about the property change taken place.

Parameters:

aPropertyChangeEvent - The property change that has taken place.