Color QML Type (Singleton)

Enthält Hilfsfunktionen für Farben. Mehr...

Hinweis: Dieser Typ ist ein QML-Singleton. Es gibt nur eine Instanz dieses Typs in der QML-Engine.

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Methoden

• color blend(color a, color b, real factor)
• color darker(color baseColor, real factor)
• bool equal(color lhs, color rhs)
• color fromString(string name)
• color hsla(real hue, real saturation, real lightness, real alpha)
• color hsva(real hue, real saturation, real value, real alpha)
• color lighter(color baseColor, real factor)
• color rgba(real red, real green, real blue, real alpha)
• color tint(color baseColor, color tintColor)
• color transparent(color color, real opacity)

Ausführliche Beschreibung

Methodendokumentation

color blend(color a, color b, real factor)

Gibt eine Farbe zurück, die eine Mischung aus a und b ist. Die resultierende Farbe wird aus den unabhängigen linearen Interpolationen der RGB-Farbkanäle von a und b gebildet.

Ist factor kleiner als 0,0, wird a zurückgegeben. Ist factor größer als 1,0, wird b zurückgegeben.

color darker(color baseColor, real factor)

Gibt eine Farbe zurück, die um den angegebenen Faktor „ factor “ dunkler ist als die Farbe „ baseColor “.

Die Funktion wandelt die aktuelle RGB-Farbe in HSV um, dividiert die V-Komponente durch den Faktor und wandelt die Farbe wieder in RGB zurück.

Ist der Faktor größer als 1,0, gibt diese Funktion eine dunklere Farbe zurück. Wird der Faktor auf 3,0 gesetzt, wird eine Farbe zurückgegeben, deren Helligkeit ein Drittel der ursprünglichen beträgt. Ist der Faktor kleiner als 1,0, ist die zurückgegebene Farbe heller; wir empfehlen jedoch, für diesen Zweck die Funktion „ Color::lighter()“ zu verwenden. Ist der Faktor 0 oder negativ, ist der Rückgabewert nicht definiert.

bool equal(color lhs, color rhs)

Gibt „true“ zurück, wenn „ lhs “ und „ rhs “ gleich sind. Siehe „ operator==()“.

color fromString(string name)

Gibt die Farbe zurück, die dem angegebenen „ name “ entspricht (d. h. rot oder #ff0000). Wenn es diese Farbe nicht gibt, wird eine Ausnahme ausgelöst.

color hsla(real hue, real saturation, real lightness, real alpha)

Gibt eine Farbe mit den angegebenen Komponenten „ hue “, „ saturation “, „ lightness “ und „ alpha “ zurück. Alle Komponenten sollten im Bereich von 0 bis 1 (einschließlich) liegen.

color hsva(real hue, real saturation, real value, real alpha)

Gibt eine Farbe mit den angegebenen Komponenten „ hue “, „ saturation “, „ value “ und „ alpha “ zurück. Alle Komponenten sollten im Bereich von 0 bis 1 (einschließlich) liegen.

color lighter(color baseColor, real factor)

Gibt eine Farbe zurück, die um den angegebenen Faktor „ factor “ heller ist als die Farbe „ baseColor “.

Die Funktion wandelt die aktuelle RGB-Farbe in HSV um, multipliziert die V-Komponente mit dem Faktor und wandelt die Farbe wieder in RGB um.

Ist der Faktor größer als 1,0, gibt diese Funktion eine hellere Farbe zurück. Wird der Faktor auf 1,5 gesetzt, wird eine um 50 % hellere Farbe zurückgegeben. Ist der Faktor kleiner als 1,0, ist die zurückgegebene Farbe dunkler; wir empfehlen jedoch, für diesen Zweck die Funktion „ Color::darker()“ zu verwenden. Ist der Faktor 0 oder negativ, ist der Rückgabewert nicht definiert.

color rgba(real red, real green, real blue, real alpha)

Gibt eine Farbe mit den angegebenen Komponenten „ red “, „ green “, „ blue “ und „ alpha “ zurück. Alle Komponenten sollten im Bereich von 0 bis 1 (einschließlich) liegen.

color tint(color baseColor, color tintColor)

Mit dieser Funktion lässt sich eine Farbe (baseColor) mit einer anderen (tintColor) abtönen.

Die Tönungsfarbe sollte in der Regel weitgehend transparent sein, da Sie sonst die darunterliegende Farbe nicht sehen können. Das folgende Beispiel erzeugt eine leichte rote Tönung, indem die Tönungsfarbe reines Rot ist, das nur zu 1/16 deckend ist.

Item {
    Rectangle {
        x: 0
        width: 80
        height: 80
        color: "lightsteelblue"
    }
    Rectangle {
        x: 100; width: 80; height: 80
        color: Color.tint("lightsteelblue", "#10FF0000")
    }
}

Das Tönen ist besonders nützlich, wenn aufgrund eines bestimmten Ereignisses eine subtile Veränderung vermittelt werden soll; in diesem Fall können Sie das Tönen nutzen, um die sichtbare Farbe effektiver anzupassen.

color transparent(color color, real opacity)

Gibt „ color “ mit einem Alpha-Wert von „ opacity “ zurück, der zwischen 0 (vollständig transparent) und 1 (vollständig undurchsichtig) liegt.