Auf dieser Seite

ColorOverlay QML Type

Ändert die Farben des Quellelements durch Anwenden einer Überlagerungsfarbe. Mehr...

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

Item

Eigenschaften

Ausführliche Beschreibung

Der Effekt ähnelt dem, der entsteht, wenn ein farbiges Glas über ein Graustufenbild gelegt wird. Die Farbe für die Überlagerung wird im ARGB-Format angegeben.

QuelleAngewandter Effekt

Farbenfrohe Schmetterlingsgrafik

Schmetterling mit Farbüberlagerung

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/butterfly.png"
        sourceSize: Qt.size(parent.width, parent.height)
        smooth: true
        visible: false
    }

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

Eigenschaftsdokumentation

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.

color : color

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

Standardmäßig ist die Eigenschaft auf „ "transparent" “ gesetzt.

Ausgabebeispiele mit unterschiedlichen Farbwerten

Schmetterling mit rotem Überzug

Schmetterling mit grüner Überlagerung

Schmetterling mit blauer Überlagerung

color: #80ff0000 color: #8000ff00 color: #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 einbezieht, beispielsweise durch Festlegen von „source“ auf das übergeordnete Element des Effekts.

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