Sur cette page

RenderPass QML Type

Encapsule une passe de rendu. Plus d'informations...

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

Node

Status: Deprecated

Propriétés

Description détaillée

Un RenderPass spécifie une seule passe de rendu - une instance d'exécution du programme de shaders - utilisée par Technique. Une passe de rendu se compose de ShaderProgram et d'une liste d'objets FilterKey, d'une liste d'objets RenderState et d'une liste d'objets Parameter.

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

Si le RenderPass définit un paramètre, il sera remplacé par un paramètre portant le même nom s'il existe dans l'une des techniques, effets, matériaux, TechniqueFilter, RenderPassFilter associés au passage au moment de l'exécution. Cela peut toujours être utile pour définir des valeurs par défaut saines.

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 FrameGraph. Chaque RenderPass peut surcharger 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 sur les propriétés

filterKeys : list<FilterKey>

Contient les clés de filtrage permettant l'utilisation de cette passe de rendu.

parameters : list<Parameter>

Contient les valeurs des paramètres de l'ombrage utilisées par la passe de rendu.

renderStates : list<RenderState>

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

shaderProgram : ShaderProgram

Contient le programme de nuanceur à utiliser pour cette passe 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.