ContentLayer QML Type
Proporciona una enumeración de las capas de contenido disponibles en QtQuick3D. Más...
| Import Statement: | import QtQuick3D |
| Since: | Qt 6.11 |
Descripción detallada
Esta clase se utiliza para representar una capa de contenido en una escena 3D. Puede utilizarse para gestionar diferentes capas de contenido, como fondo, primer plano o elementos de interfaz de usuario.
La enumeración ContentLayer define las banderas de capa disponibles que pueden utilizarse, por ejemplo, para agrupar nodos de escena o filtrar qué nodos son renderizados por la cámara.
Los nombres predefinidos de las capas no son necesariamente lo suficientemente descriptivos para casos de uso específicos, en cuyo caso puedes definir tus propias capas mediante el alias de los valores de la enumeración ContentLayer. Considere una escena de ciudad donde tiene diferentes capas para edificios, calles y vehículos. Puede asignar a cada una de estas capas una bandera específica, como layerBuildings, layerStreets, y layerVehicles mediante el alias de los valores de enumeración ContentLayer. Una vez definidas las capas, puede asignar estas banderas a los nodos de la escena y hacer que la cámara filtre qué capas renderizar estableciendo la misma propiedad de capa en Camera.
readonly property int layerBuildings: ContentLayer.Layer1 readonly property int layerStreets: ContentLayer.Layer2 readonly property int layerVehicles: ContentLayer.Layer3 | ContentLayer.Layer4
Nota: Algunas de las capas tienen significados especiales:
| Capa | Descripción |
|---|---|
| CapaNinguna | No tiene capa asignada, se utiliza para indicar que un nodo no pertenece a ninguna capa y no debe ser renderizado. |
| Capa0 | La capa principal, utilizada para el contenido primario de la escena. Los nodos se asignan a esta capa por defecto. |
| Capa1-23 | Capas de asignación libre, utilizadas para agrupar nodos en función de su propósito o funcionalidad. |
| Capa24 y superiores | Capas reservadas, utilizadas para propósitos especiales o futuras extensiones. |
| CapaToda | Indica que un nodo pertenece a todas las capas, se utiliza para nodos que deben renderizarse en todas las capas. |
Nota: Las capas se definen como banderas, lo que significa que se pueden combinar múltiples capas.
Nota: Esta clase no está pensada para ser instanciada directamente. En su lugar, se utiliza como un singleton en QML para acceder a las banderas de capa.
Véase también Ejemplo de capas.
© 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.
