QSGAbstractRenderer Class

QSGAbstractRenderer gives access to the scene graph nodes and rendering of a QSGEngine. More...

Header: #include <QSGAbstractRenderer>
qmake: QT += quick
Since: Qt 5.4
Inherits: QObject

This class was introduced in Qt 5.4.

Public Types

flags ClearMode
enum ClearModeBit { ClearColorBuffer, ClearDepthBuffer, ClearStencilBuffer }
enum MatrixTransformFlag { MatrixTransformFlipY }
flags MatrixTransformFlags

Public Functions

QColor clearColor() const
ClearMode clearMode() const
QRect deviceRect() const
QMatrix4x4 projectionMatrix() const
virtual void renderScene(uint fboId = 0) = 0
QSGRootNode *rootNode() const
void setClearColor(const QColor &color)
void setClearMode(ClearMode mode)
void setDeviceRect(const QRect &rect)
void setDeviceRect(const QSize &size)
void setProjectionMatrix(const QMatrix4x4 &matrix)
void setProjectionMatrixToRect(const QRectF &rect)
void setProjectionMatrixToRect(const QRectF &rect, MatrixTransformFlags flags)
void setRootNode(QSGRootNode *node)
void setViewportRect(const QRect &rect)
void setViewportRect(const QSize &size)
QRect viewportRect() const

Signals

Detailed Description

A QSGAbstractRenderer created by a QSGEngine allows you to set your QSGNode tree through setRootNode() and control the rendering viewport through setDeviceRect(), setViewportRect() and setProjectionMatrixToRect(). You can finally trigger the rendering to the desired framebuffer through renderScene().

The QSGAbstractRenderer is only available when used with a QSGEngine and isn't exposed when used internally by QQuickWindow.

See also QSGEngine and QSGNode.

Member Type Documentation

enum QSGAbstractRenderer::ClearModeBit
flags QSGAbstractRenderer::ClearMode

Used with setClearMode() to indicate which buffer should be cleared before the scene render.

ConstantValueDescription
QSGAbstractRenderer::ClearColorBuffer0x0001Clear the color buffer using clearColor().
QSGAbstractRenderer::ClearDepthBuffer0x0002Clear the depth buffer.
QSGAbstractRenderer::ClearStencilBuffer0x0004Clear the stencil buffer.

The ClearMode type is a typedef for QFlags<ClearModeBit>. It stores an OR combination of ClearModeBit values.

See also setClearMode() and setClearColor().

enum QSGAbstractRenderer::MatrixTransformFlag
flags QSGAbstractRenderer::MatrixTransformFlags

Used with setProjectionMatrixToRect() to indicate the expectations towards the generated projection matrix.

ConstantValueDescription
QSGAbstractRenderer::MatrixTransformFlipY0x01The traditional assumption in Qt Quick is that Y points up in the normalized device coordinate system. There is at least one modern graphics API where this is not the case (Vulkan). This flag can then be used to get a projection that is appropriate for such an API.

This enum was introduced or modified in Qt 5.14.

The MatrixTransformFlags type is a typedef for QFlags<MatrixTransformFlag>. It stores an OR combination of MatrixTransformFlag values.

See also setProjectionMatrixToRect().

Member Function Documentation

[signal] void QSGAbstractRenderer::sceneGraphChanged()

This signal is emitted on the first modification of a node in the tree after the last scene render.

QColor QSGAbstractRenderer::clearColor() const

Returns the color that clears the framebuffer at the beginning of the rendering.

See also setClearColor() and clearMode().

ClearMode QSGAbstractRenderer::clearMode() const

Flags defining which attachment of the framebuffer will be cleared before each scene render.

See also setClearMode() and clearColor().

QRect QSGAbstractRenderer::deviceRect() const

Returns the device rect of the surface being rendered to.

See also setDeviceRect().

QMatrix4x4 QSGAbstractRenderer::projectionMatrix() const

Returns the projection matrix

See also setProjectionMatrix() and setProjectionMatrixToRect().

[pure virtual] void QSGAbstractRenderer::renderScene(uint fboId = 0)

Render the scene to the specified fboId

If fboId isn't specified, the scene graph will be rendered to the default framebuffer. You will have to call QOpenGLContext::swapBuffers() yourself afterward.

The framebuffer specified by fboId will be bound automatically.

See also QOpenGLContext::swapBuffers() and QOpenGLFramebufferObject::handle().

QSGRootNode *QSGAbstractRenderer::rootNode() const

Returns the root of the QSGNode scene.

See also setRootNode().

void QSGAbstractRenderer::setClearColor(const QColor &color)

Use color to clear the framebuffer when clearMode() is set to QSGAbstractRenderer::ClearColorBuffer.

See also clearColor() and setClearMode().

void QSGAbstractRenderer::setClearMode(ClearMode mode)

Defines which attachment of the framebuffer should be cleared before each scene render with the mode flag.

See also clearMode() and setClearColor().

void QSGAbstractRenderer::setDeviceRect(const QRect &rect)

Sets rect as the geometry of the surface being rendered to.

See also deviceRect().

void QSGAbstractRenderer::setDeviceRect(const QSize &size)

This is an overloaded function.

Sets the size of the surface being rendered to.

See also deviceRect().

void QSGAbstractRenderer::setProjectionMatrix(const QMatrix4x4 &matrix)

Use matrix to project the QSGNode coordinates onto surface pixels.

See also projectionMatrix() and setProjectionMatrixToRect().

void QSGAbstractRenderer::setProjectionMatrixToRect(const QRectF &rect)

Convenience method that calls setProjectionMatrix() with an orthographic matrix generated from rect.

Note: This function assumes that the graphics API uses Y up in its normalized device coordinate system.

See also setProjectionMatrix() and projectionMatrix().

void QSGAbstractRenderer::setProjectionMatrixToRect(const QRectF &rect, MatrixTransformFlags flags)

Convenience method that calls setProjectionMatrix() with an orthographic matrix generated from rect.

Set MatrixTransformFlipY in flags when the graphics API uses Y down in its normalized device coordinate system (for example, Vulkan).

This function was introduced in Qt 5.14.

See also setProjectionMatrix() and projectionMatrix().

void QSGAbstractRenderer::setRootNode(QSGRootNode *node)

Sets the node as the root of the QSGNode scene that you want to render. You need to provide a node before trying to render the scene.

Note: This doesn't take ownership of node.

See also rootNode().

void QSGAbstractRenderer::setViewportRect(const QRect &rect)

Sets rect as the geometry of the viewport to render on the surface.

See also viewportRect().

void QSGAbstractRenderer::setViewportRect(const QSize &size)

This is an overloaded function.

Sets the size of the viewport to render on the surface.

See also viewportRect().

QRect QSGAbstractRenderer::viewportRect() const

Returns the rect of the viewport to render.

See also setViewportRect().