Blend QML Type

Führt zwei Quellobjekte unter Verwendung eines Mischmodus zusammen. Mehr...

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

Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

cached : bool
foregroundSource : variant
mode : string
source : variant

Detaillierte Beschreibung

Der Überblendungsmodus kann mit der Eigenschaft mode ausgewählt werden.

Quelle	foregroundSource	Angewandter Effekt

Hinweis: Dieser Effekt ist bei der 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"
    }
}

Eigenschaft Dokumentation

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

foregroundSource : variant

Diese Eigenschaft definiert das Element, das über die source überblendet werden soll.

Hinweis: Es wird nicht unterstützt, den Effekt sich selbst einschließen zu lassen, z. B. durch die Einstellung von foregroundSource auf das übergeordnete Element des Effekts.

mode : string

Diese Eigenschaft definiert den Modus, der verwendet wird, wenn foregroundSource über die Quelle geblendet wird. Die Groß- und Kleinschreibung wird nicht berücksichtigt.

Modus	Beschreibung
normal	Die Pixelkomponentenwerte von foregroundSource werden unter Verwendung von Alpha-Blending über die Quelle geschrieben.
Addition	Die Pixelkomponentenwerte von Quelle und foregroundSource werden addiert und geschrieben.
Durchschnitt	Die Pixelkomponentenwerte von source und foregroundSource werden gemittelt und geschrieben.
Farbe	Der Helligkeitswert von source wird mit Farbton und Sättigung von foregroundSource kombiniert und geschrieben.
colorBurn	Die dunkleren Pixel aus der Quelle werden stärker abgedunkelt; wenn sowohl die Pixel der Quelle als auch die von foregroundSource hell sind, ist das Ergebnis hell.
colorDodge	Die helleren Pixel aus der Quelle werden stärker aufgehellt; wenn sowohl die Quelle als auch foregroundSource Pixel dunkel sind, ist das Ergebnis dunkel.
verdunkeln	Der Wert der dunkleren Pixelkomponente aus der Quelle und foregroundSource wird geschrieben.
dunklerFarbe	Der rgb-Wert des Pixels mit der geringeren Luminanz aus Quelle und foregroundSource wird geschrieben.
Unterschied	Es wird der absolute Pixelkomponentenwertunterschied zwischen Quelle und foregroundSource geschrieben.
divide	Die Pixelkomponentenwerte von Quelle werden durch den Wert von foregroundSource geteilt und geschrieben.
Ausschluss	Die Differenz der Pixelkomponentenwerte mit reduziertem Kontrast zwischen Quelle und foregroundSource wird geschrieben.
hardLight	Die Pixelkomponentenwerte der Quelle werden entsprechend den Werten von foregroundSource aufgehellt oder abgedunkelt und geschrieben.
Farbton	Der Farbtonwert von foregroundSource wird mit Sättigung und Helligkeit von Quelle kombiniert und geschrieben.
aufhellen	Der hellste Pixelkomponentenwert aus der Quelle und foregroundSource wird geschrieben.
hellerFarbe	Der rgb-Wert des Pixels mit der höheren Leuchtdichte aus der Quelle und foregroundSource wird geschrieben.
heller	Der Helligkeitswert aus foregroundSource wird mit Farbton und Sättigung aus der Quelle kombiniert und geschrieben.
multiplizieren	Die Pixelkomponentenwerte aus Quelle und foregroundSource werden miteinander multipliziert und geschrieben.
negation	Die invertierte absolute Pixelkomponentenwertdifferenz zwischen Quelle und foregroundSource wird geschrieben.
Sättigung	Der Sättigungswert von foregroundSource wird mit Farbton und Helligkeit von Quelle kombiniert und geschrieben.
Bildschirm	Die Pixelwerte von Quelle und foregroundSource werden negiert, dann multipliziert, erneut negiert und geschrieben.
subtrahieren	Der Pixelwert von foregroundSource wird von der Quelle subtrahiert und geschrieben.
softLight	Die Pixelkomponentenwerte von source werden entsprechend den Werten von foregroundSource leicht aufgehellt oder abgedunkelt und geschrieben.

Beispiel Quelle	Beispiel foregroundSource

Ausgabebeispiele mit verschiedenen Moduswerten

Modus: normal	Modus: Addition	Modus: Durchschnitt

Modus: Farbe	Modus: colorBurn	Modus: colorDodge

Modus: Verdunkeln	Modus: darkerColor	Modus: Differenz

Modus: Teilen	Modus: Ausschluss	Modus: hardlight

Modus: Farbton	Modus: aufhellen	Modus: lighterColor

Modus: Helligkeit	Modus: Negation	Modus: Multiplizieren

Modus: Sättigung	Modus: Raster	Modus: subtrahieren

Modus: softLight

source : variant

Diese Eigenschaft definiert das Quellelement, das als Basis dient, wenn foregroundSource darüber geblendet wird.

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.