ContentLayer QML Type
Fournit une énumération des couches de contenu disponibles dans un site QtQuick3D. Plus...
| Import Statement: | import QtQuick3D |
| Since: | Qt 6.11 |
Description détaillée
Cette classe est utilisée pour représenter une couche de contenu dans une scène 3D. Elle peut être utilisée pour gérer différentes couches de contenu, telles que l'arrière-plan, l'avant-plan ou les éléments d'interface utilisateur.
L'énumération ContentLayer définit les drapeaux de couche disponibles qui peuvent être utilisés, par exemple, pour regrouper les nœuds de la scène ou filtrer les nœuds rendus par la caméra.
Les noms de calques prédéfinis ne sont pas nécessairement assez descriptifs pour des cas d'utilisation spécifiques. Dans ce cas, vous pouvez définir vos propres calques en utilisant les valeurs de l'énumération ContentLayer. Prenons l'exemple d'une scène urbaine dans laquelle vous disposez de différentes couches pour les bâtiments, les rues et les véhicules. Vous pouvez attribuer à chacune de ces couches un drapeau spécifique, tel que layerBuildings, layerStreets, et layerVehicles en modifiant les valeurs de l'énumération ContentLayer. Une fois les couches définies, vous pouvez attribuer ces drapeaux aux nœuds de la scène et demander à la caméra de filtrer les couches à rendre en définissant la même propriété de couche sur le site Camera.
readonly property int layerBuildings: ContentLayer.Layer1 readonly property int layerStreets: ContentLayer.Layer2 readonly property int layerVehicles: ContentLayer.Layer3 | ContentLayer.Layer4
Remarque : certaines couches ont une signification particulière :
| Couche | Description |
|---|---|
| LayerNone | Aucune couche n'est attribuée, ce qui indique qu'un nœud n'appartient à aucune couche et qu'il ne doit pas être rendu. |
| Couche0 | Le calque principal, utilisé pour le contenu principal de la scène. Les nœuds sont affectés à ce calque par défaut. |
| Couche1-23 | Couches librement attribuables, utilisées pour regrouper les nœuds en fonction de leur objectif ou de leur fonctionnalité. |
| Couche24 et plus | Couches réservées, utilisées à des fins spéciales ou pour des extensions futures. |
| CoucheTout | Indique qu'un nœud appartient à toutes les couches, utilisé pour les nœuds qui doivent être rendus dans toutes les couches. |
Remarque : les couches sont définies comme des drapeaux, ce qui signifie qu'il est possible de combiner plusieurs couches.
Remarque : cette classe n'est pas destinée à être instanciée directement. Elle est utilisée en tant que singleton dans QML pour accéder aux drapeaux des couches.
Voir aussi l'exemple des couches.
© 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.
