ThresholdMask QML Type

Blendet das Quellelement mit einem anderen Element aus und wendet einen Schwellenwert an. Mehr...

• Liste aller Elemente, einschließlich vererbter Elemente

Eigenschaften

• cached : bool
• maskSource : variant
• source : variant
• spread : real
• threshold : real

Ausführliche Beschreibung

Das Maskierungsverhalten lässt sich über den Wert „ threshold “ für die Maskenpixel steuern.

Beispiel

Das folgende Beispiel zeigt, wie der Effekt angewendet wird.

import QtQuick
import Qt5Compat.GraphicalEffects

Item {
    width: 300
    height: 300

    Image {
        id: background
        anchors.fill: parent
        source: "images/checker.png"
        smooth: true
        fillMode: Image.Tile
    }

    Image {
        id: bug
        source: "images/bug.jpg"
        sourceSize: Qt.size(parent.width, parent.height)
        smooth: true
        visible: false
    }

    Image {
        id: mask
        source: "images/fog.png"
        sourceSize: Qt.size(parent.width, parent.height)
        smooth: true
        visible: false
    }

    ThresholdMask {
        anchors.fill: bug
        source: bug
        maskSource: mask
        threshold: 0.4
        spread: 0.2
    }
}

Dokumentation zu den 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.

maskSource : variant

Diese Eigenschaft definiert das Element, das als Maske verwendet werden soll. Das Maskenelement wird in einen Zwischenpixelpuffer gerendert, und anhand der Alpha-Werte aus dem Ergebnis wird bestimmt, inwieweit die Pixel des Quellelements auf dem Bildschirm sichtbar sind.

source : variant

Diese Eigenschaft definiert das Quellelement, das maskiert werden soll.

spread : real

Diese Eigenschaft legt fest, wie glatt die Maskenränder im Bereich des Alpha-Werts „ threshold “ sind. Bei einer Einstellung von 0,0 wird die Maske wie gewohnt mit dem angegebenen Schwellenwert verwendet. Höhere Werte für „Spread“ mildern den Übergang von transparenten zu undurchsichtigen Maskenpixeln, indem dazwischen interpolierte Werte eingefügt werden.

Der Wert reicht von 0,0 (scharfe Maskenkante) bis 1,0 (weiche Maskenkante). Standardmäßig ist die Eigenschaft auf „ 0.0 “ eingestellt.

threshold : real

Diese Eigenschaft definiert einen Schwellenwert für die Maskenpixel. Die Maskenpixel, deren Alpha-Wert unter diesem Schwellenwert liegt, werden verwendet, um die entsprechenden Pixel des Quellelements vollständig auszublenden. Die Maskenpixel mit einem höheren Alpha-Wert werden verwendet, um das Quellelement mit der Anzeige alpha-gemischt darzustellen.

Der Wert reicht von 0,0 (Alpha-Wert 0) bis 1,0 (Alpha-Wert 255). Standardmäßig ist die Eigenschaft auf „ 0.0 “ gesetzt.