com.luciad.transformation

LuciadLightspeedClass TLcdGeodetic2Grid

java.lang.Object

com.luciad.transformation.TLcdGeodetic2Grid

All Implemented Interfaces:

ILcdModelXYWorldTransformation, ILcdCloneable, Serializable, Cloneable

public final class TLcdGeodetic2Grid
extends Object
implements ILcdModelXYWorldTransformation, Cloneable

This ILcdModelXYWorldTransformation defines a transformation between an ILcdGeodeticReference and an ILcdXYWorldReference. It is required that the reference datum of the geodetic datum of the ILcdGeodeticReference and the reference datum of the ILcdXYWorldReference are the same.

This class is thread safe.

See Also:

TLcdGeodeticDatum.getRefDatum(), Serialized Form

Constructor Summary

Constructors

Constructor and Description
TLcdGeodetic2Grid() Default constructor with null ILcdGeodeticReference and null ILcdGridReference.
TLcdGeodetic2Grid(ILcdModelReference aModelReferenceGeodetic, ILcdXYWorldReference aXYWorldReferenceGrid) Constructor with an ILcdModelReference and an ILcdXYWorldReference.

Method Summary

Modifier and Type	Method and Description
Object	clone() Implements a deep clone.
boolean	equals(Object aObject)
int	getDiv() Gets the number of divisions made for bounding box transformations.
ILcdModelReference	getModelReference() Gets the ILcdModelReference of this TLcdGeodetic2Grid.
ILcdXYWorldReference	getXYWorldReference() Gets the ILcdXYWorldReference of this TLcdGeodetic2Grid.
int	hashCode()
void	modelBounds2worldSFCT(ILcdBounds aModelBounds, ILcd2DEditableBounds aWorldBoundsSFCT) Transforms model bounds into world bounds.
void	modelPoint2worldSFCT(ILcdPoint aModelPoint, ILcd2DEditablePoint aWorldPoint) Transforms a model point into a world point.
void	setDiv(int aDiv) The property aDiv indicates the number of divisions made for bounding box transformations from world to model in order to approximate the bounding box of the model.
void	setModelReference(ILcdModelReference aModelReference) Sets the ILcdModelReference of this TLcdGeodetic2Grid.
void	setXYWorldReference(ILcdXYWorldReference aXYWorldReference) Sets the ILcdXYWorldReference of this TLcdGeodetic2Grid.
void	worldBounds2modelSFCT(ILcdBounds aWorldBounds, ILcd3DEditableBounds aModelBoundsSFCT) Transforms world bounds into model bounds.
void	worldPoint2modelSFCT(ILcdPoint aWorldPoint, ILcd3DEditablePoint aModelPointSFCT) Transforms a world point into a model point.

Methods inherited from class java.lang.Object

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

Constructor Detail

TLcdGeodetic2Grid

public TLcdGeodetic2Grid()

Default constructor with null ILcdGeodeticReference and null ILcdGridReference.

TLcdGeodetic2Grid

public TLcdGeodetic2Grid(ILcdModelReference aModelReferenceGeodetic,
                         ILcdXYWorldReference aXYWorldReferenceGrid)

Constructor with an ILcdModelReference and an ILcdXYWorldReference.

Parameters:

aModelReferenceGeodetic - a ILcdModelReference which should be an implementation of ILcdGeodeticReference.

aXYWorldReferenceGrid - the reference of the XY world plane.

Method Detail

getModelReference

public ILcdModelReference getModelReference()

Gets the ILcdModelReference of this TLcdGeodetic2Grid.

Specified by:

getModelReference in interface ILcdModelXYWorldTransformation

Returns:

ILcdModelReference of this TLcdGeodetic2Grid.

See Also:

setModelReference(com.luciad.model.ILcdModelReference)

setModelReference

public void setModelReference(ILcdModelReference aModelReference)

Sets the ILcdModelReference of this TLcdGeodetic2Grid.

Specified by:

setModelReference in interface ILcdModelXYWorldTransformation

Parameters:

aModelReference - ILcdModelReference that is also an ILcdGeodeticReference.

Throws:

IllegalArgumentException - when the model reference passed is not an instance of ILcdGeodeticReference

See Also:

getModelReference()

getXYWorldReference

public ILcdXYWorldReference getXYWorldReference()

Gets the ILcdXYWorldReference of this TLcdGeodetic2Grid.

Specified by:

getXYWorldReference in interface ILcdModelXYWorldTransformation

Returns:

ILcdXYWorldReference of this TLcdGeodetic2Grid.

See Also:

setXYWorldReference(com.luciad.view.ILcdXYWorldReference)

setXYWorldReference

public void setXYWorldReference(ILcdXYWorldReference aXYWorldReference)

Sets the ILcdXYWorldReference of this TLcdGeodetic2Grid.

Specified by:

setXYWorldReference in interface ILcdModelXYWorldTransformation

Parameters:

aXYWorldReference - ILcdXYWorldReference that is also an ILcdGridReference.

Throws:

IllegalArgumentException - when the world reference passed is not an instance of ILcdGridReference.

See Also:

getXYWorldReference()

setDiv

public void setDiv(int aDiv)

The property aDiv indicates the number of divisions made for bounding box transformations from world to model in order to approximate the bounding box of the model. The number of point transformations performed is proportional to aDiv*aDiv. The more divisions, the more precise the model bounding box will be.

Parameters:

aDiv - number of divisions to use for bounding box transformations.

See Also:

getDiv()

getDiv

public int getDiv()

Gets the number of divisions made for bounding box transformations.

Returns:

the number of divisions made for bounding box transformations.

See Also:

setDiv(int)

modelPoint2worldSFCT

public void modelPoint2worldSFCT(ILcdPoint aModelPoint,
                                 ILcd2DEditablePoint aWorldPoint)
                          throws TLcdOutOfBoundsException

Transforms a model point into a world point.

Specified by:

modelPoint2worldSFCT in interface ILcdModelXYWorldTransformation

Parameters:

aModelPoint - coordinate in model reference system.

aWorldPoint - coordinate in world reference system upon completion of the method.

Throws:

TLcdOutOfBoundsException - if the model point is outside the valid area of the projection.

worldPoint2modelSFCT

public void worldPoint2modelSFCT(ILcdPoint aWorldPoint,
                                 ILcd3DEditablePoint aModelPointSFCT)
                          throws TLcdOutOfBoundsException

Description copied from interface: ILcdModelXYWorldTransformation

Transforms a world point into a model point.

Specified by:

worldPoint2modelSFCT in interface ILcdModelXYWorldTransformation

Parameters:

aWorldPoint - coordinate in world reference system.

aModelPointSFCT - coordinate in model reference system upon completion of the method.

Throws:

TLcdOutOfBoundsException - if the world point is outside the valid area of the projection.

modelBounds2worldSFCT

public void modelBounds2worldSFCT(ILcdBounds aModelBounds,
                                  ILcd2DEditableBounds aWorldBoundsSFCT)
                           throws TLcdNoBoundsException

Description copied from interface: ILcdModelXYWorldTransformation

Transforms model bounds into world bounds.

Specified by:

modelBounds2worldSFCT in interface ILcdModelXYWorldTransformation

Parameters:

aModelBounds - bounds in model reference system.

aWorldBoundsSFCT - bounds in world reference system upon completion of the method.

Throws:

TLcdNoBoundsException - if the model bounds doesn't have valid corresponding bounds in world space, or if it is undefined.

worldBounds2modelSFCT

public void worldBounds2modelSFCT(ILcdBounds aWorldBounds,
                                  ILcd3DEditableBounds aModelBoundsSFCT)
                           throws TLcdOutOfBoundsException

Description copied from interface: ILcdModelXYWorldTransformation

Transforms world bounds into model bounds.

Specified by:

worldBounds2modelSFCT in interface ILcdModelXYWorldTransformation

Parameters:

aWorldBounds - bounds in world reference system.

aModelBoundsSFCT - bounds in model reference system upon completion of the method.

Throws:

TLcdOutOfBoundsException - if the world bounds are outside the valid area of the projection, or if it is undefined.

clone

public Object clone()

Implements a deep clone.

Specified by:

clone in interface ILcdCloneable

Overrides:

clone in class Object

See Also:

Object.clone()

equals

public boolean equals(Object aObject)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object