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