Spatial DataBlade
JAVA API v8.21

com.ibm.spatial.geom
Interface Surface

All Superinterfaces:
Geometry
All Known Subinterfaces:
Polygon
All Known Implementing Classes:
IfxPolygon, IfxSurface

public interface Surface
extends Geometry

A Surface is a two-dimensional geometric object.

The OpenGIS Abstract Specification defines a simple Surface as consisting of a single "patch" that is associated with one "exterior boundary" and 0 or more "interior" boundaries. Simple surfaces in three-dimensional space are isomorphic to planar surfaces. Polyhedral surfaces are formed by "stitching" together simple surfaces along their boundaries, polyhedral surfaces in three-dimensional space may not be planar as a whole.

The boundary of a simple Surface is the set of closed curves corresponding to its "exterior" and "interior" boundaries.

See Also:
Geometry

Method Summary
 double area()
          Returns the area of this Surface, as measured in the spatial reference system of this Surface.
 Point centroid()
          The mathematical centroid for this Surface as a Point.
 double perimeter()
          Returns the perimeter of a Surface, as measured in the spatial reference system of this Surface.
 Point pointOnSurface()
          Returns a point guaranteed to be on this Surface.
 
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()
Returns the area of this Surface, as measured in the spatial reference system of this Surface.

Returns:
the area of this surface in double precision

centroid

Point centroid()
               throws SpatialException
The mathematical centroid for this Surface as a Point. The result is not guaranteed to be on this Surface.

Returns:
a Point representing the centroid of this surface
Throws:
SpatialException - if an error occurs during the calculation of the centroid point coordinates

perimeter

double perimeter()
Returns the perimeter of a Surface, as measured in the spatial reference system of this Surface.

Returns:
the perimeter of this Surface

pointOnSurface

Point pointOnSurface()
                     throws SpatialException
Returns a point guaranteed to be on this Surface.

Returns:
a Point guaranteed to be on this Surface
Throws:
SpatialException - if an error occurs during the calculation of the point coordinates

Spatial DataBlade
JAVA API v8.21


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