Sur cette page

SimpleQuadRenderer QML Type

Affiche un quadrilatère texturé en plein écran sur la cible de rendu principale. En savoir plus…

Import Statement: import QtQuick3D.Helpers
Since: Qt 6.11
Inherits:

RenderExtension

Propriétés

Description détaillée

SimpleQuadRenderer est un « RenderExtension » qui effectue un blit d’un « Texture » sur l’ensemble de l’écran. Il s’exécute à l’étape « PostColor » en mode de rendu « Main », ce qui signifie qu’il s’exécute après le dessin de la scène mais avant tout effet de post-traitement, et qu’il écrit directement dans la cible de rendu principale du « View3D », en écrasant tout ce qui a été dessiné par la scène.

Le cas d’utilisation le plus courant consiste à créer un pipeline de rendu entièrement personnalisé : définissez ` View3D.renderFormat ` pour désactiver les passes intégrées d’ Qt Quick 3D avec ` View3D.DisableInternalPasses`, effectuez le rendu du contenu de la scène dans une ou plusieurs cibles de rendu ` RenderPass `, puis utilisez `SimpleQuadRenderer` pour recomposer le résultat à l’écran.

Remarque : SimpleQuadRenderer est automatiquement enregistré en tant qu’extension de la scène — il n’est pas nécessaire de l’ajouter manuellement à View3D.extensions.

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

Voir également RenderOutputProvider, RenderPass et View3D.

Documentation des propriétés

texture : Texture

La texture à afficher sur le quadrant plein écran. Il peut s'agir de n'importe quelle Texture, y compris une texture dont le paramètre « textureProvider » est défini sur « RenderOutputProvider » afin d'afficher la sortie d'un RenderPass ou l'un des passes intégrés de Qt Quick 3D (tels que la texture de profondeur ou la texture AO).

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