QGIS API Documentation  3.26.3-Buenos Aires (65e4edfdad)
qgscurvepolygon.h
Go to the documentation of this file.
1 /***************************************************************************
2  qgscurvepolygon.h
3  -------------------
4  begin : September 2014
5  copyright : (C) 2014 by Marco Hugentobler
6  email : marco at sourcepole dot ch
7  ***************************************************************************/
8 
9 /***************************************************************************
10  * *
11  * This program is free software; you can redistribute it and/or modify *
12  * it under the terms of the GNU General Public License as published by *
13  * the Free Software Foundation; either version 2 of the License, or *
14  * (at your option) any later version. *
15  * *
16  ***************************************************************************/
17 
18 #ifndef QGSCURVEPOLYGON_H
19 #define QGSCURVEPOLYGON_H
20 
21 #include "qgis_core.h"
22 #include "qgis_sip.h"
23 #include "qgssurface.h"
24 #include <memory>
25 
26 class QgsPolygon;
27 
34 class CORE_EXPORT QgsCurvePolygon: public QgsSurface
35 {
36  public:
38  QgsCurvePolygon( const QgsCurvePolygon &p );
40 
41  bool operator==( const QgsAbstractGeometry &other ) const override;
42  bool operator!=( const QgsAbstractGeometry &other ) const override;
43 
44  ~QgsCurvePolygon() override;
45 
46  QString geometryType() const override SIP_HOLDGIL;
47  int dimension() const override SIP_HOLDGIL;
48  QgsCurvePolygon *clone() const override SIP_FACTORY;
49  void clear() override;
50 
51  bool fromWkb( QgsConstWkbPtr &wkb ) override;
52  bool fromWkt( const QString &wkt ) override;
53 
54  int wkbSize( QgsAbstractGeometry::WkbFlags flags = QgsAbstractGeometry::WkbFlags() ) const override;
55  QByteArray asWkb( QgsAbstractGeometry::WkbFlags flags = QgsAbstractGeometry::WkbFlags() ) const override;
56  QString asWkt( int precision = 17 ) const override;
57  QDomElement asGml2( QDomDocument &doc, int precision = 17, const QString &ns = "gml", QgsAbstractGeometry::AxisOrder axisOrder = QgsAbstractGeometry::AxisOrder::XY ) const override;
58  QDomElement asGml3( QDomDocument &doc, int precision = 17, const QString &ns = "gml", QgsAbstractGeometry::AxisOrder axisOrder = QgsAbstractGeometry::AxisOrder::XY ) const override;
59  json asJsonObject( int precision = 17 ) const override SIP_SKIP;
60  QString asKml( int precision = 17 ) const override;
61  void normalize() final SIP_HOLDGIL;
62 
63  //surface interface
64  double area() const override SIP_HOLDGIL;
65  double perimeter() const override SIP_HOLDGIL;
66  QgsPolygon *surfaceToPolygon() const override SIP_FACTORY;
67  QgsAbstractGeometry *boundary() const override SIP_FACTORY;
68  QgsCurvePolygon *snappedToGrid( double hSpacing, double vSpacing, double dSpacing = 0, double mSpacing = 0 ) const override SIP_FACTORY;
69  bool removeDuplicateNodes( double epsilon = 4 * std::numeric_limits<double>::epsilon(), bool useZValues = false ) override;
70  bool boundingBoxIntersects( const QgsRectangle &rectangle ) const override SIP_HOLDGIL;
71 
77  double roundness() const;
78 
79  //curve polygon interface
80 
87  {
88  return mInteriorRings.size();
89  }
90 
97  {
98  return mExteriorRing.get();
99  }
100 
110  {
111  return mExteriorRing.get();
112  }
113 
114 #ifndef SIP_RUN
115 
122  const QgsCurve *interiorRing( int i ) const SIP_HOLDGIL
123  {
124  if ( i < 0 || i >= mInteriorRings.size() )
125  {
126  return nullptr;
127  }
128  return mInteriorRings.at( i );
129  }
130 
140  {
141  if ( i < 0 || i >= mInteriorRings.size() )
142  {
143  return nullptr;
144  }
145  return mInteriorRings.at( i );
146  }
147 #else
148 
157  SIP_PYOBJECT interiorRing( int i ) SIP_HOLDGIL SIP_TYPEHINT( QgsCurve );
158  % MethodCode
159  if ( a0 < 0 || a0 >= sipCpp->numInteriorRings() )
160  {
161  PyErr_SetString( PyExc_IndexError, QByteArray::number( a0 ) );
162  sipIsErr = 1;
163  }
164  else
165  {
166  return sipConvertFromType( const_cast< QgsCurve * >( sipCpp->interiorRing( a0 ) ), sipType_QgsCurve, NULL );
167  }
168  % End
169 #endif
170 
177  virtual QgsPolygon *toPolygon( double tolerance = M_PI_2 / 90, SegmentationToleranceType toleranceType = MaximumAngle ) const SIP_FACTORY;
178 
187  virtual void setExteriorRing( QgsCurve *ring SIP_TRANSFER );
188 
190  void setInteriorRings( const QVector<QgsCurve *> &rings SIP_TRANSFER );
192  virtual void addInteriorRing( QgsCurve *ring SIP_TRANSFER );
193 
194 #ifndef SIP_RUN
195 
202  bool removeInteriorRing( int ringIndex );
203 #else
204 
214  bool removeInteriorRing( int i );
215  % MethodCode
216  if ( a0 < 0 || a0 >= sipCpp->numInteriorRings() )
217  {
218  PyErr_SetString( PyExc_IndexError, QByteArray::number( a0 ) );
219  sipIsErr = 1;
220  }
221  else
222  {
223  return PyBool_FromLong( sipCpp->removeInteriorRing( a0 ) );
224  }
225  % End
226 #endif
227 
235  void removeInteriorRings( double minimumAllowedArea = -1 );
236 
244  void removeInvalidRings();
245 
259  void forceRHR();
260 
269  void forceClockwise();
270 
279  void forceCounterClockwise();
280 
281  QPainterPath asQPainterPath() const override;
282  void draw( QPainter &p ) const override;
283  void transform( const QgsCoordinateTransform &ct, Qgis::TransformDirection d = Qgis::TransformDirection::Forward, bool transformZ = false ) override SIP_THROW( QgsCsException );
284  void transform( const QTransform &t, double zTranslate = 0.0, double zScale = 1.0, double mTranslate = 0.0, double mScale = 1.0 ) override;
285 
286  bool insertVertex( QgsVertexId position, const QgsPoint &vertex ) override;
287  bool moveVertex( QgsVertexId position, const QgsPoint &newPos ) override;
288  bool deleteVertex( QgsVertexId position ) override;
289 
290  QgsCoordinateSequence coordinateSequence() const override;
291  int nCoordinates() const override;
292  int vertexNumberFromVertexId( QgsVertexId id ) const override;
293  bool isEmpty() const override SIP_HOLDGIL;
294  double closestSegment( const QgsPoint &pt, QgsPoint &segmentPt SIP_OUT, QgsVertexId &vertexAfter SIP_OUT, int *leftOf SIP_OUT = nullptr, double epsilon = 4 * std::numeric_limits<double>::epsilon() ) const override;
295 
296  bool nextVertex( QgsVertexId &id, QgsPoint &vertex SIP_OUT ) const override;
297  void adjacentVertices( QgsVertexId vertex, QgsVertexId &previousVertex SIP_OUT, QgsVertexId &nextVertex SIP_OUT ) const override;
298  bool hasCurvedSegments() const override;
299 
305  QgsAbstractGeometry *segmentize( double tolerance = M_PI_2 / 90, SegmentationToleranceType toleranceType = MaximumAngle ) const override SIP_FACTORY;
306 
312  double vertexAngle( QgsVertexId vertex ) const override;
313 
314  int vertexCount( int part = 0, int ring = 0 ) const override;
315  int ringCount( int part = 0 ) const override SIP_HOLDGIL;
316  int partCount() const override SIP_HOLDGIL;
317  QgsPoint vertexAt( QgsVertexId id ) const override;
318  double segmentLength( QgsVertexId startVertex ) const override;
319 
320  bool addZValue( double zValue = 0 ) override;
321  bool addMValue( double mValue = 0 ) override;
322  bool dropZValue() override;
323  bool dropMValue() override;
324  void swapXy() override;
325 
326  QgsCurvePolygon *toCurveType() const override SIP_FACTORY;
327 
328  bool transform( QgsAbstractGeometryTransformer *transformer, QgsFeedback *feedback = nullptr ) override;
329 
330 #ifndef SIP_RUN
331  void filterVertices( const std::function< bool( const QgsPoint & ) > &filter ) override;
332  void transformVertices( const std::function< QgsPoint( const QgsPoint & ) > &transform ) override;
333 
341  inline static const QgsCurvePolygon *cast( const QgsAbstractGeometry *geom )
342  {
343  if ( !geom )
344  return nullptr;
345 
346  const QgsWkbTypes::Type flatType = QgsWkbTypes::flatType( geom->wkbType() );
347  if ( flatType == QgsWkbTypes::CurvePolygon
348  || flatType == QgsWkbTypes::Polygon
349  || flatType == QgsWkbTypes::Triangle )
350  return static_cast<const QgsCurvePolygon *>( geom );
351  return nullptr;
352  }
353 #endif
354 
356 
357 #ifdef SIP_RUN
358  SIP_PYOBJECT __repr__();
359  % MethodCode
360  QString wkt = sipCpp->asWkt();
361  if ( wkt.length() > 1000 )
362  wkt = wkt.left( 1000 ) + QStringLiteral( "..." );
363  QString str = QStringLiteral( "<QgsCurvePolygon: %1>" ).arg( wkt );
364  sipRes = PyUnicode_FromString( str.toUtf8().constData() );
365  % End
366 #endif
367 
368  protected:
369 
370  int childCount() const override;
371  QgsAbstractGeometry *childGeometry( int index ) const override;
372  int compareToSameClass( const QgsAbstractGeometry *other ) const final;
373 
374  protected:
375 
376  std::unique_ptr< QgsCurve > mExteriorRing;
377  QVector<QgsCurve *> mInteriorRings;
378 
379  QgsRectangle calculateBoundingBox() const override;
380 };
381 
382 // clazy:excludeall=qstring-allocations
383 
384 #endif // QGSCURVEPOLYGON_H
QgsCurve
Abstract base class for curved geometry type.
Definition: qgscurve.h:35
QgsCoordinateSequence
QVector< QgsRingSequence > QgsCoordinateSequence
Definition: qgsabstractgeometry.h:57
QgsAbstractGeometry::removeDuplicateNodes
virtual bool removeDuplicateNodes(double epsilon=4 *std::numeric_limits< double >::epsilon(), bool useZValues=false)=0
Removes duplicate nodes from the geometry, wherever removing the nodes does not result in a degenerat...
QgsAbstractGeometry::fromWkt
virtual bool fromWkt(const QString &wkt)=0
Sets the geometry from a WKT string.
QgsAbstractGeometry::compareToSameClass
virtual int compareToSameClass(const QgsAbstractGeometry *other) const =0
Compares to an other geometry of the same class, and returns a integer for sorting of the two geometr...
QgsWkbTypes::Triangle
@ Triangle
Definition: qgswkbtypes.h:75
QgsCurvePolygon::interiorRing
QgsCurve * interiorRing(int i)
Retrieves an interior ring from the curve polygon.
Definition: qgscurvepolygon.h:139
QgsPolygon
Polygon geometry type.
Definition: qgspolygon.h:33
QgsAbstractGeometry::asQPainterPath
virtual QPainterPath asQPainterPath() const =0
Returns the geometry represented as a QPainterPath.
QgsAbstractGeometry::asWkb
virtual QByteArray asWkb(WkbFlags flags=QgsAbstractGeometry::WkbFlags()) const =0
Returns a WKB representation of the geometry.
QgsPoint
Point geometry type, with support for z-dimension and m-values.
Definition: qgspoint.h:48
QgsAbstractGeometry::snappedToGrid
virtual QgsAbstractGeometry * snappedToGrid(double hSpacing, double vSpacing, double dSpacing=0, double mSpacing=0) const =0
Makes a new geometry with all the points or vertices snapped to the closest point of the grid.
QgsAbstractGeometry::wkbSize
virtual int wkbSize(QgsAbstractGeometry::WkbFlags flags=QgsAbstractGeometry::WkbFlags()) const =0
Returns the length of the QByteArray returned by asWkb()
QgsCurvePolygon::exteriorRing
const QgsCurve * exteriorRing() const SIP_HOLDGIL
Returns the curve polygon's exterior ring.
Definition: qgscurvepolygon.h:96
SIP_OUT
#define SIP_OUT
Definition: qgis_sip.h:58
QgsWkbTypes::flatType
static Type flatType(Type type) SIP_HOLDGIL
Returns the flat type for a WKB type.
Definition: qgswkbtypes.h:732
QgsAbstractGeometry::filterVertices
virtual void filterVertices(const std::function< bool(const QgsPoint &) > &filter)
Filters the vertices from the geometry in place, removing any which do not return true for the filter...
Definition: qgsabstractgeometry.cpp:292
QgsCurvePolygon
Curve polygon geometry type.
Definition: qgscurvepolygon.h:34
QgsAbstractGeometry::asWkt
virtual QString asWkt(int precision=17) const =0
Returns a WKT representation of the geometry.
QgsSurface
Surface geometry type.
Definition: qgssurface.h:33
QgsWkbTypes::Type
Type
The WKB type describes the number of dimensions a geometry has.
Definition: qgswkbtypes.h:69
QgsAbstractGeometry::asKml
virtual QString asKml(int precision=17) const =0
Returns a KML representation of the geometry.
QgsCurvePolygon::cast
static const QgsCurvePolygon * cast(const QgsAbstractGeometry *geom)
Cast the geom to a QgsCurvePolygon.
Definition: qgscurvepolygon.h:341
QgsAbstractGeometry::childGeometry
virtual QgsAbstractGeometry * childGeometry(int index) const
Returns pointer to child geometry (for geometries with child geometries - i.e.
Definition: qgsabstractgeometry.h:1109
closestSegment
double closestSegment(const QgsPolylineXY &pl, const QgsPointXY &pt, int &vertexAfter, double epsilon)
Definition: qgstracer.cpp:69
QgsCurvePolygon::exteriorRing
QgsCurve * exteriorRing()
Returns a non-const pointer to the curve polygon's exterior ring.
Definition: qgscurvepolygon.h:109
QgsRectangle
A rectangle specified with double values.
Definition: qgsrectangle.h:41
SIP_TYPEHINT
#define SIP_TYPEHINT(type)
Definition: qgis_sip.h:227
SIP_FACTORY
#define SIP_FACTORY
Definition: qgis_sip.h:76
QgsAbstractGeometry::transform
virtual void transform(const QgsCoordinateTransform &ct, Qgis::TransformDirection d=Qgis::TransformDirection::Forward, bool transformZ=false) SIP_THROW(QgsCsException)=0
Transforms the geometry using a coordinate transform.
QgsCurvePolygon::numInteriorRings
int numInteriorRings() const SIP_HOLDGIL
Returns the number of interior rings contained with the curve polygon.
Definition: qgscurvepolygon.h:86
MathUtils::leftOf
double ANALYSIS_EXPORT leftOf(const QgsPoint &thepoint, const QgsPoint *p1, const QgsPoint *p2)
Returns whether 'thepoint' is left or right of the line from 'p1' to 'p2'. Negative values mean left ...
Definition: MathUtils.cpp:292
QgsAbstractGeometry::area
virtual double area() const
Returns the planar, 2-dimensional area of the geometry.
Definition: qgsabstractgeometry.cpp:176
QgsSurface::surfaceToPolygon
virtual QgsPolygon * surfaceToPolygon() const =0
Gets a polygon representation of this surface.
precision
int precision
Definition: qgswfsgetfeature.cpp:103
QgsAbstractGeometry::dimension
virtual int dimension() const =0
Returns the inherent dimension of the geometry.
QgsCsException
Custom exception class for Coordinate Reference System related exceptions.
Definition: qgsexception.h:65
SIP_SKIP
#define SIP_SKIP
Definition: qgis_sip.h:126
SIP_HOLDGIL
#define SIP_HOLDGIL
Definition: qgis_sip.h:166
SIP_THROW
#define SIP_THROW(name)
Definition: qgis_sip.h:198
QgsCurvePolygon::mExteriorRing
std::unique_ptr< QgsCurve > mExteriorRing
Definition: qgscurvepolygon.h:376
QgsAbstractGeometry::wkbType
QgsWkbTypes::Type wkbType() const SIP_HOLDGIL
Returns the WKB type of the geometry.
Definition: qgsabstractgeometry.h:206
QgsAbstractGeometry::AxisOrder
AxisOrder
Axis order for GML generation.
Definition: qgsabstractgeometry.h:138
QgsAbstractGeometry::asJsonObject
virtual json asJsonObject(int precision=17) const
Returns a json object representation of the geometry.
Definition: qgsabstractgeometry.cpp:196
QgsMeshUtils::toPolygon
CORE_EXPORT std::unique_ptr< QgsPolygon > toPolygon(const QgsMeshFace &face, const QVector< QgsMeshVertex > &vertices)
Returns face as polygon geometry, caller is responsible for delete.
Definition: qgstriangularmesh.cpp:623
QgsConstWkbPtr
A const WKB pointer.
Definition: qgswkbptr.h:137
QgsFeedback
Base class for feedback objects to be used for cancellation of something running in a worker thread.
Definition: qgsfeedback.h:44
QgsAbstractGeometry::clone
virtual QgsAbstractGeometry * clone() const =0
Clones the geometry by performing a deep copy.
qgis_sip.h
QgsWkbTypes::CurvePolygon
@ CurvePolygon
Definition: qgswkbtypes.h:82
SIP_TRANSFER
#define SIP_TRANSFER
Definition: qgis_sip.h:36
QgsAbstractGeometry::clear
virtual void clear()=0
Clears the geometry, ie reset it to a null geometry.
QgsCurvePolygon::interiorRing
const QgsCurve * interiorRing(int i) const SIP_HOLDGIL
Retrieves an interior ring from the curve polygon.
Definition: qgscurvepolygon.h:122
QgsAbstractGeometry::fromWkb
virtual bool fromWkb(QgsConstWkbPtr &wkb)=0
Sets the geometry from a WKB string.
QgsAbstractGeometry
Abstract base class for all geometries.
Definition: qgsabstractgeometry.h:79
QgsAbstractGeometry::normalize
virtual void normalize()=0
Reorganizes the geometry into a normalized form (or "canonical" form).
QgsAbstractGeometry::geometryType
virtual QString geometryType() const =0
Returns a unique string representing the geometry type.
QgsAbstractGeometry::createEmptyWithSameType
virtual QgsAbstractGeometry * createEmptyWithSameType() const =0
Creates a new geometry with the same class and same WKB type as the original and transfers ownership.
QgsAbstractGeometry::asGml3
virtual QDomElement asGml3(QDomDocument &doc, int precision=17, const QString &ns="gml", AxisOrder axisOrder=QgsAbstractGeometry::AxisOrder::XY) const =0
Returns a GML3 representation of the geometry.
QgsAbstractGeometry::operator=
QgsAbstractGeometry & operator=(const QgsAbstractGeometry &geom)
Definition: qgsabstractgeometry.cpp:34
QgsAbstractGeometry::operator!=
virtual bool operator!=(const QgsAbstractGeometry &other) const =0
str
#define str(x)
Definition: qgis.cpp:37
QgsAbstractGeometry::draw
virtual void draw(QPainter &p) const =0
Draws the geometry using the specified QPainter.
QgsWkbTypes::Polygon
@ Polygon
Definition: qgswkbtypes.h:74
QgsAbstractGeometry::childCount
virtual int childCount() const
Returns number of child geometries (for geometries with child geometries) or child points (for geomet...
Definition: qgsabstractgeometry.h:1102
QgsVertexId
Utility class for identifying a unique vertex within a geometry.
Definition: qgsvertexid.h:30
QgsAbstractGeometryTransformer
An abstract base class for classes which transform geometries by transforming input points to output ...
Definition: qgsgeometrytransformer.h:32
QgsAbstractGeometry::perimeter
virtual double perimeter() const
Returns the planar, 2-dimensional perimeter of the geometry.
Definition: qgsabstractgeometry.cpp:171
QgsAbstractGeometry::transformVertices
virtual void transformVertices(const std::function< QgsPoint(const QgsPoint &) > &transform)
Transforms the vertices from the geometry in place, applying the transform function to every vertex.
Definition: qgsabstractgeometry.cpp:297
QgsAbstractGeometry::boundary
virtual QgsAbstractGeometry * boundary() const =0
Returns the closure of the combinatorial boundary of the geometry (ie the topological boundary of the...
QgsCurvePolygon::mInteriorRings
QVector< QgsCurve * > mInteriorRings
Definition: qgscurvepolygon.h:377
QgsAbstractGeometry::operator==
virtual bool operator==(const QgsAbstractGeometry &other) const =0
Qgis::TransformDirection
TransformDirection
Indicates the direction (forward or inverse) of a transform.
Definition: qgis.h:1235
QgsAbstractGeometry::boundingBoxIntersects
virtual bool boundingBoxIntersects(const QgsRectangle &rectangle) const SIP_HOLDGIL
Returns true if the bounding box of this geometry intersects with a rectangle.
Definition: qgsabstractgeometry.cpp:390
QgsCoordinateTransform
Class for doing transforms between two map coordinate systems.
Definition: qgscoordinatetransform.h:57
QgsAbstractGeometry::asGml2
virtual QDomElement asGml2(QDomDocument &doc, int precision=17, const QString &ns="gml", AxisOrder axisOrder=QgsAbstractGeometry::AxisOrder::XY) const =0
Returns a GML2 representation of the geometry.
qgssurface.h
QgsAbstractGeometry::calculateBoundingBox
virtual QgsRectangle calculateBoundingBox() const
Default calculator for the minimal bounding box for the geometry.
Definition: qgsabstractgeometry.cpp:119