mirror of
https://github.com/qgis/QGIS.git
synced 2025-03-25 00:05:03 -04:00
af0d68b882
Faster than QgsGeometry::isGeosEmpty() because it avoids the conversion to GEOS geometries and just uses the QgsAbstractGeometry subclasses directly. Also implements faster isEmpty() overrides for specific QgsAbstractGeometry subclasses.
405 lines
14 KiB
Plaintext
405 lines
14 KiB
Plaintext
struct QgsVertexId
|
|
{
|
|
%TypeHeaderCode
|
|
#include <qgsabstractgeometry.h>
|
|
%End
|
|
|
|
enum VertexType
|
|
{
|
|
SegmentVertex, //start / endpoint of a segment
|
|
CurveVertex
|
|
};
|
|
|
|
QgsVertexId();
|
|
QgsVertexId( int _part, int _ring, int _vertex, VertexType _type);
|
|
|
|
bool isValid() const;
|
|
bool operator==( QgsVertexId other ) const;
|
|
bool operator!=( QgsVertexId other ) const;
|
|
bool partEqual( QgsVertexId o ) const;
|
|
bool ringEqual( QgsVertexId o ) const;
|
|
bool vertexEqual( QgsVertexId o ) const;
|
|
bool isValid(const QgsAbstractGeometry* geom) const;
|
|
|
|
int part;
|
|
int ring;
|
|
int vertex;
|
|
VertexType type;
|
|
};
|
|
|
|
/** \ingroup core
|
|
* \class QgsAbstractGeometry
|
|
* \brief Abstract base class for all geometries
|
|
* \note added in QGIS 2.10
|
|
*/
|
|
class QgsAbstractGeometry
|
|
{
|
|
%TypeHeaderCode
|
|
#include <qgsabstractgeometry.h>
|
|
#include <qgslinestring.h>
|
|
%End
|
|
|
|
%ConvertToSubClassCode
|
|
if (dynamic_cast<QgsPointV2*>(sipCpp) != NULL)
|
|
sipType = sipType_QgsPointV2;
|
|
else if (dynamic_cast<QgsLineString*>(sipCpp) != NULL )
|
|
sipType = sipType_QgsLineString;
|
|
else if (dynamic_cast<QgsCircularString*>(sipCpp) != NULL )
|
|
sipType = sipType_QgsCircularString;
|
|
else if (dynamic_cast<QgsCompoundCurve*>(sipCpp) != NULL )
|
|
sipType = sipType_QgsCompoundCurve;
|
|
else if (dynamic_cast<QgsPolygonV2*>(sipCpp) != NULL )
|
|
sipType = sipType_QgsPolygonV2;
|
|
else if (dynamic_cast<QgsCurvePolygon*>(sipCpp) != NULL )
|
|
sipType = sipType_QgsCurvePolygon;
|
|
else if (dynamic_cast<QgsMultiPointV2*>(sipCpp) != NULL )
|
|
sipType = sipType_QgsMultiPointV2;
|
|
else if (dynamic_cast<QgsMultiLineString*>(sipCpp) != NULL )
|
|
sipType = sipType_QgsMultiLineString;
|
|
else if (dynamic_cast<QgsMultiPolygonV2*>(sipCpp) != NULL )
|
|
sipType = sipType_QgsMultiPolygonV2;
|
|
else if (dynamic_cast<QgsMultiSurface*>(sipCpp) != NULL )
|
|
sipType = sipType_QgsMultiSurface;
|
|
else if (dynamic_cast<QgsMultiCurve*>(sipCpp) != NULL )
|
|
sipType = sipType_QgsMultiCurve;
|
|
else if (dynamic_cast<QgsGeometryCollection*>(sipCpp) != NULL )
|
|
sipType = sipType_QgsGeometryCollection;
|
|
else
|
|
sipType = 0;
|
|
%End
|
|
|
|
public:
|
|
|
|
/** Segmentation tolerance as maximum angle or maximum difference between approximation and circle*/
|
|
enum SegmentationToleranceType
|
|
{
|
|
MaximumAngle = 0,
|
|
MaximumDifference
|
|
};
|
|
|
|
|
|
QgsAbstractGeometry();
|
|
virtual ~QgsAbstractGeometry();
|
|
QgsAbstractGeometry( const QgsAbstractGeometry& geom );
|
|
//virtual QgsAbstractGeometry& operator=( const QgsAbstractGeometry& geom );
|
|
|
|
/** Clones the geometry by performing a deep copy
|
|
*/
|
|
virtual QgsAbstractGeometry* clone() const = 0 /Factory/;
|
|
|
|
/** Clears the geometry, ie reset it to a null geometry
|
|
*/
|
|
virtual void clear() = 0;
|
|
|
|
/** Returns the minimal bounding box for the geometry
|
|
*/
|
|
virtual QgsRectangle boundingBox() const = 0;
|
|
|
|
//mm-sql interface
|
|
/** Returns the inherent dimension of the geometry. For example, this is 0 for a point geometry,
|
|
* 1 for a linestring and 2 for a polygon.
|
|
*/
|
|
virtual int dimension() const = 0;
|
|
//virtual int coordDim() const { return mCoordDimension; }
|
|
|
|
/** Returns a unique string representing the geometry type.
|
|
* @see wkbType
|
|
* @see wktTypeStr
|
|
*/
|
|
virtual QString geometryType() const = 0;
|
|
|
|
/** Returns the WKB type of the geometry.
|
|
* @see geometryType
|
|
* @see wktTypeStr
|
|
*/
|
|
QgsWkbTypes::Type wkbType() const;
|
|
|
|
/** Returns the WKT type string of the geometry.
|
|
* @see geometryType
|
|
* @see wkbType
|
|
*/
|
|
QString wktTypeStr() const;
|
|
|
|
/** Returns true if the geometry is 3D and contains a z-value.
|
|
* @see isMeasure
|
|
*/
|
|
bool is3D() const;
|
|
|
|
/** Returns true if the geometry contains m values.
|
|
* @see is3D
|
|
*/
|
|
bool isMeasure() const;
|
|
|
|
/** Returns the closure of the combinatorial boundary of the geometry (ie the topological boundary of the geometry).
|
|
* For instance, a polygon geometry will have a boundary consisting of the linestrings for each ring in the polygon.
|
|
* @returns boundary for geometry. May be null for some geometry types.
|
|
* @note added in QGIS 3.0
|
|
*/
|
|
virtual QgsAbstractGeometry* boundary() const = 0;
|
|
|
|
//import
|
|
|
|
/** Sets the geometry from a WKB string.
|
|
* After successful read the wkb argument will be at the position where the reading has stopped.
|
|
* @see fromWkt
|
|
*/
|
|
virtual bool fromWkb( QgsConstWkbPtr& wkb ) = 0;
|
|
|
|
/** Sets the geometry from a WKT string.
|
|
* @see fromWkb
|
|
*/
|
|
virtual bool fromWkt( const QString& wkt ) = 0;
|
|
|
|
//export
|
|
|
|
/** Returns a WKB representation of the geometry.
|
|
* @see asWkt
|
|
* @see asGML2
|
|
* @see asGML3
|
|
* @see asJSON
|
|
* @note added in 3.0
|
|
*/
|
|
virtual QByteArray asWkb() const = 0;
|
|
|
|
/** Returns a WKT representation of the geometry.
|
|
* @param precision number of decimal places for coordinates
|
|
* @see asWkb
|
|
* @see asGML2
|
|
* @see asGML3
|
|
* @see asJSON
|
|
*/
|
|
virtual QString asWkt( int precision = 17 ) const = 0;
|
|
|
|
/** Returns a GML2 representation of the geometry.
|
|
* @param doc DOM document
|
|
* @param precision number of decimal places for coordinates
|
|
* @param ns XML namespace
|
|
* @see asWkb
|
|
* @see asWkt
|
|
* @see asGML3
|
|
* @see asJSON
|
|
*/
|
|
virtual QDomElement asGML2( QDomDocument& doc, int precision = 17, const QString& ns = "gml" ) const = 0;
|
|
|
|
/** Returns a GML3 representation of the geometry.
|
|
* @param doc DOM document
|
|
* @param precision number of decimal places for coordinates
|
|
* @param ns XML namespace
|
|
* @see asWkb
|
|
* @see asWkt
|
|
* @see asGML2
|
|
* @see asJSON
|
|
*/
|
|
virtual QDomElement asGML3( QDomDocument& doc, int precision = 17, const QString& ns = "gml" ) const = 0;
|
|
|
|
/** Returns a GeoJSON representation of the geometry.
|
|
* @param precision number of decimal places for coordinates
|
|
* @see asWkb
|
|
* @see asWkt
|
|
* @see asGML2
|
|
* @see asGML3
|
|
*/
|
|
virtual QString asJSON( int precision = 17 ) const = 0;
|
|
|
|
//render pipeline
|
|
|
|
/** Transforms the geometry using a coordinate transform
|
|
* @param ct coordinate transform
|
|
* @param d transformation direction
|
|
* @param transformZ set to true to also transform z coordinates. This requires that
|
|
* the z coordinates in the geometry represent height relative to the vertical datum
|
|
* of the source CRS (generally ellipsoidal heights) and are expressed in its vertical
|
|
* units (generally meters). If false, then z coordinates will not be changed by the
|
|
* transform.
|
|
*/
|
|
virtual void transform( const QgsCoordinateTransform& ct, QgsCoordinateTransform::TransformDirection d = QgsCoordinateTransform::ForwardTransform,
|
|
bool transformZ = false ) = 0;
|
|
|
|
/** Transforms the geometry using a QTransform object
|
|
* @param t QTransform transformation
|
|
*/
|
|
virtual void transform( const QTransform& t ) = 0;
|
|
|
|
|
|
//virtual void clip( const QgsRectangle& rect );
|
|
|
|
/** Draws the geometry using the specified QPainter.
|
|
* @param p destination QPainter
|
|
*/
|
|
virtual void draw( QPainter& p ) const = 0;
|
|
|
|
/** Returns next vertex id and coordinates
|
|
* @param id initial value should be the starting vertex id. The next vertex id will be stored
|
|
* in this variable if found.
|
|
* @param vertex container for found node
|
|
* @return false if at end
|
|
*/
|
|
virtual bool nextVertex( QgsVertexId& id, QgsPointV2& vertex ) const = 0;
|
|
|
|
/** Retrieves the sequence of geometries, rings and nodes.
|
|
* @return coordinate sequence
|
|
*/
|
|
virtual QList< QList< QList< QgsPointV2 > > > coordinateSequence() const = 0;
|
|
|
|
/** Returns the number of nodes contained in the geometry
|
|
*/
|
|
virtual int nCoordinates() const;
|
|
|
|
/** Returns the point corresponding to a specified vertex id
|
|
*/
|
|
virtual QgsPointV2 vertexAt( QgsVertexId id ) const = 0;
|
|
|
|
/** Searches for the closest segment of the geometry to a given point.
|
|
* @param pt specifies the point to find closest segment to
|
|
* @param segmentPt storage for the closest point within the geometry
|
|
* @param vertexAfter storage for the ID of the vertex at the end of the closest segment
|
|
* @param leftOf returns whether the point lies on the left side of the nearest segment (true if point is to left of segment,
|
|
* false if point is to right of segment)
|
|
* @param epsilon epsilon for segment snapping
|
|
* @returns squared distance to closest segment or negative value on error
|
|
*/
|
|
virtual double closestSegment( const QgsPointV2& pt, QgsPointV2& segmentPt, QgsVertexId& vertexAfter, bool* leftOf, double epsilon ) const = 0;
|
|
|
|
//low-level editing
|
|
|
|
/** Inserts a vertex into the geometry
|
|
* @param position vertex id for position of inserted vertex
|
|
* @param vertex vertex to insert
|
|
* @returns true if insert was successful
|
|
* @see moveVertex
|
|
* @see deleteVertex
|
|
*/
|
|
virtual bool insertVertex( QgsVertexId position, const QgsPointV2& vertex ) = 0;
|
|
|
|
/** Moves a vertex within the geometry
|
|
* @param position vertex id for vertex to move
|
|
* @param newPos new position of vertex
|
|
* @returns true if move was successful
|
|
* @see insertVertex
|
|
* @see deleteVertex
|
|
*/
|
|
virtual bool moveVertex( QgsVertexId position, const QgsPointV2& newPos ) = 0;
|
|
|
|
/** Deletes a vertex within the geometry
|
|
* @param position vertex id for vertex to delete
|
|
* @returns true if delete was successful
|
|
* @see insertVertex
|
|
* @see moveVertex
|
|
*/
|
|
virtual bool deleteVertex( QgsVertexId position ) = 0;
|
|
|
|
/** Returns the length of the geometry.
|
|
* @see area()
|
|
* @see perimeter()
|
|
*/
|
|
virtual double length() const;
|
|
|
|
/** Returns the perimeter of the geometry.
|
|
* @see area()
|
|
* @see length()
|
|
*/
|
|
virtual double perimeter() const;
|
|
|
|
/** Returns the area of the geometry.
|
|
* @see length()
|
|
* @see perimeter()
|
|
*/
|
|
virtual double area() const;
|
|
|
|
/** Returns the centroid of the geometry */
|
|
virtual QgsPointV2 centroid() const;
|
|
|
|
/** Returns true if the geometry is empty
|
|
*/
|
|
virtual bool isEmpty() const;
|
|
|
|
/** Returns true if the geometry contains curved segments
|
|
*/
|
|
virtual bool hasCurvedSegments() const;
|
|
|
|
/** Returns a version of the geometry without curves. Caller takes ownership of
|
|
* the returned geometry.
|
|
* @param tolerance segmentation tolerance
|
|
* @param toleranceType maximum segmentation angle or maximum difference between approximation and curve
|
|
*/
|
|
virtual QgsAbstractGeometry* segmentize( double tolerance = M_PI_2 / 90, SegmentationToleranceType toleranceType = MaximumAngle ) const /Factory/;
|
|
|
|
/** Returns the geometry converted to the more generic curve type.
|
|
E.g. QgsLineString -> QgsCompoundCurve, QgsPolygonV2 -> QgsCurvePolygon,
|
|
QgsMultiLineString -> QgsMultiCurve, QgsMultiPolygonV2 -> QgsMultiSurface
|
|
@return the converted geometry. Caller takes ownership*/
|
|
virtual QgsAbstractGeometry* toCurveType() const /Factory/;
|
|
|
|
/** Returns approximate angle at a vertex. This is usually the average angle between adjacent
|
|
* segments, and can be pictured as the orientation of a line following the curvature of the
|
|
* geometry at the specified vertex.
|
|
* @param vertex the vertex id
|
|
* @return rotation in radians, clockwise from north
|
|
*/
|
|
virtual double vertexAngle( QgsVertexId vertex ) const = 0;
|
|
|
|
virtual int vertexCount( int part = 0, int ring = 0 ) const = 0;
|
|
virtual int ringCount( int part = 0 ) const = 0;
|
|
|
|
/** Returns count of parts contained in the geometry.
|
|
* @see vertexCount
|
|
* @see ringCount
|
|
*/
|
|
virtual int partCount() const = 0;
|
|
|
|
/** Adds a z-dimension to the geometry, initialized to a preset value.
|
|
* @param zValue initial z-value for all nodes
|
|
* @returns true on success
|
|
* @note added in QGIS 2.12
|
|
* @see dropZValue()
|
|
* @see addMValue()
|
|
*/
|
|
virtual bool addZValue( double zValue = 0 ) = 0;
|
|
|
|
/** Adds a measure to the geometry, initialized to a preset value.
|
|
* @param mValue initial m-value for all nodes
|
|
* @returns true on success
|
|
* @note added in QGIS 2.12
|
|
* @see dropMValue()
|
|
* @see addZValue()
|
|
*/
|
|
virtual bool addMValue( double mValue = 0 ) = 0;
|
|
|
|
/** Drops any z-dimensions which exist in the geometry.
|
|
* @returns true if Z values were present and have been removed
|
|
* @see addZValue()
|
|
* @see dropMValue()
|
|
* @note added in QGIS 2.14
|
|
*/
|
|
virtual bool dropZValue() = 0;
|
|
|
|
/** Drops any measure values which exist in the geometry.
|
|
* @returns true if m-values were present and have been removed
|
|
* @see addMValue()
|
|
* @see dropZValue()
|
|
* @note added in QGIS 2.14
|
|
*/
|
|
virtual bool dropMValue() = 0;
|
|
|
|
/** Converts the geometry to a specified type.
|
|
* @returns true if conversion was successful
|
|
* @note added in QGIS 2.14
|
|
*/
|
|
virtual bool convertTo( QgsWkbTypes::Type type );
|
|
|
|
protected:
|
|
|
|
/** Updates the geometry type based on whether sub geometries contain z or m values.
|
|
*/
|
|
void setZMTypeFromSubGeometry( const QgsAbstractGeometry* subggeom, QgsWkbTypes::Type baseGeomType );
|
|
|
|
/** Default calculator for the minimal bounding box for the geometry. Derived classes should override this method
|
|
* if a more efficient bounding box calculation is available.
|
|
*/
|
|
virtual QgsRectangle calculateBoundingBox() const;
|
|
|
|
/** Clears any cached parameters associated with the geometry, e.g., bounding boxes
|
|
*/
|
|
virtual void clearCache() const;
|
|
};
|