ContentLayer QML Type
Singleton fournissant des constantes de drapeaux de calque pour le regroupement et le filtrage des nœuds de scène. En savoir plus…
| Import Statement: | import QtQuick3D |
| Since: | Qt 6.11 |
Description détaillée
ContentLayer est un singleton qui expose l’énumération LayerFlag, laquelle fournit des constantes de drapeaux binaires permettant d’affecter des nœuds à des couches de contenu nommées. Les couches peuvent être utilisées pour regrouper des nœuds de scène ou pour filtrer les nœuds rendus par une caméra.
Les noms de couches prédéfinis ne sont pas nécessairement descriptifs pour des cas d’utilisation spécifiques. Vous pouvez définir vos propres noms de couches sémantiques en créant des alias pour les valeurs de ` ContentLayer `. Par exemple, dans une scène urbaine comportant des bâtiments, des rues et des véhicules :
readonly property int layerBuildings: ContentLayer.Layer1
readonly property int layerStreets: ContentLayer.Layer2
readonly property int layerVehicles: ContentLayer.Layer3 | ContentLayer.Layer4Une fois définis, attribuez ces indicateurs aux nœuds via ` Node.layers ` et activez les indicateurs correspondants sur une ` Camera ` pour contrôler les couches qu’elle affiche.
Remarque : certaines couches ont une signification particulière :
| Calque | Description |
|---|---|
| LayerNone | Aucun calque attribué. Les nœuds ayant cette valeur n'appartiennent à aucun calque et ne sont pas affichés. |
| Couche 0 | Le calque principal par défaut. Les nœuds sont affectés à ce calque par défaut. |
| Couche 1 à Couche 23 | Couches utilisateur librement attribuables permettant de regrouper les nœuds par objectif ou par fonctionnalité. |
| Couche 24 et suivantes | Réservées à l’usage interne d’ Qt Quick 3D. |
| CoucheAll | Correspond à toutes les couches ; les nœuds ayant cette valeur sont rendus par toutes les caméras. |
Remarque : les couches sont des indicateurs binaires et peuvent être combinées avec l'opérateur « | ».
Remarque : l’affectationde couche n’est pas héritée ; définir « Node.layers » sur un nœud ne propage pas la valeur du parent vers l’enfant. Chaque nœud conserve sa propre affectation de couche et doit être défini individuellement.
Remarque : ContentLayer est un singleton et n’est pas destiné à être instancié directement.
© 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.
