Blend QML Type
ブレンドモードを使用して、2つのソースアイテムを合成します。詳細...
| Import Statement: | import Qt5Compat.GraphicalEffects |
| Since: | QtGraphicalEffects 1.0 |
| Inherits: |
プロパティ
- cached : bool
- foregroundSource : variant
- mode : string
- source : variant
詳細な説明
ブレンドモードは、mode プロパティで選択できます。
| ソース | foregroundSource | 適用されたエフェクト |
|---|---|---|
|
|
|
注:この エフェクトは 、OpenGL で実行している場合に利用可能です。
例
以下の例は、このエフェクトを適用する方法を示しています。
import QtQuick
import Qt5Compat.GraphicalEffects
Item {
width: 300
height: 300
Image {
id: bug
source: "images/bug.jpg"
sourceSize: Qt.size(parent.width, parent.height)
smooth: true
visible: false
}
Image {
id: butterfly
source: "images/butterfly.png"
sourceSize: Qt.size(parent.width, parent.height)
smooth: true
visible: false
}
Blend {
anchors.fill: bug
source: bug
foregroundSource: butterfly
mode: "subtract"
}
}プロパティのドキュメント
cached : bool
このプロパティを使用すると、エフェクトの出力ピクセルをキャッシュして、レンダリングパフォーマンスを向上させることができます。
ソースまたはエフェクトのプロパティが変更されるたびに、キャッシュ内のピクセルを更新する必要があります。エフェクトの出力を保存するために追加のメモリバッファが必要となるため、メモリ使用量が増加します。
ソースまたはエフェクトのプロパティがアニメーション化される場合は、キャッシュを無効にすることをお勧めします。
デフォルトでは、このプロパティは false に設定されています。
foregroundSource : variant
このプロパティは、source 上にブレンドされるアイテムを定義します。
注: 例えば、foregroundSource をエフェクトの親に設定するなどして、エフェクト自体をそのエフェクトに含めることは サポートされていません。
mode : string
このプロパティは、foregroundSource がソースとブレンドされる際に使用されるモードを定義します。値は大文字小文字を区別しません。
| mode | 説明 |
|---|---|
| normal | foregroundSource からのピクセル成分の値が、アルファブレンディングを使用してソースの上に書き込まれます。 |
| addition | ソースとforegroundSource からのピクセル成分の値が加算され、書き込まれます。 |
| 平均 | ソースと `foregroundSource ` からのピクセル成分の値を平均化し、書き込みます。 |
| 色 | ソースの明度値に、foregroundSource の色相と彩度を組み合わせて書き込みます。 |
| colorBurn | ソースのピクセルが暗い場合はさらに暗くなり、ソースとforegroundSource の両方のピクセルが明るい場合は、結果は明るくなります。 |
| colorDodge | ソースの明るいピクセルはさらに明るくされます。ソースとforegroundSource の両方のピクセルが暗い場合、結果は暗くなります。 |
| darken | ソースとforegroundSource のピクセル値のうち、暗い方のピクセル値が書き込まれます。 |
| darkerColor | ソースとforegroundSource のうち、より低輝度のピクセルのRGB値が書き込まれます。 |
| difference | ソースとforegroundSource の間のピクセル成分値の絶対差が書き込まれます。 |
| divide | ソースのピクセル成分値が、foregroundSource の値で除算され、書き込まれます。 |
| exclusion | ソースとforegroundSource 間の、コントラストが低減されたピクセル成分値の差が出力されます。 |
| hardLight | ソースのピクセル成分値は、foregroundSource の値に応じて明るくまたは暗く調整され、書き込まれます。 |
| hue | foregroundSource の色相値が、ソースの彩度および明度と組み合わされて書き込まれます。 |
| lighten | ソースとforegroundSource のうち、最も明るいピクセル成分の値が書き込まれます。 |
| lighterColorソースと xml-ph-0000@deepl.internal のうち、より明るいピクセル成分の値が書き込まれます。 | ソースとforegroundSource のうち、より輝度の高いピクセルのRGB値が書き込まれます。 |
| lightness | foregroundSource からの明度値が、ソースの色相および彩度と組み合わされて書き込まれます。 |
| multiply | ソースとforegroundSource のピクセル成分値を掛け合わせて書き込みます。 |
| negation | ソースとforegroundSource の絶対ピクセル成分値の差を反転させた値が書き込まれます。 |
| 彩度 | foregroundSource の彩度値に、ソースの色相および明度を組み合わせて書き込みます。 |
| スクリーン | ソースとforegroundSource のピクセル値は、それぞれ否定され、乗算された後、再度否定されて書き込まれます。 |
| subtract | foregroundSource からのピクセル値がソースから差し引かれ、書き込まれます。 |
| softLight | ソースのピクセル成分の値は、foregroundSource の値に応じてわずかに明るくまたは暗くされ、書き込まれます。 |
| ソースの例 | 例foregroundSource |
|---|---|
|
|
| モード値が異なる場合の出力例 | ||
|---|---|---|
|
|
|
| mode: normal | mode: addition | mode: average |
|
|
|
| mode: color | モード: カラーバーン | モード: カラー・ドッジ |
|
|
|
| モード: 暗くする | モード: ダークカラー | モード: 差分 |
|
|
|
| モード: 除算 | モード: 除外 | モード: ハードライト |
|
|
|
| モード: hue | モード:ライトン | モード: 明るい色 |
|
|
|
| モード: 明度 | モード: 否定 | モード: 乗算 |
|
|
|
| モード: 彩度 | モード: スクリーン | モード: 減算 |
| ||
| モード:ソフトライト |
source : variant
このプロパティは、foregroundSource をその上にブレンドする際のベースとなるソースアイテムを定義します。
注: エフェクトをその親に設定するなどして、エフェクト自体をソースに含めることはサポートされていません。
© 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.
























