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: |
Propriétés
- texture : Texture
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.