OpacityMask QML Type

ソースアイテムを別のアイテムでマスクします。詳細...

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

プロパティ

• cached : bool
• invert : bool
• maskSource : variant
• source : variant

詳細説明

例

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

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: mask
        source: "images/butterfly.png"
        sourceSize: Qt.size(parent.width, parent.height)
        smooth: true
        visible: false
    }

    OpacityMask {
        anchors.fill: bug
        source: bug
        maskSource: mask
    }
}

プロパティの説明

cached : bool

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

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

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

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

invert : bool

このプロパティは、sourceMask のアルファ値がどのように動作するかを制御する。

このプロパティがfalse の場合、結果の不透明度はソースアルファにマスクアルファAs * Am を掛けたものになります。

このプロパティがtrue の場合、結果の不透明度はソースアルファにマスクアルファの逆数As * (1 - Am) を掛けたものになります。

デフ ォル ト はfalse です。

maskSource : variant

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

source : variant

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