Auf dieser Seite

Desaturate QML Type

Verringert die Farbsättigung. Mehr...

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

Item

Eigenschaften

Ausführliche Beschreibung

Die entsättigten Pixelwerte werden als Durchschnittswerte der ursprünglichen RGB-Komponentenwerte des Quellelements berechnet.

QuelleAngewandter Effekt

Schwarzer Käfer auf einem Blatt

Käfer mit entsättigten Farben

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
    }

    Desaturate {
        anchors.fill: bug
        source: bug
        desaturation: 0.8
    }
}

Eigenschaftsdokumentation

cached : bool

Mit dieser Eigenschaft können die Ausgangspixel 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 Quelle oder die Effekteigenschaften animiert werden.

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

desaturation : real

Diese Eigenschaft legt fest, inwieweit die Quellfarben entsättigt werden.

Der Wert reicht von 0,0 (keine Änderung) bis 1,0 (entfärbt). Standardmäßig ist die Eigenschaft auf „ 0.0 “ (keine Änderung) eingestellt.

Ausgabebeispiele mit unterschiedlichen Entsättigungswerten

Käfer in voller Farbe

Beetle teilweise entsättigt

Beetle vollständig entsättigt und in Graustufen umgewandelt

Entsättigung: 0,0 Entsättigung: 0,5 Entsättigung: 1,0

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.