RenderStateSet QML Type

The RenderStateSet FrameGraph node offers a way of specifying a set of RenderState objects to be applied during the execution of a framegraph branch. More...

Import Statement: import Qt3D.Render 2.12
Since: Qt 5.5
Instantiates: QRenderStateSet
Inherits:

FrameGraphNode

Properties

Detailed Description

States set on a RenderStateSet are set globally, contrary to the per-material states that can be set on a RenderPass. By default, an empty RenderStateSet will result in all render states being disabled when executed. Adding a RenderState state explicitly enables that render state at runtime.

The RenderStateSet is enabled when added to the active frame graph:

import Qt3D.Core 2.0
import Qt3D.Render 2.0
import Qt3D.Extras 2.0

Entity {
    id: rootNode
    components: [
        RenderSettings {
            activeFrameGraph: RenderSurfaceSelector {
                ClearBuffers {
                    buffers : ClearBuffers.ColorDepthBuffer

                    CameraSelector {
                        camera: Camera {
                            position: Qt.vector3d(10, 0, 0)
                            viewCenter: Qt.vector3d(0, 0, 0)
                        }
                        RenderStateSet {
                            renderStates: [
                                CullFace { mode: CullFace.Back }
                            ]
                        }
                    }
                }
            }
        }
    ]

    Entity {
        id: sphereEntity
        components: [
            SphereMesh {},
            PhongMaterial {}
        ]
    }
}

See also RenderState and RenderPass.

Property Documentation

renderStates : list<RenderState>

Holds the list of RenderState objects used by the RenderStateSet.


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