En esta página

RenderPass QML Type

Encapsula un paso de renderizado. Más información...

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

Node

Status: Deprecated

Este tipo está obsoleto. Recomendamos encarecidamente no utilizarlo en código nuevo.

Propiedades

Descripción detallada

Un RenderPass especifica una única pasada de renderizado —una instancia de ejecución del programa de sombreado— utilizada por Technique. Una pasada de renderizado consta de un objeto « ShaderProgram » y una lista de objetos « FilterKey », una lista de objetos « RenderState » y una lista de objetos « Parameter ».

RenderPass ejecuta el ` ShaderProgram ` utilizando los nodos ` RenderState ` y `Parameter` especificados cuando al menos uno de los nodos ` FilterKey ` a los que se hace referencia coincide con cualquiera de los nodos ` FilterKey ` de ` RenderPassFilter `, o cuando no hay ningún ` RenderPassFilter ` presente en el `FrameGraph`.

Si el RenderPass define un «Parameter», este quedará anulado por un «Parameter» con el mismo nombre si existe en cualquiera de los «Technique», «Effect», «Material», « TechniqueFilter » o « RenderPassFilter » asociados al paso en tiempo de ejecución. Esto puede seguir siendo útil para definir valores por defecto razonables.

En el momento del renderizado, para cada nodo hoja del FrameGraph se registra un estado de renderizado base mediante la acumulación de los estados definidos por todos los nodos « RenderStateSet » de la rama del FrameGraph. Cada «RenderPass» puede sobrescribir este estado de renderizado base especificando sus propios nodos « 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 {}
            ]
        }
    ]
}

Véase también « RenderPassFilter », « FilterKey », « Parameter », « RenderState », « Effect » y « Technique ».

Documentación de la propiedad

filterKeys : list<FilterKey>

Contiene las claves de filtro que permiten utilizar esta pasada de renderizado.

parameters : list<Parameter>

Almacena los valores de los parámetros del shader utilizados por la pasada de renderizado.

renderStates : list<RenderState>

Almacena los estados de renderizado utilizados por la pasada de renderizado.

shaderProgram : ShaderProgram

Almacena el programa de sombreado que se va a utilizar para esta pasada de renderizado.

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