SimpleQuadRenderer QML Type

Renders a full-screen textured quad to the main render target. More...

• List of all members, including inherited members

Properties

• texture : Texture

Detailed Description

SimpleQuadRenderer is a RenderExtension that blits a Texture across the entire screen. It runs at the PostColor stage in the Main render mode, which means it executes after the scene has been drawn but before any post-processing effects, and it writes directly into the View3D's main render target, overwriting whatever was drawn by the scene.

The most common use case is building a fully custom rendering pipeline: set View3D.renderFormat to disable Qt Quick 3D's built-in passes with View3D.DisableInternalPasses, render the scene content into one or more RenderPass targets, and then use SimpleQuadRenderer to composite the result back onto the screen.

import QtQuick3D
import QtQuick3D.Helpers

View3D {
    // Disable the built-in render passes so we can provide our own output
    renderFormat: View3D.DisableInternalPasses

    // A custom offscreen pass that renders scene content
    RenderPass {
        id: mainColorPass
        commands: [
            RenderablesFilter { renderableTypes: RenderablesFilter.Opaque | RenderablesFilter.Transparent }
        ]
    }

    // Blit the result of the custom pass to the screen
    SimpleQuadRenderer {
        texture: Texture {
            textureProvider: RenderOutputProvider {
                renderPass: mainColorPass
            }
        }
    }
}

See also RenderOutputProvider, RenderPass, and View3D.

Property Documentation

texture : Texture

The texture to render across the full-screen quad. This can be any Texture, including one whose textureProvider is set to a RenderOutputProvider to display output from a RenderPass or one of Qt Quick 3D's built-in passes (such as the depth texture or AO texture).