Package com.luciad.transformation

Class TLcdGeoReference2GeoReference

java.lang.Object

com.luciad.transformation.TLcdGeoReference2GeoReference

All Implemented Interfaces:

ILcdModelModelTransformation

public class TLcdGeoReference2GeoReference
extends Object
implements ILcdModelModelTransformation

Utility class to transform points and bounds between ILcdGeoReference implementations. Transformations between any of the following references are supported:

• ILcdGeodeticReference
• ILcdGridReference
• ILcdGeocentricReference
• ILcdTopocentricReference
• ILcdGeoidReference

The transformations can be applied in both directions. This class is thread-safe.

Constructor Summary

Constructors

Constructor	Description
TLcdGeoReference2GeoReference()	Constructs a transformation utility instance with no references set.
TLcdGeoReference2GeoReference(ILcdGeoReference aSourceReference, ILcdGeoReference aDestinationReference)	Constructs a transformation utility instance with the given references as source and destination reference.

Method Summary

Modifier and Type	Method	Description
void	destBounds2sourceSFCT(ILcdBounds aDestinationBounds, ILcd3DEditableBounds aSourceBoundsSFCT)	Deprecated. use destinationBounds2sourceSFCT(com.luciad.shape.ILcdBounds, com.luciad.shape.shape3D.ILcd3DEditableBounds).
void	destinationBounds2sourceSFCT(ILcdBounds aDestinationBounds, ILcd3DEditableBounds aSourceBoundsSFCT)	Transforms a bounds from the destination ILcdGeoReference to the source ILcdGeoReference.
void	destinationPoint2sourceSFCT(ILcdPoint aDestinationPoint, ILcd3DEditablePoint aSourcePointSFCT)	Transforms a point from the destination ILcdGeoReference to the source ILcdGeoReference.
void	destPoint2sourceSFCT(ILcdPoint aDestinationPoint, ILcd3DEditablePoint aSourcePointSFCT)	Deprecated. use destinationPoint2sourceSFCT(com.luciad.shape.ILcdPoint, com.luciad.shape.shape3D.ILcd3DEditablePoint).
ILcdGeoReference	getDestinationReference()	s Returns the destination ILcdGeoReference of this TLcdModelModelTransformation.
ILcdGeoReference	getSourceReference()	Returns the source ILcdGeoReference of this TLcdModelModelTransformation.
boolean	isValid()	Returns whether this TLcdModelModelTransformation has a valid transformation.
void	setDestinationReference(ILcdModelReference aModelReference)	Sets the destination ILcdModelReference.
void	setDestinationReference(ILcdGeoReference aDestinationReference)	Sets the destination ILcdGeoReference of this TLcdModelModelTransformation.
void	setSourceReference(ILcdModelReference aSourceReference)	Sets the source ILcdModelReference.
void	setSourceReference(ILcdGeoReference aSourceReference)	Sets the source ILcdGeoReference of this TLcdModelModelTransformation.
void	sourceBounds2destinationSFCT(ILcdBounds aSourceBounds, ILcd3DEditableBounds aDestinationBoundsSFCT)	Transforms a bounds from the source ILcdGeoReference to the destination ILcdGeoReference.
void	sourceBounds2destSFCT(ILcdBounds aSourceBounds, ILcd3DEditableBounds aDestinationBoundsSFCT)	Deprecated. use sourceBounds2destinationSFCT(com.luciad.shape.ILcdBounds, com.luciad.shape.shape3D.ILcd3DEditableBounds)
void	sourcePoint2destinationSFCT(ILcdPoint aSourcePoint, ILcd3DEditablePoint aDestinationPointSFCT)	Transforms a point from the source ILcdGeoReference to the destination ILcdGeoReference.
void	sourcePoint2destSFCT(ILcdPoint aSourcePoint, ILcd3DEditablePoint aDestinationPointSFCT)	Deprecated. use sourcePoint2destinationSFCT(com.luciad.shape.ILcdPoint, com.luciad.shape.shape3D.ILcd3DEditablePoint).

Methods inherited from class java.lang.Object

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

Constructor Details

TLcdGeoReference2GeoReference

public TLcdGeoReference2GeoReference()

Constructs a transformation utility instance with no references set. Before transforming points or bounds the source and destination reference need to be set.

See Also:

• setSourceReference(com.luciad.model.ILcdModelReference)
• setDestinationReference(com.luciad.model.ILcdModelReference)

TLcdGeoReference2GeoReference

public TLcdGeoReference2GeoReference(ILcdGeoReference aSourceReference,
 ILcdGeoReference aDestinationReference)

Constructs a transformation utility instance with the given references as source and destination reference.

Parameters:

aSourceReference - the reference designated as source reference.

aDestinationReference - the reference designated as destination reference.

Method Details

isValid

public boolean isValid()

Returns whether this TLcdModelModelTransformation has a valid transformation.

Returns:

whether this TLcdModelModelTransformation has a valid transformation.

getSourceReference

public ILcdGeoReference getSourceReference()

Returns the source ILcdGeoReference of this TLcdModelModelTransformation.

Returns:

the source ILcdGeoReference of this TLcdModelModelTransformation.

See Also:

• setSourceReference(com.luciad.model.ILcdModelReference)

setSourceReference

public void setSourceReference(ILcdModelReference aSourceReference)

Sets the source ILcdModelReference.

Specified by:

setSourceReference in interface ILcdModelModelTransformation

Parameters:

aSourceReference - the source ILcdModelReference.

Throws:

IllegalArgumentException - if the given reference is not a ILcdGeoReference.

setSourceReference

public void setSourceReference(ILcdGeoReference aSourceReference)

Sets the source ILcdGeoReference of this TLcdModelModelTransformation.

Parameters:

aSourceReference - the new sourceReference value.

See Also:

• getSourceReference()

getDestinationReference

public ILcdGeoReference getDestinationReference()

s Returns the destination ILcdGeoReference of this TLcdModelModelTransformation.

Returns:

the destination ILcdGeoReference of this TLcdModelModelTransformation.

See Also:

• setDestinationReference(com.luciad.model.ILcdModelReference)

setDestinationReference

public void setDestinationReference(ILcdModelReference aModelReference)

Sets the destination ILcdModelReference.

Specified by:

setDestinationReference in interface ILcdModelModelTransformation

Parameters:

aModelReference - the destination ILcdModelReference.

Throws:

IllegalArgumentException - if the given reference is not a ILcdGeoReference.

setDestinationReference

public void setDestinationReference(ILcdGeoReference aDestinationReference)

Sets the destination ILcdGeoReference of this TLcdModelModelTransformation.

Parameters:

aDestinationReference - the new destinationReference value.

See Also:

• getDestinationReference()

destPoint2sourceSFCT

@Deprecated
public void destPoint2sourceSFCT(ILcdPoint aDestinationPoint,
 ILcd3DEditablePoint aSourcePointSFCT)
                          throws TLcdOutOfBoundsException

Deprecated.

use destinationPoint2sourceSFCT(com.luciad.shape.ILcdPoint, com.luciad.shape.shape3D.ILcd3DEditablePoint).

Parameters:

aDestinationPoint - the point within the destination ILcdGeoReference.

aSourcePointSFCT - the transformed point within the source ILcdGeoReference by side effect. This should be a different point than aDestinationPoint

Throws:

TLcdOutOfBoundsException - if the point is outside the valid area.

sourcePoint2destSFCT

@Deprecated
public void sourcePoint2destSFCT(ILcdPoint aSourcePoint,
 ILcd3DEditablePoint aDestinationPointSFCT)
                          throws TLcdOutOfBoundsException

Deprecated.

use sourcePoint2destinationSFCT(com.luciad.shape.ILcdPoint, com.luciad.shape.shape3D.ILcd3DEditablePoint).

Parameters:

aSourcePoint - the point within the source ILcdGeoReference.

aDestinationPointSFCT - the transformed point within the destination ILcdGeoReference by side effect. This should be a different point than aSourcePoint

Throws:

TLcdOutOfBoundsException - if the point is outside the valid area.

sourcePoint2destinationSFCT

public void sourcePoint2destinationSFCT(ILcdPoint aSourcePoint,
 ILcd3DEditablePoint aDestinationPointSFCT)
                                 throws TLcdOutOfBoundsException

Transforms a point from the source ILcdGeoReference to the destination ILcdGeoReference.

Specified by:

sourcePoint2destinationSFCT in interface ILcdModelModelTransformation

Parameters:

aSourcePoint - the point within the source ILcdGeoReference.

aDestinationPointSFCT - the transformed point within the destination ILcdGeoReference by side effect. This should be a different point than aSourcePoint

Throws:

TLcdOutOfBoundsException - if the point is outside the valid area.

destinationPoint2sourceSFCT

public void destinationPoint2sourceSFCT(ILcdPoint aDestinationPoint,
 ILcd3DEditablePoint aSourcePointSFCT)
                                 throws TLcdOutOfBoundsException

Transforms a point from the destination ILcdGeoReference to the source ILcdGeoReference.

Specified by:

destinationPoint2sourceSFCT in interface ILcdModelModelTransformation

Parameters:

aDestinationPoint - the point within the destination ILcdGeoReference.

aSourcePointSFCT - the transformed point within the source ILcdGeoReference by side effect. This should be a different point than aDestinationPoint

Throws:

TLcdOutOfBoundsException - if the point is outside the valid area.

sourceBounds2destSFCT

@Deprecated
public void sourceBounds2destSFCT(ILcdBounds aSourceBounds,
 ILcd3DEditableBounds aDestinationBoundsSFCT)
                           throws TLcdNoBoundsException

Deprecated.

use sourceBounds2destinationSFCT(com.luciad.shape.ILcdBounds, com.luciad.shape.shape3D.ILcd3DEditableBounds)

Transforms a bounds from the source ILcdGeoReference to the destination ILcdGeoReference.

Parameters:

aSourceBounds - the bounds within the source ILcdGeoReference.

aDestinationBoundsSFCT - the transformed bounds within the destination ILcdGeoReference by side effect.

Throws:

TLcdNoBoundsException - if the bounds cannot be determined.

sourceBounds2destinationSFCT

public void sourceBounds2destinationSFCT(ILcdBounds aSourceBounds,
 ILcd3DEditableBounds aDestinationBoundsSFCT)
                                  throws TLcdNoBoundsException

Transforms a bounds from the source ILcdGeoReference to the destination ILcdGeoReference.

Specified by:

sourceBounds2destinationSFCT in interface ILcdModelModelTransformation

Parameters:

aSourceBounds - the bounds within the source ILcdGeoReference.

aDestinationBoundsSFCT - the transformed bounds within the destination ILcdGeoReference by side effect.

Throws:

TLcdNoBoundsException - if the bounds cannot be determined.

destBounds2sourceSFCT

@Deprecated
public void destBounds2sourceSFCT(ILcdBounds aDestinationBounds,
 ILcd3DEditableBounds aSourceBoundsSFCT)
                           throws TLcdNoBoundsException

Deprecated.

use destinationBounds2sourceSFCT(com.luciad.shape.ILcdBounds, com.luciad.shape.shape3D.ILcd3DEditableBounds).

Transforms a bounds from the source ILcdGeoReference to the destination ILcdGeoReference.

Parameters:

aDestinationBounds - the bounds within the destination ILcdGeoReference.

aSourceBoundsSFCT - the transformed bounds within the source ILcdGeoReference by side effect.

Throws:

TLcdNoBoundsException - if the bounds cannot be determined.

destinationBounds2sourceSFCT

public void destinationBounds2sourceSFCT(ILcdBounds aDestinationBounds,
 ILcd3DEditableBounds aSourceBoundsSFCT)
                                  throws TLcdNoBoundsException

Transforms a bounds from the destination ILcdGeoReference to the source ILcdGeoReference.

Specified by:

destinationBounds2sourceSFCT in interface ILcdModelModelTransformation

Parameters:

aDestinationBounds - the bounds within the destination ILcdGeoReference.

aSourceBoundsSFCT - the transformed bounds within the source ILcdGeoReference by side effect.

Throws:

TLcdNoBoundsException - if the bounds cannot be determined.