com.luciad.transformation

LuciadLightspeedClass TLcdGridReferenceUtil

java.lang.Object

com.luciad.transformation.TLcdGridReferenceUtil

Direct Known Subclasses:

TLcdGridRefUtil

public class TLcdGridReferenceUtil
extends Object

Utility class to transform between grid coordinates and lon-lat coordinates that use the same geodetic datum. Note: it is advised to use the transformation API instead of this class to transform between references. See for example:

• TLcdDefaultModelModelTransformation
• TLcdGeoReference2GeoReference

Constructor Summary

Constructors

Constructor and Description
TLcdGridReferenceUtil() Constructor of null ILcdGridReference.
TLcdGridReferenceUtil(ILcdGridReference aGridReference) Constructor of TLcdGridReferenceUtil with a given ILcdGridReference aModelRefGrid.

Method Summary

Modifier and Type	Method and Description
ILcdGridReference	getGridReference() Gets the ILcdGridReference of this TLcdGridReferenceUtil.
ILcdGridReference	getModelRefGrid() Deprecated. Replaced by the method getGridReference since V 3.0.
void	grid2lonlatSFCT(double aX, double aY, ILcd2DEditablePoint a2DEditablePointSFCT) Transformation of a grid coordinate to a lonLatHeight coordinate.
void	grid2lonlatSFCT(ILcdPoint aXYPoint, ILcd2DEditablePoint a2DEditablePointSFCT) Transformation of a grid coordinate to a lonLatHeight coordinate.
void	grid2worldSFCT(double aX, double aY, ILcd2DEditablePoint a2DEditablePointSFCT) Transformation of a grid coordinate to a world coordinate.
void	lonlat2gridSFCT(double aLon, double aLat, ILcd2DEditablePoint aXYPointSFCT) Transformation of a lon-lat coordinate to a grid coordinate.
void	lonlatheight2gridSFCT(ILcdPoint aLLHPoint, ILcd2DEditablePoint aXYPointSFCT) Transformation of a lon-lat coordinate to a grid coordinate.
void	setGridReference(ILcdGridReference aGridReference) Sets the ILcdGridReference of this TLcdGridReferenceUtil to aGridReference.
void	setModelRefGrid(ILcdGridReference aGridReference) Deprecated. Replaced by the method setGridReference since V 3.0.
void	world2gridSFCT(ILcdPoint aWorldPoint, ILcd2DEditablePoint aXYPointSFCT) Transformation of a world coordinate to a grid coordinate.

Methods inherited from class java.lang.Object

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

Constructor Detail

TLcdGridReferenceUtil

public TLcdGridReferenceUtil()

Constructor of null ILcdGridReference.

TLcdGridReferenceUtil

public TLcdGridReferenceUtil(ILcdGridReference aGridReference)

Constructor of TLcdGridReferenceUtil with a given ILcdGridReference aModelRefGrid.

Parameters:

aGridReference - the grid reference to use.

Method Detail

getGridReference

public ILcdGridReference getGridReference()

Gets the ILcdGridReference of this TLcdGridReferenceUtil.

Returns:

the ILcdGridReference of this TLcdGridReferenceUtil.

See Also:

setGridReference(com.luciad.reference.ILcdGridReference)

setGridReference

public void setGridReference(ILcdGridReference aGridReference)

Sets the ILcdGridReference of this TLcdGridReferenceUtil to aGridReference.

Parameters:

aGridReference - the new grid reference system to be used.

See Also:

getGridReference()

setModelRefGrid

public void setModelRefGrid(ILcdGridReference aGridReference)

Deprecated. Replaced by the method setGridReference since V 3.0.

Sets the ILcdGridReference of TLcdGridReferenceUtil to aModelRefGrid.

Parameters:

aGridReference - the new grid reference system to be used.

See Also:

getGridReference(), getModelRefGrid()

getModelRefGrid

public ILcdGridReference getModelRefGrid()

Deprecated. Replaced by the method getGridReference since V 3.0.

Gets the ILcdGridReference of the TLcdGridReferenceUtil.

Returns:

the ILcdGridReference of the TLcdGridReferenceUtil.

See Also:

setGridReference(com.luciad.reference.ILcdGridReference), setModelRefGrid(com.luciad.reference.ILcdGridReference)

grid2worldSFCT

public void grid2worldSFCT(double aX,
                           double aY,
                           ILcd2DEditablePoint a2DEditablePointSFCT)

Transformation of a grid coordinate to a world coordinate.

Parameters:

aX - the x-value of the grid coordinate.

aY - the y-value of the grid coordinate.

a2DEditablePointSFCT - the resulting world coordinate as side effect.

world2gridSFCT

public void world2gridSFCT(ILcdPoint aWorldPoint,
                           ILcd2DEditablePoint aXYPointSFCT)

Transformation of a world coordinate to a grid coordinate.

Parameters:

aWorldPoint - a world coordinate.

aXYPointSFCT - the resulting grid coordinate as side effect.

grid2lonlatSFCT

public void grid2lonlatSFCT(double aX,
                            double aY,
                            ILcd2DEditablePoint a2DEditablePointSFCT)
                     throws TLcdOutOfBoundsException

Transformation of a grid coordinate to a lonLatHeight coordinate.

Parameters:

aX - the x-value of the grid coordinate.

aY - the y-value of the grid coordinate.

a2DEditablePointSFCT - the resulting geodetic coordinate on the ellipsoid of the grid reference as side effect.

Throws:

TLcdOutOfBoundsException - The grid point (aX,aY) is outside the valid area of the projection.

grid2lonlatSFCT

public void grid2lonlatSFCT(ILcdPoint aXYPoint,
                            ILcd2DEditablePoint a2DEditablePointSFCT)
                     throws TLcdOutOfBoundsException

Transformation of a grid coordinate to a lonLatHeight coordinate.

Parameters:

aXYPoint - a grid coordinate.

a2DEditablePointSFCT - the resulting geodetic coordinate on the ellipsoid of the grid reference as side effect.

Throws:

TLcdOutOfBoundsException - The grid point (aX,aY) is outside the valid area of the projection.

lonlat2gridSFCT

public void lonlat2gridSFCT(double aLon,
                            double aLat,
                            ILcd2DEditablePoint aXYPointSFCT)
                     throws TLcdOutOfBoundsException

Transformation of a lon-lat coordinate to a grid coordinate.

Parameters:

aLon - longitude of the geodetic coordinate (in degrees).

aLat - latitude of the geodetic coordinate (in degrees).

aXYPointSFCT - the resulting grid coordinate as side effect.

Throws:

TLcdOutOfBoundsException - The lon-lat point (aLon,aLat) is outside the valid area of the projection.

lonlatheight2gridSFCT

public void lonlatheight2gridSFCT(ILcdPoint aLLHPoint,
                                  ILcd2DEditablePoint aXYPointSFCT)
                           throws TLcdOutOfBoundsException

Transformation of a lon-lat coordinate to a grid coordinate.

Parameters:

aLLHPoint - a geodetic coordinate.

aXYPointSFCT - the resulting grid coordinate as side effect.

Throws:

TLcdOutOfBoundsException - The lon-lat point (aLon,aLat) is outside the valid area of the projection.