GEOS 3.14.0dev
OverlayUtil.h
1/**********************************************************************
2 *
3 * GEOS - Geometry Engine Open Source
4 * http://geos.osgeo.org
5 *
6 * Copyright (C) 2020 Paul Ramsey <pramsey@cleverelephant.ca>
7 *
8 * This is free software; you can redistribute and/or modify it under
9 * the terms of the GNU Lesser General Public Licence as published
10 * by the Free Software Foundation.
11 * See the COPYING file for more information.
12 *
13 **********************************************************************/
14
15#pragma once
16
17#include <geos/geom/Point.h>
18#include <geos/geom/Polygon.h>
19#include <geos/geom/LineString.h>
20#include <geos/geom/Geometry.h>
21
22#include <geos/export.h>
23
24#include <vector>
25#include <memory>
26
27// Forward declarations
28namespace geos {
29namespace geom {
30class Coordinate;
31class CoordinateSequence;
32class Envelope;
33class GeometryFactory;
34class PrecisionModel;
35}
36namespace operation {
37namespace overlayng {
38class InputGeometry;
39class OverlayGraph;
40}
41}
42}
43
44namespace geos { // geos.
45namespace operation { // geos.operation
46namespace overlayng { // geos.operation.overlayng
47
54class GEOS_DLL OverlayUtil {
64
65private:
66
67 static constexpr double SAFE_ENV_BUFFER_FACTOR = 0.1;
68 static constexpr int SAFE_ENV_GRID_FACTOR = 3;
69 static constexpr double AREA_HEURISTIC_TOLERANCE = 0.1;
70
82 static bool resultEnvelope(int opCode, const InputGeometry* inputGeom, const PrecisionModel* pm, Envelope& rsltEnvelope);
83 static double safeExpandDistance(const Envelope* env, const PrecisionModel* pm);
84 static bool safeEnv(const Envelope* env, const PrecisionModel* pm, Envelope& rsltEnvelope);
85
86 static bool isEmpty(const Geometry* geom);
87
93 static bool isDisjoint(const Envelope* envA, const Envelope* envB, const PrecisionModel* pm);
94
95 static bool isLess(double v1, double v2, double tol) {
96 return v1 <= v2 * (1 + tol);
97 };
98
99 static bool isGreater(double v1, double v2, double tol) {
100 return v1 >= v2 * (1 - tol);
101 }
102
103
104public:
105
106 static bool isFloating(const PrecisionModel* pm);
107
123 static bool clippingEnvelope(int opCode, const InputGeometry* inputGeom, const PrecisionModel* pm, Envelope& rsltEnvelope);
124
131 static bool isEmptyResult(int opCode, const Geometry* a, const Geometry* b, const PrecisionModel* pm);
132
138 static bool isEnvDisjoint(const Geometry* a, const Geometry* b, const PrecisionModel* pm);
139
147 static std::unique_ptr<Geometry> createEmptyResult(int dim, const GeometryFactory* geomFact);
148
162 static int resultDimension(int opCode, int dim0, int dim1);
163
167 static std::unique_ptr<Geometry> createResultGeometry(
168 std::vector<std::unique_ptr<Polygon>>& resultPolyList,
169 std::vector<std::unique_ptr<LineString>>& resultLineList,
170 std::vector<std::unique_ptr<Point>>& resultPointList,
171 const GeometryFactory* geometryFactory);
172
173 static std::unique_ptr<Geometry> toLines(OverlayGraph* graph, bool isOutputEdges, const GeometryFactory* geomFact);
174
192 const Geometry* geom0, const Geometry* geom1,
193 int opCode, const Geometry* result);
194
199 static bool round(const Point* pt, const PrecisionModel* pm, Coordinate& rsltCoord);
200
201 template<typename T>
202 static void moveGeometry(std::vector<std::unique_ptr<T>>& inGeoms, std::vector<std::unique_ptr<Geometry>>& outGeoms)
203 {
204 static_assert(std::is_base_of<Geometry, T>::value, "");
205 for (auto& geom: inGeoms) {
206 Geometry* outGeom = static_cast<Geometry*>(geom.release());
207 outGeoms.emplace_back(outGeom);
208 }
209 return;
210 }
211
212
213};
214
215
216} // namespace geos.operation.overlayng
217} // namespace geos.operation
218} // namespace geos
219
The internal representation of a list of coordinates inside a Geometry.
Definition CoordinateSequence.h:56
Coordinate is the lightweight class used to store coordinates.
Definition Coordinate.h:217
An Envelope defines a rectangulare region of the 2D coordinate plane.
Definition Envelope.h:59
Supplies a set of utility methods for building Geometry objects from CoordinateSequence or other Geom...
Definition GeometryFactory.h:70
Basic implementation of Geometry, constructed and destructed by GeometryFactory.
Definition Geometry.h:197
Definition LineString.h:66
Definition Point.h:61
Represents a linear polygon, which may include holes.
Definition Polygon.h:61
Specifies the precision model of the Coordinate in a Geometry.
Definition PrecisionModel.h:88
Definition InputGeometry.h:41
Definition OverlayGraph.h:52
Definition OverlayUtil.h:54
static bool round(const Point *pt, const PrecisionModel *pm, Coordinate &rsltCoord)
static int resultDimension(int opCode, int dim0, int dim1)
static bool isEmptyResult(int opCode, const Geometry *a, const Geometry *b, const PrecisionModel *pm)
static std::unique_ptr< Geometry > createEmptyResult(int dim, const GeometryFactory *geomFact)
static bool isEnvDisjoint(const Geometry *a, const Geometry *b, const PrecisionModel *pm)
static bool isResultAreaConsistent(const Geometry *geom0, const Geometry *geom1, int opCode, const Geometry *result)
static std::unique_ptr< Geometry > createResultGeometry(std::vector< std::unique_ptr< Polygon > > &resultPolyList, std::vector< std::unique_ptr< LineString > > &resultLineList, std::vector< std::unique_ptr< Point > > &resultPointList, const GeometryFactory *geometryFactory)
static bool clippingEnvelope(int opCode, const InputGeometry *inputGeom, const PrecisionModel *pm, Envelope &rsltEnvelope)
Basic namespace for all GEOS functionalities.
Definition geos.h:39