En esta página

Qt3DRender::QLayerFilter Class

class Qt3DRender::QLayerFilter

Controla 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

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.

ConstanteValorDescripción
Qt3DRender::QLayerFilter::AcceptAnyMatchingLayers0Acepta 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::AcceptAllMatchingLayers1Acepta las entidades que hacen referencia a todos los objetos QLayer añadidos a este QLayerFilter
Qt3DRender::QLayerFilter::DiscardAnyMatchingLayers2Descartar entidades que hagan referencia a uno o más objetos QLayer añadidos a este QLayerFilter
Qt3DRender::QLayerFilter::DiscardAllMatchingLayers3Descartar 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.