ContentLayer QML Type

Singleton, das Ebenen-Flag-Konstanten zum Gruppieren und Filtern von Szenenknoten bereitstellt. Mehr...

Import Statement:	`import QtQuick3D`
Since:	Qt 6.11

Liste aller Mitglieder, einschließlich geerbter Mitglieder

Ausführliche Beschreibung

ContentLayer ist ein Singleton, das die Enumeration „ LayerFlag “ bereitstellt, welche Bit-Flag-Konstanten zur Zuordnung von Knoten zu benannten Inhalts-Layern enthält. Layer können verwendet werden, um Szenenknoten zu gruppieren oder zu filtern, welche Knoten von einer Kamera gerendert werden.

Die vordefinierten Layer-Namen sind nicht unbedingt aussagekräftig für bestimmte Anwendungsfälle. Sie können eigene semantische Layer-Namen definieren, indem Sie den Werten von „ ContentLayer “ Aliase zuweisen. Beispielsweise in einer Stadtszene mit Gebäuden, Straßen und Fahrzeugen:

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

Weisen Sie diese Flags nach der Definition den Knoten über „ Node.layers “ zu und setzen Sie die entsprechenden Flags auf einem „ Camera “, um zu steuern, welche Ebenen gerendert werden.

Hinweis: Einige Ebenen haben eine besondere Bedeutung:

Ebene	Beschreibung
LayerNone	Keine Ebene zugewiesen. Knoten mit diesem Wert gehören zu keiner Ebene und werden nicht gerendert.
Ebene 0	Die standardmäßige Hauptebene. Knoten werden standardmäßig dieser Ebene zugewiesen.
Ebene 1–Ebene 23	Frei zuweisbare Benutzerebenen zum Gruppieren von Knoten nach Zweck oder Funktionalität.
Ebene 24 und höher	Für den internen Gebrauch durch Qt Quick 3D reserviert.
EbeneAll	Trifft auf alle Ebenen zu; Knoten mit diesem Wert werden von jeder Kamera dargestellt.

Hinweis: Ebenen sind Bit-Flags und können mit dem Operator „ | “ kombiniert werden.

Hinweis: Die Layer-Zuweisung wird nicht vererbt; das Setzen von „ Node.layers “ an einem Knoten überträgt den Wert nicht vom übergeordneten Knoten auf den untergeordneten. Jeder Knoten behält seine eigene Layer-Zuweisung bei und muss individuell festgelegt werden.

Hinweis: „ContentLayer“ ist ein Singleton und nicht für die direkte Instanziierung vorgesehen.

Siehe auch Beispiel „Layers“.

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