Qt 5.11 | Qt 3D | QML Types | RenderStateSet QML Type

Qt 5.11.3 Reference Documentation

# 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.0
Since: | Qt 5.5
Instantiates: | QRenderStateSet
Inherits: | FrameGraphNode

- List of all members, including inherited members

## Properties

- renderStates : list<RenderState>

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