Sur cette page

RenderablesFilter QML Type

Définit un filtre permettant de sélectionner les éléments de rendu concernés dans un « pass ». En savoir plus…

Import Statement: import QtQuick3D
Since: Qt 6.11
Inherits:

Command

Propriétés

Description détaillée

Le type RenderablesFilter permet de spécifier quels éléments rendables de la scène doivent être affectés par un « RenderPass ». En définissant la propriété « renderableTypes », vous pouvez contrôler si le pass affecte les objets opaques, les objets transparents ou aucun objet.

Il est utile de définir renderableTypes sur None lorsqu’un RenderPass sert de conteneur pour les commandes SubRenderPass et ne doit pas rendre lui-même d’objets de la scène.

En plus du filtrage par types d’éléments affichables, vous pouvez utiliser l’ layerMask pour affiner davantage la sélection des éléments concernés en fonction de l’ layers qui leur est attribuée.

// 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
        }
    ]
}

Documentation sur les propriétés

layerMask : int

Définit le masque de calque pour le filtre. Seuls les éléments affichables des calques spécifiés seront affectés par le filtre.

Voir également Node::layers.

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

Définit les types d'éléments affichables sur lesquels le filtre aura un effet.

ConstanteDescription
RenderablesFilter.NoneAucun élément de rendu ne sera rendu. Utile pour les passes de conteneur qui ne comportent que des SubRenderPasses.
RenderablesFilter.OpaqueSeuls les éléments de rendu opaques seront rendus.
RenderablesFilter.TransparentSeuls les éléments de rendu transparents seront rendus.

Remarque : plusieurs valeurs peuvent être combinées à l'aide de l'opérateur |.

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