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