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 のアルファ値付近におけるマスクエッジの滑らかさを定義します。スプレッドを 0.0 に設定すると、指定されたしきい値で通常通りマスクが使用されます。スプレッドの値を高く設定すると、透明なマスクピクセルから不透明なマスクピクセルへの移行が、その間に補間値を追加することで滑らかになります。

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

threshold : real

このプロパティは、マスクピクセルのしきい値を定義します。このプロパティよりもアルファ値が低いマスクピクセルは、ソースアイテムの対応するピクセルを完全にマスクするために使用されます。アルファ値が高いマスクピクセルは、ソースアイテムを表示画面にアルファブレンディングするために使用されます。

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