QgsOffscreen3DEngine Class Reference

3 Off-screen 3D engine implementation. More...

#include <qgsoffscreen3dengine.h>

Inheritance diagram for QgsOffscreen3DEngine:

Public Member Functions
	QgsOffscreen3DEngine ()
	~QgsOffscreen3DEngine () override
Qt3DRender::QCamera *	camera () override
	Returns pointer to the engine's camera entity. More...
Qt3DRender::QRenderSettings *	renderSettings () override
	Returns access to the engine's render settings (the frame graph can be accessed from here) More...
void	requestCaptureImage () override
	Starts a request for an image rendered by the engine. More...
void	setClearColor (const QColor &color) override
	Sets background color of the scene. More...
void	setFrustumCullingEnabled (bool enabled) override
	Sets whether frustum culling is enabled (this should make rendering faster by not rendering entities outside of camera's view) More...
void	setRootEntity (Qt3DCore::QEntity *root) override
	Sets root entity of the 3D scene. More...
void	setSize (QSize s)
	Sets the size of the rendering area (in pixels) More...
QSize	size () const override
	Returns size of the engine's rendering area in pixels. More...
QSurface *	surface () const override
	Returns the surface of the engine. More...
Public Member Functions inherited from QgsAbstract3DEngine
	QgsAbstract3DEngine (QObject *parent=nullptr)
	Constructor for QgsAbstract3DEngine with the specified parent object. More...

Additional Inherited Members
Signals inherited from QgsAbstract3DEngine
void	imageCaptured (const QImage &image)
	Emitted after a call to requestCaptureImage() to return the captured image. More...

Detailed Description

3 Off-screen 3D engine implementation.

It is useful for recording rendered 3D scenes of arbitrary size.

Note

While the on-screen 3D engine also allows capturing of images, its limitation is that the captured images are of the size of the on-screen window.

Not available in Python bindings

Since

QGIS 3.4

Definition at line 64 of file qgsoffscreen3dengine.h.

Constructor & Destructor Documentation

QgsOffscreen3DEngine()

QgsOffscreen3DEngine::QgsOffscreen3DEngine

(

)

Definition at line 39 of file qgsoffscreen3dengine.cpp.

~QgsOffscreen3DEngine()

QgsOffscreen3DEngine::~QgsOffscreen3DEngine ( )

override

Definition at line 101 of file qgsoffscreen3dengine.cpp.

Member Function Documentation

camera()

Qt3DRender::QCamera * QgsOffscreen3DEngine::camera ( )

overridevirtual

Returns pointer to the engine's camera entity.

Implements QgsAbstract3DEngine.

Definition at line 223 of file qgsoffscreen3dengine.cpp.

renderSettings()

Qt3DRender::QRenderSettings * QgsOffscreen3DEngine::renderSettings ( )

overridevirtual

Returns access to the engine's render settings (the frame graph can be accessed from here)

Implements QgsAbstract3DEngine.

Definition at line 218 of file qgsoffscreen3dengine.cpp.

requestCaptureImage()

void QgsOffscreen3DEngine::requestCaptureImage ( )

overridevirtual

Starts a request for an image rendered by the engine.

The function does not block - when the rendered image is captured, it is returned in imageCaptured() signal. Only one image request can be active at a time.

Implements QgsAbstract3DEngine.

Definition at line 238 of file qgsoffscreen3dengine.cpp.

setClearColor()

void QgsOffscreen3DEngine::setClearColor ( const QColor &  color )

overridevirtual

Sets background color of the scene.

Implements QgsAbstract3DEngine.

Definition at line 118 of file qgsoffscreen3dengine.cpp.

setFrustumCullingEnabled()

void QgsOffscreen3DEngine::setFrustumCullingEnabled ( bool  enabled )

overridevirtual

Sets whether frustum culling is enabled (this should make rendering faster by not rendering entities outside of camera's view)

Implements QgsAbstract3DEngine.

Definition at line 123 of file qgsoffscreen3dengine.cpp.

setRootEntity()

void QgsOffscreen3DEngine::setRootEntity ( Qt3DCore::QEntity *  root )

overridevirtual

Sets root entity of the 3D scene.

Implements QgsAbstract3DEngine.

Definition at line 205 of file qgsoffscreen3dengine.cpp.

setSize()

void QgsOffscreen3DEngine::setSize

(

QSize

s

)

Sets the size of the rendering area (in pixels)

Definition at line 107 of file qgsoffscreen3dengine.cpp.

size()

QSize QgsOffscreen3DEngine::size ( ) const

overridevirtual

Returns size of the engine's rendering area in pixels.

Implements QgsAbstract3DEngine.

Definition at line 228 of file qgsoffscreen3dengine.cpp.

surface()

QSurface * QgsOffscreen3DEngine::surface ( ) const

overridevirtual

Returns the surface of the engine.

Since

QGIS 3.14

Implements QgsAbstract3DEngine.

Definition at line 233 of file qgsoffscreen3dengine.cpp.

---

The documentation for this class was generated from the following files:

• /build/qgis-3.16.0+99unstable/src/3d/qgsoffscreen3dengine.h
• /build/qgis-3.16.0+99unstable/src/3d/qgsoffscreen3dengine.cpp