ThresholdMask QML Type

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

Import Statement:	`import Qt5Compat.GraphicalEffects`
Since:	QtGraphicalEffects 1.0
Inherits:	Item

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 Wert threshold für die Maskenpixel gesteuert werden.

Quelle	MaskeQuelle	Angewandter Effekt

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.

Original	Maske	Angewandter Effekt

Hinweis: Es wird nicht unterstützt, den Effekt sich selbst einschließen zu lassen, z. B. indem maskSource auf das übergeordnete Element des Effekts gesetzt wird.

source : variant

Diese Eigenschaft definiert das Quellelement, das maskiert werden soll.

Hinweis: Es wird nicht unterstützt, den Effekt sich selbst einschließen zu lassen, z. B. indem source auf das übergeordnete Element des Effekts gesetzt wird.

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 für spread wird der Übergang von den transparenten Maskenpixeln zu den undurchsichtigen Maskenpixeln weicher, indem interpolierte Werte zwischen ihnen 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.

Ausgabebeispiele mit verschiedenen Spread-Werten

Spreizung: 0.0	Spreizung: 0.2	Spreizung: 0.8
threshold: 0.4	threshold: 0.4	threshold: 0.4

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 Ausgangsteils vollständig auszublenden. Die Maskenpixel, die einen höheren Alphawert haben, werden verwendet, um das Quellelement 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.

Ausgabebeispiele mit verschiedenen Schwellenwerten

Schwellenwert: 0.0	Schwellenwert: 0.5	Schwellenwert: 0.7
spread: 0.2	spread: 0.2	spread: 0.2

© 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.