Spatial DataBlade
JAVA API v8.21

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

Spatial DataBlade
JAVA API v8.21


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