OpacityMask QML Type

Maskiert das Ausgangselement mit einem anderen Element. Mehr...

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

Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

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

Ausführliche Beschreibung

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

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

invert : bool

Diese Eigenschaft steuert, wie sich die Alphawerte der sourceMask verhalten werden.

Wenn diese Eigenschaft false lautet, ist die resultierende Deckkraft der Quell-Alpha-Wert multipliziert mit dem Masken-Alpha-Wert, As * Am.

Wenn diese Eigenschaft true lautet, ist die resultierende Deckkraft die mit dem Kehrwert der Maske Alpha multiplizierte Quell-Alpha, 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 Pixel-Zwischenpuffer gerendert und die Alphawerte aus dem Ergebnis werden verwendet, um die Sichtbarkeit der Pixel des Quellelements in der Anzeige zu bestimmen.

Original	Maske	Angewandter Effekt

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 die Quelle auf das übergeordnete Element des Effekts gesetzt wird.

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