Class TLcdLonLatRhumbPolyline
 All Implemented Interfaces:
ILcdBounded
,ILcdCurve
,ILcdPointList
,ILcdPointList2
,ILcdPolyline
,ILcdPolypoint
,ILcdShape
,ILcd2DEditablePointList
,ILcd2DEditablePolyline
,ILcd2DEditablePolypoint
,ILcd2DEditableShape
,ILcdCache
,ILcdCloneable
,ILcdInvalidateable
,Serializable
,Cloneable
ILcd2DEditablePolyline
in the geodetic space.
In addition to the properties defined by ILcd2DEditablePolyline
,
a TLcdLonLatRhumbPolyline
has an ellipsoid on which it lives.
Contrary to TLcdLonLatPolyline
, the line segments are not located on geodesics.
Instead the segments are lines of constant azimuth.
All longitude/latitude coordinates are expressed in degrees.
This class is threadsafe for concurrent readonly access of its contents. For readwrite access, external locking must be used. Such locking is typically done at the model level.
 Since:
 9.0
 See Also:

Field Summary
Fields inherited from class com.luciad.shape.shape2D.ALcd2DEditablePolypoint
fBounds, fFocusPoint
Fields inherited from interface com.luciad.shape.ILcdCurve
INTERPOLATION_CIRCLE_BY_3POINTS, INTERPOLATION_CIRCLE_BY_CENTERPOINT, INTERPOLATION_CIRCULARARC_BY_3POINTS, INTERPOLATION_CIRCULARARC_BY_BULGE, INTERPOLATION_CIRCULARARC_BY_CENTERPOINT, INTERPOLATION_ELLIPTICAL, INTERPOLATION_GEODESIC, INTERPOLATION_LINEAR, INTERPOLATION_MIXED, INTERPOLATION_RHUMB

Constructor Summary
ConstructorDescriptionConstructs a polyline with no points that is defined on the default ellipsoid.TLcdLonLatRhumbPolyline
(ILcdEllipsoid aEllipsoid) Constructs a polyline with no points that is defined on the given ellipsoid.TLcdLonLatRhumbPolyline
(ILcd2DEditablePointList a2DEditablePointList) Constructs a polyline with the given point list on the default ellipsoid.TLcdLonLatRhumbPolyline
(ILcd2DEditablePointList a2DEditablePointList, ILcdEllipsoid aEllipsoid) Constructs a polyline with the given point list on the given ellipsoid. 
Method Summary
Modifier and TypeMethodDescriptionprotected void
The bounds are determined by including all points that determine the polyline.clone()
Creates and returns a copy of this object.void
computePointSFCT
(double aParam, ILcd3DEditablePoint aPointSFCT) Computes a point of the curve, defined by the given parameter.boolean
contains2D
(double x, double y) Checks whether thisILcdShape
contains the given point in the 2D space.boolean
contains2D
(ILcdPoint aPoint) Checks whether thisALcdShape
contains the given point in the 2D cartesian plane.boolean
Returns whether the given object has the same class, the same focus point, the same coordinates, and the same ellipsoid.Returns the ellipsoid on which this shape is defined.Retrieves the end point of the curve.double
Returns the angle of the curve's tangent at the end point, in degrees counterclockwise from the direction at 3 o'clock.Returns the interpolation method used by this curve.double
getLength2D
(double aParam1, double aParam2) Returns the length between two points of the curve, defined by the given parameters.int
Returns the number of intersections between this curve and a line segment defined by the two specified points.Retrieves the start point of the curve.double
Returns the angle of the curve's tangent at the start point, in degrees counterclockwise from the direction at 3 o'clock.double
getTangent2D
(double aParam) Returns the angle of the curve's tangent in the point defined by the given parameter, in degrees counterclockwise from the direction at 3 o'clock.int
hashCode()
The hash code of this shape is the hash code of its class, in order to be consistent with theALcdShape.equals(Object)
method.void
setEllipsoid
(ILcdEllipsoid aEllipsoid) Sets the ellipsoid on which this shape is defined.Methods inherited from class com.luciad.shape.shape2D.TLcdLonLatPolypoint
calculateFocusPoint
Methods inherited from class com.luciad.shape.shape2D.ALcd2DEditablePolypoint
clearCache, get2DEditablePointList, getBounds, getCachedObject, getFocusPoint, getPoint, getPointCount, getPointSFCT, getX, getY, getZ, insert2DPoint, insertIntoCache, invalidateBounds, invalidateObject, move2D, move2DPoint, removeCachedObject, removePointAt, set2DEditablePointList, setFocusPoint, toString, translate2D, translate2DPoint
Methods inherited from class com.luciad.shape.shape2D.ALcd2DEditableShape
contains3D, move2D
Methods inherited from class com.luciad.shape.ALcdShape
contains3D, fromDomainObject
Methods inherited from class java.lang.Object
finalize, getClass, notify, notifyAll, wait, wait, wait
Methods inherited from interface com.luciad.shape.shape2D.ILcd2DEditablePointList
append2DPoint, insert2DPoint, move2DPoint, removePointAt, translate2D, translate2DPoint
Methods inherited from interface com.luciad.shape.shape2D.ILcd2DEditableShape
move2D, move2D, translate2D
Methods inherited from interface com.luciad.shape.ILcdBounded
getBounds
Methods inherited from interface com.luciad.util.ILcdCache
clearCache, getCachedObject, insertIntoCache, removeCachedObject
Methods inherited from interface com.luciad.shape.ILcdPointList
getPoint, getPointCount, getPointSFCT, getX, getY, getZ
Methods inherited from interface com.luciad.shape.ILcdShape
contains3D, contains3D, getFocusPoint

Constructor Details

TLcdLonLatRhumbPolyline
public TLcdLonLatRhumbPolyline()Constructs a polyline with no points that is defined on the default ellipsoid. 
TLcdLonLatRhumbPolyline
Constructs a polyline with no points that is defined on the given ellipsoid. Parameters:
aEllipsoid
 the ellipsoid on which this shape is defined.

TLcdLonLatRhumbPolyline
Constructs a polyline with the given point list on the default ellipsoid. Parameters:
a2DEditablePointList
 the point list that contains the points of the polyline.

TLcdLonLatRhumbPolyline
public TLcdLonLatRhumbPolyline(ILcd2DEditablePointList a2DEditablePointList, ILcdEllipsoid aEllipsoid) Constructs a polyline with the given point list on the given ellipsoid. Parameters:
a2DEditablePointList
 the point list that contains the points of the polyline.aEllipsoid
 the ellipsoid on which this shape is defined.


Method Details

getEllipsoid
Returns the ellipsoid on which this shape is defined. Returns:
 the ellipsoid on which this shape is defined.

setEllipsoid
Sets the ellipsoid on which this shape is defined. Parameters:
aEllipsoid
 the new ellipsoid on which this shape is defined.

calculateBounds
protected void calculateBounds()The bounds are determined by including all points that determine the polyline. Sample points are taken on each line segment in order to take the geodesic characteristics into account. Since the maximum or minimum may be missed this way a small extension of the bounds is applied. Overrides:
calculateBounds
in classTLcdLonLatPolypoint

contains2D
Description copied from class:ALcdShape
Checks whether thisALcdShape
contains the given point in the 2D cartesian plane. Specified by:
contains2D
in interfaceILcdShape
 Overrides:
contains2D
in classALcdShape
 Parameters:
aPoint
 the point to test. Returns:
 the boolean result of the containment test.
 See Also:

contains2D
public boolean contains2D(double x, double y) Description copied from interface:ILcdShape
Checks whether thisILcdShape
contains the given point in the 2D space. Only the first two dimensions of theILcdShape
are considered. Specified by:
contains2D
in interfaceILcdShape
 Overrides:
contains2D
in classALcd2DEditablePolypoint
 Parameters:
x
 the x coordinate of the point.y
 the y coordinate of the point. Returns:
 the boolean result of the containment test.

computePointSFCT
Description copied from interface:ILcdCurve
Computes a point of the curve, defined by the given parameter. At parameter 0, the point is the same as
ILcdCurve.getStartPoint()
.  At parameter 1, the point is the same as
ILcdCurve.getEndPoint()
.
 Specified by:
computePointSFCT
in interfaceILcdCurve
 Parameters:
aParam
 a value of the closed interval [0,1]aPointSFCT
 the point to store the computed curve point in
 At parameter 0, the point is the same as

getEndPoint
Description copied from interface:ILcdCurve
Retrieves the end point of the curve.This is equivalent to
computePointSFCT(1)
. Specified by:
getEndPoint
in interfaceILcdCurve
 Returns:
 the end point of the curve

getEndTangent2D
public double getEndTangent2D()Description copied from interface:ILcdCurve
Returns the angle of the curve's tangent at the end point, in degrees counterclockwise from the direction at 3 o'clock.The tangent orientation is from the end point, away from the curve before it.
This is the same as
getTangent2D(1)
. Specified by:
getEndTangent2D
in interfaceILcdCurve
 Returns:
 the curve's angle in the end point

getInterpolation
Description copied from interface:ILcdCurve
Returns the interpolation method used by this curve.A set of predefined constants are defined in this interface, which are used by the default
ILcdCurve
implementations provided by LuciadLightspeed.Custom implementations can define their own constants, and use them to interpret the interpolation of the curve.
 Specified by:
getInterpolation
in interfaceILcdCurve
 Returns:
 the interpolation method used by this curve.

getLength2D
public double getLength2D(double aParam1, double aParam2) Description copied from interface:ILcdCurve
Returns the length between two points of the curve, defined by the given parameters. When
aParam1 == aParam2
, the length is 0.  When
aParam1 == 0 and aParam2 == 1
, the length is the whole length of the curve.  When
aParam1 > aParam2
, the length is (aParam1 to 1
) + (0 to aParam2
).
 Specified by:
getLength2D
in interfaceILcdCurve
 Parameters:
aParam1
 a value of the closed interval [0,1]aParam2
 a value of the closed interval [0,1] Returns:
 the length of the curve.
 When

getLineSegmentIntersectionCount
Description copied from interface:ILcdCurve
Returns the number of intersections between this curve and a line segment defined by the two specified points.This information can be used to perform containment calculations, if this curve is closed or if this curve is part of a composite closed curve. By determining the number of intersections between this curve and a line segment starting from a given point in a fixed direction, one can determine whether a point is located within the closed curve by using the evenodd rule.
 Specified by:
getLineSegmentIntersectionCount
in interfaceILcdCurve
 Parameters:
aP1
 the first point of the line segmentaP2
 the second point of the line segment Returns:
 the number of intersections between the curve and the line segment

getStartPoint
Description copied from interface:ILcdCurve
Retrieves the start point of the curve.This is equivalent to
computePointSFCT(0)
. Specified by:
getStartPoint
in interfaceILcdCurve
 Returns:
 the start point of the curve

getStartTangent2D
public double getStartTangent2D()Description copied from interface:ILcdCurve
Returns the angle of the curve's tangent at the start point, in degrees counterclockwise from the direction at 3 o'clock.The tangent orientation is from the start point towards the rest of the shape.
This is the same as
getTangent2D(0)
. Specified by:
getStartTangent2D
in interfaceILcdCurve
 Returns:
 the curve's angle in the start point

getTangent2D
public double getTangent2D(double aParam) Description copied from interface:ILcdCurve
Returns the angle of the curve's tangent in the point defined by the given parameter, in degrees counterclockwise from the direction at 3 o'clock.The tangent orientation is from the point at parameter
aParam
towards the rest of the shape. The tangent at parameter 0 is the same as
ILcdCurve.getStartTangent2D()
.  The tangent at parameter 1 is the same as
ILcdCurve.getEndTangent2D()
.
 Specified by:
getTangent2D
in interfaceILcdCurve
 Parameters:
aParam
 a value of the closed interval [0,1] Returns:
 the curve's angle in the point defined by the given parameter
 The tangent at parameter 0 is the same as

clone
Creates and returns a copy of this object.The contained editable points list is cloned.
The contained ellipsoid is copied without being cloned.
The cache, the bounds and the focus point are not copied or cloned at all, but recalculated when needed.
 Specified by:
clone
in interfaceILcdCloneable
 Overrides:
clone
in classTLcdLonLatPolypoint
 See Also:

equals
Returns whether the given object has the same class, the same focus point, the same coordinates, and the same ellipsoid. Overrides:
equals
in classALcd2DEditablePolypoint

hashCode
public int hashCode()Description copied from class:ALcdShape
The hash code of this shape is the hash code of its class, in order to be consistent with theALcdShape.equals(Object)
method. Extensions should refine this implementation, based on their properties. Overrides:
hashCode
in classALcd2DEditablePolypoint
