com.luciad.transformation

LuciadLightspeedClass TLcdGeocentric2Grid

java.lang.Object

com.luciad.transformation.TLcdGeocentric2Grid

All Implemented Interfaces:

ILcdModelXYWorldTransformation, ILcdCloneable, Serializable, Cloneable

public final class TLcdGeocentric2Grid
extends Object
implements ILcdModelXYWorldTransformation, Cloneable

This ILcdModelXYWorldTransformation defines a transformation between an ILcdGeocentricReference and an ILcdXYWorldReference. It is required that the reference datum of the geodetic datum of the ILcdGeocentricReference 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
TLcdGeocentric2Grid() Default constructor with null ILcdGeocentricReference and null ILcdGridReference.
TLcdGeocentric2Grid(ILcdModelReference aModelReferenceGeocentric, ILcdXYWorldReference aXYWorldReferenceGrid) Constructor with an ILcdGeocentricReference and an ILcdGridReference.

Method Summary

Modifier and Type	Method and Description
Object	clone() Implements a deep clone.
int	getDiv() Gets the number of divisions made for bounding box transformations.
ILcdModelReference	getModelReference() Gets the ILcdModelReference of this TLcdGeocentric2Grid.
ILcdXYWorldReference	getXYWorldReference() Gets the ILcdXYWorldReference of this TLcdGeocentric2Grid.
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 TLcdGeocentric2Grid.
void	setXYWorldReference(ILcdXYWorldReference aXYWorldReference) Sets the ILcdXYWorldReference of this TLcdGeocentric2Grid.
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

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

Constructor Detail

TLcdGeocentric2Grid

public TLcdGeocentric2Grid()

Default constructor with null ILcdGeocentricReference and null ILcdGridReference.

TLcdGeocentric2Grid

public TLcdGeocentric2Grid(ILcdModelReference aModelReferenceGeocentric,
                           ILcdXYWorldReference aXYWorldReferenceGrid)

Constructor with an ILcdGeocentricReference and an ILcdGridReference.

Parameters:

aModelReferenceGeocentric - ILcdModelReference that is also an ILcdGeocentricReference.

aXYWorldReferenceGrid - ILcdXYWorldReference that is also an ILcdGridReference.

Method Detail

getModelReference

public ILcdModelReference getModelReference()

Gets the ILcdModelReference of this TLcdGeocentric2Grid.

Specified by:

getModelReference in interface ILcdModelXYWorldTransformation

Returns:

ILcdModelReference of this TLcdGeocentric2Grid.

See Also:

setModelReference(com.luciad.model.ILcdModelReference)

setModelReference

public void setModelReference(ILcdModelReference aModelReference)

Sets the ILcdModelReference of this TLcdGeocentric2Grid.

Specified by:

setModelReference in interface ILcdModelXYWorldTransformation

Parameters:

aModelReference - ILcdModelReference that is also an ILcdGeocentricReference.

Throws:

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

See Also:

getModelReference()

getXYWorldReference

public ILcdXYWorldReference getXYWorldReference()

Gets the ILcdXYWorldReference of this TLcdGeocentric2Grid.

Specified by:

getXYWorldReference in interface ILcdModelXYWorldTransformation

Returns:

ILcdXYWorldReference of this TLcdGeocentric2Grid.

See Also:

setXYWorldReference(com.luciad.view.ILcdXYWorldReference)

setXYWorldReference

public void setXYWorldReference(ILcdXYWorldReference aXYWorldReference)

Sets the ILcdXYWorldReference of this TLcdGeocentric2Grid.

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()