Blend QML Type
Fügt zwei Quellelemente mithilfe eines Mischmodus zusammen. Mehr…
| Import Statement: | import Qt5Compat.GraphicalEffects |
| Since: | QtGraphicalEffects 1.0 |
| Inherits: |
Eigenschaften
- cached : bool
- foregroundSource : variant
- mode : string
- source : variant
Ausführliche Beschreibung
Der Mischmodus kann über die Eigenschaft „ mode “ ausgewählt werden.
| Quelle | foregroundSource | Angewandter Effekt |
|---|---|---|
|
|
|
Hinweis: Dieser Effekt ist bei Ausführung mit OpenGL verfügbar.
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: butterfly
source: "images/butterfly.png"
sourceSize: Qt.size(parent.width, parent.height)
smooth: true
visible: false
}
Blend {
anchors.fill: bug
source: bug
foregroundSource: butterfly
mode: "subtract"
}
}Dokumentation der 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.
foregroundSource : variant
Diese Eigenschaft definiert das Element, das über das „ source “ eingeblendet werden soll.
Hinweis: Es wird nicht unterstützt, dass der Effekt sich selbst einbezieht, beispielsweise durch Setzen von „foregroundSource“ auf das übergeordnete Element des Effekts.
mode : string
Diese Eigenschaft legt den Modus fest, der verwendet wird, wenn „ foregroundSource “ mit der Quelle überblendet wird. Bei den Werten wird die Groß-/Kleinschreibung nicht berücksichtigt.
| mode | Beschreibung |
|---|---|
| normal | Die Pixelkomponentenwerte von „ foregroundSource “ werden mithilfe von Alpha-Blending über die Quelle geschrieben. |
| addition | Die Pixelkomponentenwerte von „source“ und „ foregroundSource “ werden addiert und geschrieben. |
| Mittelwert | Die Pixelkomponentenwerte von „source“ und „ foregroundSource “ werden gemittelt und geschrieben. |
| Farbe | Der Helligkeitswert der Quelle wird mit dem Farbton und der Sättigung des „ foregroundSource “ kombiniert und geschrieben. |
| colorBurn | Die dunkleren Pixel der Quelle werden noch weiter abgedunkelt; sind sowohl die Pixel der Quelle als auch die des „ foregroundSource “ hell, ist das Ergebnis hell. |
| colorDodge | Die helleren Pixel der Quelle werden noch heller gemacht; sind sowohl die Pixel der Quelle als auch die von „ foregroundSource “ dunkel, ist das Ergebnis dunkel. |
| darken | Der Wert der dunkleren Pixelkomponente aus Quelle und „ foregroundSource “ wird geschrieben. |
| darkerColor | Der RGB-Wert des Pixels mit der geringeren Luminanz aus Quelle und „ foregroundSource “ wird geschrieben. |
| difference | Die absolute Differenz der Pixelkomponentenwerte zwischen „source“ und „ foregroundSource “ wird geschrieben. |
| divide | Die Pixelkomponentenwerte aus der Quelle werden durch den Wert aus „ foregroundSource “ geteilt und geschrieben. |
| Ausschluss | Die Differenz der Pixelkomponentenwerte zwischen Quelle und Ziel foregroundSource, bei der der Kontrast reduziert wurde, wird geschrieben. |
| hardLight | Die Pixelkomponentenwerte der Quelle werden entsprechend den Werten von „ foregroundSource “ aufgehellt oder abgedunkelt und geschrieben. |
| Farbton | foregroundSource Der Farbtonwert aus dem Zielbild wird mit der Sättigung und Helligkeit der Quelle kombiniert und geschrieben. |
| lighten | Der hellste Wert der Pixelkomponenten aus der Quelle und aus „ foregroundSource “ wird geschrieben. |
| lighterColor | Der RGB-Wert des Pixels mit der höheren Luminanz aus der Quelle und „ foregroundSource “ wird geschrieben. |
| Helligkeit | Der Helligkeitswert aus „ foregroundSource “ wird mit dem Farbton und der Sättigung aus „source“ kombiniert und geschrieben. |
| multiply | Die Pixelkomponentenwerte aus „source“ und „ foregroundSource “ werden miteinander multipliziert und geschrieben. |
| Negation | Die invertierte Differenz der absoluten Pixelkomponentenwerte zwischen der Quelle und dem Bild „ foregroundSource “ wird geschrieben. |
| Sättigung | Der Sättigungswert von „ foregroundSource “ wird mit dem Farbton und der Helligkeit der Quelle kombiniert und geschrieben. |
| Screen | Die Pixelwerte von „source“ und „ foregroundSource “ werden negiert, anschließend multipliziert, erneut negiert und geschrieben. |
| Subtrahieren | Der Pixelwert von „ foregroundSource “ wird von der Quelle subtrahiert und geschrieben. |
| SoftLight | Die Pixelkomponentenwerte der Quelle werden entsprechend den Werten von „ foregroundSource “ leicht aufgehellt oder abgedunkelt und geschrieben. |
| Beispiel „source“ | Beispiel foregroundSource |
|---|---|
|
|
| Ausgabebeispiele mit unterschiedlichen Moduswerten | ||
|---|---|---|
|
|
|
| Modus: normal | Modus: Addition | Modus: Durchschnitt |
|
|
|
| Modus: Farbe | Modus: „colorBurn“ | Modus: „Farbe aufhellen“ |
|
|
|
| Modus: Abdunkeln | Modus: „dunklerFarbe“ | Modus: Differenz |
|
|
|
| Modus: „Divide“ | Modus: Ausschluss | Modus: Hartlicht |
|
|
|
| Modus: Farbton | Modus: Aufhellen | Modus: hellere Farbe |
|
|
|
| Modus: Helligkeit | Modus: Negation | Modus: Multiplizieren |
|
|
|
| Modus: Sättigung | Modus: „Screen“ | Modus: Subtrahieren |
| ||
| Modus: Weiches Licht |
source : variant
Diese Eigenschaft definiert das Quellelement, das als Grundlage dient, wenn „ foregroundSource “ darüber eingeblendet wird.
Hinweis: Es wird nicht unterstützt, dass der Effekt sich selbst einbezieht, beispielsweise indem „source“ 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.
























