- Qt 6.11
- Qt Quick 3D
- QML Types
- ContentLayer
- Qt Quick 3D | Commercial or GPLv3

# ContentLayer QML Type

Provides enumeration of content layers available in a QtQuick3D. More...

Import Statement: | `import QtQuick3D`
Since: | Qt 6.11

- List of all members, including inherited members

## Detailed Description

This class is used to represent a layer of content in a 3D scene. It can be used to manage different layers of content, such as background, foreground, or UI elements.

The ContentLayer enumeration defines the available layer flags that can be used, for example, to group scene nodes together or filter which nodes are rendered by the camera.

The predefined layer names are not necessarily descriptive enough for specific use cases, in which case you can define your own layers by aliasing the ContentLayer enumeration values. Consider a city scene where you have different layers for buildings, streets, and vehicles. You can assign each of these layers a specific flag, such as `layerBuildings`, `layerStreets`, and `layerVehicles` by aliasing the ContentLayer enumeration values. Once the layers are defined, you can assign these flags to the nodes in the scene and have the camera filter which layers to render by setting the same layer property on the Camera.

     readonly property int layerBuildings: ContentLayer.Layer1
     readonly property int layerStreets: ContentLayer.Layer2
     readonly property int layerVehicles: ContentLayer.Layer3 | ContentLayer.Layer4

Note: Some of the layers have special meanings:

Layer | Description
--- | ---
LayerNone | No layer assigned, used to indicate that a node does not belong to any layer and should not be rendered.
Layer0 | The main layer, used for the primary content in the scene. Nodes are assigned to this layer by default.
Layer1-23 | Freely assignable layers, used for grouping nodes together based on their purpose or functionality.
Layer24 and up | Reserved layers, used for special purposes or future extensions.
LayerAll | Indicates that a node belongs to all layers, used for nodes that should be rendered in every layer.

Note: The layers are defined as flags, which means that you can combine multiple layers

Note: This class is not intended to be instantiated directly. Instead, it is used as a singleton in QML to access the layer flags.

See also Layers Example.