Sur cette page

RenderPass QML Type

Encapsule un Render Pass. En savoir plus…

Import Statement: import Qt3D.Render 2.12
In C++: QRenderPass
Inherits:

Node

Status: Deprecated

Ce type est obsolète. Nous déconseillons fortement de l'utiliser dans du nouveau code.

Propriétés

Description détaillée

Un RenderPass spécifie un passage de rendu unique (une instance d’exécution d’un programme de shader) utilisé par Technique. Un RenderPass se compose d’un ShaderProgram et d’une liste d’objets FilterKey, d’une liste d’objets RenderState et d’une liste d’objets Parameter.

RenderPass exécute l’ ShaderProgram à l’aide des nœuds RenderState et Parameter fournis lorsque au moins l’un des nœuds FilterKey référencés correspond à l’un des nœuds FilterKey du RenderPassFilter ou lorsqu’aucun RenderPassFilter n’est présent dans le FrameGraph.

Si le RenderPass définit un Parameter, celui-ci sera remplacé par un Parameter portant le même nom s’il existe dans l’un des nœuds Technique, Effect, Material, TechniqueFilter ou RenderPassFilter associés au pass lors de l’exécution. Cela peut néanmoins s’avérer utile pour définir des valeurs par défaut raisonnables.

Au moment du rendu, pour chaque nœud feuille du FrameGraph, un état de rendu de base est enregistré en accumulant les états définis par tous les nœuds « RenderStateSet » de la branche du FrameGraph. Chaque RenderPass peut redéfinir cet état de rendu de base en spécifiant ses propres nœuds « RenderState ».

Technique {
    filterKeys: [
        FilterKey { name: "renderingStyle"; value: "forward" }
    ]
    graphicsApiFilter: {
        api: GraphicsApiFilter.OpenGL
        profile: GraphicsApiFilter.CoreProfile
        majorVersion: 3
        minorVersion: 1
    }
    renderPasses: [
        RenderPass {
            id: pass
            shaderProgram: ShaderProgram {
                // ...
            }
            parameters: [
                Parameter { name: "color"; value: "red" }
            ]
            renderStates: [
                DepthTest {}
            ]
        }
    ]
}

Voir également RenderPassFilter, FilterKey, Parameter, RenderState, Effect et Technique.

Documentation relative aux biens immobiliers

filterKeys : list<FilterKey>

Contient les clés de filtre permettant d'utiliser ce passage de rendu.

parameters : list<Parameter>

Contient les valeurs des paramètres du shader utilisés par le passage de rendu.

renderStates : list<RenderState>

Contient les états de rendu utilisés par la passe de rendu.

shaderProgram : ShaderProgram

Contient le programme de shader à utiliser pour ce passage de rendu.

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