Back to Qt.io
Contact Us Blog Download Qt

OpacityMask QML Type

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

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

Item

プロパティ

詳細説明

ソースマスクソース適用される効果

適用例

次の例は、エフェクトを適用する方法を示しています。

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 に設定されています。

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


invert : bool

このプロパティは、sourceMask のアルファ値の動作を制御します。

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

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

デフ ォル ト はfalse です。


maskSource : variant

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

オリジナルマスク適用される効果


source : variant

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

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


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