com.ibm.spatial.geom
Interface MultiSurface

All Superinterfaces:

Geometry, GeometryCollection

All Known Subinterfaces:

MultiPolygon

All Known Implementing Classes:

IfxMultiPolygon

public interface MultiSurface
extends GeometryCollection

A MultiSurface is a two-dimensional geometric collection whose elements are surfaces. The interiors of any two surfaces in a MultiSurface may not intersect. The boundaries of any two elements in a MultiSurface may intersect at most at a finite number of points.

MultiSurface is a non-instantiable class in this specification, it defines a set of methods for its subclasses and is included for reasons of extensibility. The instantiable subclass of MultiSurface is MultiPolygon, corresponding to a collection of Polygons.

See Also:

GeometryCollection, Surface

Method Summary

double	area() The area of this MultiSurface (the sum of the areas of all constituent surfaces), as measured in the coordinate system of this MultiSurface.
Point	centroid() The mathematical centroid for this MultiSurface.
double	perimeter() Computes the total perimeter of this surface collection, as measured in the coordinate system of this MultiSurface.
Point	pointOnSurface() A Point guaranteed to be on this MultiSurface.

Methods inherited from interface com.ibm.spatial.geom.GeometryCollection

geometryN, numGeometries

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

area

double area()

The area of this MultiSurface (the sum of the areas of all constituent surfaces), as measured in the coordinate system of this MultiSurface.

Returns:

the area of this MultiSurface as a double precision number

centroid

Point centroid()
               throws SpatialException

The mathematical centroid for this MultiSurface. The result is not guaranteed to be on this MultiSurface.

Returns:

a Point representing the centroid of this MultiSurface

Throws:

SpatialException - if an error occurs during the calculation of the point coordinates

pointOnSurface

Point pointOnSurface()
                     throws SpatialException

A Point guaranteed to be on this MultiSurface.

Returns:

a Point guaranteed to be on this MultiSurface

Throws:

SpatialException - if an error occurs during the calculation of the point coordinates

perimeter

double perimeter()

Computes the total perimeter of this surface collection, as measured in the coordinate system of this MultiSurface.

Returns:

the total perimeter of this MultiSurface