このページでは

Blend QML Type

ブレンドモードを使用して、2つのソースアイテムを合成します。詳細...

Import Statement: import Qt5Compat.GraphicalEffects
Since: QtGraphicalEffects 1.0
Inherits:

Item

プロパティ

詳細な説明

ブレンドモードは、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説明
normalforegroundSource からのピクセル成分の値が、アルファブレンディングを使用してソースの上に書き込まれます。
additionソースとforegroundSource からのピクセル成分の値が加算され、書き込まれます。
平均ソースと `foregroundSource ` からのピクセル成分の値を平均化し、書き込みます。
色ソースの明度値に、foregroundSource の色相と彩度を組み合わせて書き込みます。
colorBurnソースのピクセルが暗い場合はさらに暗くなり、ソースとforegroundSource の両方のピクセルが明るい場合は、結果は明るくなります。
colorDodgeソースの明るいピクセルはさらに明るくされます。ソースとforegroundSource の両方のピクセルが暗い場合、結果は暗くなります。
darkenソースとforegroundSource のピクセル値のうち、暗い方のピクセル値が書き込まれます。
darkerColorソースとforegroundSource のうち、より低輝度のピクセルのRGB値が書き込まれます。
differenceソースとforegroundSource の間のピクセル成分値の絶対差が書き込まれます。
divideソースのピクセル成分値が、foregroundSource の値で除算され、書き込まれます。
exclusionソースとforegroundSource 間の、コントラストが低減されたピクセル成分値の差が出力されます。
hardLightソースのピクセル成分値は、foregroundSource の値に応じて明るくまたは暗く調整され、書き込まれます。
hueforegroundSource の色相値が、ソースの彩度および明度と組み合わされて書き込まれます。
lightenソースとforegroundSource のうち、最も明るいピクセル成分の値が書き込まれます。
lighterColorソースと xml-ph-0000@deepl.internal のうち、より明るいピクセル成分の値が書き込まれます。ソースとforegroundSource のうち、より輝度の高いピクセルのRGB値が書き込まれます。
lightnessforegroundSource からの明度値が、ソースの色相および彩度と組み合わされて書き込まれます。
multiplyソースとforegroundSource のピクセル成分値を掛け合わせて書き込みます。
negationソースとforegroundSource の絶対ピクセル成分値の差を反転させた値が書き込まれます。
彩度foregroundSource の彩度値に、ソースの色相および明度を組み合わせて書き込みます。
スクリーンソースとforegroundSource のピクセル値は、それぞれ否定され、乗算された後、再度否定されて書き込まれます。
subtractforegroundSource からのピクセル値がソースから差し引かれ、書き込まれます。
softLightソースのピクセル成分の値は、foregroundSource の値に応じてわずかに明るくまたは暗くされ、書き込まれます。
ソースの例例foregroundSource

葉の上の黒いカブトムシ

色鮮やかな蝶のイラスト

モード値が異なる場合の出力例

「ブレンド効果」と「通常モード」

加算モードでのブレンド効果

平均モードによるブレンド効果

mode: normal mode: addition mode: average

エフェクトとカラーモードの組み合わせ

「ブレンド」効果と「カラーバーン」モード

「ブレンド効果」と「カラー・ドッジ」モード

mode: color モード: カラーバーン モード: カラー・ドッジ

「ブレンド」エフェクトと「暗くする」モード

「エフェクト」と「darkerColor」モードを組み合わせる

「ブレンド効果」と「差分モード」

モード: 暗くする モード: ダークカラー モード: 差分

「ブレンド」効果と「除算」モード

除外モードでのブレンド効果

「ブレンド」エフェクトと「ハードライト」モード

モード: 除算 モード: 除外 モード: ハードライト

色相モードでのブレンド効果

「ブレンド」効果と「明るく」モード

「blend」エフェクトと「lighterColor」モードの組み合わせ

モード: 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.