HueSaturation QML Type

Ändert die Farben der Quellelemente im HSL-Farbraum. Mehr...

• Liste aller Elemente, einschließlich geerbter Elemente

Eigenschaften

• cached : bool
• hue : real
• lightness : real
• saturation : real
• source : variant

Ausführliche Beschreibung

„HueSaturation“ ähnelt dem Effekt „ Colorize “, jedoch werden die Werte für Farbton und Sättigung unterschiedlich behandelt. Der Effekt „HueSaturation“ verschiebt stets den Farbton, die Sättigung und die Helligkeit gegenüber dem Original, anstatt sie festzulegen.

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
    }

    HueSaturation {
        anchors.fill: bug
        source: bug
        hue: -0.3
        saturation: 0.5
        lightness: -0.1
    }
}

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.

hue : real

Diese Eigenschaft definiert den Farbtonwert, der zum Quellfarbtonwert addiert wird.

Der Wert reicht von -1,0 (Verringerung) bis 1,0 (Erhöhung). Standardmäßig ist die Eigenschaft auf „ 0.0 “ (keine Änderung) gesetzt.

lightness : real

Diese Eigenschaft definiert den Helligkeitswert, der zum Sättigungswert der Quelle addiert wird.

Der Wert reicht von -1,0 (Verringerung) bis 1,0 (Erhöhung). Standardmäßig ist die Eigenschaft auf „ 0.0 “ (keine Änderung) eingestellt.

saturation : real

Diese Eigenschaft legt den Sättigungswert fest, der zum Sättigungswert der Quelle addiert wird.

Der Wert reicht von -1,0 (Verringerung) bis 1,0 (Erhöhung). Standardmäßig ist die Eigenschaft auf „ 0.0 “ (keine Änderung) eingestellt.

source : variant

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