/usr/include/geos/geom/Polygon.h is in libgeos-dev 3.2.2-3ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 | /**********************************************************************
* $Id: Polygon.h 2556 2009-06-06 22:22:28Z strk $
*
* GEOS - Geometry Engine Open Source
* http://geos.refractions.net
*
* Copyright (C) 2005 2006 Refractions Research Inc.
* Copyright (C) 2001-2002 Vivid Solutions Inc.
*
* This is free software; you can redistribute and/or modify it under
* the terms of the GNU Lesser General Public Licence as published
* by the Free Software Foundation.
* See the COPYING file for more information.
*
**********************************************************************
*
* Last port: geom/Polygon.java rev. 1.50
*
**********************************************************************/
#ifndef GEOS_GEOM_POLYGON_H
#define GEOS_GEOM_POLYGON_H
#include <geos/export.h>
#include <string>
#include <vector>
#include <geos/platform.h>
#include <geos/geom/Geometry.h>
#include <geos/geom/Envelope.h> // for proper use of auto_ptr<>
#include <geos/geom/Dimension.h> // for Dimension::DimensionType
#include <geos/inline.h>
#include <memory> // for auto_ptr
// Forward declarations
namespace geos {
namespace geom { // geos::geom
class Coordinate;
class CoordinateArraySequence;
class CoordinateSequenceFilter;
class LinearRing;
class LineString;
}
}
namespace geos {
namespace geom { // geos::geom
/**
* \class Polygon geom.h geos.h
*
* \brief Represents a linear polygon, which may include holes.
*
* The shell and holes of the polygon are represented by {@link LinearRing}s.
* In a valid polygon, holes may touch the shell or other holes at a single point.
* However, no sequence of touching holes may split the polygon into two pieces.
* The orientation of the rings in the polygon does not matter.
* <p>
* The shell and holes must conform to the assertions specified in the <A
* HREF="http://www.opengis.org/techno/specs.htm">OpenGIS Simple Features
* Specification for SQL</A> .
*
*/
class GEOS_DLL Polygon: public Geometry{
public:
friend class GeometryFactory;
/// A vector of const Polygon pointers
typedef std::vector<const Polygon *> ConstVect;
virtual ~Polygon();
/**
* Creates and returns a full copy of this {@link Polygon} object.
* (including all coordinates contained by it).
*
* @return a clone of this instance
*/
virtual Geometry *clone() const { return new Polygon(*this); }
CoordinateSequence* getCoordinates() const;
size_t getNumPoints() const;
/// Returns surface dimension (2)
Dimension::DimensionType getDimension() const;
/// Returns 1 (Polygon boundary is a MultiLineString)
int getBoundaryDimension() const;
/** \brief
* Computes the boundary of this geometry
*
* @return a lineal geometry (which may be empty)
* @see Geometry#getBoundary
*/
Geometry* getBoundary() const;
bool isEmpty() const;
/** \brief
* Tests if a valid polygon is simple.
* This method always returns true, since a valid polygon is always simple
*
* @return <code>true</code>
*/
bool isSimple() const;
/// Returns the exterior ring (shell)
const LineString* getExteriorRing() const;
/// Returns number of interior rings (hole)
size_t getNumInteriorRing() const;
/// Get nth interior ring (hole)
const LineString* getInteriorRingN(size_t n) const;
std::string getGeometryType() const;
virtual GeometryTypeId getGeometryTypeId() const;
bool equalsExact(const Geometry *other, double tolerance=0) const;
void apply_rw(const CoordinateFilter *filter);
void apply_ro(CoordinateFilter *filter) const;
void apply_rw(GeometryFilter *filter);
void apply_ro(GeometryFilter *filter) const;
void apply_rw(CoordinateSequenceFilter& filter);
void apply_ro(CoordinateSequenceFilter& filter) const;
Geometry* convexHull() const;
void normalize();
int compareToSameClass(const Geometry *p) const; //was protected
const Coordinate* getCoordinate() const;
double getArea() const;
/// Returns the perimeter of this <code>Polygon</code>
double getLength() const;
void apply_rw(GeometryComponentFilter *filter);
void apply_ro(GeometryComponentFilter *filter) const;
bool isRectangle() const;
protected:
Polygon(const Polygon &p);
/**
* Constructs a <code>Polygon</code> with the given exterior
* and interior boundaries.
*
* @param newShell the outer boundary of the new Polygon,
* or <code>null</code> or an empty
* LinearRing if the empty geometry
* is to be created.
*
* @param newHoles the LinearRings defining the inner
* boundaries of the new Polygon, or
* null or empty LinearRing
* if the empty geometry is to be created.
*
* @param newFactory the GeometryFactory used to create this geometry
*
* Polygon will take ownership of Shell and Holes LinearRings
*/
Polygon(LinearRing *newShell, std::vector<Geometry *> *newHoles,
const GeometryFactory *newFactory);
LinearRing *shell;
std::vector<Geometry *> *holes; //Actually vector<LinearRing *>
Envelope::AutoPtr computeEnvelopeInternal() const;
private:
void normalize(LinearRing *ring, bool clockwise);
};
} // namespace geos::geom
} // namespace geos
//#ifdef GEOS_INLINE
//# include "geos/geom/Polygon.inl"
//#endif
#endif // ndef GEOS_GEOM_POLYGON_H
/**********************************************************************
* $Log$
* Revision 1.7 2006/06/08 17:58:57 strk
* Polygon::getNumInteriorRing() return size_t, Polygon::interiorRingN() takes size_t.
*
* Revision 1.6 2006/05/04 15:49:39 strk
* updated all Geometry::getDimension() methods to return Dimension::DimensionType (closes bug#93)
*
* Revision 1.5 2006/04/28 10:55:39 strk
* Geometry constructors made protected, to ensure all constructions use GeometryFactory,
* which has been made friend of all Geometry derivates. getNumPoints() changed to return
* size_t.
*
* Revision 1.4 2006/04/10 18:15:09 strk
* Changed Geometry::envelope member to be of type auto_ptr<Envelope>.
* Changed computeEnvelopeInternal() signater to return auto_ptr<Envelope>
*
* Revision 1.3 2006/03/24 09:52:41 strk
* USE_INLINE => GEOS_INLINE
*
* Revision 1.2 2006/03/15 09:12:45 strk
* isSimple doc
*
* Revision 1.1 2006/03/09 16:46:49 strk
* geos::geom namespace definition, first pass at headers split
*
**********************************************************************/
|