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: |
Propriétés
- layerMask : int
- renderableTypes : enumeration
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.
| Constante | Description |
|---|---|
RenderablesFilter.None | Aucun élément de rendu ne sera rendu. Utile pour les passes de conteneur qui ne comportent que des SubRenderPasses. |
RenderablesFilter.Opaque | Seuls les éléments de rendu opaques seront rendus. |
RenderablesFilter.Transparent | Seuls 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.