QGIS API Documentation 3.28.0-Firenze (ed3ad0430f)
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
189 private:
190
194 void destroyJob( QgsMapRendererJob *job );
195 QgsMapSettings prepareMapSettings() const;
196 void updateTransform();
197 void zoomToFullExtent();
198 void clearTemporalCache();
199
200 std::unique_ptr<QgsQuickMapSettings> mMapSettings;
201 bool mPinching = false;
202 QPoint mPinchStartPoint;
203 QgsMapRendererParallelJob *mJob = nullptr;
204 std::unique_ptr<QgsMapRendererCache> mCache;
205 QgsLabelingResults *mLabelingResults = nullptr;
206 QImage mImage;
207 QgsMapSettings mImageMapSettings;
208 QTimer mRefreshTimer;
209 bool mDirty = false;
210 bool mFreeze = false;
211 QList<QMetaObject::Connection> mLayerConnections;
212 QTimer mMapUpdateTimer;
213 bool mIncrementalRendering = false;
214 bool mSilentRefresh = false;
215 bool mDeferredRefreshPending = false;
216
217 QQuickWindow *mWindow = nullptr;
218};
219
220#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...