Class TLcdGML31ArcByBulge
- All Implemented Interfaces:
ILcdDataObject
,ILcdBounded
,ILcdCircularArc
,ILcdCircularArcByBulge
,ILcdCompositeCurve
,ILcdCurve
,ILcdShape
,ILcd2DEditableCircularArcByBulge
,ILcd2DEditableShape
,ILcdCloneable
,ILcdDeepCloneable
,ILcdFeatured
,ILcdSelfDescribedFeatured
,Serializable
,Cloneable
- Since:
- 10.0
- See Also:
-
Field Summary
Modifier and TypeFieldDescriptionstatic final TLcdDataProperty
Data property that maps to thebulge
element.static final TLcdDataProperty
Data property that maps to theinterpolation
attribute.static final TLcdDataProperty
Data property that maps to thenormal
element.static final TLcdDataProperty
Data property that maps to thenumArc
attribute.static final TLcdDataProperty
Data property that maps to thenumDerivativeInterior
attribute.static final TLcdDataProperty
Data property that maps to thenumDerivativesAtEnd
attribute.static final TLcdDataProperty
Data property that maps to thenumDerivativesAtStart
attribute.static final TLcdDataProperty
Data property that maps to the choice between thepos
andpointProperty
andpointRep
andposList
andcoordinates
elements.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
ConstructorDescriptionTLcdGML31ArcByBulge
(double aStartX, double aStartY, double aEndX, double aEndY, double aBulge, ILcdModelReference aModelReference) Creates a new circular arc using the given point coordinates, bulge factor and model reference.TLcdGML31ArcByBulge
(TLcdDataType aType) TLcdGML31ArcByBulge
(TLcdDataType aDataType, ILcdModelReference aModelReference) Creates a new instance and initializes its posGroup with a direct position list initialized with the given model reference.TLcdGML31ArcByBulge
(ILcdModelReference aModelReference) Creates a new instance and initializes its posGroup with a direct position list initialized with the given model reference. -
Method Summary
Modifier and TypeMethodDescriptionvoid
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
contains2D
(ILcdPoint aPoint) Checks whether thisILcdShape
contains the givenILcdPoint
in the 2D space.boolean
contains3D
(double aX, double aY, double aZ) Checks whether thisILcdShape
contains the given point in the 3D space.boolean
contains3D
(ILcdPoint aPoint) Checks whether thisILcdShape
contains the givenILcdPoint
in the 3D space.double
Returns the angle over which thisILcdCircularArc
extends (in degrees).Returns theILcdBounds
by which the geometry of thisILcdBounded
object is bounded.double
getBulge()
Returns the bulge factor of this arc.Returns the value of the property that maps to thebulge
element.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 the interpolation method used by this curve.Returns the value of the property that maps to theinterpolation
attribute.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.Returns the value of the property that maps to thenormal
element.Returns the value of the property that maps to thenumArc
attribute.long
Returns the value of the property that maps to thenumDerivativeInterior
attribute.long
Returns the value of the property that maps to thenumDerivativesAtEnd
attribute.long
Returns the value of the property that maps to thenumDerivativesAtStart
attribute.protected int
Returns the value of the property that maps to the choice between thepos
andpointProperty
andpointRep
andposList
andcoordinates
elements.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.void
move2D
(double aX, double aY) Moves thisILcd2DEditableShape
to the given point in the 2D space.void
Moves thisILcd2DEditableShape
to the given point in the 2D space.void
moveEndPoint2D
(double aX, double aY) Moves the end 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.void
setBulge
(double aBulge) Sets the bulge factor to the given value.void
Sets the value of the property that maps to theinterpolation
attribute.void
Sets the value of the property that maps to thenumArc
attribute.void
setNumDerivativeInterior
(long aValue) Sets the value of the property that maps to thenumDerivativeInterior
attribute.void
setNumDerivativesAtEnd
(long aValue) Sets the value of the property that maps to thenumDerivativesAtEnd
attribute.void
setNumDerivativesAtStart
(long aValue) Sets the value of the property that maps to thenumDerivativesAtStart
attribute.void
setPosGroup
(Object aValue) Sets the value of the property that maps to the choice between thepos
andpointProperty
andpointRep
andposList
andcoordinates
elements.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
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.format.gml31.model.TLcdGML31ArcStringByBulge
clone, clone, getCurves
Methods inherited from class com.luciad.datamodel.TLcdFeaturedDataObject
canSetFeature, getFeature, getFeature, getFeatureCount, getFeaturedDescriptor, setFeature, setFeature
Methods inherited from class com.luciad.datamodel.TLcdDataObject
getDataType, getValue, getValue, hasValue, hasValue, setValue, setValue, toString
Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
Methods inherited from interface com.luciad.util.ILcdCloneable
clone
-
Field Details
-
INTERPOLATION_ATTR_PROPERTY
Data property that maps to theinterpolation
attribute. The possible values for this property are instances ofELcdGML31CurveInterpolation
. -
NUM_ARC_PROPERTY
Data property that maps to thenumArc
attribute. The possible values for this property are instances ofLong
. -
POS_GROUP_PROPERTY
Data property that maps to the choice between thepos
andpointProperty
andpointRep
andposList
andcoordinates
elements. The possible values for this property are instances ofList<TLcdGML31DirectPosition>
List<TLcdGML31PointProperty>
List<TLcdGML31PointProperty>
TLcdGML31DirectPositionList
TLcdGML31Coordinates
-
BULGE_GML_PROPERTY
Data property that maps to thebulge
element. The possible values for this property are instances ofILcdDoubleList
. -
NORMAL_PROPERTY
Data property that maps to thenormal
element. The possible values for this property are instances ofList<TLcdGML31Vector>
. -
NUM_DERIVATIVE_INTERIOR_PROPERTY
Data property that maps to thenumDerivativeInterior
attribute. The possible values for this property are instances oflong
. -
NUM_DERIVATIVES_AT_END_PROPERTY
Data property that maps to thenumDerivativesAtEnd
attribute. The possible values for this property are instances oflong
. -
NUM_DERIVATIVES_AT_START_PROPERTY
Data property that maps to thenumDerivativesAtStart
attribute. The possible values for this property are instances oflong
.
-
-
Constructor Details
-
TLcdGML31ArcByBulge
public TLcdGML31ArcByBulge() -
TLcdGML31ArcByBulge
-
TLcdGML31ArcByBulge
Creates a new instance and initializes its posGroup with a direct position list initialized with the given model reference.- Parameters:
aModelReference
- the model reference for this arc
-
TLcdGML31ArcByBulge
public TLcdGML31ArcByBulge(double aStartX, double aStartY, double aEndX, double aEndY, double aBulge, ILcdModelReference aModelReference) Creates a new circular arc using the given point coordinates, bulge factor and model reference.- Parameters:
aStartX
- the X-coordinate of the arc's start point.aStartY
- the Y-coordinate of the arc's start point.aEndX
- the X-coordinate of the arc's end point.aEndY
- the Y-coordinate of the arc's end point.aBulge
- the bulge factor of the arc.aModelReference
- the model reference
-
TLcdGML31ArcByBulge
Creates a new instance and initializes its posGroup with a direct position list initialized with the given model reference.- Parameters:
aDataType
- the data type for this arcaModelReference
- the model reference for this arc
-
-
Method Details
-
setBulge
public void setBulge(double aBulge) Description copied from interface:ILcd2DEditableCircularArcByBulge
Sets the bulge factor to the given value.- Specified by:
setBulge
in interfaceILcd2DEditableCircularArcByBulge
- Parameters:
aBulge
- the bulge factor.- See Also:
-
moveStartPoint2D
public void moveStartPoint2D(double aX, double aY) Description copied from interface:ILcd2DEditableCircularArcByBulge
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 interfaceILcd2DEditableCircularArcByBulge
- 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:ILcd2DEditableCircularArcByBulge
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 interfaceILcd2DEditableCircularArcByBulge
- 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:ILcd2DEditableCircularArcByBulge
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 interfaceILcd2DEditableCircularArcByBulge
- 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:ILcd2DEditableCircularArcByBulge
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 interfaceILcd2DEditableCircularArcByBulge
- Parameters:
aDeltaX
- the x coordinate of the translation vector.aDeltaY
- the y coordinate of the translation vector.
-
getBulge
public double getBulge()Description copied from interface:ILcdCircularArcByBulge
Returns the bulge factor of this arc. The bulge factor is the ratio of (1) the distance between the arc midpoint and the center of the arc's chord, and (2) half the length of the arc's chord. The sign of the bulge indicates whether the midpoint is on the left side (positive) or right side (negative) of the vector from start to end point. So a bulge factor with an absolute value of 1 means a half-circle, smaller than 1 means a less bulging arc and larger than 1 means an arc that bulges out in the start and end point.- Specified by:
getBulge
in interfaceILcdCircularArcByBulge
- Returns:
- the bulge factor of this arc.
-
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.
-
getStartPoint
Description copied from interface:ILcdCurve
Retrieves the start point of the curve.This is equivalent to
computePointSFCT(0)
.- Specified by:
getStartPoint
in interfaceILcdCompositeCurve
- Specified by:
getStartPoint
in interfaceILcdCurve
- Overrides:
getStartPoint
in classTLcdGML31ArcStringByBulge
- 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 interfaceILcdCompositeCurve
- Specified by:
getEndPoint
in interfaceILcdCurve
- Overrides:
getEndPoint
in classTLcdGML31ArcStringByBulge
- 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
- Overrides:
getStartTangent2D
in classTLcdGML31ArcStringByBulge
- 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
- Overrides:
getEndTangent2D
in classTLcdGML31ArcStringByBulge
- 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
- Overrides:
getTangent2D
in classTLcdGML31ArcStringByBulge
- 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
- Overrides:
getLength2D
in classTLcdGML31ArcStringByBulge
- 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
-
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
- Overrides:
computePointSFCT
in classTLcdGML31ArcStringByBulge
- 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
-
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 interfaceILcdCircularArc
- Specified by:
getInterpolation
in interfaceILcdCircularArcByBulge
- Specified by:
getInterpolation
in interfaceILcdCompositeCurve
- Specified by:
getInterpolation
in interfaceILcdCurve
- Overrides:
getInterpolation
in classTLcdGML31ArcStringByBulge
- Returns:
- the interpolation method used by this curve.
-
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
- Overrides:
getLineSegmentIntersectionCount
in classTLcdGML31ArcStringByBulge
- 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
-
move2D
Description copied from interface:ILcd2DEditableShape
Moves thisILcd2DEditableShape
to the given point in the 2D space. The focus point is used as the handle by which the shape is moved. Only the first two dimensions of theILcdShape
and theILcdPoint
are considered. The third dimension is left unchanged.- Specified by:
move2D
in interfaceILcd2DEditableShape
- Parameters:
aPoint
- theILcdPoint
to move to.- See Also:
-
move2D
public void move2D(double aX, double aY) Description copied from interface:ILcd2DEditableShape
Moves thisILcd2DEditableShape
to the given point in the 2D space. The focus point is used as the handle by which the shape is moved. Only the first two dimensions of theILcdShape
are considered. The third dimension is left unchanged.- Specified by:
move2D
in interfaceILcd2DEditableShape
- Parameters:
aX
- the x coordinate of the point.aY
- the y coordinate of the point.
-
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.
-
getFocusPoint
Description copied from interface:ILcdShape
Returns the focus point of thisILcdShape
.- Specified by:
getFocusPoint
in interfaceILcdShape
- Overrides:
getFocusPoint
in classTLcdGML31ArcStringByBulge
- Returns:
- the focus point of this
ILcdShape
.
-
contains2D
Description copied from interface:ILcdShape
Checks whether thisILcdShape
contains the givenILcdPoint
in the 2D space. Only the first two dimensions of theILcdShape
and theILcdPoint
are considered.- Specified by:
contains2D
in interfaceILcdShape
- Overrides:
contains2D
in classTLcdGML31ArcStringByBulge
- Parameters:
aPoint
- theILcdPoint
to test.- Returns:
- the boolean result of the containment test.
- See Also:
-
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
- Overrides:
contains2D
in classTLcdGML31ArcStringByBulge
- Parameters:
aX
- the x coordinate of the point.aY
- the y coordinate of the point.- Returns:
- the boolean result of the containment test.
-
contains3D
Description copied from interface:ILcdShape
Checks whether thisILcdShape
contains the givenILcdPoint
in the 3D space.- Specified by:
contains3D
in interfaceILcdShape
- Overrides:
contains3D
in classTLcdGML31ArcStringByBulge
- Parameters:
aPoint
- theILcdPoint
to test.- Returns:
- the boolean result of the containment test.
- See Also:
-
contains3D
public boolean contains3D(double aX, double aY, double aZ) Description copied from interface:ILcdShape
Checks whether thisILcdShape
contains the given point in the 3D space.- Specified by:
contains3D
in interfaceILcdShape
- Overrides:
contains3D
in classTLcdGML31ArcStringByBulge
- Parameters:
aX
- the x coordinate of the point.aY
- the y coordinate of the point.aZ
- the z 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
- Overrides:
getBounds
in classTLcdGML31ArcStringByBulge
- Returns:
- the
ILcdBounds
by which the geometry of thisILcdBounded
object is bounded.
-
getPointCount
protected int getPointCount() -
getInterpolationAttr
Returns the value of the property that maps to theinterpolation
attribute.The attribute "interpolation" specifies the curve interpolation mechanism used for this segment. This mechanism uses the control points and control parameters to determine the position of this curve segment. For an ArcStringByBulge the interpolation is fixed as "circularArc2PointWithBulge".
- Returns:
- the value of the
INTERPOLATION_ATTR_PROPERTY
property.
-
setInterpolationAttr
Sets the value of the property that maps to theinterpolation
attribute.The attribute "interpolation" specifies the curve interpolation mechanism used for this segment. This mechanism uses the control points and control parameters to determine the position of this curve segment. For an ArcStringByBulge the interpolation is fixed as "circularArc2PointWithBulge".
- Parameters:
aValue
- the value to set for theINTERPOLATION_ATTR_PROPERTY
property.
-
getNumArc
Returns the value of the property that maps to thenumArc
attribute.The number of arcs in the arc string can be explicitly stated in this attribute. The number of control points in the arc string must be numArc + 1.
- Returns:
- the value of the
NUM_ARC_PROPERTY
property.
-
setNumArc
Sets the value of the property that maps to thenumArc
attribute.The number of arcs in the arc string can be explicitly stated in this attribute. The number of control points in the arc string must be numArc + 1.
- Parameters:
aValue
- the value to set for theNUM_ARC_PROPERTY
property.
-
getPosGroup
Returns the value of the property that maps to the choice between thepos
andpointProperty
andpointRep
andposList
andcoordinates
elements.The possible values for this property are instances of
List<TLcdGML31DirectPosition>
List<TLcdGML31PointProperty>
List<TLcdGML31PointProperty>
TLcdGML31DirectPositionList
TLcdGML31Coordinates
- Returns:
- the value of the
POS_GROUP_PROPERTY
property.
-
setPosGroup
Sets the value of the property that maps to the choice between thepos
andpointProperty
andpointRep
andposList
andcoordinates
elements.The possible values for this property are instances of
List<TLcdGML31DirectPosition>
List<TLcdGML31PointProperty>
List<TLcdGML31PointProperty>
TLcdGML31DirectPositionList
TLcdGML31Coordinates
- Parameters:
aValue
- the value to set for thePOS_GROUP_PROPERTY
property.
-
getBulgeGML
Returns the value of the property that maps to thebulge
element.The bulge controls the offset of each arc's midpoint. The "bulge" is the real number multiplier for the normal that determines the offset direction of the midpoint of each arc. The length of the bulge sequence is exactly 1 less than the length of the control point array, since a bulge is needed for each pair of adjacent points in the control point array. The bulge is not given by a distance, since it is simply a multiplier for the normal. The midpoint of the resulting arc is given by: midPoint = ((startPoint + endPoint)/2.0) + bulge*normal
- Returns:
- the value of the
BULGE_GML_PROPERTY
property.
-
getNormal
Returns the value of the property that maps to thenormal
element.The attribute "normal" is a vector normal (perpendicular) to the chord of the arc, the line joining the first and last point of the arc. In a 2D coordinate system, there are only two possible directions for the normal, and it is often given as a signed real, indicating its length, with a positive sign indicating a left turn angle from the chord line, and a negative sign indicating a right turn from the chord. In 3D, the normal determines the plane of the arc, along with the start and endPoint of the arc. The normal is usually a unit vector, but this is not absolutely necessary. If the normal is a zero vector, the geometric object becomes equivalent to the straight line between the two end points. The length of the normal sequence is exactly the same as for the bulge sequence, 1 less than the control point sequence length.
- Returns:
- the value of the
NORMAL_PROPERTY
property.
-
getNumDerivativeInterior
public long getNumDerivativeInterior()Returns the value of the property that maps to thenumDerivativeInterior
attribute.The attribute "numDerivativesInterior" specifies the type of continuity that is guaranteed interior to the curve. The default value of "0" means simple continuity, which is a mandatory minimum level of continuity. This level is referred to as "C 0 " in mathematical texts. A value of 1 means that the function and its first derivative are continuous at the appropriate end point: "C 1 " continuity. A value of "n" for any integer means the function and its first n derivatives are continuous: "C n " continuity. NOTE: Use of these values is only appropriate when the basic curve definition is an underdetermined system. For example, line string segments cannot support continuity above C 0 , since there is no spare control parameter to adjust the incoming angle at the end points of the segment. Spline functions on the other hand often have extra degrees of freedom on end segments that allow them to adjust the values of the derivatives to support C 1 or higher continuity.
- Returns:
- the value of the
NUM_DERIVATIVE_INTERIOR_PROPERTY
property.
-
setNumDerivativeInterior
public void setNumDerivativeInterior(long aValue) Sets the value of the property that maps to thenumDerivativeInterior
attribute.The attribute "numDerivativesInterior" specifies the type of continuity that is guaranteed interior to the curve. The default value of "0" means simple continuity, which is a mandatory minimum level of continuity. This level is referred to as "C 0 " in mathematical texts. A value of 1 means that the function and its first derivative are continuous at the appropriate end point: "C 1 " continuity. A value of "n" for any integer means the function and its first n derivatives are continuous: "C n " continuity. NOTE: Use of these values is only appropriate when the basic curve definition is an underdetermined system. For example, line string segments cannot support continuity above C 0 , since there is no spare control parameter to adjust the incoming angle at the end points of the segment. Spline functions on the other hand often have extra degrees of freedom on end segments that allow them to adjust the values of the derivatives to support C 1 or higher continuity.
- Parameters:
aValue
- the value to set for theNUM_DERIVATIVE_INTERIOR_PROPERTY
property.
-
getNumDerivativesAtEnd
public long getNumDerivativesAtEnd()Returns the value of the property that maps to thenumDerivativesAtEnd
attribute.The attribute "numDerivativesAtEnd" specifies the type of continuity between this curve segment and its successor. If this is the last curve segment in the curve, one of these values, as appropriate, is ignored. The default value of "0" means simple continuity, which is a mandatory minimum level of continuity. This level is referred to as "C 0 " in mathematical texts. A value of 1 means that the function and its first derivative are continuous at the appropriate end point: "C 1 " continuity. A value of "n" for any integer means the function and its first n derivatives are continuous: "C n " continuity. NOTE: Use of these values is only appropriate when the basic curve definition is an underdetermined system. For example, line string segments cannot support continuity above C 0 , since there is no spare control parameter to adjust the incoming angle at the end points of the segment. Spline functions on the other hand often have extra degrees of freedom on end segments that allow them to adjust the values of the derivatives to support C 1 or higher continuity.
- Returns:
- the value of the
NUM_DERIVATIVES_AT_END_PROPERTY
property.
-
setNumDerivativesAtEnd
public void setNumDerivativesAtEnd(long aValue) Sets the value of the property that maps to thenumDerivativesAtEnd
attribute.The attribute "numDerivativesAtEnd" specifies the type of continuity between this curve segment and its successor. If this is the last curve segment in the curve, one of these values, as appropriate, is ignored. The default value of "0" means simple continuity, which is a mandatory minimum level of continuity. This level is referred to as "C 0 " in mathematical texts. A value of 1 means that the function and its first derivative are continuous at the appropriate end point: "C 1 " continuity. A value of "n" for any integer means the function and its first n derivatives are continuous: "C n " continuity. NOTE: Use of these values is only appropriate when the basic curve definition is an underdetermined system. For example, line string segments cannot support continuity above C 0 , since there is no spare control parameter to adjust the incoming angle at the end points of the segment. Spline functions on the other hand often have extra degrees of freedom on end segments that allow them to adjust the values of the derivatives to support C 1 or higher continuity.
- Parameters:
aValue
- the value to set for theNUM_DERIVATIVES_AT_END_PROPERTY
property.
-
getNumDerivativesAtStart
public long getNumDerivativesAtStart()Returns the value of the property that maps to thenumDerivativesAtStart
attribute.The attribute "numDerivativesAtStart" specifies the type of continuity between this curve segment and its predecessor. If this is the first curve segment in the curve, one of these values, as appropriate, is ignored. The default value of "0" means simple continuity, which is a mandatory minimum level of continuity. This level is referred to as "C 0 " in mathematical texts. A value of 1 means that the function and its first derivative are continuous at the appropriate end point: "C 1 " continuity. A value of "n" for any integer means the function and its first n derivatives are continuous: "C n " continuity. NOTE: Use of these values is only appropriate when the basic curve definition is an underdetermined system. For example, line string segments cannot support continuity above C 0 , since there is no spare control parameter to adjust the incoming angle at the end points of the segment. Spline functions on the other hand often have extra degrees of freedom on end segments that allow them to adjust the values of the derivatives to support C 1 or higher continuity.
- Returns:
- the value of the
NUM_DERIVATIVES_AT_START_PROPERTY
property.
-
setNumDerivativesAtStart
public void setNumDerivativesAtStart(long aValue) Sets the value of the property that maps to thenumDerivativesAtStart
attribute.The attribute "numDerivativesAtStart" specifies the type of continuity between this curve segment and its predecessor. If this is the first curve segment in the curve, one of these values, as appropriate, is ignored. The default value of "0" means simple continuity, which is a mandatory minimum level of continuity. This level is referred to as "C 0 " in mathematical texts. A value of 1 means that the function and its first derivative are continuous at the appropriate end point: "C 1 " continuity. A value of "n" for any integer means the function and its first n derivatives are continuous: "C n " continuity. NOTE: Use of these values is only appropriate when the basic curve definition is an underdetermined system. For example, line string segments cannot support continuity above C 0 , since there is no spare control parameter to adjust the incoming angle at the end points of the segment. Spline functions on the other hand often have extra degrees of freedom on end segments that allow them to adjust the values of the derivatives to support C 1 or higher continuity.
- Parameters:
aValue
- the value to set for theNUM_DERIVATIVES_AT_START_PROPERTY
property.
-