QGIS API Documentation 3.37.0-Master (fdefdf9c27f)
qgsquickmapcanvasmap.h
Go to the documentation of this file.
1/***************************************************************************
2 qgsquickmapcanvasmap.h
3 --------------------------------------
4 Date : 10.12.2014
5 Copyright : (C) 2014 by Matthias Kuhn
6 Email : matthias (at) opengis.ch
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#ifndef QGSQUICKMAPCANVASMAP_H
17#define QGSQUICKMAPCANVASMAP_H
18
19#include "qgis_quick.h"
20#include "qgsquickmapsettings.h"
21
22#include <QFutureSynchronizer>
23#include <QTimer>
24#include <QtQuick/QQuickItem>
25#include <qgsmapsettings.h>
26#include <qgspoint.h>
27
28#include <memory>
29
33
52class QUICK_EXPORT QgsQuickMapCanvasMap : public QQuickItem
53{
54 Q_OBJECT
55
64 Q_PROPERTY( QgsQuickMapSettings *mapSettings READ mapSettings )
65
66
70 Q_PROPERTY( bool freeze READ freeze WRITE setFreeze NOTIFY freezeChanged )
71
72
77 Q_PROPERTY( bool isRendering READ isRendering NOTIFY isRenderingChanged )
78
79
84 Q_PROPERTY( int mapUpdateInterval READ mapUpdateInterval WRITE setMapUpdateInterval NOTIFY mapUpdateIntervalChanged )
85
86
89 Q_PROPERTY( bool incrementalRendering READ incrementalRendering WRITE setIncrementalRendering NOTIFY incrementalRenderingChanged )
90
91 public:
93 explicit QgsQuickMapCanvasMap( QQuickItem *parent = nullptr );
95
96 QSGNode *updatePaintNode( QSGNode *oldNode, QQuickItem::UpdatePaintNodeData * ) override;
97
99 QgsQuickMapSettings *mapSettings() const;
100
102 bool freeze() const;
103
105 void setFreeze( bool freeze );
106
108 bool isRendering() const;
109
111 int mapUpdateInterval() const;
112
114 void setMapUpdateInterval( int mapUpdateInterval );
115
117 bool incrementalRendering() const;
118
120 void setIncrementalRendering( bool incrementalRendering );
121
122 signals:
123
128
133
136
139
142
145
146 protected:
147#if QT_VERSION < QT_VERSION_CHECK( 6, 0, 0 )
148 void geometryChanged( const QRectF &newGeometry, const QRectF &oldGeometry ) override;
149#else
150 void geometryChange( const QRectF &newGeometry, const QRectF &oldGeometry ) override;
151#endif
152
153 public slots:
155 void stopRendering();
156
160 void zoom( QPointF center, qreal scale );
161
165 void pan( QPointF oldPos, QPointF newPos );
166
171 void refresh();
172
176 void clearCache();
177
178 private slots:
179 void refreshMap();
180 void renderJobUpdated();
181 void renderJobFinished();
182 void layerRepaintRequested( bool deferred );
183 void onWindowChanged( QQuickWindow *window );
184 void onScreenChanged( QScreen *screen );
185 void onExtentChanged();
186 void onLayersChanged();
187 void onTemporalStateChanged();
188 void onzRangeChanged();
189
190 private:
191
195 void destroyJob( QgsMapRendererJob *job );
196 QgsMapSettings prepareMapSettings() const;
197 void updateTransform();
198 void zoomToFullExtent();
199 void clearTemporalCache();
200 void clearElevationCache();
201
202 std::unique_ptr<QgsQuickMapSettings> mMapSettings;
203 bool mPinching = false;
204 QPoint mPinchStartPoint;
205 QgsMapRendererParallelJob *mJob = nullptr;
206 std::unique_ptr<QgsMapRendererCache> mCache;
207 QgsLabelingResults *mLabelingResults = nullptr;
208 QImage mImage;
209 QgsMapSettings mImageMapSettings;
210 QTimer mRefreshTimer;
211 bool mDirty = false;
212 bool mFreeze = false;
213 QList<QMetaObject::Connection> mLayerConnections;
214 QTimer mMapUpdateTimer;
215 bool mIncrementalRendering = false;
216 bool mSilentRefresh = false;
217 bool mDeferredRefreshPending = false;
218
219 QQuickWindow *mWindow = nullptr;
220};
221
222#endif // QGSQUICKMAPCANVASMAP_H
Class that stores computed placement from labeling engine.
This class is responsible for keeping cache of rendered images resulting from a map rendering job.
Abstract base class for map rendering implementations.
Job implementation that renders all layers in parallel.
The QgsMapSettings class contains configuration for rendering of the map.
This class implements a visual Qt Quick Item that does map rendering according to the current map set...
void freezeChanged()
When freeze property is set to true, the map canvas does not refresh.
void mapCanvasRefreshed()
Signal is emitted when a canvas is refreshed.
void incrementalRenderingChanged()
When the incrementalRendering property is set to true, the automatic refresh of map canvas during ren...
void renderStarting()
Signal is emitted when a rendering is starting.
void mapUpdateIntervalChanged()
Interval in milliseconds after which the map canvas will be updated while a rendering job is ongoing.
void isRenderingChanged()
The isRendering property is set to true while a rendering job is pending for this map canvas map.
The QgsQuickMapSettings class encapsulates QgsMapSettings class to offer settings of configuration of...