QGIS API Documentation  3.8.0-Zanzibar (11aff65)
qgslayertreemapcanvasbridge.cpp
Go to the documentation of this file.
1 /***************************************************************************
2  qgslayertreemapcanvasbridge.cpp
3  --------------------------------------
4  Date : May 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 
17 
18 #include "qgslayertree.h"
19 #include "qgslayertreeutils.h"
20 #include "qgsmaplayer.h"
21 #include "qgsvectorlayer.h"
22 #include "qgsmapcanvas.h"
23 #include "qgsmapoverviewcanvas.h"
24 #include "qgsproject.h"
25 #include "qgssettings.h"
26 #include "qgsgui.h"
27 
29  : QObject( parent )
30  , mRoot( root )
31  , mCanvas( canvas )
32  , mPendingCanvasUpdate( false )
33  , mAutoSetupOnFirstLayer( true )
34  , mHasLayersLoaded( !root->findLayers().isEmpty() )
35 {
36  connect( root, &QgsLayerTreeGroup::customPropertyChanged, this, &QgsLayerTreeMapCanvasBridge::nodeCustomPropertyChanged );
37  connect( root, &QgsLayerTreeNode::visibilityChanged, this, &QgsLayerTreeMapCanvasBridge::nodeVisibilityChanged );
38  connect( root, &QgsLayerTree::layerOrderChanged, this, &QgsLayerTreeMapCanvasBridge::deferredSetCanvasLayers );
39 
40  connect( QgsProject::instance(), &QgsProject::layersAdded, this, &QgsLayerTreeMapCanvasBridge::layersAdded );
41 
43 }
44 
46 {
47  QList<QgsMapLayer *> canvasLayers, overviewLayers, allLayerOrder;
48 
49  if ( mRoot->hasCustomLayerOrder() )
50  {
51  const QList<QgsMapLayer *> customOrderLayers = mRoot->customLayerOrder();
52  for ( const QgsMapLayer *layer : customOrderLayers )
53  {
54  QgsLayerTreeLayer *nodeLayer = mRoot->findLayer( layer->id() );
55  if ( nodeLayer )
56  {
57  if ( !nodeLayer->layer()->isSpatial() )
58  continue;
59 
60  allLayerOrder << nodeLayer->layer();
61  if ( nodeLayer->isVisible() )
62  canvasLayers << nodeLayer->layer();
63  if ( nodeLayer->customProperty( QStringLiteral( "overview" ), 0 ).toInt() )
64  overviewLayers << nodeLayer->layer();
65  }
66  }
67  }
68  else
69  {
70  setCanvasLayers( mRoot, canvasLayers, overviewLayers, allLayerOrder );
71  }
72 
73  const QList<QgsLayerTreeLayer *> layerNodes = mRoot->findLayers();
74  int currentSpatialLayerCount = 0;
75  int currentValidSpatialLayerCount = 0;
76  for ( QgsLayerTreeLayer *layerNode : layerNodes )
77  {
78  if ( layerNode->layer() && layerNode->layer()->isSpatial() )
79  {
80  currentSpatialLayerCount++;
81  if ( layerNode->layer()->isValid() )
82  currentValidSpatialLayerCount++;
83  }
84  }
85 
86  bool firstLayers = mAutoSetupOnFirstLayer && !mHasLayersLoaded && currentSpatialLayerCount != 0;
87  bool firstValidLayers = mAutoSetupOnFirstLayer && !mHasValidLayersLoaded && currentValidSpatialLayerCount != 0;
88 
89  mCanvas->setLayers( canvasLayers );
90  if ( mOverviewCanvas )
91  mOverviewCanvas->setLayers( overviewLayers );
92 
93  if ( firstValidLayers )
94  {
95  // if we are moving from zero to non-zero layers, let's zoom to those data (only consider valid layers here!)
96  mCanvas->zoomToFullExtent();
97  }
98 
99  if ( !mFirstCRS.isValid() )
100  {
101  // find out what is the first used CRS in case we may need to turn on OTF projections later
102  for ( const QgsLayerTreeLayer *layerNode : layerNodes )
103  {
104  if ( layerNode->layer() && layerNode->layer()->crs().isValid() )
105  {
106  mFirstCRS = layerNode->layer()->crs();
107  break;
108  }
109  }
110  }
111 
112  if ( mFirstCRS.isValid() && firstLayers )
113  {
114  const QgsGui::ProjectCrsBehavior projectCrsBehavior = QgsSettings().enumValue( QStringLiteral( "/projections/newProjectCrsBehavior" ), QgsGui::UseCrsOfFirstLayerAdded, QgsSettings::App );
115  switch ( projectCrsBehavior )
116  {
118  QgsProject::instance()->setCrs( mFirstCRS );
119  break;
120 
122  break;
123  }
124  }
125 
126  mHasLayersLoaded = currentSpatialLayerCount;
127  mHasValidLayersLoaded = currentValidSpatialLayerCount;
128  if ( currentSpatialLayerCount == 0 )
129  mFirstCRS = QgsCoordinateReferenceSystem();
130 
131  mPendingCanvasUpdate = false;
132 
133  emit canvasLayersChanged( canvasLayers );
134 }
135 
136 void QgsLayerTreeMapCanvasBridge::setCanvasLayers( QgsLayerTreeNode *node, QList<QgsMapLayer *> &canvasLayers, QList<QgsMapLayer *> &overviewLayers, QList<QgsMapLayer *> &allLayers )
137 {
138  if ( QgsLayerTree::isLayer( node ) )
139  {
140  QgsLayerTreeLayer *nodeLayer = QgsLayerTree::toLayer( node );
141  if ( nodeLayer->layer() && nodeLayer->layer()->isSpatial() )
142  {
143  allLayers << nodeLayer->layer();
144  if ( nodeLayer->isVisible() )
145  canvasLayers << nodeLayer->layer();
146  if ( nodeLayer->customProperty( QStringLiteral( "overview" ), 0 ).toInt() )
147  overviewLayers << nodeLayer->layer();
148  }
149  }
150 
151  const QList<QgsLayerTreeNode *> children = node->children();
152  for ( QgsLayerTreeNode *child : children )
153  setCanvasLayers( child, canvasLayers, overviewLayers, allLayers );
154 }
155 
156 void QgsLayerTreeMapCanvasBridge::deferredSetCanvasLayers()
157 {
158  if ( mPendingCanvasUpdate )
159  return;
160 
161  mPendingCanvasUpdate = true;
162  QMetaObject::invokeMethod( this, "setCanvasLayers", Qt::QueuedConnection );
163 }
164 
165 void QgsLayerTreeMapCanvasBridge::nodeVisibilityChanged()
166 {
167  deferredSetCanvasLayers();
168 }
169 
170 void QgsLayerTreeMapCanvasBridge::nodeCustomPropertyChanged( QgsLayerTreeNode *node, const QString &key )
171 {
172  Q_UNUSED( node )
173  if ( key == QLatin1String( "overview" ) )
174  deferredSetCanvasLayers();
175 }
176 
177 void QgsLayerTreeMapCanvasBridge::layersAdded( const QList<QgsMapLayer *> &layers )
178 {
179  for ( QgsMapLayer *l : layers )
180  {
181  if ( l )
182  {
183  connect( l, &QgsMapLayer::dataSourceChanged, this, [ this, l ]
184  {
185  if ( l->isValid() && l->isSpatial() && mAutoSetupOnFirstLayer && !mHasValidLayersLoaded )
186  {
187  mHasValidLayersLoaded = true;
188  // if we are moving from zero valid layers to non-zero VALID layers, let's zoom to those data
189  mCanvas->zoomToFullExtent();
190  }
191  } );
192  }
193  }
194 }
static QgsLayerTreeLayer * toLayer(QgsLayerTreeNode *node)
Cast node to a layer.
Definition: qgslayertree.h:75
Base class for all map layer types.
Definition: qgsmaplayer.h:78
void layersAdded(const QList< QgsMapLayer *> &layers)
Emitted when one or more layers were added to the registry.
This class is a composition of two QSettings instances:
Definition: qgssettings.h:58
Set the project CRS to the CRS of the first layer added to a new project.
Definition: qgsgui.h:56
void layerOrderChanged()
Emitted when the layer order has changed.
bool isVisible() const
Returns whether a node is really visible (ie checked and all its ancestors checked as well) ...
Q_INVOKABLE void setCanvasLayers()
force update of canvas layers from the layer tree. Normally this should not be needed to be called...
Map canvas is a class for displaying all GIS data types on a canvas.
Definition: qgsmapcanvas.h:73
QList< QgsMapLayer * > customLayerOrder() const
The order in which layers will be rendered on the canvas.
QList< QgsLayerTreeNode * > children()
Gets list of children of the node. Children are owned by the parent.
Namespace with helper functions for layer tree operations.
Definition: qgslayertree.h:32
void setLayers(const QList< QgsMapLayer *> &layers)
updates layer set for overview
QVariant customProperty(const QString &key, const QVariant &defaultValue=QVariant()) const
Read a custom property from layer. Properties are stored in a map and saved in project file...
void setCrs(const QgsCoordinateReferenceSystem &crs)
Sets the project&#39;s native coordinate reference system.
Definition: qgsproject.cpp:649
static bool isLayer(const QgsLayerTreeNode *node)
Check whether the node is a valid layer node.
Definition: qgslayertree.h:53
This class is a base class for nodes in a layer tree.
void dataSourceChanged()
Emitted whenever the layer&#39;s data source has been changed.
bool hasCustomLayerOrder() const
Determines if the layer order should be derived from the layer tree or if a custom override order sha...
void canvasLayersChanged(const QList< QgsMapLayer * > &layers)
Emitted when the set of layers (or order of layers) visible in the canvas changes.
QgsMapLayer * layer() const
Returns the map layer associated with this node.
QgsLayerTreeMapCanvasBridge(QgsLayerTree *root, QgsMapCanvas *canvas, QObject *parent=nullptr)
Constructor: does not take ownership of the layer tree nor canvas.
void visibilityChanged(QgsLayerTreeNode *node)
Emitted when check state of a node within the tree has been changed.
void setLayers(const QList< QgsMapLayer *> &layers)
Sets the list of layers that should be shown in the canvas.
static QgsProject * instance()
Returns the QgsProject singleton instance.
Definition: qgsproject.cpp:438
void zoomToFullExtent()
Zoom to the full extent of all layers.
This class represents a coordinate reference system (CRS).
Always set new projects to use a preset default CRS.
Definition: qgsgui.h:57
T enumValue(const QString &key, const T &defaultValue, const Section section=NoSection)
Returns the setting value for a setting based on an enum.
Definition: qgssettings.h:244
virtual bool isSpatial() const
Returns true if the layer is considered a spatial layer, ie it has some form of geometry associated w...
QList< QgsLayerTreeLayer * > findLayers() const
Find all layer nodes.
QgsLayerTreeLayer * findLayer(QgsMapLayer *layer) const
Find layer node representing the map layer.
void customPropertyChanged(QgsLayerTreeNode *node, const QString &key)
Emitted when a custom property of a node within the tree has been changed or removed.
ProjectCrsBehavior
Defines the behavior to use when setting the CRS for a newly created project.
Definition: qgsgui.h:54
Layer tree node points to a map layer.
bool isValid() const
Returns whether this CRS is correctly initialized and usable.