mirror of
https://github.com/qgis/QGIS.git
synced 2025-02-25 00:58:06 -05:00
224 lines
6.7 KiB
Plaintext
224 lines
6.7 KiB
Plaintext
/************************************************************************
|
|
* This file has been generated automatically from *
|
|
* *
|
|
* src/core/qgspointlocator.h *
|
|
* *
|
|
* Do not edit manually ! Edit header and run scripts/sipify.pl again *
|
|
************************************************************************/
|
|
|
|
|
|
|
|
|
|
|
|
|
|
class QgsPointLocator : QObject
|
|
{
|
|
%Docstring
|
|
The class defines interface for querying point location:
|
|
- query nearest vertices / edges to a point
|
|
- query vertices / edges in rectangle
|
|
- query areas covering a point
|
|
|
|
Works with one layer.
|
|
|
|
.. versionadded:: 2.8
|
|
%End
|
|
|
|
%TypeHeaderCode
|
|
#include "qgspointlocator.h"
|
|
%End
|
|
public:
|
|
|
|
explicit QgsPointLocator( QgsVectorLayer *layer, const QgsCoordinateReferenceSystem &destinationCrs = QgsCoordinateReferenceSystem(),
|
|
const QgsCoordinateTransformContext &transformContext = QgsCoordinateTransformContext(),
|
|
const QgsRectangle *extent = 0 );
|
|
%Docstring
|
|
Construct point locator for a ``layer``.
|
|
|
|
If a valid QgsCoordinateReferenceSystem is passed for ``destinationCrs`` then the locator will
|
|
do the searches on data reprojected to the given CRS. For accurate reprojection it is important
|
|
to set the correct ``transformContext`` if a ``destinationCrs`` is specified. This is usually taken
|
|
from the current :py:func:`QgsProject.transformContext()`
|
|
|
|
If ``extent`` is not null, the locator will index only a subset of the layer which falls within that extent.
|
|
%End
|
|
|
|
~QgsPointLocator();
|
|
|
|
QgsVectorLayer *layer() const;
|
|
%Docstring
|
|
Get associated layer
|
|
|
|
.. versionadded:: 2.14
|
|
%End
|
|
|
|
QgsCoordinateReferenceSystem destinationCrs() const;
|
|
%Docstring
|
|
Get destination CRS - may be an invalid QgsCoordinateReferenceSystem if not doing OTF reprojection
|
|
|
|
.. versionadded:: 2.14
|
|
%End
|
|
|
|
const QgsRectangle *extent() const;
|
|
%Docstring
|
|
Get extent of the area point locator covers - if null then it caches the whole layer
|
|
|
|
.. versionadded:: 2.14
|
|
%End
|
|
|
|
void setExtent( const QgsRectangle *extent );
|
|
%Docstring
|
|
Configure extent - if not null, it will index only that area
|
|
|
|
.. versionadded:: 2.14
|
|
%End
|
|
|
|
enum Type
|
|
{
|
|
Invalid,
|
|
Vertex,
|
|
Edge,
|
|
Area,
|
|
All
|
|
};
|
|
|
|
typedef QFlags<QgsPointLocator::Type> Types;
|
|
|
|
|
|
bool init( int maxFeaturesToIndex = -1 );
|
|
%Docstring
|
|
Prepare the index for queries. Does nothing if the index already exists.
|
|
If the number of features is greater than the value of maxFeaturesToIndex, creation of index is stopped
|
|
to make sure we do not run out of memory. If maxFeaturesToIndex is -1, no limits are used. Returns
|
|
false if the creation of index has been prematurely stopped due to the limit of features, otherwise true *
|
|
%End
|
|
|
|
bool hasIndex() const;
|
|
%Docstring
|
|
Indicate whether the data have been already indexed
|
|
%End
|
|
|
|
struct Match
|
|
{
|
|
Match();
|
|
%Docstring
|
|
construct invalid match
|
|
%End
|
|
|
|
Match( QgsPointLocator::Type t, QgsVectorLayer *vl, QgsFeatureId fid, double dist, const QgsPointXY &pt, int vertexIndex = 0, QgsPointXY *edgePoints = 0 );
|
|
|
|
QgsPointLocator::Type type() const;
|
|
|
|
bool isValid() const;
|
|
bool hasVertex() const;
|
|
bool hasEdge() const;
|
|
bool hasArea() const;
|
|
|
|
double distance() const;
|
|
%Docstring
|
|
for vertex / edge match
|
|
units depending on what class returns it (geom.cache: layer units, map canvas snapper: dest crs units)
|
|
%End
|
|
|
|
QgsPointXY point() const;
|
|
%Docstring
|
|
for vertex / edge match
|
|
coords depending on what class returns it (geom.cache: layer coords, map canvas snapper: dest coords)
|
|
%End
|
|
|
|
int vertexIndex() const;
|
|
%Docstring
|
|
for vertex / edge match (first vertex of the edge)
|
|
%End
|
|
|
|
QgsVectorLayer *layer() const;
|
|
%Docstring
|
|
The vector layer where the snap occurred.
|
|
Will be null if the snap happened on an intersection.
|
|
%End
|
|
|
|
QgsFeatureId featureId() const;
|
|
%Docstring
|
|
The id of the feature to which the snapped geometry belongs.
|
|
%End
|
|
|
|
void edgePoints( QgsPointXY &pt1 /Out/, QgsPointXY &pt2 /Out/ ) const;
|
|
%Docstring
|
|
Only for a valid edge match - obtain endpoints of the edge
|
|
%End
|
|
|
|
bool operator==( const QgsPointLocator::Match &other ) const;
|
|
|
|
protected:
|
|
};
|
|
|
|
typedef QList<QgsPointLocator::Match> MatchList;
|
|
|
|
struct MatchFilter
|
|
{
|
|
virtual ~MatchFilter();
|
|
virtual bool acceptMatch( const QgsPointLocator::Match &match ) = 0;
|
|
};
|
|
|
|
|
|
Match nearestVertex( const QgsPointXY &point, double tolerance, QgsPointLocator::MatchFilter *filter = 0 );
|
|
%Docstring
|
|
Find nearest vertex to the specified point - up to distance specified by tolerance
|
|
Optional filter may discard unwanted matches.
|
|
%End
|
|
|
|
Match nearestEdge( const QgsPointXY &point, double tolerance, QgsPointLocator::MatchFilter *filter = 0 );
|
|
%Docstring
|
|
Find nearest edge to the specified point - up to distance specified by tolerance
|
|
Optional filter may discard unwanted matches.
|
|
%End
|
|
|
|
Match nearestArea( const QgsPointXY &point, double tolerance, QgsPointLocator::MatchFilter *filter = 0 );
|
|
%Docstring
|
|
Find nearest area to the specified point - up to distance specified by tolerance
|
|
Optional filter may discard unwanted matches.
|
|
This will first perform a pointInPolygon and return first result.
|
|
If no match is found and tolerance is not 0, it will return nearestEdge.
|
|
|
|
.. versionadded:: 3.0
|
|
%End
|
|
|
|
MatchList edgesInRect( const QgsRectangle &rect, QgsPointLocator::MatchFilter *filter = 0 );
|
|
%Docstring
|
|
Find edges within a specified recangle
|
|
Optional filter may discard unwanted matches.
|
|
%End
|
|
MatchList edgesInRect( const QgsPointXY &point, double tolerance, QgsPointLocator::MatchFilter *filter = 0 );
|
|
%Docstring
|
|
Override of edgesInRect that construct rectangle from a center point and tolerance
|
|
%End
|
|
|
|
|
|
MatchList pointInPolygon( const QgsPointXY &point );
|
|
%Docstring
|
|
find out if the point is in any polygons
|
|
%End
|
|
|
|
|
|
int cachedGeometryCount() const;
|
|
%Docstring
|
|
Return how many geometries are cached in the index
|
|
|
|
.. versionadded:: 2.14
|
|
%End
|
|
|
|
protected:
|
|
bool rebuildIndex( int maxFeaturesToIndex = -1 );
|
|
protected slots:
|
|
void destroyIndex();
|
|
};
|
|
|
|
|
|
/************************************************************************
|
|
* This file has been generated automatically from *
|
|
* *
|
|
* src/core/qgspointlocator.h *
|
|
* *
|
|
* Do not edit manually ! Edit header and run scripts/sipify.pl again *
|
|
************************************************************************/
|