com.luciad.transformation

LuciadFusionClass TLcdGrid2Geocentric

java.lang.Object

com.luciad.transformation.TLcdGrid2Geocentric

All Implemented Interfaces:

ILcdModelXYZWorldTransformation, Serializable, Cloneable

public final class TLcdGrid2Geocentric
extends Object
implements ILcdModelXYZWorldTransformation, Cloneable

This ILcdModelXYZWorldTransformation defines a transformation between an ILcdGridReference and an ILcdGeocentricReference.
It is required that the reference datum of the geodetic datum of the ILcdGeodeticReference and the reference datum of the ILcdXYZWorldReference are the same.

This class is thread safe.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
TLcdGrid2Geocentric() Constructs a new TLcdGrid2Geocentric transformation which has both its model and world reference set to null.
TLcdGrid2Geocentric(ILcdModelReference aModelReference, ILcdXYZWorldReference aWorldReference) Constructs a new TLcdGrid2Geocentric transformation using a specified model and world reference.

Method Summary

Modifier and Type	Method and Description
Object	clone() Performs a deep clone of this transformation.
int	getDiv() Gets the number of divisions made for bounding box transformations.
ILcdModelReference	getModelReference() Gets the model reference of this transformation.
ILcdXYZWorldReference	getXYZWorldReference() Gets the world reference of this transformation.
void	modelBounds2worldSFCT(ILcdBounds aBounds, ILcd3DEditableBounds aBoundsSFCT) Transforms model bounds into world bounds.
void	modelPoint2worldSFCT(ILcdPoint aPoint, ILcd3DEditablePoint aPointSFCT) Transforms a model point into a world point.
void	setDiv(int aNbDivisions) The property aNbDivisions 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 for this transformation.
void	setXYZWorldReference(ILcdXYZWorldReference aWorldReference) Sets the ILcdXYZWorldReference for this transformation.
void	worldBounds2modelSFCT(ILcdBounds aBounds, ILcd3DEditableBounds aBoundsSFCT) Transforms world bounds into model bounds.
void	worldPoint2modelSFCT(ILcdPoint aPoint, ILcd3DEditablePoint aPointSFCT) 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

TLcdGrid2Geocentric

public TLcdGrid2Geocentric()

Constructs a new TLcdGrid2Geocentric transformation which has both its model and world reference set to null. This transformation should not be used until a valid model and world reference has been set.

TLcdGrid2Geocentric

public TLcdGrid2Geocentric(ILcdModelReference aModelReference,
                           ILcdXYZWorldReference aWorldReference)

Constructs a new TLcdGrid2Geocentric transformation using a specified model and world reference.

Parameters:

aModelReference - the model reference for this transformation

aWorldReference - the world reference for this transformation

See Also:

setModelReference(com.luciad.model.ILcdModelReference), setXYZWorldReference(com.luciad.view.ILcdXYZWorldReference)

Method Detail

getModelReference

public ILcdModelReference getModelReference()

Gets the model reference of this transformation.

Specified by:

getModelReference in interface ILcdModelXYZWorldTransformation

Returns:

the model reference of this transformation.

See Also:

setModelReference(com.luciad.model.ILcdModelReference)

setModelReference

public void setModelReference(ILcdModelReference aModelReference)

Sets the ILcdModelReference for this transformation. The specified model reference must also be an instance of ILcdGridReference

Specified by:

setModelReference in interface ILcdModelXYZWorldTransformation

Parameters:

aModelReference - the model reference for this transformation

Throws:

IllegalArgumentException - if the specified model reference is not an instance of ILcdGridReference

See Also:

getModelReference()

getXYZWorldReference

public ILcdXYZWorldReference getXYZWorldReference()

Gets the world reference of this transformation.

Specified by:

getXYZWorldReference in interface ILcdModelXYZWorldTransformation

Returns:

the world reference of this transformation.

See Also:

setXYZWorldReference(com.luciad.view.ILcdXYZWorldReference)

setXYZWorldReference

public void setXYZWorldReference(ILcdXYZWorldReference aWorldReference)

Sets the ILcdXYZWorldReference for this transformation. This world reference must also be an instance of ILcdGeocentricReference.

Specified by:

setXYZWorldReference in interface ILcdModelXYZWorldTransformation

Parameters:

aWorldReference - the world reference for this transformation

Throws:

IllegalArgumentException - if the specified world reference is not an instance of ILcdGeocentricReference

See Also:

getXYZWorldReference()

setDiv

public void setDiv(int aNbDivisions)

The property aNbDivisions 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 aNbDivisions*aNbDivisions. The more divisions, the more precise the model bounding box will be.

Parameters:

aNbDivisions - 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 aPoint,
                                 ILcd3DEditablePoint aPointSFCT)
                          throws TLcdOutOfBoundsException

Description copied from interface: ILcdModelXYZWorldTransformation

Transforms a model point into a world point.

Specified by:

modelPoint2worldSFCT in interface ILcdModelXYZWorldTransformation

Parameters:

aPoint - coordinate in model reference system.

aPointSFCT - 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 aPoint,
                                 ILcd3DEditablePoint aPointSFCT)
                          throws TLcdOutOfBoundsException

Description copied from interface: ILcdModelXYZWorldTransformation

Transforms a world point into a model point.

Specified by:

worldPoint2modelSFCT in interface ILcdModelXYZWorldTransformation

Parameters:

aPoint - coordinate in world reference system.

aPointSFCT - 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 aBounds,
                                  ILcd3DEditableBounds aBoundsSFCT)
                           throws TLcdNoBoundsException

Description copied from interface: ILcdModelXYZWorldTransformation

Transforms model bounds into world bounds.

Specified by:

modelBounds2worldSFCT in interface ILcdModelXYZWorldTransformation

Parameters:

aBounds - bounds in model reference system.

aBoundsSFCT - 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 aBounds,
                                  ILcd3DEditableBounds aBoundsSFCT)
                           throws TLcdOutOfBoundsException

Description copied from interface: ILcdModelXYZWorldTransformation

Transforms world bounds into model bounds.

Specified by:

worldBounds2modelSFCT in interface ILcdModelXYZWorldTransformation

Parameters:

aBounds - bounds in world reference system.

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

Performs a deep clone of this transformation. The model and world reference that are set on this transformation are also cloned.

Overrides:

clone in class Object

Returns:

a deep clone of this transformation