En esta página

RenderablesFilter QML Type

Define un filtro para seleccionar a qué elementos renderizables afecta en un ` pass`. Más información...

Import Statement: import QtQuick3D
Since: Qt 6.11
Inherits:

Command

Propiedades

Descripción detallada

El tipo RenderablesFilter se utiliza para especificar qué elementos renderizables de la escena deben verse afectados por un « RenderPass ». Al establecer la propiedad « renderableTypes », puedes controlar si el paso afecta a objetos opacos, a objetos transparentes o a ningún objeto.

Establecer ` renderableTypes ` en ` None ` resulta útil cuando un ` RenderPass ` actúa como contenedor de comandos ` SubRenderPass ` y no debe renderizar ningún objeto de la escena por sí mismo.

Además de filtrar por tipos de objetos renderizables, puedes utilizar la propiedad « layerMask » para refinar aún más qué objetos renderizables se ven afectados en función de su « layers » asignado.

// A pass that renders only opaque scene objects
RenderPass {
    id: opaquePass
    commands: [
        ColorAttachment { name: "color0"; target: opaqueColorTexture },
        DepthTextureAttachment { target: depthTexture },
        RenderablesFilter {
            renderableTypes: RenderablesFilter.Opaque
        }
    ]
}

// A pass that renders only transparent objects on top
RenderPass {
    id: transparentPass
    commands: [
        ColorAttachment { name: "color0"; target: transparentColorTexture },
        RenderablesFilter {
            renderableTypes: RenderablesFilter.Transparent
        }
    ]
}

Documentación de propiedades

layerMask : int

Establece la máscara de capa para el filtro. Solo los elementos renderizables de las capas especificadas se verán afectados por el filtro.

Véase también Node::layers.

renderableTypes : enumeration [default: RenderablesFilter.Opaque | RenderablesFilter.Transparent]

Establece los tipos de elementos renderizables sobre los que actuará el filtro.

ConstanteDescripción
RenderablesFilter.NoneNo se renderizará ningún elemento renderizable. Útil para pasadas de contenedor que solo tengan SubRenderPasses.
RenderablesFilter.OpaqueSolo se renderizarán los elementos opacos.
RenderablesFilter.TransparentSolo se renderizarán los elementos renderizables transparentes.

Nota: Se pueden combinarvarios valores utilizando el operador |.

© 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.