oracle.sdoapi.geom
Interface CurveString

All Superinterfaces:
java.lang.Cloneable, Curve, Geometry, java.io.Serializable
All Known Subinterfaces:
LineString

public interface CurveString
extends Curve

CurveString is an interface that represents a generic string of curves regardless of interpolation type (OGC line string type is actually a special case of curve string with linear interpolation between points). This interface is an extension to the OGC simple feature geometry object model.


Method Summary
 int getNumPoints()
          Gets the number of coordinate points in this curve string.
 int getNumSegments()
          Gets the number of segments in this curve string.
 CoordPoint[] getPointArray()
          Gets an array of all coordinate points in this curve string.
 int getPointArray(CoordPoint[] pointArray, int pointOffset, int numPoints)
          Gets an array of all coordinate points in this curve string.
 void getPointAt(CoordPoint point, int i)
          Gets the i-th coordinate point on this curve string.
 CoordPoint getPointAt(int i)
          Gets the i-th coordinate point on this curve string.
 java.util.Enumeration getPoints()
          Gets an enumeration of all coordinate points in this curve string.
 Segment[] getSegmentArray()
          Gets an array of all segments in this curve string.
 Segment getSegmentAt(int i)
          Gets the segment at index i in the Segment array for this curve string.
 java.util.Enumeration getSegments()
          Gets an enumeration of all segments in this curve string.
 
Methods inherited from interface oracle.sdoapi.geom.Curve
getEndPoint, getEndPoint, getStartPoint, getStartPoint, isClosed, length
 
Methods inherited from interface oracle.sdoapi.geom.Geometry
clone, getAllIsolatedPoints, getAllSegments, getCoordinateDimension, getDimensionality, getEnvelope, getGeometryType, getLabelPoint, getLabelPoint, getSpatialReference, isEmpty, isSimple, isValid, linearize
 

Method Detail

getNumSegments

public int getNumSegments()
Gets the number of segments in this curve string. A segment can be a line or an circular arc, for example.
Returns:
the number of segments in this curve string

getSegments

public java.util.Enumeration getSegments()
Gets an enumeration of all segments in this curve string.
Returns:
an enumeration of all segments in this curve string

getSegmentArray

public Segment[] getSegmentArray()
Gets an array of all segments in this curve string.
Returns:
an array of all segments in this curve string

getSegmentAt

public Segment getSegmentAt(int i)
Gets the segment at index i in the Segment array for this curve string.
Parameters:
i - the index of the segment. The first segment is at index 0.
Returns:
the (i-1)th segment of this curve string, that is, the segment at Segment[i]. The 2nd segment is at Segment[1]

getNumPoints

public int getNumPoints()
Gets the number of coordinate points in this curve string.
Returns:
the number of coordinate points in this curve string

getPoints

public java.util.Enumeration getPoints()
Gets an enumeration of all coordinate points in this curve string.
Returns:
an enumeration of all coordinate points in this curve string

getPointArray

public CoordPoint[] getPointArray()
Gets an array of all coordinate points in this curve string.
Parameters:
points - an array of all coordinate points in this curve string

getPointArray

public int getPointArray(CoordPoint[] pointArray,
                         int pointOffset,
                         int numPoints)
Gets an array of all coordinate points in this curve string.
Parameters:
pointArray - a preallocated array of coordinate point to be filled with all coordinates in this curve string. All points in this array must be preallocated.
pointOffset - position in this curve string from which to begin to retrieve points
numPoints - number of points to retrieve
Returns:
the actual number of points that are retrieved by this invocation

getPointAt

public CoordPoint getPointAt(int i)
Gets the i-th coordinate point on this curve string.
Parameters:
i - the index of the coordinate point
Returns:
the i-th coordinate point of this curve string

getPointAt

public void getPointAt(CoordPoint point,
                       int i)
Gets the i-th coordinate point on this curve string.
Parameters:
point - the coordinate point that is to be filled with the ordinates of point i of this curve string
i - the index of the coordinate point