RenderPass QML Type

Der Typ RenderPass definiert einen benutzerdefinierten Renderpass zum Rendern von 3D-Inhalten. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• augmentShader : url
• clearColor : color
• commands : list<RenderCommand>
• depthClearValue : real
• materialMode : RenderPass::MaterialModes
• overrideMaterial : Material
• passMode : RenderPass::PassMode
• renderTargetFlags : RenderPass::RenderTargetFlags
• stencilClearValue : int

Detaillierte Beschreibung

Mit einem RenderPass können Sie einen benutzerdefinierten Rendering-Schritt in der Rendering-Pipeline definieren. Sie können verschiedene Eigenschaften angeben, wie z. B. die klare Farbe, den Materialmodus und die Überschreibungsmaterialien. Außerdem können Sie eine Liste von Renderbefehlen definieren, die vorgeben, wie das Rendering durchgeführt werden soll.

Freigabe von Daten für die Shader

Wie bei Effekten und benutzerdefinierten Materialien gibt der RenderPass benutzerdefinierte Eigenschaften automatisch an die Shader weiter und aktualisiert sie.

Dokumentation der Eigenschaften

augmentShader : url

Diese Eigenschaft enthält die Augment-Shader-URL für den Renderpass, wenn materialMode auf AugmentMaterial gesetzt ist.

Die Shader-Datei sollte eine Funktion mit der folgenden Signatur enthalten:

void MAIN_FRAGMENT_AUGMENT() {
    // Custom shader code here
}

Diese Funktion wird mit dem vorhandenen Fragment-Shader des Materials kombiniert, das von dem Objekt verwendet wird, das in diesem Renderpass gerendert wird. So können Benutzer den vorhandenen Material-Shader mit benutzerdefiniertem Code erweitern.

clearColor : color [default: Qt.black]

Diese Eigenschaft enthält die klare Farbe für den Rendervorgang.

commands : list<RenderCommand>

Diese Eigenschaft enthält die Liste der Renderbefehle für den Renderpass.

Die Befehle in der Liste werden in der Reihenfolge ausgeführt, in der sie in der Liste erscheinen.

Siehe auch renderTargetBlend, PipelineStateOverride, RenderablesFilter, RenderPassTexture, ColorAttachment, DepthTextureAttachment, DepthStencilAttachment, und AddDefine.

depthClearValue : real [default: 1.0]

Diese Eigenschaft enthält den Wert für den Tiefenausgleich für den Rendervorgang.

materialMode : RenderPass::MaterialModes [default: RenderPass.OriginalMaterial]

Diese Eigenschaft enthält den Materialmodus für den Renderpass.

overrideMaterial : Material

Diese Eigenschaft enthält das Override-Material für den Renderpass, wenn materialMode auf OverrideMaterial eingestellt ist.

passMode : RenderPass::PassMode [default: RenderPass.UserPass]

Diese Eigenschaft enthält den Passmodus für den Renderpass.

Zusätzlich zu den standardmäßigen Benutzer-Renderpässen unterstützt Qt Quick 3D die manuelle Auslösung interner Renderpässe für das Rendern der Skybox und der 2D-Elemente.

renderTargetFlags : RenderPass::RenderTargetFlags [default: RenderPass.RenderTargetFlags.None]

Diese Eigenschaft enthält die Renderzielflags für den Renderdurchgang.

Mögliche Werte sind:

Siehe auch QRhiTextureRenderTarget::Flags.

stencilClearValue : int [default: 0]

Diese Eigenschaft enthält den Stencil-Clear-Wert für den Rendervorgang.