OpacityMask QML Type

Blendet das Quellelement durch ein anderes Element aus. Mehr...

• Liste aller Elemente, einschließlich geerbter Elemente

Eigenschaften

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

Ausführliche Beschreibung

Beispiel

Das folgende Beispiel zeigt, wie der Effekt angewendet wird.

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
    }
}

Dokumentation der Eigenschaften

cached : bool

Mit dieser Eigenschaft können die Ausgabepixel des Effekts zwischengespeichert werden, um die Rendering-Leistung zu verbessern.

Jedes Mal, wenn die Eigenschaften der Quelle oder des Effekts geändert werden, müssen die Pixel im Cache aktualisiert werden. Der Speicherverbrauch steigt, da ein zusätzlicher Speicherpuffer zum Speichern der Effekt-Ausgabe benötigt wird.

Es wird empfohlen, den Cache zu deaktivieren, wenn die Eigenschaften der Quelle oder des Effekts animiert werden.

Standardmäßig ist die Eigenschaft auf „ false “ gesetzt.

invert : bool

Diese Eigenschaft steuert, wie sich die Alpha-Werte der „sourceMask“ verhalten.

Ist diese Eigenschaft auf „ false “ gesetzt, entspricht die resultierende Deckkraft dem Alpha-Wert der Quelle multipliziert mit dem Alpha-Wert der Maske, As * Am.

Ist diese Eigenschaft auf „ true “ gesetzt, ergibt sich die resultierende Deckkraft aus dem Alpha-Wert der Quelle multipliziert mit dem Kehrwert des Alpha-Werts der Maske: As * (1 - Am).

Die Standardeinstellung ist „ false “.

maskSource : variant

Diese Eigenschaft definiert das Element, das als Maske verwendet werden soll. Das Maskenelement wird in einen Zwischenpixelpuffer gerendert, und die Alpha-Werte aus dem Ergebnis werden verwendet, um die Sichtbarkeit der Pixel des Quellelements auf dem Bildschirm zu bestimmen.

source : variant

Diese Eigenschaft definiert das Quellelement, das maskiert werden soll.