mirror of
https://github.com/qgis/QGIS.git
synced 2025-10-15 00:02:52 -04:00
e99d4d2306
`surfaceToPolygon` is only useful for `QgsCurvePolygon` which inherits from `QgsSurface`. The next commit will introduce `QgsPolyhedralSurface` which also inherits from `QgsSurface`. For `QgsPolyhedralSurface`, it does not make sense to have `surfaceToPolygon`. By moving `surfaceToPolygon` definition in `QgsCurvePolygon` this allows to keep the functionality.
359 lines
11 KiB
Plaintext
359 lines
11 KiB
Plaintext
/************************************************************************
|
|
* This file has been generated automatically from *
|
|
* *
|
|
* src/core/geometry/qgscurvepolygon.h *
|
|
* *
|
|
* Do not edit manually ! Edit header and run scripts/sipify.py again *
|
|
************************************************************************/
|
|
|
|
|
|
|
|
|
|
|
|
class QgsCurvePolygon: QgsSurface
|
|
{
|
|
%Docstring(signature="appended")
|
|
Curve polygon geometry type
|
|
%End
|
|
|
|
%TypeHeaderCode
|
|
#include "qgscurvepolygon.h"
|
|
%End
|
|
public:
|
|
QgsCurvePolygon();
|
|
QgsCurvePolygon( const QgsCurvePolygon &p );
|
|
|
|
public:
|
|
virtual bool fuzzyEqual( const QgsAbstractGeometry &other, double epsilon = 1e-8 ) const /HoldGIL/;
|
|
virtual bool fuzzyDistanceEqual( const QgsAbstractGeometry &other, double epsilon = 1e-8 ) const /HoldGIL/;
|
|
virtual bool operator==( const QgsAbstractGeometry &other ) const;
|
|
|
|
virtual bool operator!=( const QgsAbstractGeometry &other ) const;
|
|
|
|
~QgsCurvePolygon();
|
|
|
|
virtual QString geometryType() const /HoldGIL/;
|
|
|
|
virtual int dimension() const /HoldGIL/;
|
|
|
|
virtual QgsCurvePolygon *clone() const /Factory/;
|
|
|
|
virtual void clear();
|
|
|
|
|
|
virtual bool fromWkb( QgsConstWkbPtr &wkb );
|
|
|
|
virtual bool fromWkt( const QString &wkt );
|
|
|
|
|
|
virtual int wkbSize( QgsAbstractGeometry::WkbFlags flags = QgsAbstractGeometry::WkbFlags() ) const;
|
|
|
|
virtual QByteArray asWkb( QgsAbstractGeometry::WkbFlags flags = QgsAbstractGeometry::WkbFlags() ) const;
|
|
|
|
virtual QString asWkt( int precision = 17 ) const;
|
|
|
|
virtual QDomElement asGml2( QDomDocument &doc, int precision = 17, const QString &ns = "gml", QgsAbstractGeometry::AxisOrder axisOrder = QgsAbstractGeometry::AxisOrder::XY ) const;
|
|
|
|
virtual QDomElement asGml3( QDomDocument &doc, int precision = 17, const QString &ns = "gml", QgsAbstractGeometry::AxisOrder axisOrder = QgsAbstractGeometry::AxisOrder::XY ) const;
|
|
|
|
virtual QString asKml( int precision = 17 ) const;
|
|
|
|
void normalize() final /HoldGIL/;
|
|
|
|
virtual QgsPolygon *surfaceToPolygon() const /Factory/;
|
|
%Docstring
|
|
Gets a polygon representation of this surface.
|
|
Ownership is transferred to the caller.
|
|
%End
|
|
|
|
virtual double area() const /HoldGIL/;
|
|
|
|
virtual double perimeter() const /HoldGIL/;
|
|
|
|
virtual QgsAbstractGeometry *boundary() const /Factory/;
|
|
|
|
virtual QgsCurvePolygon *snappedToGrid( double hSpacing, double vSpacing, double dSpacing = 0, double mSpacing = 0, bool removeRedundantPoints = false ) const /Factory/;
|
|
|
|
virtual QgsCurvePolygon *simplifyByDistance( double tolerance ) const /Factory/;
|
|
|
|
virtual bool removeDuplicateNodes( double epsilon = 4 * DBL_EPSILON, bool useZValues = false );
|
|
|
|
virtual bool boundingBoxIntersects( const QgsBox3D &box3d ) const /HoldGIL/;
|
|
|
|
|
|
double roundness() const;
|
|
%Docstring
|
|
Returns the roundness of the curve polygon.
|
|
The returned value is between 0 and 1.
|
|
|
|
.. versionadded:: 3.24
|
|
%End
|
|
|
|
|
|
int numInteriorRings() const /HoldGIL/;
|
|
%Docstring
|
|
Returns the number of interior rings contained with the curve polygon.
|
|
|
|
.. seealso:: :py:func:`interiorRing`
|
|
%End
|
|
|
|
const QgsCurve *exteriorRing() const /HoldGIL/;
|
|
%Docstring
|
|
Returns the curve polygon's exterior ring.
|
|
|
|
.. seealso:: :py:func:`interiorRing`
|
|
%End
|
|
|
|
|
|
|
|
SIP_PYOBJECT interiorRing( int i ) /HoldGIL,TypeHint="QgsCurve"/;
|
|
%Docstring
|
|
Retrieves an interior ring from the curve polygon. The first interior ring has index 0.
|
|
|
|
:raises IndexError: if no interior ring with the specified index exists.
|
|
|
|
.. seealso:: :py:func:`numInteriorRings`
|
|
|
|
.. seealso:: :py:func:`exteriorRing`
|
|
%End
|
|
%MethodCode
|
|
if ( a0 < 0 || a0 >= sipCpp->numInteriorRings() )
|
|
{
|
|
PyErr_SetString( PyExc_IndexError, QByteArray::number( a0 ) );
|
|
sipIsErr = 1;
|
|
}
|
|
else
|
|
{
|
|
return sipConvertFromType( const_cast< QgsCurve * >( sipCpp->interiorRing( a0 ) ), sipType_QgsCurve, NULL );
|
|
}
|
|
%End
|
|
|
|
virtual QgsPolygon *toPolygon( double tolerance = M_PI_2 / 90, SegmentationToleranceType toleranceType = MaximumAngle ) const /Factory/;
|
|
%Docstring
|
|
Returns a new polygon geometry corresponding to a segmentized approximation
|
|
of the curve.
|
|
|
|
:param tolerance: segmentation tolerance
|
|
:param toleranceType: maximum segmentation angle or maximum difference between approximation and curve
|
|
%End
|
|
|
|
virtual void setExteriorRing( QgsCurve *ring /Transfer/ );
|
|
%Docstring
|
|
Sets the exterior ring of the polygon. The CurvePolygon type will be updated to match the dimensionality
|
|
of the exterior ring. For instance, setting a 2D exterior ring on a 3D CurvePolygon will drop the z dimension
|
|
from the CurvePolygon and all interior rings.
|
|
|
|
:param ring: new exterior ring. Ownership is transferred to the CurvePolygon.
|
|
|
|
.. seealso:: :py:func:`setInteriorRings`
|
|
|
|
.. seealso:: :py:func:`exteriorRing`
|
|
%End
|
|
|
|
void setInteriorRings( const QVector<QgsCurve *> &rings /Transfer/ );
|
|
%Docstring
|
|
Sets all interior rings (takes ownership)
|
|
%End
|
|
virtual void addInteriorRing( QgsCurve *ring /Transfer/ );
|
|
%Docstring
|
|
Adds an interior ring to the geometry (takes ownership)
|
|
%End
|
|
|
|
|
|
bool removeInteriorRing( int i );
|
|
%Docstring
|
|
Removes an interior ring from the polygon. The first interior ring has index 0.
|
|
The corresponding ring is removed from the polygon and deleted.
|
|
It is not possible to remove the exterior ring using this method.
|
|
|
|
:raises IndexError: if no interior ring with the specified index exists.
|
|
|
|
.. seealso:: :py:func:`removeInteriorRings`
|
|
%End
|
|
%MethodCode
|
|
if ( a0 < 0 || a0 >= sipCpp->numInteriorRings() )
|
|
{
|
|
PyErr_SetString( PyExc_IndexError, QByteArray::number( a0 ) );
|
|
sipIsErr = 1;
|
|
}
|
|
else
|
|
{
|
|
return PyBool_FromLong( sipCpp->removeInteriorRing( a0 ) );
|
|
}
|
|
%End
|
|
|
|
void removeInteriorRings( double minimumAllowedArea = -1 );
|
|
%Docstring
|
|
Removes the interior rings from the polygon. If the minimumAllowedArea
|
|
parameter is specified then only rings smaller than this minimum
|
|
area will be removed.
|
|
|
|
.. seealso:: :py:func:`removeInteriorRing`
|
|
%End
|
|
|
|
void removeInvalidRings();
|
|
%Docstring
|
|
Removes any interior rings which are not valid from the polygon.
|
|
|
|
For example, this removes unclosed rings and rings with less than 4 vertices.
|
|
%End
|
|
|
|
void forceRHR();
|
|
%Docstring
|
|
Forces the geometry to respect the Right-Hand-Rule, in which the area that is
|
|
bounded by the polygon is to the right of the boundary. In particular, the exterior
|
|
ring is oriented in a clockwise direction and the interior rings in a counter-clockwise
|
|
direction.
|
|
|
|
.. warning::
|
|
|
|
Due to the conflicting definitions of the right-hand-rule in general use, it is recommended
|
|
to use the explicit :py:func:`~QgsCurvePolygon.forceClockwise` or :py:func:`~QgsCurvePolygon.forceCounterClockwise` methods instead.
|
|
|
|
.. seealso:: :py:func:`forceClockwise`
|
|
|
|
.. seealso:: :py:func:`forceCounterClockwise`
|
|
|
|
.. versionadded:: 3.6
|
|
%End
|
|
|
|
void forceClockwise();
|
|
%Docstring
|
|
Forces the polygon to respect the exterior ring is clockwise, interior rings are counter-clockwise convention.
|
|
|
|
This convention is used primarily by ESRI software.
|
|
|
|
.. seealso:: :py:func:`forceCounterClockwise`
|
|
|
|
.. versionadded:: 3.24
|
|
%End
|
|
|
|
void forceCounterClockwise();
|
|
%Docstring
|
|
Forces the polygon to respect the exterior ring is counter-clockwise, interior rings are clockwise convention.
|
|
|
|
This convention matches the OGC Simple Features specification.
|
|
|
|
.. seealso:: :py:func:`forceClockwise`
|
|
|
|
.. versionadded:: 3.24
|
|
%End
|
|
|
|
virtual QPainterPath asQPainterPath() const;
|
|
|
|
virtual void draw( QPainter &p ) const;
|
|
|
|
virtual void transform( const QgsCoordinateTransform &ct, Qgis::TransformDirection d = Qgis::TransformDirection::Forward, bool transformZ = false ) throw( QgsCsException );
|
|
|
|
virtual void transform( const QTransform &t, double zTranslate = 0.0, double zScale = 1.0, double mTranslate = 0.0, double mScale = 1.0 );
|
|
|
|
|
|
virtual bool insertVertex( QgsVertexId position, const QgsPoint &vertex );
|
|
|
|
virtual bool moveVertex( QgsVertexId position, const QgsPoint &newPos );
|
|
|
|
virtual bool deleteVertex( QgsVertexId position );
|
|
|
|
|
|
virtual QgsCoordinateSequence coordinateSequence() const;
|
|
|
|
virtual int nCoordinates() const;
|
|
|
|
virtual int vertexNumberFromVertexId( QgsVertexId id ) const;
|
|
|
|
virtual bool isEmpty() const /HoldGIL/;
|
|
|
|
virtual double closestSegment( const QgsPoint &pt, QgsPoint &segmentPt /Out/, QgsVertexId &vertexAfter /Out/, int *leftOf /Out/ = 0, double epsilon = 4 * DBL_EPSILON ) const;
|
|
|
|
|
|
virtual bool nextVertex( QgsVertexId &id, QgsPoint &vertex /Out/ ) const;
|
|
|
|
virtual void adjacentVertices( QgsVertexId vertex, QgsVertexId &previousVertex /Out/, QgsVertexId &nextVertex /Out/ ) const;
|
|
|
|
virtual bool hasCurvedSegments() const;
|
|
|
|
|
|
virtual QgsAbstractGeometry *segmentize( double tolerance = M_PI_2 / 90, SegmentationToleranceType toleranceType = MaximumAngle ) const /Factory/;
|
|
|
|
%Docstring
|
|
Returns a geometry without curves. Caller takes ownership
|
|
|
|
:param tolerance: segmentation tolerance
|
|
:param toleranceType: maximum segmentation angle or maximum difference between approximation and curve
|
|
%End
|
|
|
|
virtual double vertexAngle( QgsVertexId vertex ) const;
|
|
|
|
%Docstring
|
|
Returns approximate rotation angle for a vertex. Usually average angle between adjacent segments.
|
|
|
|
:param vertex: the vertex id
|
|
|
|
:return: rotation in radians, clockwise from north
|
|
%End
|
|
|
|
virtual int vertexCount( int part = 0, int ring = 0 ) const;
|
|
|
|
virtual int ringCount( int part = 0 ) const /HoldGIL/;
|
|
|
|
virtual int partCount() const /HoldGIL/;
|
|
|
|
virtual QgsPoint vertexAt( QgsVertexId id ) const;
|
|
|
|
virtual double segmentLength( QgsVertexId startVertex ) const;
|
|
|
|
|
|
virtual bool addZValue( double zValue = 0 );
|
|
|
|
virtual bool addMValue( double mValue = 0 );
|
|
|
|
virtual bool dropZValue();
|
|
|
|
virtual bool dropMValue();
|
|
|
|
virtual void swapXy();
|
|
|
|
|
|
virtual QgsCurvePolygon *toCurveType() const /Factory/;
|
|
|
|
|
|
virtual bool transform( QgsAbstractGeometryTransformer *transformer, QgsFeedback *feedback = 0 );
|
|
|
|
|
|
|
|
virtual QgsCurvePolygon *createEmptyWithSameType() const /Factory/;
|
|
|
|
|
|
SIP_PYOBJECT __repr__();
|
|
%MethodCode
|
|
QString wkt = sipCpp->asWkt();
|
|
if ( wkt.length() > 1000 )
|
|
wkt = wkt.left( 1000 ) + QStringLiteral( "..." );
|
|
QString str = QStringLiteral( "<QgsCurvePolygon: %1>" ).arg( wkt );
|
|
sipRes = PyUnicode_FromString( str.toUtf8().constData() );
|
|
%End
|
|
|
|
protected:
|
|
|
|
virtual int childCount() const;
|
|
|
|
virtual QgsAbstractGeometry *childGeometry( int index ) const;
|
|
|
|
int compareToSameClass( const QgsAbstractGeometry *other ) const final;
|
|
|
|
protected:
|
|
|
|
|
|
virtual QgsBox3D calculateBoundingBox3D() const;
|
|
|
|
};
|
|
|
|
|
|
/************************************************************************
|
|
* This file has been generated automatically from *
|
|
* *
|
|
* src/core/geometry/qgscurvepolygon.h *
|
|
* *
|
|
* Do not edit manually ! Edit header and run scripts/sipify.py again *
|
|
************************************************************************/
|