ThresholdMask QML Type

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

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

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

プロパティ

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

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

オリジナル	マスク	適用されたエフェクト

注意: 例えば、maskSource をエフェクトの親に設定するなど、エフェクトに自分自身を含めることはサポートされていません。

source : variant

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

注：例えば、source をエフェクトの親に設定することによって、エフェクトがそれ自身を含むようにすることはサポートされていません。

spread : real

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

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

spread 値を変えた出力例

spread: 0.0	spread: 0.2	spread: 0.8
threshold:0.4	threshold:0.4	threshold:0.4

threshold : real

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

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

閾値を変えた出力例

しきい値0.0	threshold：0.5	しきい値0.7
spread:0.2	spread:0.2	spread:0.2

©2024 The Qt Company Ltd. 本書に含まれる文書の著作権は、それぞれの所有者に帰属します。本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の商標です。その他すべての商標は、それぞれの所有者に帰属します。