このページでは

RenderPass QML Type

RenderPassタイプは、3Dコンテンツをレンダリングするためのカスタムレンダーパスを定義します。詳細...

Import Statement: import QtQuick3D
Since: Qt 6.11
Inherits:

Object3D

プロパティ

詳細説明

RenderPassを使用すると、レンダリングパイプラインのカスタムレンダリングステップを定義できます。クリア カラー、マテリアル モード、オーバーライド マテリアルなど、さまざまなプロパティを指定できます。さらに、レンダリングの実行方法を指示するレンダー コマンドのリストを定義できます。

シェーダへのデータの公開

エフェクトやカスタムマテリアルと同様に、RenderPassはユーザ定義のプロパティを自動的にシェーダに公開し、更新します。

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

augmentShader : url

このプロパティは、materialModeAugmentMaterial に設定されているときのレンダリングパスの拡張シェーダ 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

このプロパティは、materialModeOverrideMaterial に設定されているときのレンダーパスのオーバーライドマテリアルを保持します。

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

このプロパティは、レンダー パスのパス モードを保持します。

標準のユーザーレンダーパスに加えて、Qt Quick 3D 、スカイボックスと2Dアイテムをレンダリングするための内部レンダーパスを手動でトリガーするユーザーをサポートしています。

定数説明
RenderPass.UserPassユーザー指定のレンダーパス。
RenderPass.SkyboxPassQt Quick 3D組み込みのスカイボックス・レンダー・パス。
RenderPass.Item2DPassQt 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.