Kuesa is running on top of Qt 3D which allows it to fully benefit from all of its features. Qt 3D offers a way to filter part of the scene at render time using instances of the Qt3DRender::QLayer class. Kuesa incorporates support for such layers at several differnent levels.

Creating and Exporting Layers

Using Blender and the gltf Exporter

In Blender, since version 2.80, nodes and geometries are now distributed across collections. If you export using the glTF exporter and the Kuesa Layer extension is enabled, each Collection will result in a distinct layer.

Using layers to filter content

In some cases it might be useful to disable part of the scene or making sure some elements are being draw prior to some others. That's were layers will come in handy.

The [ForwardRenderer] framegraph allows to specify a set of layers. When specified, each layer added will ensure that all elements referencing said layer are drawn before elements referencing the next layer in the list.

If no layers are specified, everything will be drawn. As soon as you start specifying layers however, only the elements that match one or more layers will be rendered.

Keep in mind that the more layers you have and request to be filtered, the more work Qt 3D and Kuesa will be doing.