QRenderSettings Class

(Qt3DRender::QRenderSettings)

The QRenderSettings class holds settings related to rendering process and host the active FrameGraph. More...

Header: #include <QRenderSettings>
qmake: QT += 3drender
Since: Qt 5.7
Instantiated By: RenderSettings
Inherits: Qt3DCore::QComponent

Public Types

enum RenderPolicy { OnDemand, Always }

Properties

Public Functions

QRenderSettings(Qt3DCore::QNode *parent = nullptr)
Qt3DRender::QFrameGraphNode *activeFrameGraph() const
Qt3DRender::QPickingSettings *pickingSettings()
Qt3DRender::QRenderSettings::RenderPolicy renderPolicy() const

Public Slots

void setActiveFrameGraph(Qt3DRender::QFrameGraphNode *activeFrameGraph)
void setRenderPolicy(Qt3DRender::QRenderSettings::RenderPolicy renderPolicy)

Signals

void activeFrameGraphChanged(Qt3DRender::QFrameGraphNode *activeFrameGraph)
void renderPolicyChanged(Qt3DRender::QRenderSettings::RenderPolicy renderPolicy)

Static Public Members

const QMetaObject staticMetaObject
  • 9 static public members inherited from QObject

Additional Inherited Members

Detailed Description

The QRenderSettings class holds settings related to rendering process and host the active FrameGraph.

The QRenderSettings component must be set as a component of the scene root entity. It specifies render policy and picking settings, as well as hosts the active FrameGraph.

Member Type Documentation

enum QRenderSettings::RenderPolicy

The render policy.

ConstantValueDescription
Qt3DRender::QRenderSettings::OnDemand0The FrameGraph is rendered only when something changes.
Qt3DRender::QRenderSettings::Always1The FrameGraph is rendered continuously, even if nothing has changed.

Property Documentation

activeFrameGraph : Qt3DRender::QFrameGraphNode*

Holds the currently active FrameGraph.

Access functions:

Qt3DRender::QFrameGraphNode *activeFrameGraph() const
void setActiveFrameGraph(Qt3DRender::QFrameGraphNode *activeFrameGraph)

Notifier signal:

void activeFrameGraphChanged(Qt3DRender::QFrameGraphNode *activeFrameGraph)

pickingSettings : Qt3DRender::QPickingSettings* const

Holds the current pick settings for the FrameGraph.

Access functions:

Qt3DRender::QPickingSettings *pickingSettings()

renderPolicy : RenderPolicy

Holds the current render policy.

Access functions:

Qt3DRender::QRenderSettings::RenderPolicy renderPolicy() const
void setRenderPolicy(Qt3DRender::QRenderSettings::RenderPolicy renderPolicy)

Notifier signal:

void renderPolicyChanged(Qt3DRender::QRenderSettings::RenderPolicy renderPolicy)

Member Function Documentation

QRenderSettings::QRenderSettings(Qt3DCore::QNode *parent = nullptr)

Default constructs an instance of QRenderSettings.

© 2021 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.