En esta página

SubRenderPass QML Type

Renderiza una subsección del trabajo en el mismo destino de renderizado que el elemento principal RenderPass. Más...

Import Statement: import QtQuick3D
Since: Qt 6.11
Inherits:

Command

Propiedades

Descripción detallada

SubRenderPass es un « Command » que subdivide un « RenderPass » en partes más pequeñas, configuradas de forma independiente, aunque comparten el mismo destino de renderizado. Solo el « RenderPass » padre controla en qué texturas se realiza el renderizado (mediante « ColorAttachment » y « DepthTextureAttachment ») y cuándo comienza el paso (y, por lo tanto, cuándo se borra el destino de renderizado). Un SubRenderPass no puede establecer su propio destino de renderizado ni sus ajustes de borrado; estos siempre se heredan del paso padre.

Lo que sí puede controlar un SubRenderPass es qué se renderiza y cómo: dispone de su propio « commands », por lo que puede incluir un « RenderablesFilter » para seleccionar un subconjunto de objetos, un « PipelineStateOverride » para modificar el estado de profundidad o mezcla, un « materialMode » diferente, etc.

Un uso típico es un proceso de renderizado directo en el que una única pasada de color utiliza SubRenderPasses independientes para el fondo, los objetos opacos y los objetos transparentes. Las tres subpasadas escriben en las mismas texturas de color y profundidad, pero cada una tiene un estado de proceso diferente:

RenderPass {
    id: mainColorPass
    commands: [
        // Render targets are set at the parent RenderPass level only
        ColorAttachment { name: "color0"; target: colorTexture },
        DepthTextureAttachment { target: depthTexture },

        // Sub-pass 1: render the skybox background
        SubRenderPass { renderPass: skyboxSubPass },

        // Sub-pass 2: opaque objects with depth testing and writing
        SubRenderPass { renderPass: opaqueSubPass },

        // Sub-pass 3: transparent objects with blending, no depth write
        SubRenderPass { renderPass: transparentSubPass }
    ]
}

// Sub-passes share mainColorPass's render target
RenderPass {
    id: skyboxSubPass
    passMode: RenderPass.SkyboxPass
}

RenderPass {
    id: opaqueSubPass
    commands: [
        RenderablesFilter { renderableTypes: RenderablesFilter.Opaque }
    ]
}

RenderPass {
    id: transparentSubPass
    commands: [
        RenderablesFilter { renderableTypes: RenderablesFilter.Transparent },
        PipelineStateOverride {
            blendEnabled: true
            depthWriteEnabled: false
        }
    ]
}

Véase también RenderPass, RenderablesFilter y PipelineStateOverride.

Documentación de propiedades

renderPass : RenderPass

El archivo « RenderPass », que se ejecutará como un subpaso cuando se procese este comando.

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