Class TLcdLonLatCircularArcBy3Points
- All Implemented Interfaces:
ILcdBounded
,ILcdCircularArc
,ILcdCircularArcBy3Points
,ILcdCurve
,ILcdShape
,ILcd2DEditableCircularArcBy3Points
,ILcd2DEditableShape
,ILcdCache
,ILcdCloneable
,Serializable
,Cloneable
ILcd2DEditableCircularArcBy3Points
in the geodetic space.
In addition to the properties defined by ILcd2DEditableCircularArcBy3Points
,
a TLcdLonLatCircularArcBy3Points
has an ellipsoid on which it lives.
All longitude/latitude coordinates are expressed in degrees.
This class is thread-safe for concurrent read-only access of its contents. For read-write 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 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
ConstructorDescriptionDefault constructor, initializing the three points at (0,0).TLcdLonLatCircularArcBy3Points
(double aStartX, double aStartY, double aIntermediateX, double aIntermediateY, double aEndX, double aEndY, ILcdEllipsoid aEllipsoid) Creates a new circular arc using the given point coordinates and ellipsis.TLcdLonLatCircularArcBy3Points
(ILcdEllipsoid aEllipsoid) Default constructor, initializing the three points at (0,0).TLcdLonLatCircularArcBy3Points
(ILcdPoint aStartPoint, ILcdPoint aIntermediatePoint, ILcdPoint aEndPoint, ILcdEllipsoid aEllipsoid) Creates a new circular arc using the given points and ellipsis. -
Method Summary
Modifier and TypeMethodDescriptionvoid
Clears the cache.clone()
Creates and returns a copy of this object, by delegating toObject.clone()
.void
computePointSFCT
(double aParam, ILcd3DEditablePoint aPointSFCT) Computes a point of the curve, defined by the given parameter.boolean
contains2D
(double aX, double aY) Checks whether thisILcdShape
contains the given point in the 2D space.boolean
An object is considered equal to this shape if it has the same class.double
Returns the angle over which thisILcdCircularArc
extends (in degrees).Returns theILcdBounds
by which the geometry of thisILcdBounded
object is bounded.getCachedObject
(Object aKey) Looks up and returns the cached Object corresponding to the given key.Returns the center of thisILcdCircularArc
.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 focus point of thisILcdShape
.Returns an intermediate point of this arc.Returns the interpolation method used by this curve, which isILcdCurve.INTERPOLATION_CIRCULARARC_BY_3POINTS
.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.double
Returns the radius of thisILcdCircularArc
.double
Returns the start angle of thisILcdCircularArc
(in degrees).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
insertIntoCache
(Object aKey, Object aObject) Inserts a cache Object corresponding to the given key Object.void
moveEndPoint2D
(double aX, double aY) Moves the end point to the given point in the 2D space.void
moveIntermediatePoint2D
(double aX, double aY) Moves the intermediate point to the given point in the 2D space.void
moveStartPoint2D
(double aX, double aY) Moves the start point to the given point in the 2D space.removeCachedObject
(Object aKey) Looks up and removes the cached Object corresponding to the given key.void
setEllipsoid
(ILcdEllipsoid aEllipsoid) Sets the ellipsoid of thisTLcdLonLatCircularArcBy3Points
.toString()
void
translate2D
(double aDeltaX, double aDeltaY) Translates thisILcd2DEditableShape
from its current position over the given translation vector in the 2D space.void
translateEndPoint2D
(double aDeltaX, double aDeltaY) Translates the end point from its current position over the given translation vector in the 2D space.void
translateIntermediatePoint2D
(double aDeltaX, double aDeltaY) Translates the intermediate point from its current position over the given translation vector in the 2D space.void
translateStartPoint2D
(double aDeltaX, double aDeltaY) Translates the start point from its current position over the given translation vector in the 2D space.Methods inherited from class com.luciad.shape.shape2D.ALcd2DEditableShape
contains3D, move2D, move2D
Methods inherited from class com.luciad.shape.ALcdShape
contains2D, contains3D, fromDomainObject
Methods inherited from class java.lang.Object
finalize, getClass, notify, notifyAll, wait, wait, wait
Methods inherited from interface com.luciad.shape.shape2D.ILcd2DEditableShape
move2D, move2D
Methods inherited from interface com.luciad.shape.ILcdShape
contains2D, contains3D, contains3D
-
Constructor Details
-
TLcdLonLatCircularArcBy3Points
public TLcdLonLatCircularArcBy3Points()Default constructor, initializing the three points at (0,0). After creation, an ellipsoid must be set usingsetEllipsoid(com.luciad.geodesy.ILcdEllipsoid)
in order for the shape to be usable. -
TLcdLonLatCircularArcBy3Points
Default constructor, initializing the three points at (0,0).- Parameters:
aEllipsoid
- the ellipsoid on which this shape is defined.
-
TLcdLonLatCircularArcBy3Points
public TLcdLonLatCircularArcBy3Points(ILcdPoint aStartPoint, ILcdPoint aIntermediatePoint, ILcdPoint aEndPoint, ILcdEllipsoid aEllipsoid) Creates a new circular arc using the given points and ellipsis.- Parameters:
aStartPoint
- the start point of the arcaIntermediatePoint
- a point on the arc that is not the start nor the end pointaEndPoint
- the end point of the arcaEllipsoid
- the ellipsoid on which this shape is defined.
-
TLcdLonLatCircularArcBy3Points
public TLcdLonLatCircularArcBy3Points(double aStartX, double aStartY, double aIntermediateX, double aIntermediateY, double aEndX, double aEndY, ILcdEllipsoid aEllipsoid) Creates a new circular arc using the given point coordinates and ellipsis.- Parameters:
aStartX
- X-coordinate of the arc's start pointaStartY
- Y-coordinate of the arc's start pointaIntermediateX
- X-coordinate of a point on the arc that is not the start nor the end pointaIntermediateY
- Y-coordinate of a point on the arc that is not the start nor the end pointaEndX
- X-coordinate of the arc's end pointaEndY
- Y-coordinate of the arc's end pointaEllipsoid
- the ellipsoid on which this shape is defined.
-
-
Method Details
-
getCenter
Description copied from interface:ILcdCircularArc
Returns the center of thisILcdCircularArc
.- Specified by:
getCenter
in interfaceILcdCircularArc
- Returns:
- the center of this
ILcdCircularArc
.
-
getRadius
public double getRadius()Description copied from interface:ILcdCircularArc
Returns the radius of thisILcdCircularArc
.- Specified by:
getRadius
in interfaceILcdCircularArc
- Returns:
- the radius of this
ILcdCircularArc
.
-
getStartAngle
public double getStartAngle()Description copied from interface:ILcdCircularArc
Returns the start angle of thisILcdCircularArc
(in degrees). The angle is measured from 3 o'clock position, positive counter-clockwise.- Specified by:
getStartAngle
in interfaceILcdCircularArc
- Returns:
- the start angle of the arc (in degrees). The angle is measured from 3 o'clock position, positive counter-clockwise.
-
getArcAngle
public double getArcAngle()Description copied from interface:ILcdCircularArc
Returns the angle over which thisILcdCircularArc
extends (in degrees). The angle is positive counter-clockwise.- Specified by:
getArcAngle
in interfaceILcdCircularArc
- Returns:
- the angle over which the arc extends (in degrees). The angle is positive counter-clockwise.
-
getEllipsoid
- Returns:
- the ellipsoid of this
TLcdLonLatCircularArcBy3Points
.
-
setEllipsoid
Sets the ellipsoid of thisTLcdLonLatCircularArcBy3Points
.- Parameters:
aEllipsoid
- the new ellipsoid.
-
getFocusPoint
Description copied from interface:ILcdShape
Returns the focus point of thisILcdShape
.- Specified by:
getFocusPoint
in interfaceILcdShape
- Returns:
- the focus point of this
ILcdShape
.
-
contains2D
public boolean contains2D(double aX, double aY) 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
- Parameters:
aX
- the x coordinate of the point.aY
- the y coordinate of the point.- Returns:
- the boolean result of the containment test.
-
getBounds
Description copied from interface:ILcdBounded
Returns theILcdBounds
by which the geometry of thisILcdBounded
object is bounded.If the geometry does not allow retrieving valid bounds (for example a polyline with 0 points) the return value is unspecified. It is highly recommended to return an
undefined
bounds. You can create undefined bounds using the default constructors ofTLcdLonLatBounds
orTLcdXYBounds
.- Specified by:
getBounds
in interfaceILcdBounded
- Returns:
- the
ILcdBounds
by which the geometry of thisILcdBounded
object is bounded.
-
translate2D
public void translate2D(double aDeltaX, double aDeltaY) Description copied from interface:ILcd2DEditableShape
Translates thisILcd2DEditableShape
from its current position over the given translation vector in the 2D space. Only the first two dimensions of theILcdShape
are considered. The third dimension is left unchanged.- Specified by:
translate2D
in interfaceILcd2DEditableShape
- Parameters:
aDeltaX
- the x coordinate of the translation vector.aDeltaY
- the y coordinate of the translation vector.
-
moveStartPoint2D
public void moveStartPoint2D(double aX, double aY) Description copied from interface:ILcd2DEditableCircularArcBy3Points
Moves the start point to the given point in the 2D space. Only the first two dimensions of theILcdShape
are considered. The third dimension is left unchanged.- Specified by:
moveStartPoint2D
in interfaceILcd2DEditableCircularArcBy3Points
- Parameters:
aX
- the x coordinate of the point.aY
- the y coordinate of the point.
-
moveEndPoint2D
public void moveEndPoint2D(double aX, double aY) Description copied from interface:ILcd2DEditableCircularArcBy3Points
Moves the end point to the given point in the 2D space. Only the first two dimensions of theILcdShape
are considered. The third dimension is left unchanged.- Specified by:
moveEndPoint2D
in interfaceILcd2DEditableCircularArcBy3Points
- Parameters:
aX
- the x coordinate of the point.aY
- the y coordinate of the point.
-
moveIntermediatePoint2D
public void moveIntermediatePoint2D(double aX, double aY) Description copied from interface:ILcd2DEditableCircularArcBy3Points
Moves the intermediate point to the given point in the 2D space. Only the first two dimensions of theILcdShape
are considered. The third dimension is left unchanged.- Specified by:
moveIntermediatePoint2D
in interfaceILcd2DEditableCircularArcBy3Points
- Parameters:
aX
- the x coordinate of the point.aY
- the y coordinate of the point.
-
translateStartPoint2D
public void translateStartPoint2D(double aDeltaX, double aDeltaY) Description copied from interface:ILcd2DEditableCircularArcBy3Points
Translates the start point from its current position over the given translation vector in the 2D space. Only the first two dimensions of the points are considered. The third dimension is left unchanged.- Specified by:
translateStartPoint2D
in interfaceILcd2DEditableCircularArcBy3Points
- Parameters:
aDeltaX
- the x coordinate of the translation vector.aDeltaY
- the y coordinate of the translation vector.
-
translateEndPoint2D
public void translateEndPoint2D(double aDeltaX, double aDeltaY) Description copied from interface:ILcd2DEditableCircularArcBy3Points
Translates the end point from its current position over the given translation vector in the 2D space. Only the first two dimensions of the points are considered. The third dimension is left unchanged.- Specified by:
translateEndPoint2D
in interfaceILcd2DEditableCircularArcBy3Points
- Parameters:
aDeltaX
- the x coordinate of the translation vector.aDeltaY
- the y coordinate of the translation vector.
-
translateIntermediatePoint2D
public void translateIntermediatePoint2D(double aDeltaX, double aDeltaY) Description copied from interface:ILcd2DEditableCircularArcBy3Points
Translates the intermediate point from its current position over the given translation vector in the 2D space. Only the first two dimensions of the points are considered. The third dimension is left unchanged.- Specified by:
translateIntermediatePoint2D
in interfaceILcd2DEditableCircularArcBy3Points
- Parameters:
aDeltaX
- the x coordinate of the translation vector.aDeltaY
- the y coordinate of the translation vector.
-
getIntermediatePoint
Description copied from interface:ILcdCircularArcBy3Points
Returns an intermediate point of this arc.- Specified by:
getIntermediatePoint
in interfaceILcdCircularArcBy3Points
- Returns:
- an intermediate point of this arc.
-
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
-
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
-
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
-
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
-
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
-
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
-
getInterpolation
Returns the interpolation method used by this curve, which isILcdCurve.INTERPOLATION_CIRCULARARC_BY_3POINTS
.- Specified by:
getInterpolation
in interfaceILcdCircularArc
- Specified by:
getInterpolation
in interfaceILcdCircularArcBy3Points
- Specified by:
getInterpolation
in interfaceILcdCurve
- Returns:
- the interpolation method used by this curve,
which is
INTERPOLATION_CIRCULARARC_BY_3POINTS
.
-
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
-
insertIntoCache
Description copied from interface:ILcdCache
Inserts a cache Object corresponding to the given key Object.- Specified by:
insertIntoCache
in interfaceILcdCache
- Parameters:
aKey
- the key Object that will be used to identify the Object. The key must therefore be a unique identifier, typically the caller itself:insertIntoCache(this, ...)
.aObject
- the Object to be cached.
-
getCachedObject
Description copied from interface:ILcdCache
Looks up and returns the cached Object corresponding to the given key.- Specified by:
getCachedObject
in interfaceILcdCache
- Parameters:
aKey
- the key Object that was used for storing the cache Object.- Returns:
- the cached Object, or null if there is no Object corresponding to the given key.
-
removeCachedObject
Description copied from interface:ILcdCache
Looks up and removes the cached Object corresponding to the given key.- Specified by:
removeCachedObject
in interfaceILcdCache
- Parameters:
aKey
- the key Object that was used for storing the cache Object.- Returns:
- the cached Object, or null if there was no Object corresponding to the given key.
-
clearCache
public void clearCache()Description copied from interface:ILcdCache
Clears the cache.- Specified by:
clearCache
in interfaceILcdCache
-
clone
Description copied from class:ALcdShape
Creates and returns a copy of this object, by delegating toObject.clone()
. Extensions should delegate to this implementation withsuper.clone()
, in order to create an object instance of the right type, with all fields copied. They then should explicitly clone any non-primitive fields for which a deeper clone is required.- Specified by:
clone
in interfaceILcdCloneable
- Overrides:
clone
in classALcdShape
- See Also:
-
equals
Description copied from class:ALcdShape
An object is considered equal to this shape if it has the same class. Extensions should refine this comparison, based on their properties. -
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. -
toString
-
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 even-odd 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
-