QGIS API Documentation 3.41.0-Master (af5edcb665c)
Loading...
Searching...
No Matches
qgsabstract3dengine.h
Go to the documentation of this file.
1/***************************************************************************
2 qgsabstract3dengine.h
3 --------------------------------------
4 Date : July 2018
5 Copyright : (C) 2018 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#ifndef QGSABSTRACT3DENGINE_H
17#define QGSABSTRACT3DENGINE_H
18
19#include "qgis_3d.h"
20
21#include <QObject>
22#include <QElapsedTimer>
23
24#define SIP_NO_FILE
25
26class QColor;
27class QRect;
28class QSurface;
29
30namespace Qt3DCore
31{
32 class QEntity;
33}
34
35namespace Qt3DRender
36{
37 class QRenderSettings;
38 class QCamera;
39 class QFrameGraphNode;
40} // namespace Qt3DRender
41
42class QgsFrameGraph;
43
60class _3D_EXPORT QgsAbstract3DEngine : public QObject
61{
62 Q_OBJECT
63 public:
67 QgsAbstract3DEngine( QObject *parent = nullptr );
68
70 virtual void setClearColor( const QColor &color ) = 0;
72 virtual void setFrustumCullingEnabled( bool enabled ) = 0;
74 virtual void setRootEntity( Qt3DCore::QEntity *root ) = 0;
75
77 virtual Qt3DRender::QRenderSettings *renderSettings() = 0;
79 virtual Qt3DRender::QCamera *camera() = 0;
81 virtual QSize size() const = 0;
83 virtual void setSize( QSize s ) = 0;
84
90 void requestDepthBufferCapture();
91
97 void requestCaptureImage();
98
104 virtual QSurface *surface() const = 0;
105
111 QgsFrameGraph *frameGraph() { return mFrameGraph; }
112
120 void setRenderCaptureEnabled( bool enabled );
121
126 bool renderCaptureEnabled() const;
127
131 void dumpFrameGraphToConsole() const;
132
134 QString dumpFrameGraph() const;
135
137 QString dumpSceneGraph() const;
138
139 signals:
141 void imageCaptured( const QImage &image );
142
148 void depthBufferCaptured( const QImage &image );
149
155
156 protected:
157 QgsFrameGraph *mFrameGraph = nullptr;
158};
159
160
161#endif // QGSABSTRACT3DENGINE_H
void sizeChanged()
Emitted after a call to setSize()
void imageCaptured(const QImage &image)
Emitted after a call to requestCaptureImage() to return the captured image.
virtual QSurface * surface() const =0
Returns the surface of the engine.
void depthBufferCaptured(const QImage &image)
Emitted after a call to requestDepthBufferCapture() to return the captured depth buffer.
virtual Qt3DRender::QCamera * camera()=0
Returns pointer to the engine's camera entity.
virtual void setClearColor(const QColor &color)=0
Sets background color of the scene.
virtual void setSize(QSize s)=0
Sets the size of the rendering area (in pixels)
virtual void setFrustumCullingEnabled(bool enabled)=0
Sets whether frustum culling is enabled (this should make rendering faster by not rendering entities ...
QgsFrameGraph * frameGraph()
Returns the shadow rendering frame graph object used to render the scene.
virtual void setRootEntity(Qt3DCore::QEntity *root)=0
Sets root entity of the 3D scene.
virtual QSize size() const =0
Returns size of the engine's rendering area in pixels.
virtual Qt3DRender::QRenderSettings * renderSettings()=0
Returns access to the engine's render settings (the frame graph can be accessed from here)