ContentLayer QML Type
Bietet eine Aufzählung der in einer QtQuick3D verfügbaren Inhaltsebenen.
| Import Statement: | import QtQuick3D |
| Since: | Qt 6.11 |
Detaillierte Beschreibung
Diese Klasse wird verwendet, um eine Inhaltsebene in einer 3D-Szene darzustellen. Sie kann verwendet werden, um verschiedene Inhaltsebenen zu verwalten, wie z. B. Hintergrund, Vordergrund oder UI-Elemente.
Die Aufzählung ContentLayer definiert die verfügbaren Layer-Flags, die z.B. verwendet werden können, um Szenenknoten zu gruppieren oder zu filtern, welche Knoten von der Kamera gerendert werden.
Die vordefinierten Ebenennamen sind für bestimmte Anwendungsfälle nicht unbedingt aussagekräftig genug. In diesem Fall können Sie Ihre eigenen Ebenen definieren, indem Sie die Werte der ContentLayer Aufzählung aliasieren. Nehmen wir eine Stadtszene, in der Sie verschiedene Ebenen für Gebäude, Straßen und Fahrzeuge haben. Sie können jeder dieser Ebenen ein bestimmtes Kennzeichen zuweisen, z. B. layerBuildings, layerStreets und layerVehicles, indem Sie die Aufzählungswerte von ContentLayer als Alias verwenden. Sobald die Ebenen definiert sind, können Sie diese Flaggen den Knoten in der Szene zuweisen und die Kamera filtern lassen, welche Ebenen gerendert werden sollen, indem Sie die gleiche Ebeneneigenschaft auf Camera einstellen.
readonly property int layerBuildings: ContentLayer.Layer1 readonly property int layerStreets: ContentLayer.Layer2 readonly property int layerVehicles: ContentLayer.Layer3 | ContentLayer.Layer4
Hinweis: Einige der Ebenen haben besondere Bedeutungen:
| Ebene | Beschreibung |
|---|---|
| EbeneKeine | Keine Ebene zugewiesen, wird verwendet, um anzuzeigen, dass ein Knoten zu keiner Ebene gehört und nicht gerendert werden soll. |
| Ebene0 | Die Hauptebene, die für den primären Inhalt der Szene verwendet wird. Knoten werden standardmäßig dieser Ebene zugewiesen. |
| Ebene1-23 | Frei zuweisbare Ebenen, die für die Gruppierung von Knoten auf der Grundlage ihres Zwecks oder ihrer Funktionalität verwendet werden. |
| Ebene24 und höher | Reservierte Ebenen, die für spezielle Zwecke oder zukünftige Erweiterungen verwendet werden. |
| EbeneAlle | Zeigt an, dass ein Knoten zu allen Ebenen gehört; wird für Knoten verwendet, die in jeder Ebene gerendert werden sollen. |
Hinweis: Die Ebenen werden als Flags definiert, was bedeutet, dass Sie mehrere Ebenen kombinieren können.
Hinweis: Diese Klasse ist nicht dazu gedacht, direkt instanziiert zu werden. Stattdessen wird sie als Singleton in QML verwendet, um auf die Layer-Flags zuzugreifen.
Siehe auch Layers Example.
© 2026 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.
