qgsgeometry.h

Go to the documentation of this file.

/***************************************************************************
  qgsgeometry.h - Geometry (stored as Open Geospatial Consortium WKB)
  -------------------------------------------------------------------
Date                 : 02 May 2005
Copyright            : (C) 2005 by Brendan Morley
email                : morb at ozemail dot com dot au
 ***************************************************************************
 *                                                                         *
 *   This program is free software; you can redistribute it and/or modify  *
 *   it under the terms of the GNU General Public License as published by  *
 *   the Free Software Foundation; either version 2 of the License, or     *
 *   (at your option) any later version.                                   *
 *                                                                         *
 ***************************************************************************/
 
#ifndef QGSGEOMETRY_H
#define QGSGEOMETRY_H
 
#include <functional>
 
#include <QDomDocument>
#include <QJsonObject>
#include <QSet>
#include <QString>
#include <QVector>
 
#include <climits>
#include <limits>
#include <memory>
 
#include "qgis_core.h"
#include "qgis_sip.h"
 
#include "qgsabstractgeometry.h"
#include "qgspointxy.h"
#include "qgspoint.h"
#include "qgsfeatureid.h"
 
#ifndef SIP_RUN
#include "json_fwd.hpp"
using namespace nlohmann;
#endif
 
class QgsGeometryEngine;
class QgsVectorLayer;
class QgsMapToPixel;
class QPainter;
class QgsPolygon;
class QgsLineString;
class QgsCurve;
class QgsFeedback;
 
typedef QVector<QgsPointXY> QgsPolylineXY;
 
typedef QgsPointSequence QgsPolyline;
 
#ifndef SIP_RUN
typedef QVector<QgsPolylineXY> QgsPolygonXY;
#else
typedef QVector<QVector<QgsPointXY>> QgsPolygonXY;
#endif
 
typedef QVector<QgsPointXY> QgsMultiPointXY;
 
#ifndef SIP_RUN
typedef QVector<QgsPolylineXY> QgsMultiPolylineXY;
#else
typedef QVector<QVector<QgsPointXY>> QgsMultiPolylineXY;
#endif
 
#ifndef SIP_RUN
typedef QVector<QgsPolygonXY> QgsMultiPolygonXY;
#else
typedef QVector<QVector<QVector<QgsPointXY>>> QgsMultiPolygonXY;
#endif
 
class QgsRectangle;
 
class QgsConstWkbPtr;
 
struct QgsGeometryPrivate;
 
class CORE_EXPORT QgsGeometry
{
    Q_GADGET
    Q_PROPERTY( bool isNull READ isNull )
    Q_PROPERTY( QgsWkbTypes::GeometryType type READ type )
 
  public:
 
    enum OperationResult
    {
      Success = 0, 
      NothingHappened = 1000, 
      InvalidBaseGeometry, 
      InvalidInputGeometryType, 
      SelectionIsEmpty, 
      SelectionIsGreaterThanOne, 
      GeometryEngineError, 
      LayerNotEditable, 
      /* Add part issues */
      AddPartSelectedGeometryNotFound, 
      AddPartNotMultiGeometry, 
      /* Add ring issues*/
      AddRingNotClosed, 
      AddRingNotValid, 
      AddRingCrossesExistingRings, 
      AddRingNotInExistingFeature, 
      /* Split features */
      SplitCannotSplitPoint, 
    };
    Q_ENUM( OperationResult )
 
    
    QgsGeometry() SIP_HOLDGIL;
 
    QgsGeometry( const QgsGeometry & );
 
    QgsGeometry &operator=( QgsGeometry const &rhs ) SIP_SKIP;
 
    explicit QgsGeometry( QgsAbstractGeometry *geom SIP_TRANSFER );
 
    explicit QgsGeometry( std::unique_ptr< QgsAbstractGeometry > geom ) SIP_SKIP;
 
    virtual ~QgsGeometry();
 
    const QgsAbstractGeometry *constGet() const SIP_HOLDGIL;
 
    QgsAbstractGeometry *get();
 
    void set( QgsAbstractGeometry *geometry SIP_TRANSFER ) SIP_DEPRECATED;
 
    bool isNull() const SIP_HOLDGIL;
 
    static QgsGeometry fromWkt( const QString &wkt );
    static QgsGeometry fromPointXY( const QgsPointXY &point ) SIP_HOLDGIL;
    static QgsGeometry fromMultiPointXY( const QgsMultiPointXY &multipoint );
 
    static QgsGeometry fromPolylineXY( const QgsPolylineXY &polyline );
 
    static QgsGeometry fromPolyline( const QgsPolyline &polyline );
 
    static QgsGeometry fromMultiPolylineXY( const QgsMultiPolylineXY &multiline );
    static QgsGeometry fromPolygonXY( const QgsPolygonXY &polygon );
    static QgsGeometry fromMultiPolygonXY( const QgsMultiPolygonXY &multipoly );
    static QgsGeometry fromRect( const QgsRectangle &rect ) SIP_HOLDGIL;
    static QgsGeometry collectGeometry( const QVector<QgsGeometry> &geometries );
 
    static QgsGeometry createWedgeBuffer( const QgsPoint &center, double azimuth, double angularWidth,
                                          double outerRadius, double innerRadius = 0 );
 
    void fromWkb( unsigned char *wkb, int length ) SIP_SKIP;
 
    void fromWkb( const QByteArray &wkb );
 
    QgsWkbTypes::Type wkbType() const SIP_HOLDGIL;
 
    QgsWkbTypes::GeometryType type() const SIP_HOLDGIL;
 
    bool isEmpty() const;
 
    bool isMultipart() const SIP_HOLDGIL;
 
    bool equals( const QgsGeometry &geometry ) const;
 
    bool isGeosEqual( const QgsGeometry & ) const;
 
    enum ValidityFlag
    {
      FlagAllowSelfTouchingHoles = 1 << 0, 
    };
    Q_DECLARE_FLAGS( ValidityFlags, ValidityFlag )
 
    
    bool isGeosValid( QgsGeometry::ValidityFlags flags = QgsGeometry::ValidityFlags() ) const;
 
    bool isSimple() const;
 
    double area() const;
 
    double length() const;
 
    double distance( const QgsGeometry &geom ) const;
 
#ifndef SIP_RUN
 
    // TODO QGIS 4: consider renaming vertices_begin, vertices_end, parts_begin, parts_end, etc
    // to camelCase
 
    QgsAbstractGeometry::vertex_iterator vertices_begin() const;
 
    QgsAbstractGeometry::vertex_iterator vertices_end() const;
#endif
 
    QgsVertexIterator vertices() const;
 
#ifndef SIP_RUN
 
    QgsAbstractGeometry::part_iterator parts_begin();
 
    QgsAbstractGeometry::part_iterator parts_end();
 
    QgsAbstractGeometry::const_part_iterator const_parts_begin() const;
 
    QgsAbstractGeometry::const_part_iterator const_parts_end() const;
#endif
 
    QgsGeometryPartIterator parts();
 
    QgsGeometryConstPartIterator constParts() const;
 
    double hausdorffDistance( const QgsGeometry &geom ) const;
 
    double hausdorffDistanceDensify( const QgsGeometry &geom, double densifyFraction ) const;
 
    QgsPointXY closestVertex( const QgsPointXY &point, int &closestVertexIndex SIP_OUT, int &previousVertexIndex SIP_OUT, int &nextVertexIndex SIP_OUT, double &sqrDist SIP_OUT ) const;
 
    double distanceToVertex( int vertex ) const;
 
    double angleAtVertex( int vertex ) const;
 
    void adjacentVertices( int atVertex, int &beforeVertex SIP_OUT, int &afterVertex SIP_OUT ) const;
 
    bool insertVertex( double x, double y, int beforeVertex );
 
    bool insertVertex( const QgsPoint &point, int beforeVertex );
 
    bool moveVertex( double x, double y, int atVertex );
 
    bool moveVertex( const QgsPoint &p, int atVertex );
 
    bool deleteVertex( int atVertex );
 
    QgsPoint vertexAt( int atVertex ) const;
 
    double sqrDistToVertexAt( QgsPointXY &point SIP_IN, int atVertex ) const;
 
    QgsGeometry nearestPoint( const QgsGeometry &other ) const;
 
    QgsGeometry shortestLine( const QgsGeometry &other ) const;
 
    double closestVertexWithContext( const QgsPointXY &point, int &atVertex SIP_OUT ) const;
 
    double closestSegmentWithContext( const QgsPointXY &point, QgsPointXY &minDistPoint SIP_OUT, int &nextVertexIndex SIP_OUT, int *leftOrRightOfSegment SIP_OUT = nullptr, double epsilon = DEFAULT_SEGMENT_EPSILON ) const;
 
    OperationResult addRing( const QVector<QgsPointXY> &ring );
 
    OperationResult addRing( QgsCurve *ring SIP_TRANSFER );
 
    OperationResult addPart( const QVector<QgsPointXY> &points, QgsWkbTypes::GeometryType geomType = QgsWkbTypes::UnknownGeometry ) SIP_PYNAME( addPointsXY );
 
    OperationResult addPart( const QgsPointSequence &points, QgsWkbTypes::GeometryType geomType = QgsWkbTypes::UnknownGeometry ) SIP_PYNAME( addPoints );
 
    OperationResult addPart( QgsAbstractGeometry *part SIP_TRANSFER, QgsWkbTypes::GeometryType geomType = QgsWkbTypes::UnknownGeometry );
 
    OperationResult addPart( const QgsGeometry &newPart ) SIP_PYNAME( addPartGeometry );
 
    QgsGeometry removeInteriorRings( double minimumAllowedArea = -1 ) const;
 
    OperationResult translate( double dx, double dy, double dz = 0.0, double dm = 0.0 );
 
    OperationResult transform( const QgsCoordinateTransform &ct, QgsCoordinateTransform::TransformDirection direction = QgsCoordinateTransform::ForwardTransform, bool transformZ = false ) SIP_THROW( QgsCsException );
 
    OperationResult transform( const QTransform &t, double zTranslate = 0.0, double zScale = 1.0, double mTranslate = 0.0, double mScale = 1.0 );
 
    OperationResult rotate( double rotation, const QgsPointXY &center );
 
    Q_DECL_DEPRECATED OperationResult splitGeometry( const QVector<QgsPointXY> &splitLine, QVector<QgsGeometry> &newGeometries SIP_OUT, bool topological, QVector<QgsPointXY> &topologyTestPoints SIP_OUT, bool splitFeature = true ) SIP_DEPRECATED;
 
    OperationResult splitGeometry( const QgsPointSequence &splitLine, QVector<QgsGeometry> &newGeometries SIP_OUT, bool topological, QgsPointSequence &topologyTestPoints SIP_OUT, bool splitFeature = true, bool skipIntersectionTest SIP_PYARGREMOVE = false );
 
    OperationResult splitGeometry( const QgsCurve *curve,  QVector<QgsGeometry> &newGeometries SIP_OUT, bool preserveCircular, bool topological, QgsPointSequence &topologyTestPoints SIP_OUT, bool splitFeature = true );
 
    OperationResult reshapeGeometry( const QgsLineString &reshapeLineString );
 
    int makeDifferenceInPlace( const QgsGeometry &other ) SIP_SKIP;
 
    QgsGeometry makeDifference( const QgsGeometry &other ) const;
 
    QgsRectangle boundingBox() const;
 
    QgsGeometry orientedMinimumBoundingBox( double &area SIP_OUT, double &angle SIP_OUT, double &width SIP_OUT, double &height SIP_OUT ) const;
 
    QgsGeometry orientedMinimumBoundingBox() const SIP_SKIP;
 
    QgsGeometry minimalEnclosingCircle( QgsPointXY &center SIP_OUT, double &radius SIP_OUT, unsigned int segments = 36 ) const;
 
    QgsGeometry minimalEnclosingCircle( unsigned int segments = 36 ) const SIP_SKIP;
 
    QgsGeometry orthogonalize( double tolerance = 1.0E-8, int maxIterations = 1000, double angleThreshold = 15.0 ) const;
 
    QgsGeometry snappedToGrid( double hSpacing, double vSpacing, double dSpacing = 0, double mSpacing = 0 ) const;
 
    bool removeDuplicateNodes( double epsilon = 4 * std::numeric_limits<double>::epsilon(), bool useZValues = false );
 
    bool intersects( const QgsRectangle &rectangle ) const;
 
    bool intersects( const QgsGeometry &geometry ) const;
 
    bool boundingBoxIntersects( const QgsRectangle &rectangle ) const;
 
    bool boundingBoxIntersects( const QgsGeometry &geometry ) const;
 
    bool contains( const QgsPointXY *p ) const;
 
    bool contains( const QgsGeometry &geometry ) const;
 
    bool disjoint( const QgsGeometry &geometry ) const;
 
    bool touches( const QgsGeometry &geometry ) const;
 
    bool overlaps( const QgsGeometry &geometry ) const;
 
    bool within( const QgsGeometry &geometry ) const;
 
 
    bool crosses( const QgsGeometry &geometry ) const;
 
    enum BufferSide
    {
      SideLeft = 0, 
      SideRight, 
    };
    Q_ENUM( BufferSide )
 
    
    enum EndCapStyle
    {
      CapRound = 1, 
      CapFlat, 
      CapSquare, 
    };
    Q_ENUM( EndCapStyle )
 
    
    enum JoinStyle
    {
      JoinStyleRound = 1, 
      JoinStyleMiter, 
      JoinStyleBevel, 
    };
    Q_ENUM( JoinStyle )
 
    
    QgsGeometry buffer( double distance, int segments ) const;
 
    QgsGeometry buffer( double distance, int segments, EndCapStyle endCapStyle, JoinStyle joinStyle, double miterLimit ) const;
 
    QgsGeometry offsetCurve( double distance, int segments, JoinStyle joinStyle, double miterLimit ) const;
 
    QgsGeometry singleSidedBuffer( double distance, int segments, BufferSide side,
                                   JoinStyle joinStyle = JoinStyleRound,
                                   double miterLimit = 2.0 ) const;
 
    QgsGeometry taperedBuffer( double startWidth, double endWidth, int segments ) const;
 
    QgsGeometry variableWidthBufferByM( int segments ) const;
 
    QgsGeometry extendLine( double startDistance, double endDistance ) const;
 
    QgsGeometry simplify( double tolerance ) const;
 
    QgsGeometry densifyByCount( int extraNodesPerSegment ) const;
 
    QgsGeometry densifyByDistance( double distance ) const;
 
    QgsGeometry convertToCurves( double distanceTolerance = 1e-8, double angleTolerance = 1e-8 ) const;
 
    QgsGeometry centroid() const;
 
    QgsGeometry pointOnSurface() const;
 
    QgsGeometry poleOfInaccessibility( double precision, double *distanceToBoundary SIP_OUT = nullptr ) const;
 
    QgsGeometry convexHull() const;
 
    QgsGeometry voronoiDiagram( const QgsGeometry &extent = QgsGeometry(), double tolerance = 0.0, bool edgesOnly = false ) const;
 
    QgsGeometry delaunayTriangulation( double tolerance = 0.0, bool edgesOnly = false ) const;
 
    QgsGeometry subdivide( int maxNodes = 256 ) const;
 
    QgsGeometry interpolate( double distance ) const;
 
    double lineLocatePoint( const QgsGeometry &point ) const;
 
    double interpolateAngle( double distance ) const;
 
    QgsGeometry intersection( const QgsGeometry &geometry ) const;
 
    QgsGeometry clipped( const QgsRectangle &rectangle );
 
    QgsGeometry combine( const QgsGeometry &geometry ) const;
 
    QgsGeometry mergeLines() const;
 
    QgsGeometry difference( const QgsGeometry &geometry ) const;
 
    QgsGeometry symDifference( const QgsGeometry &geometry ) const;
 
    QgsGeometry extrude( double x, double y );
 
#ifndef SIP_RUN
 
    QVector< QgsPointXY > randomPointsInPolygon( int count, const std::function< bool( const QgsPointXY & ) > &acceptPoint, unsigned long seed = 0, QgsFeedback *feedback = nullptr, int maxTriesPerPoint = 0 ) const;
 
    QVector< QgsPointXY > randomPointsInPolygon( int count, unsigned long seed = 0, QgsFeedback *feedback = nullptr ) const;
#else
 
    SIP_PYOBJECT randomPointsInPolygon( int count, unsigned long seed = 0 ) const SIP_TYPEHINT( QgsPolylineXY );
    % MethodCode
    const QgsWkbTypes::GeometryType type = sipCpp->type();
    if ( sipCpp->isNull() )
    {
      PyErr_SetString( PyExc_ValueError, QStringLiteral( "Cannot generate points inside a null geometry." ).toUtf8().constData() );
      sipIsErr = 1;
    }
    else if ( type != QgsWkbTypes::PolygonGeometry )
    {
      PyErr_SetString( PyExc_TypeError, QStringLiteral( "Cannot generate points inside a %1 geometry. Only Polygon types are permitted." ).arg( QgsWkbTypes::displayString( sipCpp->wkbType() ) ).toUtf8().constData() );
      sipIsErr = 1;
    }
    else
    {
      const sipTypeDef *qvector_type = sipFindType( "QVector<QgsPointXY>" );
      sipRes = sipConvertFromNewType( new QVector< QgsPointXY >( sipCpp->randomPointsInPolygon( a0, a1 ) ), qvector_type, Py_None );
    }
    % End
 
 
#endif
 
    int wkbSize( QgsAbstractGeometry::WkbFlags flags = QgsAbstractGeometry::WkbFlags() ) const;
 
    QByteArray asWkb( QgsAbstractGeometry::WkbFlags flags = QgsAbstractGeometry::WkbFlags() ) const;
 
    QString asWkt( int precision = 17 ) const;
 
#ifdef SIP_RUN
    SIP_PYOBJECT __repr__();
    % MethodCode
    QString str;
    if ( sipCpp->isNull() )
      str = QStringLiteral( "<QgsGeometry: null>" );
    else
    {
      QString wkt = sipCpp->asWkt();
      if ( wkt.length() > 1000 )
        wkt = wkt.left( 1000 ) + QStringLiteral( "..." );
      str = QStringLiteral( "<QgsGeometry: %1>" ).arg( wkt );
    }
    sipRes = PyUnicode_FromString( str.toUtf8().constData() );
    % End
#endif
 
    QString asJson( int precision = 17 ) const;
 
    virtual json asJsonObject( int precision = 17 ) const SIP_SKIP;
 
    QVector< QgsGeometry > coerceToType( QgsWkbTypes::Type type ) const;
 
    QgsGeometry convertToType( QgsWkbTypes::GeometryType destType, bool destMultipart = false ) const;
 
    /* Accessor functions for getting geometry data */
 
#ifndef SIP_RUN
 
    QgsPointXY asPoint() const;
#else
 
    SIP_PYOBJECT asPoint() const SIP_TYPEHINT( QgsPointXY );
    % MethodCode
    const QgsWkbTypes::Type type = sipCpp->wkbType();
    if ( sipCpp->isNull() )
    {
      PyErr_SetString( PyExc_ValueError, QStringLiteral( "Null geometry cannot be converted to a point." ).toUtf8().constData() );
      sipIsErr = 1;
    }
    else if ( QgsWkbTypes::flatType( type ) != QgsWkbTypes::Point )
    {
      PyErr_SetString( PyExc_TypeError, QStringLiteral( "%1 geometry cannot be converted to a point. Only Point types are permitted." ).arg( QgsWkbTypes::displayString( type ) ).toUtf8().constData() );
      sipIsErr = 1;
    }
    else
    {
      sipRes = sipConvertFromNewType( new QgsPointXY( sipCpp->asPoint() ), sipType_QgsPointXY, Py_None );
    }
    % End
#endif
 
#ifndef SIP_RUN
 
    QgsPolylineXY asPolyline() const;
#else
 
    SIP_PYOBJECT asPolyline() const SIP_TYPEHINT( QgsPolylineXY );
    % MethodCode
    const QgsWkbTypes::Type type = sipCpp->wkbType();
    if ( sipCpp->isNull() )
    {
      PyErr_SetString( PyExc_ValueError, QStringLiteral( "Null geometry cannot be converted to a polyline." ).toUtf8().constData() );
      sipIsErr = 1;
    }
    else if ( QgsWkbTypes::geometryType( type ) != QgsWkbTypes::LineGeometry || QgsWkbTypes::isMultiType( type ) )
    {
      PyErr_SetString( PyExc_TypeError, QStringLiteral( "%1 geometry cannot be converted to a polyline. Only single line or curve types are permitted." ).arg( QgsWkbTypes::displayString( type ) ).toUtf8().constData() );
      sipIsErr = 1;
    }
    else
    {
      const sipTypeDef *qvector_type = sipFindType( "QVector< QgsPointXY >" );
      sipRes = sipConvertFromNewType( new QgsPolylineXY( sipCpp->asPolyline() ), qvector_type, Py_None );
    }
    % End
#endif
 
#ifndef SIP_RUN
 
    QgsPolygonXY asPolygon() const;
#else
 
    SIP_PYOBJECT asPolygon() const SIP_TYPEHINT( QgsPolygonXY );
    % MethodCode
    const QgsWkbTypes::Type type = sipCpp->wkbType();
    if ( sipCpp->isNull() )
    {
      PyErr_SetString( PyExc_ValueError, QStringLiteral( "Null geometry cannot be converted to a polygon." ).toUtf8().constData() );
      sipIsErr = 1;
    }
    else if ( QgsWkbTypes::geometryType( type ) != QgsWkbTypes::PolygonGeometry || QgsWkbTypes::isMultiType( type ) )
    {
      PyErr_SetString( PyExc_TypeError, QStringLiteral( "%1 geometry cannot be converted to a polygon. Only single polygon or curve polygon types are permitted." ).arg( QgsWkbTypes::displayString( type ) ).toUtf8().constData() );
      sipIsErr = 1;
    }
    else
    {
      const sipTypeDef *qvector_type = sipFindType( "QVector<QVector<QgsPointXY>>" );
      sipRes = sipConvertFromNewType( new QgsPolygonXY( sipCpp->asPolygon() ), qvector_type, Py_None );
    }
    % End
#endif
 
#ifndef SIP_RUN
 
    QgsMultiPointXY asMultiPoint() const;
#else
 
    SIP_PYOBJECT asMultiPoint() const SIP_TYPEHINT( QgsMultiPointXY );
    % MethodCode
    const QgsWkbTypes::Type type = sipCpp->wkbType();
    if ( sipCpp->isNull() )
    {
      PyErr_SetString( PyExc_ValueError, QStringLiteral( "Null geometry cannot be converted to a multipoint." ).toUtf8().constData() );
      sipIsErr = 1;
    }
    else if ( QgsWkbTypes::geometryType( type ) != QgsWkbTypes::PointGeometry || !QgsWkbTypes::isMultiType( type ) )
    {
      PyErr_SetString( PyExc_TypeError, QStringLiteral( "%1 geometry cannot be converted to a multipoint. Only multipoint types are permitted." ).arg( QgsWkbTypes::displayString( type ) ).toUtf8().constData() );
      sipIsErr = 1;
    }
    else
    {
      const sipTypeDef *qvector_type = sipFindType( "QVector< QgsPointXY >" );
      sipRes = sipConvertFromNewType( new QgsPolylineXY( sipCpp->asMultiPoint() ), qvector_type, Py_None );
    }
    % End
#endif
 
#ifndef SIP_RUN
 
    QgsMultiPolylineXY asMultiPolyline() const;
#else
 
    SIP_PYOBJECT asMultiPolyline() const SIP_TYPEHINT( QgsMultiPolylineXY );
    % MethodCode
    const QgsWkbTypes::Type type = sipCpp->wkbType();
    if ( sipCpp->isNull() )
    {
      PyErr_SetString( PyExc_ValueError, QStringLiteral( "Null geometry cannot be converted to a multilinestring." ).toUtf8().constData() );
      sipIsErr = 1;
    }
    else if ( QgsWkbTypes::geometryType( type ) != QgsWkbTypes::LineGeometry || !QgsWkbTypes::isMultiType( type ) )
    {
      PyErr_SetString( PyExc_TypeError, QStringLiteral( "%1 geometry cannot be converted to a multilinestring. Only multi linestring or curves are permitted." ).arg( QgsWkbTypes::displayString( type ) ).toUtf8().constData() );
      sipIsErr = 1;
    }
    else
    {
      const sipTypeDef *qvector_type = sipFindType( "QVector<QVector<QgsPointXY>>" );
      sipRes = sipConvertFromNewType( new QgsMultiPolylineXY( sipCpp->asMultiPolyline() ), qvector_type, Py_None );
    }
    % End
#endif
 
#ifndef SIP_RUN
 
    QgsMultiPolygonXY asMultiPolygon() const;
#else
 
    SIP_PYOBJECT asMultiPolygon() const SIP_TYPEHINT( QgsMultiPolygonXY );
    % MethodCode
    const QgsWkbTypes::Type type = sipCpp->wkbType();
    if ( sipCpp->isNull() )
    {
      PyErr_SetString( PyExc_ValueError, QStringLiteral( "Null geometry cannot be converted to a multipolygon." ).toUtf8().constData() );
      sipIsErr = 1;
    }
    else if ( QgsWkbTypes::geometryType( type ) != QgsWkbTypes::PolygonGeometry || !QgsWkbTypes::isMultiType( type ) )
    {
      PyErr_SetString( PyExc_TypeError, QStringLiteral( "%1 geometry cannot be converted to a multipolygon. Only multi polygon or curves are permitted." ).arg( QgsWkbTypes::displayString( type ) ).toUtf8().constData() );
      sipIsErr = 1;
    }
    else
    {
      const sipTypeDef *qvector_type = sipFindType( "QVector<QVector<QVector<QgsPointXY>>>" );
      sipRes = sipConvertFromNewType( new QgsMultiPolygonXY( sipCpp->asMultiPolygon() ), qvector_type, Py_None );
    }
    % End
#endif
 
    QVector<QgsGeometry> asGeometryCollection() const;
 
    QPointF asQPointF() const SIP_HOLDGIL;
 
    QPolygonF asQPolygonF() const SIP_HOLDGIL;
 
    bool deleteRing( int ringNum, int partNum = 0 );
 
    bool deletePart( int partNum );
 
    bool convertToMultiType();
 
    bool convertToSingleType();
 
    bool convertGeometryCollectionToSubclass( QgsWkbTypes::GeometryType geomType );
 
    int avoidIntersections( const QList<QgsVectorLayer *> &avoidIntersectionsLayers,
                            const QHash<QgsVectorLayer *, QSet<QgsFeatureId> > &ignoreFeatures SIP_PYARGREMOVE = ( QHash<QgsVectorLayer *, QSet<QgsFeatureId> >() ) );
 
    QgsGeometry makeValid() const;
 
    QgsGeometry forceRHR() const;
 
    class CORE_EXPORT Error
    {
      public:
        Error()
          : mMessage( QStringLiteral( "none" ) )
        {}
 
        explicit Error( const QString &m )
          : mMessage( m )
        {}
 
        Error( const QString &m, const QgsPointXY &p )
          : mMessage( m )
          , mLocation( p )
          , mHasLocation( true ) {}
 
        QString what() const;
 
        QgsPointXY where() const;
 
        bool hasWhere() const;
 
#ifdef SIP_RUN
        SIP_PYOBJECT __repr__();
        % MethodCode
        QString str = QStringLiteral( "<QgsGeometry.Error: %1>" ).arg( sipCpp->what() );
        sipRes = PyUnicode_FromString( str.toUtf8().data() );
        % End
#endif
 
        bool operator==( const QgsGeometry::Error &other ) const
        {
          return other.mMessage == mMessage && other.mHasLocation == mHasLocation && other.mLocation == mLocation;
        }
 
      private:
        QString mMessage;
        QgsPointXY mLocation;
        bool mHasLocation = false;
    };
 
    enum ValidationMethod
    {
      ValidatorQgisInternal, 
      ValidatorGeos, 
    };
 
    void validateGeometry( QVector<QgsGeometry::Error> &errors SIP_OUT, ValidationMethod method = ValidatorQgisInternal, QgsGeometry::ValidityFlags flags = QgsGeometry::ValidityFlags() ) const;
 
    static QgsGeometry unaryUnion( const QVector<QgsGeometry> &geometries );
 
    static QgsGeometry polygonize( const QVector<QgsGeometry> &geometries );
 
    void convertToStraightSegment( double tolerance = M_PI / 180., QgsAbstractGeometry::SegmentationToleranceType toleranceType = QgsAbstractGeometry::MaximumAngle );
 
    bool requiresConversionToStraightSegments() const;
 
    void mapToPixel( const QgsMapToPixel &mtp );
 
    void draw( QPainter &p ) const;
 
    bool vertexIdFromVertexNr( int number, QgsVertexId &id SIP_OUT ) const;
 
    int vertexNrFromVertexId( QgsVertexId id ) const;
 
    QString lastError() const SIP_HOLDGIL;
 
    void filterVertices( const std::function< bool( const QgsPoint & ) > &filter ) SIP_SKIP;
 
    void transformVertices( const std::function< QgsPoint( const QgsPoint & ) > &transform ) SIP_SKIP;
 
    static QgsGeometry fromQPointF( QPointF point ) SIP_HOLDGIL;
 
    static QgsGeometry fromQPolygonF( const QPolygonF &polygon );
 
    Q_DECL_DEPRECATED static QgsPolylineXY createPolylineFromQPolygonF( const QPolygonF &polygon ) SIP_DEPRECATED;
 
    Q_DECL_DEPRECATED static QgsPolygonXY createPolygonFromQPolygonF( const QPolygonF &polygon ) SIP_DEPRECATED;
 
#ifndef SIP_RUN
 
    static bool compare( const QgsPolylineXY &p1, const QgsPolylineXY &p2,
                         double epsilon = 4 * std::numeric_limits<double>::epsilon() );
 
    static bool compare( const QgsPolygonXY &p1, const QgsPolygonXY &p2,
                         double epsilon = 4 * std::numeric_limits<double>::epsilon() );
 
    static bool compare( const QgsMultiPolygonXY &p1, const QgsMultiPolygonXY &p2,
                         double epsilon = 4 * std::numeric_limits<double>::epsilon() );
#else
 
    static bool compare( PyObject *obj1, PyObject *obj2, double epsilon = 4 * std::numeric_limits<double>::epsilon() );
    % MethodCode
    {
      sipRes = false;
      int state0;
      int state1;
      int sipIsErr = 0;
 
      if ( PyList_Check( a0 ) && PyList_Check( a1 ) &&
           PyList_GET_SIZE( a0 ) && PyList_GET_SIZE( a1 ) )
      {
        PyObject *o0 = PyList_GetItem( a0, 0 );
        PyObject *o1 = PyList_GetItem( a1, 0 );
        if ( o0 && o1 )
        {
          // compare polyline - polyline
          if ( sipCanConvertToType( o0, sipType_QgsPointXY, SIP_NOT_NONE ) &&
               sipCanConvertToType( o1, sipType_QgsPointXY, SIP_NOT_NONE ) &&
               sipCanConvertToType( a0, sipType_QVector_0100QgsPointXY, SIP_NOT_NONE ) &&
               sipCanConvertToType( a1, sipType_QVector_0100QgsPointXY, SIP_NOT_NONE ) )
          {
            QgsPolylineXY *p0;
            QgsPolylineXY *p1;
            p0 = reinterpret_cast<QgsPolylineXY *>( sipConvertToType( a0, sipType_QVector_0100QgsPointXY, 0, SIP_NOT_NONE, &state0, &sipIsErr ) );
            p1 = reinterpret_cast<QgsPolylineXY *>( sipConvertToType( a1, sipType_QVector_0100QgsPointXY, 0, SIP_NOT_NONE, &state1, &sipIsErr ) );
            if ( sipIsErr )
            {
              sipReleaseType( p0, sipType_QVector_0100QgsPointXY, state0 );
              sipReleaseType( p1, sipType_QVector_0100QgsPointXY, state1 );
            }
            else
            {
              sipRes = QgsGeometry::compare( *p0, *p1, a2 );
            }
          }
          else if ( PyList_Check( o0 ) && PyList_Check( o1 ) &&
                    PyList_GET_SIZE( o0 ) && PyList_GET_SIZE( o1 ) )
          {
            PyObject *oo0 = PyList_GetItem( o0, 0 );
            PyObject *oo1 = PyList_GetItem( o1, 0 );
            if ( oo0 && oo1 )
            {
              // compare polygon - polygon
              if ( sipCanConvertToType( oo0, sipType_QgsPointXY, SIP_NOT_NONE ) &&
                   sipCanConvertToType( oo1, sipType_QgsPointXY, SIP_NOT_NONE ) &&
                   sipCanConvertToType( a0, sipType_QVector_0600QVector_0100QgsPointXY, SIP_NOT_NONE ) &&
                   sipCanConvertToType( a1, sipType_QVector_0600QVector_0100QgsPointXY, SIP_NOT_NONE ) )
              {
                QgsPolygonXY *p0;
                QgsPolygonXY *p1;
                p0 = reinterpret_cast<QgsPolygonXY *>( sipConvertToType( a0, sipType_QVector_0600QVector_0100QgsPointXY, 0, SIP_NOT_NONE, &state0, &sipIsErr ) );
                p1 = reinterpret_cast<QgsPolygonXY *>( sipConvertToType( a1, sipType_QVector_0600QVector_0100QgsPointXY, 0, SIP_NOT_NONE, &state1, &sipIsErr ) );
                if ( sipIsErr )
                {
                  sipReleaseType( p0, sipType_QVector_0600QVector_0100QgsPointXY, state0 );
                  sipReleaseType( p1, sipType_QVector_0600QVector_0100QgsPointXY, state1 );
                }
                else
                {
                  sipRes = QgsGeometry::compare( *p0, *p1, a2 );
                }
              }
              else if ( PyList_Check( oo0 ) && PyList_Check( oo1 ) &&
                        PyList_GET_SIZE( oo0 ) && PyList_GET_SIZE( oo1 ) )
              {
                PyObject *ooo0 = PyList_GetItem( oo0, 0 );
                PyObject *ooo1 = PyList_GetItem( oo1, 0 );
                if ( ooo0 && ooo1 )
                {
                  // compare multipolygon - multipolygon
                  if ( sipCanConvertToType( ooo0, sipType_QgsPointXY, SIP_NOT_NONE ) &&
                       sipCanConvertToType( ooo1, sipType_QgsPointXY, SIP_NOT_NONE ) &&
                       sipCanConvertToType( a0, sipType_QVector_0600QVector_0600QVector_0100QgsPointXY, SIP_NOT_NONE ) &&
                       sipCanConvertToType( a1, sipType_QVector_0600QVector_0600QVector_0100QgsPointXY, SIP_NOT_NONE ) )
                  {
                    QgsMultiPolygonXY *p0;
                    QgsMultiPolygonXY *p1;
                    p0 = reinterpret_cast<QgsMultiPolygonXY *>( sipConvertToType( a0, sipType_QVector_0600QVector_0600QVector_0100QgsPointXY, 0, SIP_NOT_NONE, &state0, &sipIsErr ) );
                    p1 = reinterpret_cast<QgsMultiPolygonXY *>( sipConvertToType( a1, sipType_QVector_0600QVector_0600QVector_0100QgsPointXY, 0, SIP_NOT_NONE, &state1, &sipIsErr ) );
                    if ( sipIsErr )
                    {
                      sipReleaseType( p0, sipType_QVector_0600QVector_0600QVector_0100QgsPointXY, state0 );
                      sipReleaseType( p1, sipType_QVector_0600QVector_0600QVector_0100QgsPointXY, state1 );
                    }
                    else
                    {
                      sipRes = QgsGeometry::compare( *p0, *p1, a2 );
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
    % End
#endif
 
    QgsGeometry smooth( unsigned int iterations = 1, double offset = 0.25,
                        double minimumDistance = -1.0, double maxAngle = 180.0 ) const;
 
    static QgsGeometryEngine *createGeometryEngine( const QgsAbstractGeometry *geometry ) SIP_FACTORY;
 
    static void convertPointList( const QVector<QgsPointXY> &input, QgsPointSequence &output );
 
    static void convertPointList( const QgsPointSequence &input, QVector<QgsPointXY> &output );
 
    operator QVariant() const
    {
      return QVariant::fromValue( *this );
    }
 
  private:
 
    QgsGeometryPrivate *d; //implicitly shared data pointer
 
    mutable QString mLastError;
 
    void detach();
 
    void reset( std::unique_ptr< QgsAbstractGeometry > newGeometry );
 
    static void convertToPolyline( const QgsPointSequence &input, QgsPolylineXY &output );
    static void convertPolygon( const QgsPolygon &input, QgsPolygonXY &output );
 
    QgsGeometry convertToPoint( bool destMultipart ) const;
    QgsGeometry convertToLine( bool destMultipart ) const;
    QgsGeometry convertToPolygon( bool destMultipart ) const;
 
    std::unique_ptr< QgsLineString > smoothLine( const QgsLineString &line, unsigned int iterations = 1, double offset = 0.25,
        double minimumDistance = -1, double maxAngle = 180.0 ) const;
 
    std::unique_ptr< QgsPolygon > smoothPolygon( const QgsPolygon &polygon, unsigned int iterations = 1, double offset = 0.25,
        double minimumDistance = -1, double maxAngle = 180.0 ) const;
 
 
    friend class QgsInternalGeometryEngine;
 
}; // class QgsGeometry
 
Q_DECLARE_METATYPE( QgsGeometry )
Q_DECLARE_OPERATORS_FOR_FLAGS( QgsGeometry::ValidityFlags )
 
CORE_EXPORT QDataStream &operator<<( QDataStream &out, const QgsGeometry &geometry );
CORE_EXPORT QDataStream &operator>>( QDataStream &in, QgsGeometry &geometry );
 
#endif