Colorize QML Type

Legt die Farbe im HSL-Farbraum fest. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

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

Ausführliche Beschreibung

Der Effekt ähnelt dem, der entsteht, wenn ein farbiges Glas über ein Graustufenbild gelegt wird. „Colorize“ verwendet den HSL-Farbraum (Farbton, Sättigung und Helligkeit). Sie können für jede Eigenschaft einen gewünschten Wert festlegen. Mit dem „ HueSaturation “-Effekt können Sie alle HSL-Werte verschieben.

Alternativ können Sie den Effekt „ ColorOverlay “ verwenden, um das Quellelement im RGBA-Farbraum einzufärben.

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
    }

    Colorize {
        anchors.fill: bug
        source: bug
        hue: 0.0
        saturation: 0.5
        lightness: -0.2
    }
}

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 zur Einfärbung der Quelle verwendet wird.

Der Wert liegt zwischen 0,0 und 1,0. Standardmäßig ist die Eigenschaft auf „ 0.0 “ gesetzt, was eine leicht rötliche Farbe ergibt.

lightness : real

Diese Eigenschaft legt fest, um wie viel der Helligkeitswert der Quelle erhöht oder verringert wird.

Im Gegensatz zu den Eigenschaften „Farbton“ und „Sättigung“ legt „Helligkeit“ nicht den verwendeten Wert fest, sondern verschiebt den vorhandenen Helligkeitswert des Quellpixels.

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

saturation : real

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

Der Wert reicht von 0,0 (entgesättigt) bis 1,0 (gesättigt). Standardmäßig ist die Eigenschaft auf „ 1.0 “ (gesättigt) eingestellt.

source : variant

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