geomgraph/EdgeRing.h

/**********************************************************************
 *
 * GEOS - Geometry Engine Open Source
 * http://geos.osgeo.org
 *
 * Copyright (C) 2011 Sandro Santilli <strk@keybit.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: geomgraph/EdgeRing.java r428 (JTS-1.12+)
 *
 **********************************************************************/
 
 
#ifndef GEOS_GEOMGRAPH_EDGERING_H
#define GEOS_GEOMGRAPH_EDGERING_H
 
#include <geos/export.h>
#include <geos/geomgraph/Label.h> // for composition
 
#include <geos/inline.h>
 
#include <vector>
#include <cassert> // for testInvariant
#include <iosfwd> // for operator<<
 
#ifdef _MSC_VER
#pragma warning(push)
#pragma warning(disable: 4251) // warning C4251: needs to have dll-interface to be used by clients of class
#endif
 
// Forward declarations
namespace geos {
        namespace geom {
                class GeometryFactory;
                class LinearRing;
                class Polygon;
                class Coordinate;
                class CoordinateSequence;
        }
        namespace geomgraph {
                class DirectedEdge;
                //class Label;
                class Edge;
        }
}
 
namespace geos {
namespace geomgraph { // geos.geomgraph

class GEOS_DLL EdgeRing {
 
public:
        friend std::ostream& operator<< (std::ostream& os, const EdgeRing& er);
 
        EdgeRing(DirectedEdge *newStart,
                        const geom::GeometryFactory *newGeometryFactory);
 
        virtual ~EdgeRing();
 
        bool isIsolated();
 
        bool isHole();
 
        /*
         * Return a pointer to the LinearRing owned by
         * this object. Make a copy if you need it beyond
         * this objects's lifetime.
         */
        geom::LinearRing* getLinearRing();
 
        Label& getLabel();
 
        bool isShell();
 
        EdgeRing *getShell();
 
        void setShell(EdgeRing *newShell);
 
        void addHole(EdgeRing *edgeRing);

        geom::Polygon* toPolygon(const geom::GeometryFactory* geometryFactory);

        void computeRing();
 
        virtual DirectedEdge* getNext(DirectedEdge *de)=0;
 
        virtual void setEdgeRing(DirectedEdge *de, EdgeRing *er)=0;

        std::vector<DirectedEdge*>& getEdges();
 
        int getMaxNodeDegree();
 
        void setInResult();

        bool containsPoint(const geom::Coordinate& p);
 
        void testInvariant()
        {
                // pts are never NULL
                assert(pts);
 
#ifndef NDEBUG
                // If this is not an hole, check that
                // each hole is not null and 
                // has 'this' as it's shell
                if ( ! shell )
                {
                        for (std::vector<EdgeRing*>::const_iterator
                                it=holes.begin(), itEnd=holes.end();
                                it != itEnd;
                                ++it)
                        {
                                EdgeRing* hole=*it;
                                assert(hole);
                                assert(hole->getShell()==this);
                        }
                }
#endif // ndef NDEBUG
        }
 
protected:
 
        DirectedEdge *startDe; // the directed edge which starts the list of edges for this EdgeRing
 
        const geom::GeometryFactory *geometryFactory;

        void computePoints(DirectedEdge *newStart);
 
        void mergeLabel(const Label& deLabel);

        void mergeLabel(const Label& deLabel, int geomIndex);
 
        void addPoints(Edge *edge, bool isForward, bool isFirstEdge);

        std::vector<EdgeRing*> holes;
 
private:
 
        int maxNodeDegree;

        std::vector<DirectedEdge*> edges;
 
        geom::CoordinateSequence* pts;
 
        // label stores the locations of each geometry on the
        // face surrounded by this ring
        Label label;
 
        geom::LinearRing *ring;  // the ring created for this EdgeRing
 
        bool isHoleVar;

        EdgeRing *shell;  
 
        void computeMaxNodeDegree();
 
};
 
std::ostream& operator<< (std::ostream& os, const EdgeRing& er);
 
} // namespace geos.geomgraph
} // namespace geos
 
#ifdef _MSC_VER
#pragma warning(pop)
#endif
 
#endif // ifndef GEOS_GEOMGRAPH_EDGERING_H