OpacityMask QML Type
Maskiert das Ausgangselement mit einem anderen Element. Mehr...
| Import Statement: | import Qt5Compat.GraphicalEffects |
| Since: | QtGraphicalEffects 1.0 |
| Inherits: |
Eigenschaften
- cached : bool
- invert : bool
- maskSource : variant
- source : variant
Detaillierte Beschreibung
Hinweis: Die Komponente MultiEffect bietet einen Maskeneffekt mit einigen Leistungsvorteilen. Für neuen Code sollte sie als Alternative zur Verwendung von Qt Graphical Effects in Betracht gezogen werden.
| Quelle | MaskeQuelle | Angewandter Effekt |
|---|---|---|
|
|
|
Beispiel
Das folgende Beispiel zeigt, wie man den Effekt anwendet.
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, dass der Effekt sich selbst einschließt, z. B. indem maskSource auf den übergeordneten Effekt gesetzt wird.
invert : bool
Diese Eigenschaft steuert, wie sich die Alphawerte der sourceMask verhalten sollen.
Wenn diese Eigenschaft false lautet, ist die resultierende Deckkraft das mit der Maske Alpha multiplizierte Alpha der Quelle, 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 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 |
|---|---|---|
|
|
|
source : variant
Diese Eigenschaft definiert die Quelle, die maskiert werden soll.
Hinweis: Es wird nicht unterstützt, dass der Effekt sich selbst einschließt, z. B. indem die Quelle auf das übergeordnete Element des Effekts gesetzt wird.
© 2026 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.


