renderTargetBlend QML Value Type

レンダリングパスの単一の色アタッチメントに対するブレンドパラメータを定義します。詳細...

Import Statement:	`import QtQuick3D`
Since:	Qt 6.11

プロパティ

blendEnabled : bool
colorWrite : enumeration
dstAlpha : enumeration
dstColor : enumeration
opAlpha : enumeration
opColor : enumeration
srcAlpha : enumeration
srcColor : enumeration

詳細な説明

renderTargetBlend 型は、RenderPass の単一のカラーアタッチメントに対するブレンドパラメータを指定するために使用されます。renderTargetBlend のインスタンスは、PipelineStateOverride のtargetBlend0 からtargetBlend7 までのプロパティのいずれかに割り当てることができます。ここで、インデックスはカラーアタッチメントのスロットに対応しています。

カラーブレンド式は次のとおりです：

result.rgb = srcColor * src.rgb  opColor  dstColor * dst.rgb
result.a   = srcAlpha * src.a   opAlpha  dstAlpha * dst.a

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

blendEnabled : bool

true に設定すると、カラーアタッチメントのブレンドが有効になります。false に設定すると、ブレンドが無効になり、出力色がアタッチメントに直接書き込まれます。デフォルト値はfalse です。

colorWrite : enumeration

カラーアタッチメントに書き込むカラーチャンネルを制御するビットマスクです。| 演算子を使用して、複数の値を組み合わせることができます。デフォルト値はR | G | B | A です。

定数	説明
`RenderTargetBlend.R`	赤チャンネルに書き込みます。
`RenderTargetBlend.G`	緑チャンネルに書き込みます。
`RenderTargetBlend.B`	青チャンネルに書き込みます。
`RenderTargetBlend.A`	アルファチャンネルに書き込みます。

dstAlpha : enumeration

宛先のアルファブレンド係数を設定します。この値は、ブレンド処理の前に、カラーアタッチメント内の現在の値のアルファ成分をスケーリングします。デフォルト値はOneMinusSrcAlpha です。使用可能な値の一覧については、srcColor を参照してください。

dstColor : enumeration

宛先色のブレンド係数を設定します。この値は、ブレンド処理の前に、カラーアタッチメント内の現在の値のRGB成分をスケーリングします。デフォルト値はOneMinusSrcAlpha です。使用可能な値の一覧については、srcColor を参照してください。

opAlpha : enumeration

スケーリングされたソースおよび宛先のアルファ成分を合成するために使用する算術演算を設定します。デフォルト値は `Add` です。使用可能な値の一覧については、opColor を参照してください。

opColor : enumeration

スケーリングされたソース色成分と宛先色成分を合成するために使用する算術演算を設定します。デフォルト値はAdd です。

定数	説明
`RenderTargetBlend.Add`	Result = src + dst。
`RenderTargetBlend.Subtract`	Result = src - dst。
`RenderTargetBlend.ReverseSubtract`	Result = dst - src。
`RenderTargetBlend.Min`	Result = min(src, dst)。
`RenderTargetBlend.Max`	Result = max(src, dst)。

srcAlpha : enumeration

ソースのアルファブレンド係数を設定します。この値は、ブレンド処理の前にフラグメントシェーダーの出力のアルファ成分をスケーリングします。デフォルト値はOne です。使用可能な値の一覧については、srcColor を参照してください。

srcColor : enumeration

ソースカラーのブレンド係数を設定します。この値は、ブレンド処理の前にフラグメントシェーダーの出力のRGB成分をスケーリングします。デフォルト値はOne です。

定数	説明
`RenderTargetBlend.Zero`	係数は (0, 0, 0) です。
`RenderTargetBlend.One`	係数は (0, 0, 0) です。係数は (1, 1, 1) です。
`RenderTargetBlend.SrcColor`	係数はソースカラー (r, g, b) です。
`RenderTargetBlend.OneMinusSrcColor`	乗数は、ソースの (1-r, 1-g, 1-b) です。
`RenderTargetBlend.DstColor`	係数は、宛先色 (r, g, b) です。
`RenderTargetBlend.OneMinusDstColor`	係数は、宛先の (1-r, 1-g, 1-b) です。係数は、送信元のアルファ (a, a, a) です。
`RenderTargetBlend.SrcAlpha`	ファクターは、ソースのアルファ (a, a, a) です。
`RenderTargetBlend.OneMinusSrcAlpha`	ファクターは、ソースの (1-a, 1-a, 1-a) です。
`RenderTargetBlend.DstAlpha`	ファクタは、宛先のアルファ (a, a, a) です。
`RenderTargetBlend.OneMinusDstAlpha`	ファクターは、宛先の (1-a, 1-a, 1-a) です。
`RenderTargetBlend.ConstantColor`	係数は、パイプラインで設定された固定色です。
`RenderTargetBlend.OneMinusConstantColor`	ファクターは、定数色から 1 を引いた値です。
`RenderTargetBlend.ConstantAlpha`	ファクターは、定数アルファです。
`RenderTargetBlend.OneMinusConstantAlpha`	ファクタは、定数アルファから 1 を引いた値です。
`RenderTargetBlend.SrcAlphaSaturate`	ファクターは、RGB の場合 min(src.a, 1-dst.a)、A の場合 1 です。
`RenderTargetBlend.Src1Color`	ファクターは、フラグメントシェーダーの 2 番目の色出力から取得されます。
`RenderTargetBlend.OneMinusSrc1Color`	ファクタは、2番目のカラー出力から 1 を引いた値です。
`RenderTargetBlend.Src1Alpha`	ファクターは、2番目のカラー出力のアルファ値です。
`RenderTargetBlend.OneMinusSrc1Alpha`	ファクターは、2番目の出力のアルファ値を引いた1です。

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