Qt3DRender::QLayerFilter Class
class Qt3DRender::QLayerFilterControla las capas dibujadas en una rama del gráfico de marcos. Más...
| Encabezado: | #include <qlayerfilter.h> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS 3drender) target_link_libraries(mytarget PRIVATE Qt6::3drender) |
| qmake: | QT += 3drender |
| En QML: | LayerFilter |
| Heredan de: | Qt3DRender::QFrameGraphNode |
| Estado: | Obsoleto |
Esta clase está obsoleta. Se desaconseja encarecidamente su uso en código nuevo.
Tipos públicos
| enum | FilterMode { AcceptAnyMatchingLayers, AcceptAllMatchingLayers, DiscardAnyMatchingLayers, DiscardAllMatchingLayers } |
Propiedades
- filterMode : FilterMode
Funciones públicas
| QLayerFilter(Qt3DCore::QNode *parent = nullptr) | |
| void | addLayer(Qt3DRender::QLayer *layer) |
| Qt3DRender::QLayerFilter::FilterMode | filterMode() const |
| QList<Qt3DRender::QLayer *> | layers() const |
| void | removeLayer(Qt3DRender::QLayer *layer) |
| void | setFilterMode(Qt3DRender::QLayerFilter::FilterMode filterMode) |
Señales
| void | filterModeChanged(Qt3DRender::QLayerFilter::FilterMode filterMode) |
Descripción detallada
Se puede utilizar un « Qt3DRender::QLayerFilter » para indicar al renderizador qué capa o capas debe dibujar en esa rama del gráfico de fotogramas. QLayerFilter selecciona qué entidades dibujar en función de las instancias de « QLayer » añadidas a QLayerFilter y como componentes de « Qt3DCore::QEntity ».
QLayerFilter puede configurarse para seleccionar o descartar entidades con un QLayer específico en función de la propiedad filterMode. Por defecto, se seleccionan las entidades que hacen referencia a uno de los objetos QLayer a los que también hace referencia el QLayerFilter (AcceptAnyMatchingLayers).
Dentro del árbol FrameGraph, pueden anidarse varios nodos QLayerFilter dentro de una rama que va desde la raíz hasta una hoja. En ese caso, el filtrado se aplicará primero a todas las entidades de la escena utilizando el método de filtrado especificado por el primer QLayerFilter declarado. A continuación, el subconjunto de entidades filtrado se filtrará de nuevo según el método de filtrado establecido en el segundo QLayerFilter declarado. Este proceso se repite hasta que se hayan procesado todos los nodos QLayerFilter de la rama.
Documentación sobre los tipos de miembro
enum QLayerFilter::FilterMode
Especifica las reglas para seleccionar las entidades que se van a dibujar.
| Constante | Valor | Descripción |
|---|---|---|
Qt3DRender::QLayerFilter::AcceptAnyMatchingLayers | 0 | Acepta las entidades que hacen referencia a uno o más objetos de tipo « QLayer » añadidos a este « QLayerFilter ». Este es el valor por defecto |
Qt3DRender::QLayerFilter::AcceptAllMatchingLayers | 1 | Acepta las entidades que hacen referencia a todos los objetos QLayer añadidos a este QLayerFilter |
Qt3DRender::QLayerFilter::DiscardAnyMatchingLayers | 2 | Descartar entidades que hagan referencia a uno o más objetos QLayer añadidos a este QLayerFilter |
Qt3DRender::QLayerFilter::DiscardAllMatchingLayers | 3 | Descartar entidades que hagan referencia a todos los objetos de QLayer añadidos a este QLayerFilter |
Documentación de la propiedad
filterMode : FilterMode
Almacena el modo de filtro que especifica las entidades que se deben seleccionar para el dibujo.
El valor por defecto es AcceptMatchingLayers.
Funciones de acceso:
| Qt3DRender::QLayerFilter::FilterMode | filterMode() const |
| void | setFilterMode(Qt3DRender::QLayerFilter::FilterMode filterMode) |
Señal de notificación:
| void | filterModeChanged(Qt3DRender::QLayerFilter::FilterMode filterMode) |
Documentación de funciones de miembro
[explicit] QLayerFilter::QLayerFilter(Qt3DCore::QNode *parent = nullptr)
El constructor crea una instancia con el ` parent` especificado.
void QLayerFilter::addLayer(Qt3DRender::QLayer *layer)
Añadir « layer » a la lista actual de capas
QList<Qt3DRender::QLayer *> QLayerFilter::layers() const
Devuelve la lista actual de capas
void QLayerFilter::removeLayer(Qt3DRender::QLayer *layer)
Eliminar « layer » de la lista actual 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.