QRenderSettings Class | Qt 3D 5.12.7

Qt 5.12 | Qt 3D | C++ Classes | QRenderSettings

Qt 5.12.7 Reference Documentation

# 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

- List of all members, including inherited members
- Obsolete members

## Public Types

enum | RenderPolicy { OnDemand, Always }

## Properties

- activeFrameGraph : Qt3DRender::QFrameGraphNode*
- pickingSettings : Qt3DRender::QPickingSettings* const
- renderPolicy : RenderPolicy

- 1 property inherited from Qt3DCore::QComponent
- 3 properties inherited from Qt3DCore::QNode
- 1 property inherited from QObject

## Public Functions

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

- 2 public functions inherited from Qt3DCore::QComponent
- 13 public functions inherited from Qt3DCore::QNode
- 31 public functions inherited from QObject

## Public Slots

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

- 1 public slot inherited from Qt3DCore::QComponent
- 3 public slots inherited from Qt3DCore::QNode
- 1 public slot inherited from QObject

## Signals

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

- 3 signals inherited from Qt3DCore::QComponent
- 4 signals inherited from Qt3DCore::QNode
- 2 signals inherited from QObject

## Static Public Members

const QMetaObject | staticMetaObject

- 9 static public members inherited from QObject

### Additional Inherited Members

- 2 protected functions inherited from Qt3DCore::QNode
- 9 protected functions inherited from QObject

## 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.

Constant | Value | Description
--- | --- | ---
`Qt3DRender::QRenderSettings::OnDemand` | `0` | The FrameGraph is rendered only when something changes.
`Qt3DRender::QRenderSettings::Always` | `1` | The 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.