ThresholdMask QML Type

ソースアイテムを別のアイテムでマスクし、しきい値を適用します。詳細...

• 継承されたメンバを含む、すべてのメンバのリスト

プロパティ

• cached : bool
• maskSource : variant
• source : variant
• spread : real
• threshold : real

詳細説明

マスクの動作は、マスクピクセルのthreshold 値で制御できます。

例

次の例は、効果を適用する方法を示しています。

import QtQuick
import Qt5Compat.GraphicalEffects

Item {
    width: 300
    height: 300

    Image {
        id: background
        anchors.fill: parent
        source: "images/checker.png"
        smooth: true
        fillMode: Image.Tile
    }

    Image {
        id: bug
        source: "images/bug.jpg"
        sourceSize: Qt.size(parent.width, parent.height)
        smooth: true
        visible: false
    }

    Image {
        id: mask
        source: "images/fog.png"
        sourceSize: Qt.size(parent.width, parent.height)
        smooth: true
        visible: false
    }

    ThresholdMask {
        anchors.fill: bug
        source: bug
        maskSource: mask
        threshold: 0.4
        spread: 0.2
    }
}

プロパティの説明

cached : bool

このプロパティは、レンダリングのパフォーマンスを向上させるために、エフェクトの出力ピクセルをキャッシュできるようにします。

ソースまたはエフェクトのプロパティが変更されるたびに、キャッシュ内のピクセルを更新する必要があります。エフェクト出力を保存するために余分なメモリバッファが必要になるため、メモリ消費量が増加します。

ソースまたはエフェクトプロパティがアニメーションするときは、キャッシュを無効にすることをお勧めします。

デフォルトでは、このプロパティはfalse に設定されています。

maskSource : variant

このプロパティは、マスクとして使用されるアイテムを定義します。マスク項目は、中間ピクセルバッファにレンダリングされ、その結果からのアルファ値は、ディスプレイにおけるソース項目のピクセルの可視性を決定するために使用される。

source : variant

このプロパティは、マスクされるソースアイテムを定義します。

spread : real

このプロパティは、threshold アルファ値付近のマスクエッジの滑らかさを定義します。spread を 0.0 に設定すると、指定されたしきい値でマスクが通常使用されます。より高いspread値を設定すると、透明なマスクピクセルから不透明なマスクピクセルへの遷移を、それらの間に補間値を追加することでソフトにします。

値の範囲は0.0（マスクエッジがシャープ）から1.0（マスクエッジがスムーズ）です。デフ ォル ト では、 こ のプ ロ パテ ィ は0.0 に設定 さ れてい ます。

threshold : real

このプロパティは、マスクピクセルのしきい値を定義する。このプロパティを下回るアルファ値を持つマスクピクセルは、ソースアイテムから対応するピクセルを完全にマスクするために使用される。より高いアルファ値を持つマスクピクセルは、ソースアイテムをディスプレイにアルファブレンディングするために使用される。

値の範囲は0.0（アルファ値0）から1.0（アルファ値255）である。デフォルトでは、このプロパティは0.0 に設定されています。