QGIS API Documentation 4.1.0-Master (60fea48833c)
Loading...
Searching...
No Matches
qgssnappingutils.cpp
Go to the documentation of this file.
1/***************************************************************************
2 qgssnappingutils.cpp
3 --------------------------------------
4 Date : November 2014
5 Copyright : (C) 2014 by Martin Dobias
6 Email : wonder dot sk at gmail dot com
7 ***************************************************************************
8 * *
9 * This program is free software; you can redistribute it and/or modify *
10 * it under the terms of the GNU General Public License as published by *
11 * the Free Software Foundation; either version 2 of the License, or *
12 * (at your option) any later version. *
13 * *
14 ***************************************************************************/
15
16#include "qgssnappingutils.h"
17
18#include "qgsgeometry.h"
19#include "qgslogger.h"
20#include "qgsproject.h"
21#include "qgsrendercontext.h"
22#include "qgsvectorlayer.h"
23
24#include <QString>
25
26#include "moc_qgssnappingutils.cpp"
27
28using namespace Qt::StringLiterals;
29
30QgsSnappingUtils::QgsSnappingUtils( QObject *parent, bool enableSnappingForInvisibleFeature )
31 : QObject( parent )
32 , mSnappingConfig( QgsProject::instance() ) // skip-keyword-check
33 , mEnableSnappingForInvisibleFeature( enableSnappingForInvisibleFeature )
34{}
35
40
41
43{
44 if ( !vl )
45 return nullptr;
46
47 if ( !mLocators.contains( vl ) )
48 {
49 QgsPointLocator *vlpl = new QgsPointLocator( vl, destinationCrs(), mMapSettings.transformContext(), nullptr );
50 connect( vlpl, &QgsPointLocator::initFinished, this, &QgsSnappingUtils::onInitFinished );
51 connect( vl, &QObject::destroyed, this, [this, vl]() { delete mLocators.take( vl ); } );
52
53 mLocators.insert( vl, vlpl );
54 }
55 return mLocators.value( vl );
56}
57
59{
60 qDeleteAll( mLocators );
61 mLocators.clear();
62
63 qDeleteAll( mTemporaryLocators );
64 mTemporaryLocators.clear();
65}
66
67
68QgsPointLocator *QgsSnappingUtils::locatorForLayerUsingStrategy( QgsVectorLayer *vl, const QgsPointXY &pointMap, double tolerance )
69{
70 if ( vl->geometryType() == Qgis::GeometryType::Null || mStrategy == IndexNeverFull )
71 return nullptr;
72
73 QgsRectangle aoi( pointMap.x() - tolerance, pointMap.y() - tolerance, pointMap.x() + tolerance, pointMap.y() + tolerance );
74
76
77 if ( loc->isIndexing() || isIndexPrepared( loc, aoi ) )
78 return loc;
79 else
80 return temporaryLocatorForLayer( vl, pointMap, tolerance );
81}
82
83QgsPointLocator *QgsSnappingUtils::temporaryLocatorForLayer( QgsVectorLayer *vl, const QgsPointXY &pointMap, double tolerance )
84{
85 if ( mTemporaryLocators.contains( vl ) )
86 delete mTemporaryLocators.take( vl );
87
88 QgsRectangle rect( pointMap.x() - tolerance, pointMap.y() - tolerance, pointMap.x() + tolerance, pointMap.y() + tolerance );
89
90 QgsPointLocator *vlpl = new QgsPointLocator( vl, destinationCrs(), mMapSettings.transformContext(), &rect );
91 connect( vlpl, &QgsPointLocator::initFinished, this, &QgsSnappingUtils::onInitFinished );
92
93 mTemporaryLocators.insert( vl, vlpl );
94 return mTemporaryLocators.value( vl );
95}
96
97bool QgsSnappingUtils::isIndexPrepared( QgsPointLocator *loc, const QgsRectangle &areaOfInterest )
98{
99 if ( mStrategy == IndexAlwaysFull && loc->hasIndex() )
100 return true;
101
102 if ( mStrategy == IndexExtent && loc->hasIndex() && ( !loc->extent() || loc->extent()->intersects( areaOfInterest ) ) )
103 return true;
104
105 QgsRectangle aoi( areaOfInterest );
106 aoi.scale( 0.999 );
107 return mStrategy == IndexHybrid && loc->hasIndex() && ( !loc->extent() || loc->extent()->contains( aoi ) ); // the index - even if it exists - is not suitable
108}
109
110static QgsPointLocator::Match _findClosestSegmentIntersection( const QgsPointXY &pt, const QgsPointLocator::MatchList &segments )
111{
112 if ( segments.isEmpty() )
113 return QgsPointLocator::Match();
114
115 QSet<QgsPointXY> endpoints;
116
117 // make a geometry
118 QVector<QgsGeometry> geoms;
119 const auto constSegments = segments;
120 for ( const QgsPointLocator::Match &m : constSegments )
121 {
122 if ( m.hasEdge() )
123 {
124 QgsPolylineXY pl( 2 );
125 m.edgePoints( pl[0], pl[1] );
126 geoms << QgsGeometry::fromPolylineXY( pl );
127 endpoints << pl[0] << pl[1];
128 }
129 }
130
132
133 // get intersection points
134 QList<QgsPointXY> newPoints;
136 {
137 const auto constAsPolyline = g.asPolyline();
138 for ( const QgsPointXY &p : constAsPolyline )
139 {
140 if ( !endpoints.contains( p ) )
141 newPoints << p;
142 }
143 }
145 {
146 const auto constAsMultiPolyline = g.asMultiPolyline();
147 for ( const QgsPolylineXY &pl : constAsMultiPolyline )
148 {
149 const auto constPl = pl;
150 for ( const QgsPointXY &p : constPl )
151 {
152 if ( !endpoints.contains( p ) )
153 newPoints << p;
154 }
155 }
156 }
157
158 if ( newPoints.isEmpty() )
159 return QgsPointLocator::Match();
160
161 // find the closest points
162 QgsPointXY minP;
163 double minSqrDist = 1e20; // "infinity"
164 const auto constNewPoints = newPoints;
165 for ( const QgsPointXY &p : constNewPoints )
166 {
167 double sqrDist = pt.sqrDist( p.x(), p.y() );
168 if ( sqrDist < minSqrDist )
169 {
170 minSqrDist = sqrDist;
171 minP = p;
172 }
173 }
174
175 return QgsPointLocator::Match( QgsPointLocator::Vertex, nullptr, 0, std::sqrt( minSqrDist ), minP );
176}
177
178static void _replaceIfBetter( QgsPointLocator::Match &bestMatch, const QgsPointLocator::Match &candidateMatch, double maxDistance )
179{
180 // is candidate match relevant?
181 if ( !candidateMatch.isValid() || candidateMatch.distance() > maxDistance )
182 return;
183
184 // is candidate match actually better?
185 if ( bestMatch.isValid() && bestMatch.type() == candidateMatch.type() && bestMatch.distance() - 10e-6 < candidateMatch.distance() )
186 return;
187
188 // ORDER
189 // LineEndpoint
190 // Vertex, Intersection
191 // Middle
192 // Centroid
193 // Edge
194 // Area
195
196 // first line endpoint -- these are like vertex matches, but even more strict
197 if ( ( bestMatch.type() & QgsPointLocator::LineEndpoint ) && !( candidateMatch.type() & QgsPointLocator::LineEndpoint ) )
198 return;
199 if ( candidateMatch.type() & QgsPointLocator::LineEndpoint )
200 {
201 bestMatch = candidateMatch;
202 return;
203 }
204
205 // Second Vertex, or intersection
206 if ( ( bestMatch.type() & QgsPointLocator::Vertex ) && !( candidateMatch.type() & QgsPointLocator::Vertex ) )
207 return;
208 if ( candidateMatch.type() & QgsPointLocator::Vertex )
209 {
210 bestMatch = candidateMatch;
211 return;
212 }
213
214 // prefer vertex, centroid, middle matches over edge matches (even if they are closer)
215 if ( ( bestMatch.type() & QgsPointLocator::Centroid || bestMatch.type() & QgsPointLocator::MiddleOfSegment )
216 && ( candidateMatch.type() & QgsPointLocator::Edge || candidateMatch.type() & QgsPointLocator::Area ) )
217 return;
218
219 // prefer middle matches over centroid matches (even if they are closer)
220 if ( ( bestMatch.type() & QgsPointLocator::MiddleOfSegment ) && ( candidateMatch.type() & QgsPointLocator::Centroid ) )
221 return;
222
223 bestMatch = candidateMatch; // the other match is better!
224}
225
226static void _updateBestMatch(
227 QgsPointLocator::Match &bestMatch, const QgsPointXY &pointMap, QgsPointLocator *loc, QgsPointLocator::Types type, double tolerance, QgsPointLocator::MatchFilter *filter, bool relaxed
228)
229{
230 if ( type & QgsPointLocator::Vertex )
231 {
232 _replaceIfBetter( bestMatch, loc->nearestVertex( pointMap, tolerance, filter, relaxed ), tolerance );
233 }
234 if ( bestMatch.type() != QgsPointLocator::Vertex && ( type & QgsPointLocator::Edge ) )
235 {
236 _replaceIfBetter( bestMatch, loc->nearestEdge( pointMap, tolerance, filter, relaxed ), tolerance );
237 }
238 if ( bestMatch.type() != QgsPointLocator::Vertex && bestMatch.type() != QgsPointLocator::Edge && ( type & QgsPointLocator::Area ) )
239 {
240 // if edges were detected, set tolerance to 0 to only do pointInPolygon (and avoid redo nearestEdge)
241 if ( type & QgsPointLocator::Edge )
242 tolerance = 0;
243 _replaceIfBetter( bestMatch, loc->nearestArea( pointMap, tolerance, filter, relaxed ), tolerance );
244 }
245 if ( type & QgsPointLocator::Centroid )
246 {
247 _replaceIfBetter( bestMatch, loc->nearestCentroid( pointMap, tolerance, filter, relaxed ), tolerance );
248 }
250 {
251 _replaceIfBetter( bestMatch, loc->nearestMiddleOfSegment( pointMap, tolerance, filter, relaxed ), tolerance );
252 }
254 {
255 _replaceIfBetter( bestMatch, loc->nearestLineEndpoints( pointMap, tolerance, filter, relaxed ), tolerance );
256 }
257}
258
259
260static QgsPointLocator::Types _snappingTypeToPointLocatorType( Qgis::SnappingTypes type )
261{
262 return QgsPointLocator::Types( static_cast<int>( type ) );
263}
264
266{
267 return snapToMap( mMapSettings.mapToPixel().toMapCoordinates( point ), filter, relaxed );
268}
269
270inline QgsRectangle _areaOfInterest( const QgsPointXY &point, double tolerance )
271{
272 return QgsRectangle( point.x() - tolerance, point.y() - tolerance, point.x() + tolerance, point.y() + tolerance );
273}
274
276{
277 if ( !mMapSettings.hasValidSettings() || !mSnappingConfig.enabled() )
278 {
279 return QgsPointLocator::Match();
280 }
281
282 if ( mSnappingConfig.mode() == Qgis::SnappingMode::ActiveLayer )
283 {
284 if ( !mCurrentLayer || mSnappingConfig.typeFlag().testFlag( Qgis::SnappingType::NoSnap ) )
285 return QgsPointLocator::Match();
286
287 // data from project
288 double tolerance = QgsTolerance::toleranceInProjectUnits( mSnappingConfig.tolerance(), mCurrentLayer, mMapSettings, mSnappingConfig.units() );
289 QgsPointLocator::Types type = _snappingTypeToPointLocatorType( mSnappingConfig.typeFlag() );
290
291 prepareIndex( QList<LayerAndAreaOfInterest>() << qMakePair( mCurrentLayer, _areaOfInterest( pointMap, tolerance ) ), relaxed );
292
293 // use ad-hoc locator
294 QgsPointLocator *loc = locatorForLayerUsingStrategy( mCurrentLayer, pointMap, tolerance );
295 if ( !loc )
296 return QgsPointLocator::Match();
297
298 QgsPointLocator::Match bestMatch;
299 QgsPointLocator::MatchList edges; // for snap on intersection
300 _updateBestMatch( bestMatch, pointMap, loc, type, tolerance, filter, relaxed );
301 if ( mSnappingConfig.intersectionSnapping() )
302 edges = loc->edgesInRect( pointMap, tolerance, filter, relaxed );
303
304 for ( QgsVectorLayer *vl : mExtraSnapLayers )
305 {
306 QgsPointLocator *loc = locatorForLayerUsingStrategy( vl, pointMap, tolerance );
307 _updateBestMatch( bestMatch, pointMap, loc, type, tolerance, filter, false );
308 if ( mSnappingConfig.intersectionSnapping() )
309 edges << loc->edgesInRect( pointMap, tolerance, filter, false );
310 }
311
312 if ( mSnappingConfig.intersectionSnapping() )
313 {
314 _replaceIfBetter( bestMatch, _findClosestSegmentIntersection( pointMap, edges ), tolerance );
315 }
316
317 return bestMatch;
318 }
319 else if ( mSnappingConfig.mode() == Qgis::SnappingMode::AdvancedConfiguration )
320 {
321 QList<LayerAndAreaOfInterest> layers;
322 QList<LayerConfig> filteredConfigs;
323
324 //maximum scale is the one with smallest denominator
325 //minimum scale is the one with highest denominator
326 //So : maxscale < range on which snapping is enabled < minscale
327 bool inRangeGlobal = ( mSnappingConfig.minimumScale() <= 0.0 || mMapSettings.scale() <= mSnappingConfig.minimumScale() )
328 && ( mSnappingConfig.maximumScale() <= 0.0 || mMapSettings.scale() >= mSnappingConfig.maximumScale() );
329
330 for ( const LayerConfig &layerConfig : std::as_const( mLayers ) )
331 {
332 QgsSnappingConfig::IndividualLayerSettings layerSettings = mSnappingConfig.individualLayerSettings( layerConfig.layer );
333
334 bool inRangeLayer = ( layerSettings.minimumScale() <= 0.0 || mMapSettings.scale() <= layerSettings.minimumScale() )
335 && ( layerSettings.maximumScale() <= 0.0 || mMapSettings.scale() >= layerSettings.maximumScale() );
336
337 //If limit to scale is disabled, snapping activated on all layer
338 //If no per layer config is set use the global one, otherwise use the layer config
339 if ( mSnappingConfig.scaleDependencyMode() == QgsSnappingConfig::Disabled
340 || ( mSnappingConfig.scaleDependencyMode() == QgsSnappingConfig::Global && inRangeGlobal )
341 || ( mSnappingConfig.scaleDependencyMode() == QgsSnappingConfig::PerLayer && inRangeLayer ) )
342 {
343 double tolerance = QgsTolerance::toleranceInProjectUnits( layerConfig.tolerance, layerConfig.layer, mMapSettings, layerConfig.unit );
344 layers << qMakePair( layerConfig.layer, _areaOfInterest( pointMap, tolerance ) );
345 filteredConfigs << layerConfig;
346 }
347 }
348 prepareIndex( layers, relaxed );
349
350 QgsPointLocator::Match bestMatch;
351 QgsPointLocator::MatchList edges; // for snap on intersection
352 double maxTolerance = 0;
354
355 for ( const LayerConfig &layerConfig : std::as_const( filteredConfigs ) )
356 {
357 double tolerance = QgsTolerance::toleranceInProjectUnits( layerConfig.tolerance, layerConfig.layer, mMapSettings, layerConfig.unit );
358 if ( QgsPointLocator *loc = locatorForLayerUsingStrategy( layerConfig.layer, pointMap, tolerance ) )
359 {
360 _updateBestMatch( bestMatch, pointMap, loc, layerConfig.type, tolerance, filter, relaxed );
361 if ( mSnappingConfig.intersectionSnapping() )
362 edges << loc->edgesInRect( pointMap, tolerance, filter, relaxed );
363
364 // We keep the maximum tolerance for intersection snapping and extra snapping
365 maxTolerance = std::max( maxTolerance, tolerance );
366 // To avoid yet an additional setting, on extra snappings, we use the combination of all enabled snap types
367 maxTypes = static_cast<QgsPointLocator::Type>( maxTypes | layerConfig.type );
368 }
369 }
370
371 for ( QgsVectorLayer *vl : mExtraSnapLayers )
372 {
373 QgsPointLocator *loc = locatorForLayerUsingStrategy( vl, pointMap, maxTolerance );
374 _updateBestMatch( bestMatch, pointMap, loc, maxTypes, maxTolerance, filter, false );
375 if ( mSnappingConfig.intersectionSnapping() )
376 edges << loc->edgesInRect( pointMap, maxTolerance, filter, false );
377 }
378
379 if ( mSnappingConfig.intersectionSnapping() )
380 _replaceIfBetter( bestMatch, _findClosestSegmentIntersection( pointMap, edges ), maxTolerance );
381
382 return bestMatch;
383 }
384 else if ( mSnappingConfig.mode() == Qgis::SnappingMode::AllLayers )
385 {
386 // data from project
387 double tolerance = QgsTolerance::toleranceInProjectUnits( mSnappingConfig.tolerance(), nullptr, mMapSettings, mSnappingConfig.units() );
388 QgsPointLocator::Types type = _snappingTypeToPointLocatorType( mSnappingConfig.typeFlag() );
389 QgsRectangle aoi = _areaOfInterest( pointMap, tolerance );
390
391 QList<LayerAndAreaOfInterest> layers;
392 const auto constLayers = mMapSettings.layers( true );
393 for ( QgsMapLayer *layer : constLayers )
394 if ( QgsVectorLayer *vl = qobject_cast<QgsVectorLayer *>( layer ) )
395 layers << qMakePair( vl, aoi );
396 prepareIndex( layers, relaxed );
397
398 QgsPointLocator::MatchList edges; // for snap on intersection
399 QgsPointLocator::Match bestMatch;
400
401 for ( const LayerAndAreaOfInterest &entry : std::as_const( layers ) )
402 {
403 QgsVectorLayer *vl = entry.first;
404 if ( QgsPointLocator *loc = locatorForLayerUsingStrategy( vl, pointMap, tolerance ) )
405 {
406 _updateBestMatch( bestMatch, pointMap, loc, type, tolerance, filter, relaxed );
407 if ( mSnappingConfig.intersectionSnapping() )
408 edges << loc->edgesInRect( pointMap, tolerance, filter, relaxed );
409 }
410 }
411
412 for ( QgsVectorLayer *vl : mExtraSnapLayers )
413 {
414 QgsPointLocator *loc = locatorForLayerUsingStrategy( vl, pointMap, tolerance );
415 _updateBestMatch( bestMatch, pointMap, loc, type, tolerance, filter, false );
416 if ( mSnappingConfig.intersectionSnapping() )
417 edges << loc->edgesInRect( pointMap, tolerance, filter, false );
418 }
419
420 if ( mSnappingConfig.intersectionSnapping() )
421 _replaceIfBetter( bestMatch, _findClosestSegmentIntersection( pointMap, edges ), tolerance );
422
423 return bestMatch;
424 }
425
426 return QgsPointLocator::Match();
427}
428
429void QgsSnappingUtils::onInitFinished( bool ok )
430{
431 QgsPointLocator *loc = static_cast<QgsPointLocator *>( sender() );
432
433 // point locator init didn't work out - too many features!
434 // let's make the allowed area smaller for the next time
435 if ( !ok )
436 {
437 mHybridMaxAreaPerLayer[loc->layer()->id()] /= 4;
438 }
439}
440
441void QgsSnappingUtils::prepareIndex( const QList<LayerAndAreaOfInterest> &layers, bool relaxed )
442{
443 // check if we need to build any index
444 QList<LayerAndAreaOfInterest> layersToIndex;
445 const auto constLayers = layers;
446 for ( const LayerAndAreaOfInterest &entry : constLayers )
447 {
448 QgsVectorLayer *vl = entry.first;
449
450 if ( vl->geometryType() == Qgis::GeometryType::Null || mStrategy == IndexNeverFull )
451 continue;
452
453 QgsPointLocator *loc = locatorForLayer( vl );
454
455 if ( !loc->isIndexing() && !isIndexPrepared( loc, entry.second ) )
456 layersToIndex << entry;
457 }
458 if ( !layersToIndex.isEmpty() )
459 {
460 // build indexes
461 QElapsedTimer t;
462 int i = 0;
463
464 if ( !relaxed )
465 {
466 t.start();
467 prepareIndexStarting( layersToIndex.count() );
468 }
469
470 for ( const LayerAndAreaOfInterest &entry : layersToIndex )
471 {
472 QgsVectorLayer *vl = entry.first;
473 QgsPointLocator *loc = locatorForLayer( vl );
474
475 if ( loc->isIndexing() && !relaxed )
476 {
478 }
479
480
481 if ( !mEnableSnappingForInvisibleFeature )
482 {
483 QgsRenderContext ctx = QgsRenderContext::fromMapSettings( mMapSettings );
484 loc->setRenderContext( &ctx );
485 }
486
487 if ( mStrategy == IndexExtent )
488 {
489 QgsRectangle rect( mMapSettings.visibleExtent() );
490 loc->setExtent( &rect );
491 loc->init( -1, relaxed );
492 }
493 else if ( mStrategy == IndexHybrid )
494 {
495 // first time the layer is used? - let's set an initial guess about indexing
496 if ( !mHybridMaxAreaPerLayer.contains( vl->id() ) )
497 {
498 long long totalFeatureCount = vl->featureCount();
499 if ( totalFeatureCount < mHybridPerLayerFeatureLimit )
500 {
501 // index the whole layer
502 mHybridMaxAreaPerLayer[vl->id()] = -1;
503 }
504 else
505 {
506 // estimate for how big area it probably makes sense to build partial index to not exceed the limit
507 // (we may change the limit later)
508 QgsRectangle layerExtent = mMapSettings.layerExtentToOutputExtent( vl, vl->extent() );
509 double totalArea = layerExtent.width() * layerExtent.height();
510 mHybridMaxAreaPerLayer[vl->id()] = totalArea * mHybridPerLayerFeatureLimit / totalFeatureCount / 4;
511 }
512 }
513
514 double indexReasonableArea = mHybridMaxAreaPerLayer[vl->id()];
515 if ( indexReasonableArea == -1 )
516 {
517 // we can safely index the whole layer
518 loc->init( -1, relaxed );
519 }
520 else
521 {
522 // use area as big as we think may fit into our limit
523 QgsPointXY c = entry.second.center();
524 double halfSide = std::sqrt( indexReasonableArea ) / 2;
525 QgsRectangle rect( c.x() - halfSide, c.y() - halfSide, c.x() + halfSide, c.y() + halfSide );
526 loc->setExtent( &rect );
527
528 // see if it's possible build index for this area
529 loc->init( mHybridPerLayerFeatureLimit, relaxed );
530 }
531 }
532 else // full index strategy
533 loc->init( relaxed );
534
535 if ( !relaxed )
537 }
538
539 if ( !relaxed )
540 {
541 QgsDebugMsgLevel( u"Prepare index total: %1 ms"_s.arg( t.elapsed() ), 2 );
542 }
543 }
544}
545
547{
548 return mSnappingConfig;
549}
550
552{
553 mEnableSnappingForInvisibleFeature = enable;
554}
555
557{
558 if ( mSnappingConfig == config )
559 return;
560
561 if ( mSnappingConfig.individualLayerSettings() != config.individualLayerSettings() )
562 onIndividualLayerSettingsChanged( config.individualLayerSettings() );
563
564 mSnappingConfig = config;
565
566 emit configChanged( mSnappingConfig );
567}
568
570{
571 mSnappingConfig.setEnabled( !mSnappingConfig.enabled() );
572 emit configChanged( mSnappingConfig );
573}
574
576{
577 if ( !mCurrentLayer )
578 return QgsPointLocator::Match();
579
580 QgsPointXY pointMap = mMapSettings.mapToPixel().toMapCoordinates( point );
581 double tolerance = QgsTolerance::vertexSearchRadius( mMapSettings );
582
583 QgsPointLocator *loc = locatorForLayerUsingStrategy( mCurrentLayer, pointMap, tolerance );
584 if ( !loc )
585 return QgsPointLocator::Match();
586
587 QgsPointLocator::Match bestMatch;
588 _updateBestMatch( bestMatch, pointMap, loc, type, tolerance, filter, false );
589 return bestMatch;
590}
591
593{
594 QString oldDestCRS = mMapSettings.destinationCrs().authid();
595 QString newDestCRS = settings.destinationCrs().authid();
596 mMapSettings = settings;
597
598 if ( newDestCRS != oldDestCRS )
600}
601
603{
604 mCurrentLayer = layer;
605}
606
608{
609 QString msg = u"--- SNAPPING UTILS DUMP ---\n"_s;
610
611 if ( !mMapSettings.hasValidSettings() )
612 {
613 msg += "invalid map settings!"_L1;
614 return msg;
615 }
616
617 QList<LayerConfig> layers;
618
619 if ( mSnappingConfig.mode() == Qgis::SnappingMode::ActiveLayer )
620 {
621 if ( mSnappingConfig.mode() == Qgis::SnappingMode::ActiveLayer && !mCurrentLayer )
622 {
623 msg += "no current layer!"_L1;
624 return msg;
625 }
626
627 layers << LayerConfig( mCurrentLayer, _snappingTypeToPointLocatorType( mSnappingConfig.typeFlag() ), mSnappingConfig.tolerance(), mSnappingConfig.units() );
628 }
629 else if ( mSnappingConfig.mode() == Qgis::SnappingMode::AllLayers )
630 {
631 const auto constLayers = mMapSettings.layers( true );
632 for ( QgsMapLayer *layer : constLayers )
633 {
634 if ( QgsVectorLayer *vl = qobject_cast<QgsVectorLayer *>( layer ) )
635 layers << LayerConfig( vl, _snappingTypeToPointLocatorType( mSnappingConfig.typeFlag() ), mSnappingConfig.tolerance(), mSnappingConfig.units() );
636 }
637 }
638 else if ( mSnappingConfig.mode() == Qgis::SnappingMode::AdvancedConfiguration )
639 {
640 layers = mLayers;
641 }
642
643 const auto constLayers = layers;
644 for ( const LayerConfig &layer : constLayers )
645 {
646 msg += QString(
647 "layer : %1\n"
648 "config: %2 tolerance %3 %4\n"
649 )
650 .arg( layer.layer->name() )
651 .arg( static_cast<int>( layer.type ) )
652 .arg( layer.tolerance )
653 .arg( static_cast<int>( layer.unit ) );
654
655 if ( mStrategy == IndexAlwaysFull || mStrategy == IndexHybrid || mStrategy == IndexExtent )
656 {
657 if ( QgsPointLocator *loc = locatorForLayer( layer.layer ) )
658 {
659 QString extentStr, cachedGeoms, limit( u"no max area"_s );
660 if ( const QgsRectangle *r = loc->extent() )
661 {
662 extentStr = u" extent %1"_s.arg( r->toString() );
663 }
664 else
665 extentStr = u"full extent"_s;
666 if ( loc->hasIndex() )
667 cachedGeoms = u"%1 feats"_s.arg( loc->cachedGeometryCount() );
668 else
669 cachedGeoms = u"not initialized"_s;
670 if ( mStrategy == IndexHybrid )
671 {
672 if ( mHybridMaxAreaPerLayer.contains( layer.layer->id() ) )
673 {
674 double maxArea = mStrategy == IndexHybrid ? mHybridMaxAreaPerLayer[layer.layer->id()] : -1;
675 if ( maxArea != -1 )
676 limit = u"max area %1"_s.arg( maxArea );
677 }
678 else
679 limit = u"not evaluated"_s;
680 }
681 msg += u"index : YES | %1 | %2 | %3\n"_s.arg( cachedGeoms, extentStr, limit );
682 }
683 else
684 msg += "index : ???\n"_L1; // should not happen
685 }
686 else
687 msg += "index : NO\n"_L1;
688 msg += "-\n"_L1;
689 }
690
691 return msg;
692}
693
694QgsCoordinateReferenceSystem QgsSnappingUtils::destinationCrs() const
695{
696 return mMapSettings.destinationCrs();
697}
698
699void QgsSnappingUtils::onIndividualLayerSettingsChanged( const QHash<QgsVectorLayer *, QgsSnappingConfig::IndividualLayerSettings> &layerSettings )
700{
701 mLayers.clear();
702
703 QHash<QgsVectorLayer *, QgsSnappingConfig::IndividualLayerSettings>::const_iterator i;
704
705 for ( i = layerSettings.constBegin(); i != layerSettings.constEnd(); ++i )
706 {
707 if ( i->enabled() )
708 {
709 mLayers.append( LayerConfig( i.key(), _snappingTypeToPointLocatorType( static_cast<Qgis::SnappingTypes>( i->typeFlag() ) ), i->tolerance(), i->units() ) );
710 }
711 }
712}
@ NoSnap
No snapping.
Definition qgis.h:776
QFlags< SnappingType > SnappingTypes
Snapping types.
Definition qgis.h:786
@ Null
No geometry.
Definition qgis.h:384
@ ActiveLayer
On the active layer.
Definition qgis.h:764
@ AdvancedConfiguration
On a per layer configuration basis.
Definition qgis.h:766
@ AllLayers
On all vector layers.
Definition qgis.h:765
@ LineString
LineString.
Definition qgis.h:297
@ MultiLineString
MultiLineString.
Definition qgis.h:301
Represents a coordinate reference system (CRS).
A geometry is the spatial representation of a feature.
static QgsGeometry fromPolylineXY(const QgsPolylineXY &polyline)
Creates a new LineString geometry from a list of QgsPointXY points.
QgsPolylineXY asPolyline() const
Returns the contents of the geometry as a polyline.
QgsMultiPolylineXY asMultiPolyline() const
Returns the contents of the geometry as a multi-linestring.
static QgsGeometry unaryUnion(const QVector< QgsGeometry > &geometries, const QgsGeometryParameters &parameters=QgsGeometryParameters())
Compute the unary union on a list of geometries.
Qgis::WkbType wkbType() const
Returns type of the geometry as a WKB type (point / linestring / polygon etc.).
Base class for all map layer types.
Definition qgsmaplayer.h:83
QString id
Definition qgsmaplayer.h:86
QgsCoordinateTransformContext transformContext() const
Returns the layer data provider coordinate transform context or a default transform context if the la...
Contains configuration for rendering maps.
QgsCoordinateReferenceSystem destinationCrs() const
Returns the destination coordinate reference system for the map render.
Defines the interface for querying point locations.
Match nearestEdge(const QgsPointXY &point, double tolerance, QgsPointLocator::MatchFilter *filter=nullptr, bool relaxed=false)
Find nearest edge to the specified point - up to distance specified by tolerance Optional filter may ...
void setRenderContext(const QgsRenderContext *context)
Configure render context - if not nullptr, it will use to index only visible feature.
int cachedGeometryCount() const
Returns how many geometries are cached in the index.
void setExtent(const QgsRectangle *extent)
Configure extent - if not nullptr, it will index only that area.
bool init(int maxFeaturesToIndex=-1, bool relaxed=false)
Prepare the index for queries.
QFlags< Type > Types
QgsVectorLayer * layer() const
Gets associated layer.
class QList< QgsPointLocator::Match > MatchList
Match nearestVertex(const QgsPointXY &point, double tolerance, QgsPointLocator::MatchFilter *filter=nullptr, bool relaxed=false)
Find nearest vertex to the specified point - up to distance specified by tolerance Optional filter ma...
bool isIndexing() const
Returns true if the point locator is currently indexing the data.
const QgsRectangle * extent() const
Gets extent of the area point locator covers - if nullptr then it caches the whole layer.
MatchList edgesInRect(const QgsRectangle &rect, QgsPointLocator::MatchFilter *filter=nullptr, bool relaxed=false)
Find edges within a specified rectangle Optional filter may discard unwanted matches.
bool hasIndex() const
Indicate whether the data have been already indexed.
Match nearestMiddleOfSegment(const QgsPointXY &point, double tolerance, QgsPointLocator::MatchFilter *filter=nullptr, bool relaxed=false)
Find nearest middle of segment to the specified point - up to distance specified by tolerance Optiona...
void waitForIndexingFinished()
If the point locator has been initialized relaxedly and is currently indexing, this methods waits for...
Match nearestCentroid(const QgsPointXY &point, double tolerance, QgsPointLocator::MatchFilter *filter=nullptr, bool relaxed=false)
Find nearest centroid to the specified point - up to distance specified by tolerance Optional filter ...
void initFinished(bool ok)
Emitted whenever index has been built and initialization is finished.
Match nearestArea(const QgsPointXY &point, double tolerance, QgsPointLocator::MatchFilter *filter=nullptr, bool relaxed=false)
Find nearest area to the specified point - up to distance specified by tolerance Optional filter may ...
Type
The type of a snap result or the filter type for a snap request.
@ Area
Snapped to an area.
@ MiddleOfSegment
Snapped to the middle of a segment.
@ Vertex
Snapped to a vertex. Can be a vertex of the geometry or an intersection.
@ Centroid
Snapped to a centroid.
@ Edge
Snapped to an edge.
@ LineEndpoint
Start or end points of lines only.
Match nearestLineEndpoints(const QgsPointXY &point, double tolerance, QgsPointLocator::MatchFilter *filter=nullptr, bool relaxed=false)
Find nearest line endpoint (start or end vertex) to the specified point - up to distance specified by...
Represents a 2D point.
Definition qgspointxy.h:62
double sqrDist(double x, double y) const
Returns the squared distance between this point a specified x, y coordinate.
Definition qgspointxy.h:189
double y
Definition qgspointxy.h:66
double x
Definition qgspointxy.h:65
Encapsulates a QGIS project, including sets of map layers and their styles, layouts,...
Definition qgsproject.h:113
A rectangle specified with double values.
bool contains(const QgsRectangle &rect) const
Returns true when rectangle contains other rectangle.
bool intersects(const QgsRectangle &rect) const
Returns true when rectangle intersects with other rectangle.
static QgsRenderContext fromMapSettings(const QgsMapSettings &mapSettings)
create initialized QgsRenderContext instance from given QgsMapSettings
A container of advanced configuration (per layer) of the snapping of the project.
double maximumScale() const
Returns max scale on which snapping is limited.
double minimumScale() const
Returns minimum scale on which snapping is limited.
Stores configuration of snapping settings for the project.
@ PerLayer
Scale dependency using min max range per layer.
@ Disabled
No scale dependency.
@ Global
Scale dependency using global min max range.
QgsPointLocator::Match snapToCurrentLayer(QPoint point, QgsPointLocator::Types type, QgsPointLocator::MatchFilter *filter=nullptr)
Snap to current layer.
void setMapSettings(const QgsMapSettings &settings)
Assign current map settings to the utils - used for conversion between screen coords to map coords.
void toggleEnabled()
Toggles the state of snapping.
@ IndexAlwaysFull
For all layers build index of full extent. Uses more memory, but queries are faster.
@ IndexHybrid
For "big" layers using IndexNeverFull, for the rest IndexAlwaysFull. Compromise between speed and mem...
@ IndexExtent
For all layer build index of extent given in map settings.
@ IndexNeverFull
For all layers only create temporary indexes of small extent. Low memory usage, slower queries.
QgsPointLocator * locatorForLayer(QgsVectorLayer *vl)
Gets a point locator for the given layer.
virtual void prepareIndexProgress(int index)
Called when finished indexing a layer with snapToMap. When index == count the indexing is complete.
QString dump()
Gets extra information about the instance.
void configChanged(const QgsSnappingConfig &snappingConfig)
Emitted when the snapping settings object changes.
~QgsSnappingUtils() override
void clearAllLocators()
Deletes all existing locators (e.g. when destination CRS has changed and we need to reindex).
QgsSnappingConfig config
void setCurrentLayer(QgsVectorLayer *layer)
Sets current layer so that if mode is SnapCurrentLayer we know which layer to use.
QgsPointLocator::Match snapToMap(QPoint point, QgsPointLocator::MatchFilter *filter=nullptr, bool relaxed=false)
Snap to map according to the current configuration.
QgsSnappingUtils(QObject *parent=nullptr, bool enableSnappingForInvisibleFeature=true)
Constructor for QgsSnappingUtils.
void setConfig(const QgsSnappingConfig &snappingConfig)
The snapping configuration controls the behavior of this object.
void setEnableSnappingForInvisibleFeature(bool enable)
Set if invisible features must be snapped or not.
QList< QgsSnappingUtils::LayerConfig > layers() const
Query layers used for snapping.
virtual void prepareIndexStarting(int count)
Called when starting to index with snapToMap - can be overridden and e.g. progress dialog can be prov...
static double vertexSearchRadius(const QgsMapSettings &mapSettings)
Static function to get vertex tolerance value.
static double toleranceInProjectUnits(double tolerance, QgsMapLayer *layer, const QgsMapSettings &mapSettings, Qgis::MapToolUnit units)
Static function to translate tolerance value into map units.
Represents a vector layer which manages a vector based dataset.
long long featureCount(const QString &legendKey) const
Number of features rendered with specified legend key.
QgsRectangle extent() const final
Returns the extent of the layer.
Q_INVOKABLE Qgis::GeometryType geometryType() const
Returns point, line or polygon.
As part of the API refactoring and improvements which landed in the Processing API was substantially reworked from the x version This was done in order to allow much of the underlying Processing framework to be ported into c
QVector< QgsPointXY > QgsPolylineXY
Polyline as represented as a vector of two-dimensional points.
Definition qgsgeometry.h:63
#define QgsDebugMsgLevel(str, level)
Definition qgslogger.h:63
QgsRectangle _areaOfInterest(const QgsPointXY &point, double tolerance)
Interface that allows rejection of some matches in intersection queries (e.g.
double distance() const
for vertex / edge match units depending on what class returns it (geom.cache: layer units,...
QgsPointLocator::Type type() const
Configures how a certain layer should be handled in a snapping operation.