SimpleQuadRenderer QML Type | Qt Quick 3D | Qt 6.11.1
Description: Renders a full-screen textured quad to the main render target.

- Qt 6.11
- Qt Quick 3D
- QML Types
- QtQuick3D.Helpers
- SimpleQuadRenderer
- Qt Quick 3D | Commercial or GPLv3

# SimpleQuadRenderer QML Type

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

Import Statement: | `import QtQuick3D.Helpers`
Since: | Qt 6.11
Inherits: | RenderExtension

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

Note: SimpleQuadRenderer is automatically registered as an extension with the scene — it does not need to be added to View3D.extensions manually.

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