mirror of
https://github.com/qgis/QGIS.git
synced 2025-02-25 00:58:06 -05:00
0a0c33dcf2
The geometry cache was only used for few geometry editing operations anyway. In earlier versions of QGIS the geometry cache was also used by old snapping classes which have been replaced by QgsPointLocator that also keeps a spatial index of geometries and it is not rebuilt on every re-render. Reasons for removal: - geometry cache was repopulated on every redraw of layers in editing mode, slowing down rendering - data structure for the cache was a simple map with features accessed by their ID (no spatial index) - the cache was only getting refreshed for the current view of the main map canvas (not a generic cache) - not used for snapping anymore where caching was important to avoid roundtrips to data provider
156 lines
6.7 KiB
Plaintext
156 lines
6.7 KiB
Plaintext
class QgsVectorLayerEditUtils
|
|
{
|
|
%TypeHeaderCode
|
|
#include <qgsvectorlayereditutils.h>
|
|
%End
|
|
public:
|
|
QgsVectorLayerEditUtils( QgsVectorLayer *layer );
|
|
|
|
/** Insert a new vertex before the given vertex number,
|
|
* in the given ring, item (first number is index 0), and feature
|
|
* Not meaningful for Point geometries
|
|
*/
|
|
bool insertVertex( double x, double y, QgsFeatureId atFeatureId, int beforeVertex );
|
|
|
|
/** Insert a new vertex before the given vertex number,
|
|
* in the given ring, item (first number is index 0), and feature
|
|
* Not meaningful for Point geometries
|
|
*/
|
|
bool insertVertex( const QgsPointV2 &point, QgsFeatureId atFeatureId, int beforeVertex );
|
|
|
|
/** Moves the vertex at the given position number,
|
|
* ring and item (first number is index 0), and feature
|
|
* to the given coordinates
|
|
*/
|
|
bool moveVertex( double x, double y, QgsFeatureId atFeatureId, int atVertex );
|
|
|
|
/** Moves the vertex at the given position number,
|
|
* ring and item (first number is index 0), and feature
|
|
* to the given coordinates
|
|
* @note available in python bindings as moveVertexV2
|
|
*/
|
|
bool moveVertex( const QgsPointV2 &p, QgsFeatureId atFeatureId, int atVertex ) /PyName=moveVertexV2/;
|
|
|
|
/** Deletes a vertex from a feature.
|
|
* @param featureId ID of feature to remove vertex from
|
|
* @param vertex index of vertex to delete
|
|
* @note added in QGIS 2.14
|
|
*/
|
|
QgsVectorLayer::EditResult deleteVertex( QgsFeatureId featureId, int vertex );
|
|
|
|
/** Adds a ring to polygon/multipolygon features
|
|
* @param ring ring to add
|
|
* @param targetFeatureIds if specified, only these features will be the candidates for adding a ring. Otherwise
|
|
* all intersecting features are tested and the ring is added to the first valid feature.
|
|
* @param modifiedFeatureId if specified, feature ID for feature that ring was added to will be stored in this parameter
|
|
* @return
|
|
* 0 in case of success,
|
|
* 1 problem with feature type,
|
|
* 2 ring not closed,
|
|
* 3 ring not valid,
|
|
* 4 ring crosses existing rings,
|
|
* 5 no feature found where ring can be inserted
|
|
*/
|
|
// TODO QGIS 3.0 returns an enum instead of a magic constant
|
|
int addRing( const QList<QgsPoint> &ring, const QgsFeatureIds &targetFeatureIds = QgsFeatureIds(), QgsFeatureId *modifiedFeatureId = 0 );
|
|
|
|
/** Adds a ring to polygon/multipolygon features
|
|
* @param ring ring to add
|
|
* @param targetFeatureIds if specified, only these features will be the candidates for adding a ring. Otherwise
|
|
* all intersecting features are tested and the ring is added to the first valid feature.
|
|
* @param modifiedFeatureId if specified, feature ID for feature that ring was added to will be stored in this parameter
|
|
* @return
|
|
* 0 in case of success,
|
|
* 1 problem with feature type,
|
|
* 2 ring not closed,
|
|
* 3 ring not valid,
|
|
* 4 ring crosses existing rings,
|
|
* 5 no feature found where ring can be inserted
|
|
* @note available in python bindings as addCurvedRing
|
|
*/
|
|
// TODO QGIS 3.0 returns an enum instead of a magic constant
|
|
int addRing( QgsCurve *ring, const QgsFeatureIds &targetFeatureIds = QgsFeatureIds(), QgsFeatureId *modifiedFeatureId = 0 ) /PyName=addCurvedRing/;
|
|
|
|
/** Adds a new part polygon to a multipart feature
|
|
* @return
|
|
* 0 in case of success,
|
|
* 1 if selected feature is not multipart,
|
|
* 2 if ring is not a valid geometry,
|
|
* 3 if new polygon ring not disjoint with existing rings,
|
|
* 4 if no feature was selected,
|
|
* 5 if several features are selected,
|
|
* 6 if selected geometry not found
|
|
*/
|
|
// TODO QGIS 3.0 returns an enum instead of a magic constant
|
|
int addPart( const QList<QgsPoint> &ring, QgsFeatureId featureId );
|
|
|
|
/** Adds a new part polygon to a multipart feature
|
|
* @return
|
|
* 0 in case of success,
|
|
* 1 if selected feature is not multipart,
|
|
* 2 if ring is not a valid geometry,
|
|
* 3 if new polygon ring not disjoint with existing rings,
|
|
* 4 if no feature was selected,
|
|
* 5 if several features are selected,
|
|
* 6 if selected geometry not found
|
|
* @note available in python bindings as addPartV2
|
|
*/
|
|
// TODO QGIS 3.0 returns an enum instead of a magic constant
|
|
int addPart( const QList<QgsPointV2> &ring, QgsFeatureId featureId ) /PyName=addPartV2/;
|
|
|
|
// @note available in python bindings as addCurvedPart
|
|
// TODO QGIS 3.0 returns an enum instead of a magic constant
|
|
int addPart( QgsCurve *ring, QgsFeatureId featureId ) /PyName=addCurvedPart/;
|
|
|
|
/** Translates feature by dx, dy
|
|
* @param featureId id of the feature to translate
|
|
* @param dx translation of x-coordinate
|
|
* @param dy translation of y-coordinate
|
|
* @return 0 in case of success
|
|
*/
|
|
int translateFeature( QgsFeatureId featureId, double dx, double dy );
|
|
|
|
/** Splits parts cut by the given line
|
|
* @param splitLine line that splits the layer feature parts
|
|
* @param topologicalEditing true if topological editing is enabled
|
|
* @return
|
|
* 0 in case of success,
|
|
* 4 if there is a selection but no feature split
|
|
*/
|
|
// TODO QGIS 3.0 returns an enum instead of a magic constant
|
|
int splitParts( const QList<QgsPoint> &splitLine, bool topologicalEditing = false );
|
|
|
|
/** Splits features cut by the given line
|
|
* @param splitLine line that splits the layer features
|
|
* @param topologicalEditing true if topological editing is enabled
|
|
* @return
|
|
* 0 in case of success,
|
|
* 4 if there is a selection but no feature split
|
|
*/
|
|
// TODO QGIS 3.0 returns an enum instead of a magic constant
|
|
int splitFeatures( const QList<QgsPoint> &splitLine, bool topologicalEditing = false );
|
|
|
|
/** Adds topological points for every vertex of the geometry.
|
|
* @param geom the geometry where each vertex is added to segments of other features
|
|
* @note geom is not going to be modified by the function
|
|
* @return 0 in case of success
|
|
*/
|
|
int addTopologicalPoints( const QgsGeometry &geom );
|
|
|
|
/** Adds a vertex to segments which intersect point p but don't
|
|
* already have a vertex there. If a feature already has a vertex at position p,
|
|
* no additional vertex is inserted. This method is useful for topological
|
|
* editing.
|
|
* @param p position of the vertex
|
|
* @return 0 in case of success
|
|
*/
|
|
int addTopologicalPoints( const QgsPoint &p );
|
|
|
|
protected:
|
|
|
|
/** Little helper function that gives bounding box from a list of points.
|
|
@return 0 in case of success */
|
|
int boundingBoxFromPointList( const QList<QgsPoint> &list, double &xmin, double &ymin, double &xmax, double &ymax ) const;
|
|
|
|
};
|