DYT/Tool/OpenSceneGraph-3.6.5/include/geos/operation/overlay/MaximalEdgeRing.h
2024-12-25 07:49:36 +08:00

106 lines
3.1 KiB
C++

/**********************************************************************
*
* GEOS - Geometry Engine Open Source
* http://geos.osgeo.org
*
* Copyright (C) 2006 Refractions Research 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: operation/overlay/MaximalEdgeRing.java rev. 1.15 (JTS-1.10)
*
**********************************************************************/
#pragma once
#include <geos/export.h>
#include <vector>
#include <geos/geomgraph/EdgeRing.h> // for inheritance
// Forward declarations
namespace geos {
namespace geom {
class GeometryFactory;
}
namespace geomgraph {
class DirectedEdge;
//class EdgeRing;
}
namespace operation {
namespace overlay {
class MinimalEdgeRing;
}
}
}
namespace geos {
namespace operation { // geos::operation
namespace overlay { // geos::operation::overlay
/** \brief
* A ring of [DirectedEdges](@ref geomgraph::DirectedEdge) which may contain nodes of degree > 2.
*
* A MaximalEdgeRing may represent two different spatial entities:
*
* - a single polygon possibly containing inversions (if the ring is oriented CW)
* - a single hole possibly containing exversions (if the ring is oriented CCW)
*
* If the MaximalEdgeRing represents a polygon,
* the interior of the polygon is strongly connected.
*
* These are the form of rings used to define polygons under some spatial data models.
* However, under the OGC SFS model, [MinimalEdgeRings](@ref MinimalEdgeRing) are required.
* A MaximalEdgeRing can be converted to a list of MinimalEdgeRings using the
* {@link #buildMinimalRings() } method.
*
* @see com.vividsolutions.jts.operation.overlay.MinimalEdgeRing
*/
class GEOS_DLL MaximalEdgeRing: public geomgraph::EdgeRing {
public:
MaximalEdgeRing(geomgraph::DirectedEdge* start,
const geom::GeometryFactory* geometryFactory);
// throw(const TopologyException &)
~MaximalEdgeRing() override = default;
geomgraph::DirectedEdge* getNext(geomgraph::DirectedEdge* de) override;
void setEdgeRing(geomgraph::DirectedEdge* de, geomgraph::EdgeRing* er) override;
/// \brief
/// This function returns a newly allocated vector of
/// pointers to newly allocated MinimalEdgeRing objects.
///
/// @deprecated pass the vector yourself instead
///
std::vector<MinimalEdgeRing*>* buildMinimalRings();
/// \brief
/// This function pushes pointers to newly allocated MinimalEdgeRing
/// objects to the provided vector.
///
void buildMinimalRings(std::vector<MinimalEdgeRing*>& minEdgeRings);
void buildMinimalRings(std::vector<EdgeRing*>& minEdgeRings);
/// \brief
/// For all nodes in this EdgeRing,
/// link the DirectedEdges at the node to form minimalEdgeRings
///
void linkDirectedEdgesForMinimalEdgeRings();
};
} // namespace geos::operation::overlay
} // namespace geos::operation
} // namespace geos