Auf dieser Seite

Blend QML Type

Fügt zwei Quellelemente mithilfe eines Mischmodus zusammen. Mehr…

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

Item

Eigenschaften

Ausführliche Beschreibung

Der Mischmodus kann über die Eigenschaft „ mode “ ausgewählt werden.

QuelleforegroundSourceAngewandter Effekt

Schwarzer Käfer auf einem Blatt

Farbenfrohe Schmetterlingsgrafik

Käfer und Schmetterling verschmelzen miteinander

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.

modeBeschreibung
normalDie Pixelkomponentenwerte von „ foregroundSource “ werden mithilfe von Alpha-Blending über die Quelle geschrieben.
additionDie Pixelkomponentenwerte von „source“ und „ foregroundSource “ werden addiert und geschrieben.
MittelwertDie Pixelkomponentenwerte von „source“ und „ foregroundSource “ werden gemittelt und geschrieben.
FarbeDer Helligkeitswert der Quelle wird mit dem Farbton und der Sättigung des „ foregroundSource “ kombiniert und geschrieben.
colorBurnDie dunkleren Pixel der Quelle werden noch weiter abgedunkelt; sind sowohl die Pixel der Quelle als auch die des „ foregroundSource “ hell, ist das Ergebnis hell.
colorDodgeDie helleren Pixel der Quelle werden noch heller gemacht; sind sowohl die Pixel der Quelle als auch die von „ foregroundSource “ dunkel, ist das Ergebnis dunkel.
darkenDer Wert der dunkleren Pixelkomponente aus Quelle und „ foregroundSource “ wird geschrieben.
darkerColorDer RGB-Wert des Pixels mit der geringeren Luminanz aus Quelle und „ foregroundSource “ wird geschrieben.
differenceDie absolute Differenz der Pixelkomponentenwerte zwischen „source“ und „ foregroundSource “ wird geschrieben.
divideDie Pixelkomponentenwerte aus der Quelle werden durch den Wert aus „ foregroundSource “ geteilt und geschrieben.
AusschlussDie Differenz der Pixelkomponentenwerte zwischen Quelle und Ziel foregroundSource, bei der der Kontrast reduziert wurde, wird geschrieben.
hardLightDie Pixelkomponentenwerte der Quelle werden entsprechend den Werten von „ foregroundSource “ aufgehellt oder abgedunkelt und geschrieben.
FarbtonforegroundSource Der Farbtonwert aus dem Zielbild wird mit der Sättigung und Helligkeit der Quelle kombiniert und geschrieben.
lightenDer hellste Wert der Pixelkomponenten aus der Quelle und aus „ foregroundSource “ wird geschrieben.
lighterColorDer RGB-Wert des Pixels mit der höheren Luminanz aus der Quelle und „ foregroundSource “ wird geschrieben.
HelligkeitDer Helligkeitswert aus „ foregroundSource “ wird mit dem Farbton und der Sättigung aus „source“ kombiniert und geschrieben.
multiplyDie Pixelkomponentenwerte aus „source“ und „ foregroundSource “ werden miteinander multipliziert und geschrieben.
NegationDie invertierte Differenz der absoluten Pixelkomponentenwerte zwischen der Quelle und dem Bild „ foregroundSource “ wird geschrieben.
SättigungDer Sättigungswert von „ foregroundSource “ wird mit dem Farbton und der Helligkeit der Quelle kombiniert und geschrieben.
ScreenDie Pixelwerte von „source“ und „ foregroundSource “ werden negiert, anschließend multipliziert, erneut negiert und geschrieben.
SubtrahierenDer Pixelwert von „ foregroundSource “ wird von der Quelle subtrahiert und geschrieben.
SoftLightDie Pixelkomponentenwerte der Quelle werden entsprechend den Werten von „ foregroundSource “ leicht aufgehellt oder abgedunkelt und geschrieben.
Beispiel „source“Beispiel foregroundSource

Schwarzer Käfer auf einem Blatt

Farbenfrohe Schmetterlingsgrafik

Ausgabebeispiele mit unterschiedlichen Moduswerten

Überblendungseffekt im Normalmodus

Überblendungseffekt mit Additionsmodus

Überblendungseffekt im Modus „Durchschnitt“

Modus: normal Modus: Addition Modus: Durchschnitt

Überblendungseffekt mit Farbmodus

Misch-Effekt im Modus „Farbe brennen“

Überblendungseffekt im Modus „Farbe aufhellen“

Modus: Farbe Modus: „colorBurn“ Modus: „Farbe aufhellen“

Überblendungseffekt im Modus „Abdunkeln“

Überblendungseffekt im Modus „dunkler“

Überblendungseffekt im Differenzmodus

Modus: Abdunkeln Modus: „dunklerFarbe“ Modus: Differenz

Überblendungseffekt mit dem Modus „Teilen“

Überblendungseffekt mit Ausschlussmodus

Überblendungseffekt im „Hard Light“-Modus

Modus: „Divide“ Modus: Ausschluss Modus: Hartlicht

Überblendungseffekt im Farbtonmodus

Überblendungseffekt mit dem Modus „Aufhellen“

Überblendungseffekt im Modus „hellere Farbe“

Modus: Farbton Modus: Aufhellen Modus: hellere Farbe

Mischmodus mit Helligkeitsmodus

Überblendungseffekt im Negationsmodus

Überblendungseffekt im Multiplikationsmodus

Modus: Helligkeit Modus: Negation Modus: Multiplizieren

Überblendungseffekt mit Sättigungsmodus

Überblendungseffekt im Bildschirmmodus

Überblendungseffekt im Subtraktionsmodus

Modus: Sättigung Modus: „Screen“ Modus: Subtrahieren

Mischmodus „SoftLight“

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.