不透明度遮罩 QML 类型

使用另一个项遮罩源项。更多信息...

导入语句	import Qt5Compat.GraphicalEffects
自	QtGraphicalEffects 1.0
继承	Item

包括继承成员在内的所有成员列表

属性

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。

注意：不支持效果包含自身，例如通过将 maskSource 设置为效果的父元素来实现。

invert : bool

此属性控制源遮罩的 alpha 值将如何行为。

如果此属性设置为 false，则结果的透明度为源 alpha 乘以遮罩 alpha，As * Am。

如果此属性设置为 true，则结果的透明度为源 alpha 乘以遮罩 alpha 的倒数，As * (1 - Am)。

默认为 false。

maskSource : variant

此属性定义要作为遮罩使用的项。遮罩项被渲染到一个中间像素缓冲区，并从结果中使用 alpha 值来决定源项在显示中的像素可见性。

原始	遮罩	应用的效果

source : variant

此属性定义要遮罩的源项。

注意：不支持让效果包括自身，例如通过将来源设置为效果的父级。