org.opengis.spatialschema.geometry.geometry
Interface ArcString

All Superinterfaces:

CurveSegment, GenericCurve

All Known Subinterfaces:

Arc, Circle

public interface ArcString

extends CurveSegment

Similar to a line string except that the interpolation is by circular arcs. Since it requires 3 points to determine a circular arc, the control points are treated as a sequence of overlapping sets of 3 positions, the start of each arc, some point between the start and end, and the end of each arc. Since the end of each arc is the start of the next, this position is not repeated in the control points sequence.

Version:

2.0

Author:

ISO/DIS 19107, OpenGIS® consortium

See Also:

GeometryFactory.createArcString(java.util.List), ArcStringByBulge.asArcString()

UML identifier (abstract type): GM_ArcString

Method Summary

List<Arc>	asArcs() Constructs a sequence of arcs that is the geometric equivalent of this arc string.
PointArray	getControlPoints() Returns the sequence of points used to control the arcs in this string.
CurveInterpolation	getInterpolation() The interpolation for a ArcString is "circular arc by 3 points".
int	getNumArc() Returns the number of circular arcs in the string.

Methods inherited from interface CurveSegment

getBoundary, getCurve, getNumDerivativeInterior, getNumDerivativesAtEnd, getNumDerivativesAtStart, getSamplePoints, reverse

Methods inherited from interface GenericCurve

asLineString, getConstructiveParam, getEndConstructiveParam, getEndParam, getEndPoint, getParam, getParamForPoint, getStartConstructiveParam, getStartParam, getStartPoint, getTangent, length, length

Method Detail

getNumArc

int getNumArc()

Returns the number of circular arcs in the string. Since the interpolation method requires overlapping sets of 3 positions, the number of arcs determines the number of control points:

numArc = (controlPoints.length - 1)/2

Returns:

The number of circular arcs.

UML identifier (operation): numArc

getControlPoints

PointArray getControlPoints()

Returns the sequence of points used to control the arcs in this string. The first three positions in the sequence determines the first arc. Any three consecutive positions beginning with an odd offset, determine another arc in the string.

Returns:

The control points. The array size is 2*numArc +1.

UML identifier (operation): controlPoints

getInterpolation

CurveInterpolation getInterpolation()

The interpolation for a ArcString is "circular arc by 3 points".

Specified by:

getInterpolation in interface CurveSegment

Returns:

Always CurveInterpolation.CIRCULAR_ARC_3_POINTS.

UML identifier (operation): interpolation

asArcs

List<Arc> asArcs()

Constructs a sequence of arcs that is the geometric equivalent of this arc string.

Returns:

The sequence of arcs.

UML identifier (operation): asGM_Arc