com.luciad.format.raster.reference

LuciadLightspeedClass TLcdOrthographicRasterReferencer

java.lang.Object

com.luciad.format.raster.reference.TLcdOrthographicRasterReferencer

All Implemented Interfaces:

ILcdRasterReferencer

public class TLcdOrthographicRasterReferencer
extends Object
implements ILcdRasterReferencer

This implementation of ILcdRasterReferencer delegates the computation of the raster reference to a given ILcdRasterReferencer, after having transformed model tie points in a geodetic reference to more suitable orthographic grid reference. The orthographic grid reference is centered around the tie points. Its geodetic datum is the geodetic datum of the geodetic reference.

If the given model reference is not a geodetic reference, the reference and the tie points are left unchanged.

This class is useful to avoid having to perform rectification in geodetic references, which is generally ill-advised due to distortion and wrap-around.

Since:

8.1

See Also:

ILcdGeodeticReference, ILcdGridReference, TLcdOrthographic

Constructor Summary

Constructors

Constructor and Description
TLcdOrthographicRasterReferencer(ILcdRasterReferencer aRasterReferencer) Creates a new TLcdOrthographicRasterReferencer that will delegate the computation of raster references to the given ILcdRasterReferencer, after having transformed geodetic coordinates to orthographic grid references.

Method Summary

Modifier and Type	Method and Description
ILcdRasterReference	createRasterReference(int aImageWidth, int aImageHeight, ILcdPoint[] aImageTiePoints, ILcdModelReference aModelReference, ILcdPoint[] aModelTiePoints, ILcdPoint[] aMappedModelTiePointsSFCT) Creates a raster reference for an image of a given size, based on pairs of tie points.

Methods inherited from class java.lang.Object

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

Constructor Detail

TLcdOrthographicRasterReferencer

public TLcdOrthographicRasterReferencer(ILcdRasterReferencer aRasterReferencer)

Creates a new TLcdOrthographicRasterReferencer that will delegate the computation of raster references to the given ILcdRasterReferencer, after having transformed geodetic coordinates to orthographic grid references.

Method Detail

createRasterReference

public ILcdRasterReference createRasterReference(int aImageWidth,
                                                 int aImageHeight,
                                                 ILcdPoint[] aImageTiePoints,
                                                 ILcdModelReference aModelReference,
                                                 ILcdPoint[] aModelTiePoints,
                                                 ILcdPoint[] aMappedModelTiePointsSFCT)

Description copied from interface: ILcdRasterReferencer

Creates a raster reference for an image of a given size, based on pairs of tie points.

An optional array can be provided for obtaining the model tie points transformed to image coordinates on return. These reflect the effects of the referencing. The differences between the transformed model tie points (expressed in pixels) and the original image tie points (also expressed in pixels) provide a measure for the success of the referencing. With a perfect raster reference, the resulting model tie points correspond to the original image tie points.

Specified by:

createRasterReference in interface ILcdRasterReferencer

Parameters:

aImageWidth - the image width of the raster, expressed in pixels.

aImageHeight - the image height of the raster, expressed in pixels.

aImageTiePoints - the image tie points, expressed in pixels.

aModelReference - the reference of the model tie points.

aModelTiePoints - the model tie points corresponding to the image tie points, expressed in model coordinates.

aMappedModelTiePointsSFCT - an optional array for obtaining the the model tie points mapped to image coordinates upon return. This parameter may be null, if the mapped points are not required.

Returns:

a raster reference containing a new model reference and raster bounds that try to satisfy the given tie points.