QGIS API Documentation 3.41.0-Master (af5edcb665c)
Loading...
Searching...
No Matches
qgs3dmapcanvas.cpp
Go to the documentation of this file.
1/***************************************************************************
2 qgs3dmapcanvas.cpp
3 --------------------------------------
4 Date : July 2017
5 Copyright : (C) 2017 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 <Qt3DCore/QAspectEngine>
17#include <Qt3DCore/QEntity>
18#if QT_VERSION >= QT_VERSION_CHECK( 6, 0, 0 )
19#include <Qt3DCore/QCoreAspect>
20#endif
21#include <Qt3DExtras/QForwardRenderer>
22#include <Qt3DRender/QRenderSettings>
23#include <Qt3DRender/QRenderAspect>
24#include <Qt3DInput/QInputAspect>
25#include <Qt3DInput/QInputSettings>
26#include <Qt3DLogic/QLogicAspect>
27#include <Qt3DRender/QCamera>
28#include <Qt3DLogic/QFrameAction>
29
30#include "qgs3dmapcanvas.h"
31#include "qgs3dmapscene.h"
32#include "qgswindow3dengine.h"
33#include "qgs3dmapsettings.h"
34#include "qgs3dmaptool.h"
36#include "qgsframegraph.h"
38#include "qgsrubberband3d.h"
39
40#include "moc_qgs3dmapcanvas.cpp"
41
42
44 : m_aspectEngine( new Qt3DCore::QAspectEngine )
45 , m_renderAspect( new Qt3DRender::QRenderAspect )
46 , m_inputAspect( new Qt3DInput::QInputAspect )
47 , m_logicAspect( new Qt3DLogic::QLogicAspect )
48 , m_renderSettings( new Qt3DRender::QRenderSettings )
49 , m_defaultCamera( new Qt3DRender::QCamera )
50 , m_inputSettings( new Qt3DInput::QInputSettings )
51 , m_root( new Qt3DCore::QEntity )
52 , m_userRoot( nullptr )
53 , m_initialized( false )
54{
55 setSurfaceType( QSurface::OpenGLSurface );
56
57 // register aspects
58#if QT_VERSION >= QT_VERSION_CHECK( 6, 0, 0 )
59 m_aspectEngine->registerAspect( new Qt3DCore::QCoreAspect );
60#endif
61 m_aspectEngine->registerAspect( m_renderAspect );
62 m_aspectEngine->registerAspect( m_inputAspect );
63 m_aspectEngine->registerAspect( m_logicAspect );
64
65 m_defaultCamera->setParent( m_root );
66 m_inputSettings->setEventSource( this );
67
68 const QgsSettings setting;
69 mEngine = new QgsWindow3DEngine( this );
70
71 connect( mEngine, &QgsAbstract3DEngine::imageCaptured, this, [=]( const QImage &image ) {
72 image.save( mCaptureFileName, mCaptureFileFormat.toLocal8Bit().data() );
73 mEngine->setRenderCaptureEnabled( false );
74 emit savedAsImage( mCaptureFileName );
75 } );
76
77 setCursor( Qt::OpenHandCursor );
78 installEventFilter( this );
79}
80
82{
83 if ( mMapTool )
84 mMapTool->deactivate();
85 // make sure the scene is deleted while map settings object is still alive
86 mScene->deleteLater();
87 mScene = nullptr;
88 mMapSettings->deleteLater();
89 mMapSettings = nullptr;
90 qDeleteAll( mHighlights );
91 mHighlights.clear();
92
93 delete m_aspectEngine;
94}
95
96void Qgs3DMapCanvas::setRootEntity( Qt3DCore::QEntity *root )
97{
98 if ( m_userRoot != root )
99 {
100 if ( m_userRoot )
101 m_userRoot->setParent( static_cast<Qt3DCore::QNode *>( nullptr ) );
102 if ( root )
103 root->setParent( m_root );
104 m_userRoot = root;
105 }
106}
107
108void Qgs3DMapCanvas::setActiveFrameGraph( Qt3DRender::QFrameGraphNode *activeFrameGraph )
109{
110 m_renderSettings->setActiveFrameGraph( activeFrameGraph );
111}
112
113Qt3DRender::QFrameGraphNode *Qgs3DMapCanvas::activeFrameGraph() const
114{
115 return m_renderSettings->activeFrameGraph();
116}
117
118Qt3DRender::QCamera *Qgs3DMapCanvas::camera() const
119{
120 return m_defaultCamera;
121}
122
123Qt3DRender::QRenderSettings *Qgs3DMapCanvas::renderSettings() const
124{
125 return m_renderSettings;
126}
127
128void Qgs3DMapCanvas::showEvent( QShowEvent *e )
129{
130 if ( !m_initialized )
131 {
132 m_root->addComponent( m_renderSettings );
133 m_root->addComponent( m_inputSettings );
134 m_aspectEngine->setRootEntity( Qt3DCore::QEntityPtr( m_root ) );
135
136 m_initialized = true;
137 }
138 QWindow::showEvent( e );
139}
140
141void Qgs3DMapCanvas::resizeEvent( QResizeEvent * )
142{
143 m_defaultCamera->setAspectRatio( float( width() ) / std::max( 1.f, static_cast<float>( height() ) ) );
144
145 mEngine->setSize( size() );
146}
147
149{
150 // TODO: eventually we want to get rid of this
151 Q_ASSERT( !mMapSettings );
152 Q_ASSERT( !mScene );
153
154 Qgs3DMapScene *newScene = new Qgs3DMapScene( *mapSettings, mEngine );
155
156 mEngine->setSize( size() );
157 mEngine->setRootEntity( newScene );
158
159 if ( mScene )
160 {
161 mScene->deleteLater();
162 }
163 mScene = newScene;
167
168 delete mMapSettings;
169 mMapSettings = mapSettings;
170
171 resetView();
172
173 connect( cameraController(), &QgsCameraController::setCursorPosition, this, [=]( QPoint point ) {
174 QCursor::setPos( mapToGlobal( point ) );
175 } );
178 connect( cameraController(), &QgsCameraController::navigationModeChanged, this, &Qgs3DMapCanvas::onNavigationModeChanged );
179 connect( cameraController(), &QgsCameraController::requestDepthBufferCapture, this, &Qgs3DMapCanvas::captureDepthBuffer );
180
182
183 emit mapSettingsChanged();
184}
185
187{
188 return mScene ? mScene->cameraController() : nullptr;
189}
190
192{
193 if ( !mScene )
194 return;
195
196 mScene->viewZoomFull();
197}
198
199void Qgs3DMapCanvas::setViewFromTop( const QgsPointXY &center, float distance, float rotation )
200{
201 if ( !mScene )
202 return;
203
204 const float worldX = center.x() - mMapSettings->origin().x();
205 const float worldY = center.y() - mMapSettings->origin().y();
206 mScene->cameraController()->setViewFromTop( worldX, worldY, distance, rotation );
207}
208
209void Qgs3DMapCanvas::saveAsImage( const QString &fileName, const QString &fileFormat )
210{
211 if ( !mScene || fileName.isEmpty() )
212 return;
213
214 mCaptureFileName = fileName;
215 mCaptureFileFormat = fileFormat;
216 mEngine->setRenderCaptureEnabled( true );
217 // Setup a frame action that is used to wait until next frame
218 Qt3DLogic::QFrameAction *screenCaptureFrameAction = new Qt3DLogic::QFrameAction;
219 mScene->addComponent( screenCaptureFrameAction );
220 // Wait to have the render capture enabled in the next frame
221 connect( screenCaptureFrameAction, &Qt3DLogic::QFrameAction::triggered, this, [=]( float ) {
222 mEngine->requestCaptureImage();
223 mScene->removeComponent( screenCaptureFrameAction );
224 screenCaptureFrameAction->deleteLater();
225 } );
226}
227
228void Qgs3DMapCanvas::captureDepthBuffer()
229{
230 if ( !mScene )
231 return;
232
233 // Setup a frame action that is used to wait until next frame
234 Qt3DLogic::QFrameAction *screenCaptureFrameAction = new Qt3DLogic::QFrameAction;
235 mScene->addComponent( screenCaptureFrameAction );
236 // Wait to have the render capture enabled in the next frame
237 connect( screenCaptureFrameAction, &Qt3DLogic::QFrameAction::triggered, this, [=]( float ) {
238 mEngine->requestDepthBufferCapture();
239 mScene->removeComponent( screenCaptureFrameAction );
240 screenCaptureFrameAction->deleteLater();
241 } );
242}
243
245{
246 if ( !mScene )
247 return;
248
249 if ( tool == mMapTool )
250 return;
251
252 // For Camera Control tool
253 if ( mMapTool && !tool )
254 {
255 mScene->cameraController()->setEnabled( true );
256 setCursor( Qt::OpenHandCursor );
257 }
258 else if ( !mMapTool && tool )
259 {
260 mScene->cameraController()->setEnabled( tool->allowsCameraControls() );
261 }
262
263 if ( mMapTool )
264 mMapTool->deactivate();
265
266 mMapTool = tool;
267
268 if ( mMapTool )
269 {
270 mMapTool->activate();
271 setCursor( mMapTool->cursor() );
272 }
273}
274
275bool Qgs3DMapCanvas::eventFilter( QObject *watched, QEvent *event )
276{
277 if ( watched != this )
278 return false;
279
280 if ( event->type() == QEvent::ShortcutOverride )
281 {
282 // if the camera controller will handle a key event, don't allow it to propagate
283 // outside of the 3d window or it may be grabbed by a parent window level shortcut
284 // and accordingly never be received by the camera controller
285 if ( cameraController() && cameraController()->willHandleKeyEvent( static_cast<QKeyEvent *>( event ) ) )
286 {
287 event->accept();
288 return true;
289 }
290 return false;
291 }
292
293 if ( !mMapTool )
294 return false;
295
296 switch ( event->type() )
297 {
298 case QEvent::MouseButtonPress:
299 mMapTool->mousePressEvent( static_cast<QMouseEvent *>( event ) );
300 break;
301 case QEvent::MouseButtonRelease:
302 mMapTool->mouseReleaseEvent( static_cast<QMouseEvent *>( event ) );
303 break;
304 case QEvent::MouseMove:
305 mMapTool->mouseMoveEvent( static_cast<QMouseEvent *>( event ) );
306 break;
307 case QEvent::KeyPress:
308 mMapTool->keyPressEvent( static_cast<QKeyEvent *>( event ) );
309 break;
310 default:
311 break;
312 }
313 return false;
314}
315
317{
318 if ( mTemporalController )
319 disconnect( mTemporalController, &QgsTemporalController::updateTemporalRange, this, &Qgs3DMapCanvas::updateTemporalRange );
320
321 mTemporalController = temporalController;
322 connect( mTemporalController, &QgsTemporalController::updateTemporalRange, this, &Qgs3DMapCanvas::updateTemporalRange );
323}
324
325void Qgs3DMapCanvas::updateTemporalRange( const QgsDateTimeRange &temporalrange )
326{
327 if ( !mScene )
328 return;
329
330 mMapSettings->setTemporalRange( temporalrange );
331 mScene->updateTemporal();
332}
333
334void Qgs3DMapCanvas::onNavigationModeChanged( Qgis::NavigationMode mode )
335{
336 mMapSettings->setCameraNavigationMode( mode );
337}
338
340{
341 if ( !mScene )
342 return;
343
344 mScene->setViewFrom2DExtent( extent );
345}
346
348{
349 return mScene ? mScene->viewFrustum2DExtent() : QVector<QgsPointXY>();
350}
351
353{
354 // we only support point clouds for now
355 if ( layer->type() != Qgis::LayerType::PointCloud )
356 return;
357
358 const QgsGeometry geom = feature.geometry();
359 const QgsPoint pt( geom.vertexAt( 0 ) );
360
361 if ( !mHighlights.contains( layer ) )
362 {
363 QgsRubberBand3D *band = new QgsRubberBand3D( *mMapSettings, mEngine, mEngine->frameGraph()->rubberBandsRootEntity(), Qgis::GeometryType::Point );
364
365 const QgsSettings settings;
366 const QColor color = QColor( settings.value( QStringLiteral( "Map/highlight/color" ), Qgis::DEFAULT_HIGHLIGHT_COLOR.name() ).toString() );
367 band->setColor( color );
368 band->setMarkerType( QgsRubberBand3D::MarkerType::Square );
369 if ( QgsPointCloudLayer3DRenderer *pcRenderer = dynamic_cast<QgsPointCloudLayer3DRenderer *>( layer->renderer3D() ) )
370 {
371 band->setWidth( pcRenderer->symbol()->pointSize() + 1 );
372 }
373 mHighlights.insert( layer, band );
374
375 connect( layer, &QgsMapLayer::renderer3DChanged, this, &Qgs3DMapCanvas::updateHighlightSizes );
376 }
377 mHighlights[layer]->addPoint( pt );
378}
379
380void Qgs3DMapCanvas::updateHighlightSizes()
381{
382 if ( QgsMapLayer *layer = qobject_cast<QgsMapLayer *>( sender() ) )
383 {
384 if ( QgsPointCloudLayer3DRenderer *rnd = dynamic_cast<QgsPointCloudLayer3DRenderer *>( layer->renderer3D() ) )
385 {
386 if ( mHighlights.contains( layer ) )
387 {
388 mHighlights[layer]->setWidth( rnd->symbol()->pointSize() + 1 );
389 }
390 }
391 }
392}
393
395{
396 for ( auto it = mHighlights.keyBegin(); it != mHighlights.keyEnd(); it++ )
397 {
398 disconnect( it.base().key(), &QgsMapLayer::renderer3DChanged, this, &Qgs3DMapCanvas::updateHighlightSizes );
399 }
400
401 qDeleteAll( mHighlights );
402 mHighlights.clear();
403}
static const QColor DEFAULT_HIGHLIGHT_COLOR
Default highlight color.
Definition qgis.h:5737
NavigationMode
The navigation mode used by 3D cameras.
Definition qgis.h:3935
@ PointCloud
Point cloud layer. Added in QGIS 3.18.
void saveAsImage(const QString &fileName, const QString &fileFormat)
Saves the current scene as an image.
QVector< QgsPointXY > viewFrustum2DExtent()
Calculates the 2D extent viewed by the 3D camera as the vertices of the viewed trapezoid.
Qgs3DMapSettings * mapSettings()
Returns access to the 3D scene configuration.
void setTemporalController(QgsTemporalController *temporalController)
Sets the temporal controller.
void mapSettingsChanged()
Emitted when the the map setting is changed.
Qt3DRender::QCamera * camera() const
Returns the default camera of the 3D Window.
void viewed2DExtentFrom3DChanged(QVector< QgsPointXY > extent)
Emitted when the viewed 2D extent seen by the 3D camera has changed.
void fpsCountChanged(float fpsCount)
Emitted when the FPS count changes (at most every frame)
void setRootEntity(Qt3DCore::QEntity *root)
Sets the specified root entity of the scene.
void setViewFromTop(const QgsPointXY &center, float distance, float rotation=0)
Sets camera position to look down at the given point (in map coordinates) in given distance from plan...
void setActiveFrameGraph(Qt3DRender::QFrameGraphNode *activeFrameGraph)
Activates the specified activeFrameGraph.
void setMapSettings(Qgs3DMapSettings *mapSettings)
Configure map scene being displayed. Takes ownership.
void showEvent(QShowEvent *e) override
Manages the display events specified in e.
void cameraNavigationSpeedChanged(double speed)
Emitted when the camera navigation speed is changed.
Qt3DRender::QRenderSettings * renderSettings() const
Returns the render settings of the 3D Window.
Qt3DRender::QFrameGraphNode * activeFrameGraph() const
Returns the node of the active frame graph.
void setMapTool(Qgs3DMapTool *tool)
Sets the active map tool that will receive events from the 3D canvas.
void setViewFrom2DExtent(const QgsRectangle &extent)
Resets camera view to show the extent (top view)
void resizeEvent(QResizeEvent *) override
Resets the aspect ratio of the 3D window.
void highlightFeature(const QgsFeature &feature, QgsMapLayer *layer)
Highlights a feature from layer using a QgsRubberBand3D.
void resetView()
Resets camera position to the default: looking down at the origin of world coordinates.
void savedAsImage(const QString &fileName)
Emitted when the 3D map canvas was successfully saved as image.
void clearHighlights()
Clears all QgsRubberBand3D highlights.
void fpsCounterEnabledChanged(bool enabled)
Emitted when the FPS counter is enabled or disabeld.
QgsCameraController * cameraController()
Returns access to the view's camera controller. Returns nullptr if the scene has not been initialized...
bool eventFilter(QObject *watched, QEvent *event) override
void viewed2DExtentFrom3DChanged(QVector< QgsPointXY > extent)
Emitted when the viewed 2D extent seen by the 3D camera has changed.
void fpsCountChanged(float fpsCount)
Emitted when the FPS count changes.
void setViewFrom2DExtent(const QgsRectangle &extent)
Resets camera view to show the extent extent (top view)
QgsCameraController * cameraController() const
Returns camera controller.
void updateTemporal()
Updates the temporale entities.
void fpsCounterEnabledChanged(bool fpsCounterEnabled)
Emitted when the FPS counter is activated or deactivated.
QVector< QgsPointXY > viewFrustum2DExtent() const
Calculates the 2D extent viewed by the 3D camera as the vertices of the viewed trapezoid.
void viewZoomFull()
Resets camera view to show the whole scene (top view)
void setCameraNavigationMode(Qgis::NavigationMode navigationMode)
Sets the navigation mode for the camera.
void setCameraMovementSpeed(double movementSpeed)
Sets the camera movement speed.
QgsVector3D origin() const
Returns coordinates in map CRS at which 3D scene has origin (0,0,0).
virtual bool allowsCameraControls() const
Whether the default mouse controls to zoom/pan/rotate camera can stay enabled while the tool is activ...
virtual void mousePressEvent(QMouseEvent *event)
Reimplement to handle mouse event forwarded by the parent Qgs3DMapCanvas.
virtual QCursor cursor() const
Mouse cursor to be used when the tool is active.
virtual void mouseMoveEvent(QMouseEvent *event)
Reimplement to handle mouse move event forwarded by the parent Qgs3DMapCanvas.
virtual void keyPressEvent(QKeyEvent *event)
Reimplement to handle key press event forwarded by the parent Qgs3DMapCanvas.
virtual void deactivate()
Called when map tool is being deactivated.
virtual void activate()
Called when set as currently active map tool.
virtual void mouseReleaseEvent(QMouseEvent *event)
Reimplement to handle mouse release event forwarded by the parent Qgs3DMapCanvas.
void requestCaptureImage()
Starts a request for an image rendered by the engine.
void requestDepthBufferCapture()
Starts a request for an image containing the depth buffer data of the engine.
void imageCaptured(const QImage &image)
Emitted after a call to requestCaptureImage() to return the captured image.
void depthBufferCaptured(const QImage &image)
Emitted after a call to requestDepthBufferCapture() to return the captured depth buffer.
void setRenderCaptureEnabled(bool enabled)
Sets whether it will be possible to render to an image.
QgsFrameGraph * frameGraph()
Returns the shadow rendering frame graph object used to render the scene.
void navigationModeChanged(Qgis::NavigationMode mode)
Emitted when the navigation mode is changed using the hotkey ctrl + ~.
void requestDepthBufferCapture()
Emitted to ask for the depth buffer image.
void cameraMovementSpeedChanged(double speed)
Emitted whenever the camera movement speed is changed by the controller.
void setViewFromTop(float worldX, float worldY, float distance, float yaw=0)
Sets camera to look down towards given point in world coordinate, in given distance from plane with z...
void depthBufferCaptured(const QImage &depthImage)
Sets the depth buffer image used by the camera controller to calculate world position from a pixel's ...
void setCursorPosition(QPoint point)
Emitted when the mouse cursor position should be moved to the specified point on the map viewport.
The feature class encapsulates a single feature including its unique ID, geometry and a list of field...
Definition qgsfeature.h:58
QgsGeometry geometry
Definition qgsfeature.h:69
Qt3DCore::QEntity * rubberBandsRootEntity()
Returns entity for all rubber bands (to show them always on top)
A geometry is the spatial representation of a feature.
QgsPoint vertexAt(int atVertex) const
Returns coordinates of a vertex.
Base class for all map layer types.
Definition qgsmaplayer.h:76
QgsAbstract3DRenderer * renderer3D() const
Returns 3D renderer associated with the layer.
void renderer3DChanged()
Signal emitted when 3D renderer associated with the layer has changed.
Qgis::LayerType type
Definition qgsmaplayer.h:86
3D renderer that renders all points from a point cloud layer
A class to represent a 2D point.
Definition qgspointxy.h:60
double y
Definition qgspointxy.h:64
double x
Definition qgspointxy.h:63
Point geometry type, with support for z-dimension and m-values.
Definition qgspoint.h:49
A rectangle specified with double values.
This class is a composition of two QSettings instances:
Definition qgssettings.h:64
QVariant value(const QString &key, const QVariant &defaultValue=QVariant(), Section section=NoSection) const
Returns the value for setting key.
A controller base class for temporal objects, contains a signal for notifying updates of the objects ...
void updateTemporalRange(const QgsDateTimeRange &range)
Signals that a temporal range has changed and needs to be updated in all connected objects.
void setTemporalRange(const QgsDateTimeRange &range)
Sets the temporal range for the object.
double y() const
Returns Y coordinate.
Definition qgsvector3d.h:50
double x() const
Returns X coordinate.
Definition qgsvector3d.h:48
void setRootEntity(Qt3DCore::QEntity *root) override
Sets root entity of the 3D scene.
void setSize(QSize s) override
Sets the size of the rendering area (in pixels)