このページでは

RenderPass QML Type

レンダリングパスをカプセル化します。詳細...

Import Statement: import Qt3D.Render 2.12
In C++: QRenderPass
Inherits:

Node

Status: Deprecated

この型は非推奨です。新しいコードでの使用は強く推奨しません。

プロパティ

詳細な説明

RenderPassは、Techniqueによって使用される単一のレンダリングパス(シェーダープログラムの実行インスタンス)を指定します。RenderPassは、ShaderProgram 、FilterKey オブジェクトのリスト、RenderState オブジェクトのリスト、およびParameter オブジェクトのリストで構成されます。

RenderPassは、参照されているFilterKey ノードのうち少なくとも1つが、RenderPassFilter 内のFilterKey ノードのいずれかと一致する場合、またはFrameGraph内にRenderPassFilter が存在しない場合に、指定されたRenderState およびParameterノードを使用してShaderProgram を実行します。

RenderPassでパラメータが定義されている場合、実行時にそのパスに関連付けられたTechnique、Effect、Material、TechniqueFilter 、RenderPassFilter のいずれかに同名のパラメータが存在すると、そちらによって上書きされます。それでも、適切なデフォルト値を定義する上で有用な場合があります。

レンダリング時には、FrameGraphの各リーフノードについて、そのFrameGraphブランチ内のすべてのRenderStateSet ノードで定義された状態を累積することで、基本レンダリング状態が記録されます。各RenderPassは、独自のRenderState ノードを指定することで、この基本レンダリング状態を上書きすることができます。

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

関連項目: RenderPassFilter 、FilterKey 、Parameter 、RenderState 、Effect 、およびTechnique 。

プロパティのドキュメント

filterKeys : list<FilterKey>

このレンダリングパスの使用を有効にするフィルターキーを保持します。

parameters : list<Parameter>

レンダーパスで使用されるシェーダーパラメータの値を保持します。

renderStates : list<RenderState>

レンダーパスで使用されるレンダリング状態を保持します。

shaderProgram : ShaderProgram

このレンダリングパスで使用するシェーダープログラムを保持します。

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