001: //$HeadURL: https://svn.wald.intevation.org/svn/deegree/base/trunk/src/org/deegree/model/spatialschema/SurfacePatch.java $
002: /*---------------- FILE HEADER ------------------------------------------
003:
004: This file is part of deegree.
005: Copyright (C) 2001-2008 by:
006: EXSE, Department of Geography, University of Bonn
007: http://www.giub.uni-bonn.de/deegree/
008: lat/lon GmbH
009: http://www.lat-lon.de
010:
011: This library is free software; you can redistribute it and/or
012: modify it under the terms of the GNU Lesser General Public
013: License as published by the Free Software Foundation; either
014: version 2.1 of the License, or (at your option) any later version.
015:
016: This library is distributed in the hope that it will be useful,
017: but WITHOUT ANY WARRANTY; without even the implied warranty of
018: MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
019: Lesser General Public License for more details.
020:
021: You should have received a copy of the GNU Lesser General Public
022: License along with this library; if not, write to the Free Software
023: Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
024:
025: Contact:
026:
027: Andreas Poth
028: lat/lon GmbH
029: Aennchenstr. 19
030: 53115 Bonn
031: Germany
032: E-Mail: poth@lat-lon.de
033:
034: Prof. Dr. Klaus Greve
035: Department of Geography
036: University of Bonn
037: Meckenheimer Allee 166
038: 53115 Bonn
039: Germany
040: E-Mail: greve@giub.uni-bonn.de
041:
042:
043: ---------------------------------------------------------------------------*/
044:
045: package org.deegree.model.spatialschema;
046:
047: import org.deegree.model.crs.CoordinateSystem;
048:
049: /**
050: *
051: * Defining the iso geometry <code>SurfacePatch</code> which is used for building surfaces. A
052: * surface patch is made of one exterior ring and 0..n interior rings. By definition there can't be
053: * a surface patch with no exterior ring. A polygon is a specialized surface patch.
054: *
055: * -----------------------------------------------------
056: *
057: * @author <a href="mailto:poth@lat-lon.de">Andreas Poth</a>
058: * @version $Revision: 9343 $ $Date: 2007-12-27 05:30:32 -0800 (Thu, 27 Dec 2007) $
059: */
060:
061: public interface SurfacePatch extends GenericSurface {
062:
063: /**
064: * The interpolation determines the surface interpolation mechanism used for this SurfacePatch.
065: * This mechanism uses the control points and control parameters defined in the various
066: * subclasses to determine the position of this SurfacePatch.
067: */
068: SurfaceInterpolation getInterpolation();
069:
070: /**
071: * @return the exterior ring of a surfacePatch
072: */
073: Position[] getExteriorRing();
074:
075: /**
076: * @return the interior rings of a surfacePatch
077: */
078: Position[][] getInteriorRings();
079:
080: /**
081: *
082: * @return the exterior ring of a surfacePatch
083: */
084: Ring getExterior();
085:
086: /**
087: *
088: * @return the interior rings of a surfacePatch
089: */
090: Ring[] getInterior();
091:
092: /**
093: * @return the coordinate system of the surface patch
094: */
095: CoordinateSystem getCoordinateSystem();
096:
097: /**
098: * The Boolean valued operation "intersects" shall return TRUE if this Geometry intersects
099: * another Geometry. Within a Complex, the Primitives do not intersect one another. In general,
100: * topologically structured data uses shared geometric objects to capture intersection
101: * information.
102: */
103: boolean intersects(Geometry gmo);
104:
105: /**
106: * The Boolean valued operation "contains" shall return TRUE if this Geometry contains another
107: * Geometry.
108: */
109: boolean contains(Geometry gmo);
110:
111: /**
112: * The operation "centroid" shall return the mathematical centroid for this Geometry. The result
113: * is not guaranteed to be on the object.
114: */
115: public Point getCentroid();
116:
117: /**
118: * The operation "area" shall return the area of this GenericSurface. The area of a 2
119: * dimensional geometric object shall be a numeric measure of its surface area Since area is an
120: * accumulation (integral) of the product of two distances, its return value shall be in a unit
121: * of measure appropriate for measuring distances squared.
122: */
123: public double getArea();
124:
125: }
|