QGIS API Documentation 3.43.0-Master (ebb4087afc0)
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#if QT_VERSION >= QT_VERSION_CHECK( 6, 0, 0 )
18#include <Qt3DCore/QCoreAspect>
19#endif
20#include <Qt3DRender/QRenderSettings>
21#include <Qt3DRender/QRenderAspect>
22#include <Qt3DInput/QInputAspect>
23#include <Qt3DInput/QInputSettings>
24#include <Qt3DLogic/QLogicAspect>
25#include <Qt3DLogic/QFrameAction>
26
27#include "qgs3dmapcanvas.h"
28#include "qgs3dmapscene.h"
29#include "qgswindow3dengine.h"
30#include "qgs3dmapsettings.h"
31#include "qgs3dmaptool.h"
33#include "qgsframegraph.h"
35#include "qgsrubberband3d.h"
36
37#include "moc_qgs3dmapcanvas.cpp"
38
39
41 : m_aspectEngine( new Qt3DCore::QAspectEngine )
42 , m_renderAspect( new Qt3DRender::QRenderAspect )
43 , m_inputAspect( new Qt3DInput::QInputAspect )
44 , m_logicAspect( new Qt3DLogic::QLogicAspect )
45 , m_renderSettings( new Qt3DRender::QRenderSettings )
46 , m_defaultCamera( new Qt3DRender::QCamera )
47 , m_inputSettings( new Qt3DInput::QInputSettings )
48 , m_root( new Qt3DCore::QEntity )
49 , m_userRoot( nullptr )
50 , m_initialized( false )
51{
52 setSurfaceType( QSurface::OpenGLSurface );
53
54 // register aspects
55#if QT_VERSION >= QT_VERSION_CHECK( 6, 0, 0 )
56 m_aspectEngine->registerAspect( new Qt3DCore::QCoreAspect );
57#endif
58 m_aspectEngine->registerAspect( m_renderAspect );
59 m_aspectEngine->registerAspect( m_inputAspect );
60 m_aspectEngine->registerAspect( m_logicAspect );
61
62 m_defaultCamera->setParent( m_root );
63 m_inputSettings->setEventSource( this );
64
65 const QgsSettings setting;
66 mEngine = new QgsWindow3DEngine( this );
67
68 connect( mEngine, &QgsAbstract3DEngine::imageCaptured, this, [=]( const QImage &image ) {
69 image.save( mCaptureFileName, mCaptureFileFormat.toLocal8Bit().data() );
70 mEngine->setRenderCaptureEnabled( false );
71 emit savedAsImage( mCaptureFileName );
72 } );
73
74 setCursor( Qt::OpenHandCursor );
75 installEventFilter( this );
76}
77
79{
80 if ( mMapTool )
81 mMapTool->deactivate();
82 // make sure the scene is deleted while map settings object is still alive
83 mScene->deleteLater();
84 mScene = nullptr;
85 mMapSettings->deleteLater();
86 mMapSettings = nullptr;
87 qDeleteAll( mHighlights );
88 mHighlights.clear();
89
90 delete m_aspectEngine;
91}
92
93void Qgs3DMapCanvas::setRootEntity( Qt3DCore::QEntity *root )
94{
95 if ( m_userRoot != root )
96 {
97 if ( m_userRoot )
98 m_userRoot->setParent( static_cast<Qt3DCore::QNode *>( nullptr ) );
99 if ( root )
100 root->setParent( m_root );
101 m_userRoot = root;
102 }
103}
104
105void Qgs3DMapCanvas::setActiveFrameGraph( Qt3DRender::QFrameGraphNode *activeFrameGraph )
106{
107 m_renderSettings->setActiveFrameGraph( activeFrameGraph );
108}
109
110Qt3DRender::QFrameGraphNode *Qgs3DMapCanvas::activeFrameGraph() const
111{
112 return m_renderSettings->activeFrameGraph();
113}
114
115Qt3DRender::QCamera *Qgs3DMapCanvas::camera() const
116{
117 return m_defaultCamera;
118}
119
120Qt3DRender::QRenderSettings *Qgs3DMapCanvas::renderSettings() const
121{
122 return m_renderSettings;
123}
124
125void Qgs3DMapCanvas::showEvent( QShowEvent *e )
126{
127 if ( !m_initialized )
128 {
129 m_root->addComponent( m_renderSettings );
130 m_root->addComponent( m_inputSettings );
131 m_aspectEngine->setRootEntity( Qt3DCore::QEntityPtr( m_root ) );
132
133 m_initialized = true;
134 }
135 QWindow::showEvent( e );
136}
137
138void Qgs3DMapCanvas::resizeEvent( QResizeEvent * )
139{
140 m_defaultCamera->setAspectRatio( float( width() ) / std::max( 1.f, static_cast<float>( height() ) ) );
141
142 mEngine->setSize( size() );
143}
144
146{
147 // TODO: eventually we want to get rid of this
148 Q_ASSERT( !mMapSettings );
149 Q_ASSERT( !mScene );
150
151 Qgs3DMapScene *newScene = new Qgs3DMapScene( *mapSettings, mEngine );
152
153 mEngine->setSize( size() );
154 mEngine->setRootEntity( newScene );
155
156 if ( mScene )
157 {
158 mScene->deleteLater();
159 }
160 mScene = newScene;
164
165 delete mMapSettings;
166 mMapSettings = mapSettings;
167
168 resetView();
169
170 connect( cameraController(), &QgsCameraController::setCursorPosition, this, [=]( QPoint point ) {
171 QCursor::setPos( mapToGlobal( point ) );
172 } );
175 connect( cameraController(), &QgsCameraController::navigationModeChanged, this, &Qgs3DMapCanvas::onNavigationModeChanged );
176 connect( cameraController(), &QgsCameraController::requestDepthBufferCapture, this, &Qgs3DMapCanvas::captureDepthBuffer );
177
179
180 emit mapSettingsChanged();
181}
182
184{
185 return mScene ? mScene->cameraController() : nullptr;
186}
187
189{
190 if ( !mScene )
191 return;
192
193 mScene->viewZoomFull();
194}
195
196void Qgs3DMapCanvas::setViewFromTop( const QgsPointXY &center, float distance, float rotation )
197{
198 if ( !mScene )
199 return;
200
201 const float worldX = center.x() - mMapSettings->origin().x();
202 const float worldY = center.y() - mMapSettings->origin().y();
203 mScene->cameraController()->setViewFromTop( worldX, worldY, distance, rotation );
204}
205
206void Qgs3DMapCanvas::saveAsImage( const QString &fileName, const QString &fileFormat )
207{
208 if ( !mScene || fileName.isEmpty() )
209 return;
210
211 mCaptureFileName = fileName;
212 mCaptureFileFormat = fileFormat;
213 mEngine->setRenderCaptureEnabled( true );
214 // Setup a frame action that is used to wait until next frame
215 Qt3DLogic::QFrameAction *screenCaptureFrameAction = new Qt3DLogic::QFrameAction;
216 mScene->addComponent( screenCaptureFrameAction );
217 // Wait to have the render capture enabled in the next frame
218 connect( screenCaptureFrameAction, &Qt3DLogic::QFrameAction::triggered, this, [=]( float ) {
219 mEngine->requestCaptureImage();
220 mScene->removeComponent( screenCaptureFrameAction );
221 screenCaptureFrameAction->deleteLater();
222 } );
223}
224
225void Qgs3DMapCanvas::captureDepthBuffer()
226{
227 if ( !mScene )
228 return;
229
230 // Setup a frame action that is used to wait until next frame
231 Qt3DLogic::QFrameAction *screenCaptureFrameAction = new Qt3DLogic::QFrameAction;
232 mScene->addComponent( screenCaptureFrameAction );
233 // Wait to have the render capture enabled in the next frame
234 connect( screenCaptureFrameAction, &Qt3DLogic::QFrameAction::triggered, this, [=]( float ) {
235 mEngine->requestDepthBufferCapture();
236 mScene->removeComponent( screenCaptureFrameAction );
237 screenCaptureFrameAction->deleteLater();
238 } );
239}
240
242{
243 if ( !mScene )
244 return;
245
246 if ( tool == mMapTool )
247 return;
248
249 // For Camera Control tool
250 if ( mMapTool && !tool )
251 {
252 mScene->cameraController()->setEnabled( true );
253 setCursor( Qt::OpenHandCursor );
254 }
255
256 if ( mMapTool )
257 mMapTool->deactivate();
258
259 mMapTool = tool;
260
261 if ( mMapTool )
262 {
263 mMapTool->activate();
264 setCursor( mMapTool->cursor() );
265 }
266}
267
268bool Qgs3DMapCanvas::eventFilter( QObject *watched, QEvent *event )
269{
270 if ( watched != this )
271 return false;
272
273 if ( event->type() == QEvent::ShortcutOverride )
274 {
275 // if the camera controller will handle a key event, don't allow it to propagate
276 // outside of the 3d window or it may be grabbed by a parent window level shortcut
277 // and accordingly never be received by the camera controller
278 if ( cameraController() && cameraController()->willHandleKeyEvent( static_cast<QKeyEvent *>( event ) ) )
279 {
280 event->accept();
281 return true;
282 }
283 return false;
284 }
285
286 if ( !mMapTool )
287 return false;
288
289 switch ( event->type() )
290 {
291 case QEvent::MouseButtonPress:
292 mMapTool->mousePressEvent( static_cast<QMouseEvent *>( event ) );
293 break;
294 case QEvent::MouseButtonRelease:
295 mMapTool->mouseReleaseEvent( static_cast<QMouseEvent *>( event ) );
296 break;
297 case QEvent::MouseMove:
298 mMapTool->mouseMoveEvent( static_cast<QMouseEvent *>( event ) );
299 break;
300 case QEvent::KeyPress:
301 mMapTool->keyPressEvent( static_cast<QKeyEvent *>( event ) );
302 break;
303 case QEvent::Wheel:
304 mMapTool->mouseWheelEvent( static_cast<QWheelEvent *>( event ) );
305 break;
306 default:
307 break;
308 }
309 return false;
310}
311
313{
314 if ( mTemporalController )
315 disconnect( mTemporalController, &QgsTemporalController::updateTemporalRange, this, &Qgs3DMapCanvas::updateTemporalRange );
316
317 mTemporalController = temporalController;
318 connect( mTemporalController, &QgsTemporalController::updateTemporalRange, this, &Qgs3DMapCanvas::updateTemporalRange );
319}
320
321void Qgs3DMapCanvas::updateTemporalRange( const QgsDateTimeRange &temporalrange )
322{
323 if ( !mScene )
324 return;
325
326 mMapSettings->setTemporalRange( temporalrange );
327 mScene->updateTemporal();
328}
329
330void Qgs3DMapCanvas::onNavigationModeChanged( Qgis::NavigationMode mode )
331{
332 mMapSettings->setCameraNavigationMode( mode );
333}
334
336{
337 if ( !mScene )
338 return;
339
340 mScene->setViewFrom2DExtent( extent );
341}
342
344{
345 return mScene ? mScene->viewFrustum2DExtent() : QVector<QgsPointXY>();
346}
347
349{
350 // we only support point clouds for now
351 if ( layer->type() != Qgis::LayerType::PointCloud )
352 return;
353
354 const QgsGeometry geom = feature.geometry();
355 const QgsPoint pt( geom.vertexAt( 0 ) );
356
357 if ( !mHighlights.contains( layer ) )
358 {
359 QgsRubberBand3D *band = new QgsRubberBand3D( *mMapSettings, mEngine, mEngine->frameGraph()->rubberBandsRootEntity(), Qgis::GeometryType::Point );
360
361 const QgsSettings settings;
362 const QColor color = QColor( settings.value( QStringLiteral( "Map/highlight/color" ), Qgis::DEFAULT_HIGHLIGHT_COLOR.name() ).toString() );
363 band->setColor( color );
364 band->setMarkerType( QgsRubberBand3D::MarkerType::Square );
365 if ( QgsPointCloudLayer3DRenderer *pcRenderer = dynamic_cast<QgsPointCloudLayer3DRenderer *>( layer->renderer3D() ) )
366 {
367 band->setWidth( pcRenderer->symbol()->pointSize() + 1 );
368 }
369 mHighlights.insert( layer, band );
370
371 connect( layer, &QgsMapLayer::renderer3DChanged, this, &Qgs3DMapCanvas::updateHighlightSizes );
372 }
373 mHighlights[layer]->addPoint( pt );
374}
375
376void Qgs3DMapCanvas::updateHighlightSizes()
377{
378 if ( QgsMapLayer *layer = qobject_cast<QgsMapLayer *>( sender() ) )
379 {
380 if ( QgsPointCloudLayer3DRenderer *rnd = dynamic_cast<QgsPointCloudLayer3DRenderer *>( layer->renderer3D() ) )
381 {
382 if ( mHighlights.contains( layer ) )
383 {
384 mHighlights[layer]->setWidth( rnd->symbol()->pointSize() + 1 );
385 }
386 }
387 }
388}
389
391{
392 for ( auto it = mHighlights.keyBegin(); it != mHighlights.keyEnd(); it++ )
393 {
394 disconnect( it.base().key(), &QgsMapLayer::renderer3DChanged, this, &Qgs3DMapCanvas::updateHighlightSizes );
395 }
396
397 qDeleteAll( mHighlights );
398 mHighlights.clear();
399}
static const QColor DEFAULT_HIGHLIGHT_COLOR
Default highlight color.
Definition qgis.h:5856
NavigationMode
The navigation mode used by 3D cameras.
Definition qgis.h:3997
@ 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 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.
virtual void mouseWheelEvent(QWheelEvent *event)
Reimplement to handle mouse wheel 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)