Auf dieser Seite

SimpleQuadRenderer QML Type

Rendert ein texturiertes Vollbild-Quad auf das Hauptrenderziel. Mehr...

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

RenderExtension

Eigenschaften

Ausführliche Beschreibung

SimpleQuadRenderer ist ein „ RenderExtension “, der ein „ Texture “ über den gesamten Bildschirm blitzt. Er läuft in der „ PostColor “-Phase im „ Main “-Rendermodus, was bedeutet, dass er nach dem Zeichnen der Szene, aber vor etwaigen Nachbearbeitungseffekten ausgeführt wird, und er schreibt direkt in das Hauptrenderziel des „ View3D “, wobei er alles überschreibt, was von der Szene gezeichnet wurde.

Der häufigste Anwendungsfall ist der Aufbau einer vollständig benutzerdefinierten Rendering-Pipeline: Setzen Sie „ View3D.renderFormat “ auf „ View3D.DisableInternalPasses “, um die integrierten Durchläufe von „ Qt Quick 3D “ zu deaktivieren, rendern Sie den Szeneninhalt in ein oder mehrere „ RenderPass “-Ziele und verwenden Sie dann „SimpleQuadRenderer“, um das Ergebnis wieder auf den Bildschirm zu compositen.

Hinweis: SimpleQuadRenderer wird automatisch als Erweiterung in der Szene registriert – es muss nicht manuell zu View3D.extensions hinzugefügt werden.

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

Siehe auch „ RenderOutputProvider “, „ RenderPass “ und „ View3D “.

Dokumentation zu den Eigenschaften

texture : Texture

Die Textur, die über das Vollbild-Quad gerendert werden soll. Dies kann ein beliebiges „ Texture “ sein, einschließlich eines, dessen „ textureProvider “ auf „ RenderOutputProvider “ gesetzt ist, um die Ausgabe eines „ RenderPass “ oder eines der integrierten Pässe von „ Qt Quick 3D “ (wie z. B. die Tiefentextur oder die AO-Textur) anzuzeigen.

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