RenderPass QML Type

Kapseln einen Render-Pass. Mehr...

Dieser Typ ist veraltet. Wir raten dringend davon ab, ihn in neuem Code zu verwenden.

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• filterKeys : list<FilterKey>
• parameters : list<Parameter>
• renderStates : list<RenderState>
• shaderProgram : ShaderProgram

Ausführliche Beschreibung

Ein „RenderPass“ bezeichnet einen einzelnen Rendering-Durchlauf – eine Instanz der Ausführung eines Shader-Programms –, der von „Technique“ verwendet wird. Ein Rendering-Durchlauf besteht aus einem „ ShaderProgram “ sowie einer Liste von „ FilterKey “-Objekten, einer Liste von „ RenderState “-Objekten und einer Liste von „ Parameter “-Objekten.

„RenderPass“ führt den „ ShaderProgram “ unter Verwendung der angegebenen „ RenderState “- und „Parameter“-Knoten aus, wenn mindestens einer der referenzierten „ FilterKey “-Knoten mit einem der „ FilterKey “-Knoten im „ RenderPassFilter “ übereinstimmt oder wenn im „FrameGraph“ kein „ RenderPassFilter “ vorhanden ist.

Wenn der RenderPass einen Parameter definiert, wird dieser durch einen gleichnamigen Parameter überschrieben, sofern dieser in einem der mit dem Pass zur Laufzeit verknüpften Knoten vom Typ „Technique“, „Effect“, „Material“, „ TechniqueFilter “ oder „ RenderPassFilter “ vorhanden ist. Dies kann dennoch nützlich sein, um sinnvolle Standardwerte festzulegen.

Zur Renderzeit wird für jeden Blattknoten des FrameGraphs ein Basis-Renderzustand erfasst, indem die von allen „ RenderStateSet “-Knoten im FrameGraph-Zweig definierten Zustände akkumuliert werden. Jeder RenderPass kann diesen Basis-Renderzustand überschreiben, indem er eigene „ RenderState “-Knoten angibt.

Technique {
    filterKeys: [
        FilterKey { name: "renderingStyle"; value: "forward" }
    ]
    graphicsApiFilter: {
        api: GraphicsApiFilter.OpenGL
        profile: GraphicsApiFilter.CoreProfile
        majorVersion: 3
        minorVersion: 1
    }
    renderPasses: [
        RenderPass {
            id: pass
            shaderProgram: ShaderProgram {
                // ...
            }
            parameters: [
                Parameter { name: "color"; value: "red" }
            ]
            renderStates: [
                DepthTest {}
            ]
        }
    ]
}

Siehe auch „ RenderPassFilter“ , „ FilterKey “, „ Parameter “, „ RenderState “, „ Effect “ und „ Technique “.

Dokumentation zu Eigenschaften

filterKeys : list<FilterKey>

Enthält die Filtertasten, die die Verwendung dieses Render-Passes ermöglichen.

parameters : list<Parameter>

Enthält die vom Render-Pass verwendeten Shader-Parameterwerte.

renderStates : list<RenderState>

Enthält die vom Render-Pass verwendeten Render-Zustände.

shaderProgram : ShaderProgram

Enthält das Shader-Programm, das für diesen Render-Durchlauf verwendet werden soll.