RenderPass QML Type
RenderPassタイプは、3Dコンテンツをレンダリングするためのカスタムレンダーパスを定義します。詳細...
| Import Statement: | import QtQuick3D |
| Since: | Qt 6.11 |
| Inherits: |
プロパティ
- augmentShader : url
- clearColor : color
- commands : list<RenderCommand>
- depthClearValue : real
- materialMode : RenderPass::MaterialModes
- overrideMaterial : Material
- passMode : RenderPass::PassMode
- renderTargetFlags : RenderPass::RenderTargetFlags
- stencilClearValue : int
詳細説明
RenderPassを使用すると、レンダリングパイプラインのカスタムレンダリングステップを定義できます。クリア カラー、マテリアル モード、オーバーライド マテリアルなど、さまざまなプロパティを指定できます。さらに、レンダリングの実行方法を指示するレンダー コマンドのリストを定義できます。
シェーダへのデータの公開
エフェクトやカスタムマテリアルと同様に、RenderPassはユーザ定義のプロパティを自動的にシェーダに公開し、更新します。
プロパティのドキュメント
augmentShader : url
このプロパティは、materialMode がAugmentMaterial に設定されているときのレンダリングパスの拡張シェーダ URL を保持します。
シェーダファイルは以下のシグネチャを持つ関数を含む必要があります:
void MAIN_FRAGMENT_AUGMENT() {
// Custom shader code here
}この関数は、このレンダリングパスでレンダリングされるオブジェクトによって使用されるマテリアルの既存のフラグメントシェーダと結合されます。ユーザがカスタムコードで既存のマテリアルシェーダを補強できるようにします。
clearColor : color [default: Qt.black]
このプロパティは、レンダーパスのクリアカラーを保持します。
commands : list<RenderCommand>
このプロパティは、レンダーパスのレンダーコマンドのリストを保持する。
リスト内のコマンドは、リストに表示された順に実行されます。
注: RenderPass と Effects のコマンドは似ていますが、同じではありません。互換性があるとマークされたものだけが、このRenderPass で使用できます。
renderTargetBlend,PipelineStateOverride,RenderablesFilter,RenderPassTexture,ColorAttachment,DepthTextureAttachment,DepthStencilAttachment,AddDefineも参照してください 。
depthClearValue : real [default: 1.0]
このプロパティは、レンダーパスの深度クリア値を保持する。
materialMode : RenderPass::MaterialModes [default: RenderPass.OriginalMaterial]
このプロパティは、レンダーパスのマテリアルモードを保持します。
| 定数 | 説明 |
|---|---|
RenderPass.OriginalMaterial | オブジェクトの元のマテリアルを使用します。 |
RenderPass.AugmentMaterial | カスタムシェーダコードで元のマテリアルを補強します。 |
RenderPass.OverrideMaterial | ユーザー指定のmaterial で元のマテリアルを上書きします。 |
overrideMaterial : Material
このプロパティは、materialMode がOverrideMaterial に設定されているときのレンダーパスのオーバーライドマテリアルを保持します。
passMode : RenderPass::PassMode [default: RenderPass.UserPass]
このプロパティは、レンダー パスのパス モードを保持します。
標準のユーザーレンダーパスに加えて、Qt Quick 3D 、スカイボックスと2Dアイテムをレンダリングするための内部レンダーパスを手動でトリガーするユーザーをサポートしています。
| 定数 | 説明 |
|---|---|
RenderPass.UserPass | ユーザー指定のレンダーパス。 |
RenderPass.SkyboxPass | Qt Quick 3D組み込みのスカイボックス・レンダー・パス。 |
RenderPass.Item2DPass | Qt Quick 3D組み込みの 2D アイテム・レンダー・パス。 |
renderTargetFlags : RenderPass::RenderTargetFlags [default: RenderPass.RenderTargetFlags.None]
このプロパティは、レンダーパスのレンダーターゲットフラグを保持する。
取り得る値は以下の通りです:
| 定数 | 説明 |
|---|---|
RenderPass.RenderTargetFlags.None | 特別な動作はありません。 |
RenderPass.RenderTargetFlags.PreserveColorContents | フレーム間のレンダー ターゲットのカラー コンテンツを保持します。 |
RenderPass.RenderTargetFlags.PreserveDepthStencilContents | フレーム間でレンダー ターゲットの深度とステンシルの内容を保持します。 |
RenderPass.RenderTargetFlags.DoNotStoreDepthStencilContents | レンダリング後にレンダーターゲットの深度とステンシルの内容を保存しない。 |
QRhiTextureRenderTarget::Flagsも参照してください 。
stencilClearValue : int [default: 0]
このプロパティは、レンダーパスのステンシルクリア値を保持する。
© 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.