ColorOverlay QML Type

Ändert die Farben des Quellobjekts durch Anwendung einer Überlagerungsfarbe. Mehr...

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

Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

cached : bool
color : color
source : variant

Ausführliche Beschreibung

Der Effekt ist vergleichbar mit dem, was passiert, wenn ein eingefärbtes Glas auf ein Graustufenbild gelegt wird. Die Farbe für die Überlagerung wird im RGBA-Format angegeben.

Quelle	Angewandter Effekt

Beispiel

Das folgende Beispiel zeigt, wie Sie den Effekt anwenden können.

import QtQuick
import Qt5Compat.GraphicalEffects

Item {
    width: 300
    height: 300

    Image {
        id: bug
        source: "images/butterfly.png"
        sourceSize: Qt.size(parent.width, parent.height)
        smooth: true
        visible: false
    }

    ColorOverlay {
        anchors.fill: bug
        source: bug
        color: "#80800000"
    }
}

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

color : color

Diese Eigenschaft definiert den Farbwert, der zur Einfärbung der Quelle verwendet wird.

Standardmäßig ist die Eigenschaft auf "transparent" eingestellt.

Ausgabebeispiele mit verschiedenen Farbwerten

Farbe: #80ff0000	Farbe: #8000ff00	Farbe: #800000ff

source : variant

Diese Eigenschaft definiert das Quellelement, das die Quellpixel für den Effekt bereitstellt.

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.

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