ThresholdMask QML Type

Maskiert das Ausgangselement mit einem anderen Element und wendet einen Schwellenwert an. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

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

Detaillierte Beschreibung

Das Maskierungsverhalten kann mit dem threshold Wert für die Maskenpixel gesteuert werden.

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 der Eigenschaft

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 erhöht sich, da für die Speicherung der Effektausgabe ein zusätzlicher Speicherplatz benötigt wird.

Es wird empfohlen, den Cache zu deaktivieren, wenn die Quelle oder die Effekteigenschaften animiert werden.

Standardmäßig ist die Eigenschaft auf false eingestellt.

maskSource : variant

Diese Eigenschaft definiert das Element, das als Maske verwendet werden soll. Das Maskenelement wird in einen Zwischenpixelpuffer gerendert und die Alphawerte des Ergebnisses werden verwendet, um die Sichtbarkeit der Pixel des Quellelements in der Anzeige zu bestimmen.

source : variant

Diese Eigenschaft definiert die Quelle, die maskiert werden soll.

spread : real

Diese Eigenschaft definiert die Glätte der Maskenränder in der Nähe des Alphawertes threshold. Bei einem Wert von 0,0 wird die Maske normalerweise mit dem angegebenen Schwellenwert verwendet. Bei höheren Werten wird der Übergang von den transparenten zu den undurchsichtigen Maskenpixeln weicher, indem dazwischen interpolierte Werte hinzugefügt werden.

Der Wert reicht von 0,0 (scharfer Maskenrand) bis 1,0 (weicher Maskenrand). Standardmäßig ist die Eigenschaft auf 0.0 eingestellt.

threshold : real

Diese Eigenschaft definiert einen Schwellenwert für die Maskenpixel. Die Maskenpixel, deren Alphawert unter dieser Eigenschaft liegt, werden verwendet, um die entsprechenden Pixel des Quellobjekts vollständig zu maskieren. Die Maskenpixel, die einen höheren Alphawert haben, werden verwendet, um das Ausgangselement auf der Anzeige zu alphabeln.

Der Wert reicht von 0,0 (Alphawert 0) bis 1,0 (Alphawert 255). Standardmäßig ist die Eigenschaft auf 0.0 eingestellt.