Spatial DataBlade
JAVA API v8.21

com.ibm.spatial.geom
Interface Curve

All Superinterfaces:
Geometry
All Known Subinterfaces:
LineString
All Known Implementing Classes:
IfxLineString

public interface Curve
extends Geometry

The Curve interface defines the methods for a class whose instances create a one-dimensional geometric object that has two end points.

A Curve is a one-dimensional geometric object usually stored as a sequence of points. A curve may be composed of several concatenated segments, each having its own interpolation type.

A Curve is simple if it does not pass through the same point twice.

A Curve is closed if its start point is equal to its end point. The boundary of a closed Curve is empty.

A Curve that is simple and closed is a Ring.

The boundary of a non-closed Curve consists of its two end points.

See Also:
Geometry, LineString

Method Summary
 Point endPoint()
          Returns the end point of a Curve.
 void endPoint(CoordPoint point)
          Fills in the CoordPoint passed as argument with the coordinates of the last point of a Curve.
 boolean isClosed()
          Tests whether this curve is closed, that is, its start point is equal to its end point.
 boolean isRing()
          Tests whether this curve is a ring (is closed and simple).
 double length()
          Returns the length of this Curve.
 Point startPoint()
          Returns the start point of a Curve.
 void startPoint(CoordPoint point)
          Fills in the CoordPoint passed as argument with the coordinates of the first point of a Curve.
 Point value(double r)
          Returns the point located r coordinate units along the Curve from the start point.
 
Methods inherited from interface com.ibm.spatial.geom.Geometry
asBinary, asText, boundary, buffer, contains, convexHull, crosses, difference, dimension, disjoint, distance, envelope, envelopesIntersect, equals, extent, exterior, interior, intersection, intersects, is3D, isEmpty, isMeasured, isSimple, isValid, locateAlong, locateBetween, numPoints, overlaps, srid, symmetricDiff, touches, union, within
 

Method Detail

endPoint

Point endPoint()
Returns the end point of a Curve.

Returns:
a geometry object representing the end point of this curve

endPoint

void endPoint(CoordPoint point)

Fills in the CoordPoint passed as argument with the coordinates of the last point of a Curve.

This method allows the user to reuse the coordinate point object passed as argument and thus be more memory efficient.

Parameters:
point - A coordinate point that is going to be filled with the coordinates of end point of this curve

isClosed

boolean isClosed()
Tests whether this curve is closed, that is, its start point is equal to its end point.

Returns:
true if this Curve is closed; otherwise false

isRing

boolean isRing()
Tests whether this curve is a ring (is closed and simple).

Returns:
true if this Curve is a ring; otherwise false

length

double length()
Returns the length of this Curve.

Returns:
Returns the length of this Curve in its associated spatial reference.

startPoint

Point startPoint()
Returns the start point of a Curve.

Returns:
a geometry object representing the start point of this curve

startPoint

void startPoint(CoordPoint point)

Fills in the CoordPoint passed as argument with the coordinates of the first point of a Curve.

This method allows the user to reuse the coordinate point object passed as argument and thus be more memory efficient.

Parameters:
point - A coordinate point that is going to be filled with the coordinates of start point of this curve

value

Point value(double r)
Returns the point located r coordinate units along the Curve from the start point. If r is less than zero or greater than the length of this curve, an exception is raised. Note that value(0.0) = start_point and value(length) = end_point.

Parameters:
r - length of the curve between the start point and the point to be returned
Returns:
the point located r coordinate units along this object from the start point

Spatial DataBlade
JAVA API v8.21


Licensed Materials - Property of IBM
Copyright IBM Corp. 2002, 2012 All Rights Reserved.