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 をエフェクトの親に設定するなど、エフェクトに自分自身を含めることはサポートされていません。


© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.