public class TLcdTerrainDistanceUtil
extends java.lang.Object
Constructor and Description 

TLcdTerrainDistanceUtil() 
Modifier and Type  Method and Description 

boolean 
isTraceOn()
Deprecated.
This method has been deprecated. It is recommended to use the
standard Java logging framework directly.

static void 
setClassTraceOn(boolean aClassTraceOn)
Deprecated.
This method has been deprecated. It is recommended to use the
standard Java logging framework directly.

void 
setModelModelTransformation(ILcdModelModelTransformation aModelModelTransformation)
Sets the model to model transformation to enable transformation of the start and end point
to the segment scanners reference.

void 
setTraceOn(boolean aTraceOn)
Deprecated.
This method has been deprecated. It is recommended to use the
standard Java logging framework directly.

double 
terrainDistance(ILcdPoint aStartPoint,
ILcdGeoReference aStartPointReference,
ILcdPoint aEndPoint,
ILcdGeoReference aEndPointReference,
ILcdSegmentScanner aSegmentScanner,
ALcdTerrainElevationProvider aTerrainElevationProvider,
double aStepSize)
Computes the distance between two points taking into account the terrain underneath and the path
defined by the segment scanner.

double 
terrainDistance(ILcdPoint aStartPoint,
ILcdGeoReference aStartPointReference,
ILcdPoint aEndPoint,
ILcdGeoReference aEndPointReference,
ILcdSegmentScanner aSegmentScanner,
ALcdTerrainElevationProvider aTerrainElevationProvider,
double aStartStepSize,
int aMaximumSamples,
double aAbsoluteTolerance,
double aRelativeTolerance,
double aMinStepSize)
Computes the distance between two points taking into account the terrain underneath and the path
defined by the segment scanner.

public double terrainDistance(ILcdPoint aStartPoint, ILcdGeoReference aStartPointReference, ILcdPoint aEndPoint, ILcdGeoReference aEndPointReference, ILcdSegmentScanner aSegmentScanner, ALcdTerrainElevationProvider aTerrainElevationProvider, double aStepSize)
aStartPoint
 the starting point.aStartPointReference
 the reference the start points coordinates are expressed in.aEndPoint
 the end point.aEndPointReference
 the reference the end points coordinates are expressed in.aSegmentScanner
 defines the path between the start and end point.aTerrainElevationProvider
 provides elevation information for intermediate points.aStepSize
 defines the number of points the segment scanner will generate in between the
start and end point. Expressed in meters.public double terrainDistance(ILcdPoint aStartPoint, ILcdGeoReference aStartPointReference, ILcdPoint aEndPoint, ILcdGeoReference aEndPointReference, ILcdSegmentScanner aSegmentScanner, ALcdTerrainElevationProvider aTerrainElevationProvider, double aStartStepSize, int aMaximumSamples, double aAbsoluteTolerance, double aRelativeTolerance, double aMinStepSize)
aStartPoint
 the starting point.aStartPointReference
 the reference the start points coordinates are expressed in.aEndPoint
 the end point.aEndPointReference
 the reference the end points coordinates are expressed in.aSegmentScanner
 defines the path between the start and end point.aTerrainElevationProvider
 provides elevation information for intermediate points.aStartStepSize
 defines the number of points the segment scanner will generate in between the
start and end point in the first calculation. If this is smaller than the minimum step size then the
minimum step size is used.aMaximumSamples
 the maximum number of intermediate points in one calculation step to be used for the
distance calculation.aAbsoluteTolerance
 an upper limit, expressed in meters, for the difference
between two consecutive calculations for the distance measurement of one segment.aRelativeTolerance
 an upper limit for the difference relative to the total distance between two consecutive
calculations for the distance measurement calculated for one segment.aMinStepSize
 the minimum distance between two points used in the calculation.public void setModelModelTransformation(ILcdModelModelTransformation aModelModelTransformation)
aModelModelTransformation
 the transformation to use to transform the start and end point
to the scanners reference. This will enable the scanner to produce meaningful points in between the
start and end point.public static void setClassTraceOn(boolean aClassTraceOn)
true
then all log messages are recorded, otherwise only
the informative, warning and error messages are recorded.aClassTraceOn
 if true then all log messages are recorded,
otherwise only the informative, warning and error messages are recorded.public void setTraceOn(boolean aTraceOn)
true
or false
as argument automatically turns
off tracing for all other class instances for which
setTraceOn
has not been called.
If the argument is false
then only the informative, warning
and error log messages are recorded.aTraceOn
 if true then all log messages are recorded for this
instance. If false, then only the informative, warning and
error log messages are recorded.public boolean isTraceOn()
true
if tracing is enabled for this class.