En esta página

ContentLayer QML Type

Singleton que proporciona constantes de indicadores de capa para agrupar y filtrar nodos de escena. Más...

Import Statement: import QtQuick3D
Since: Qt 6.11

Descripción detallada

ContentLayer es un singleton que expone la enumeración LayerFlag, la cual proporciona constantes de indicadores de bits para asignar nodos a capas de contenido con nombre. Las capas se pueden utilizar para agrupar nodos de escena o para filtrar qué nodos son renderizados por una cámara.

Los nombres de capa predefinidos no son necesariamente descriptivos para casos de uso específicos. Puedes definir tus propios nombres semánticos de capa asignando alias a los valores de ` ContentLayer `. Por ejemplo, en una escena urbana con edificios, calles y vehículos:

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

Una vez definidos, asigne estos indicadores a los nodos mediante « Node.layers » y establezca los indicadores correspondientes en un « Camera » para controlar qué capas se renderizan.

Nota: Algunas capas tienen significados especiales:

CapaDescripción
LayerNoneNo hay ninguna capa asignada. Los nodos con este valor no pertenecen a ninguna capa y no se representan.
Capa 0La capa principal por defecto. Los nodos se asignan a esta capa de forma predeterminada.
Capa 1–Capa 23Capas de usuario libremente asignables para agrupar nodos por finalidad o funcionalidad.
Capa 24 y superioresReservadas para uso interno de Qt Quick 3D.
Capa «All»Coincide con todas las capas; los nodos con este valor se renderizan con todas las cámaras.

Nota: Las capas son indicadores de bits y se pueden combinar con el operador « | ».

Nota: La asignaciónde capas no se hereda; establecer « Node.layers » en un nodo no propaga el valor de padre a hijo. Cada nodo mantiene su propia asignación de capas y debe configurarse individualmente.

Nota: ContentLayer es un singleton y no está pensado para ser instanciado directamente.

Véase también el 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.