Color QML Type (Singleton)

Contient des fonctions utilitaires pour les couleurs. En savoir plus...

Remarque : ce type est un singleton QML. Il n'existe qu'une seule instance de ce type dans le moteur QML.

• Liste de tous les membres, y compris les membres hérités

Méthodes

• 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)

Description détaillée

Documentation de la méthode

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

Renvoie une couleur résultant d'un mélange entre a et b. La couleur obtenue est construite à partir d'interpolations linéaires indépendantes des canaux de couleur RVB de a et b.

Si factor est inférieur à 0,0, a est renvoyé. Si factor est supérieur à 1,0, b est renvoyé.

color darker(color baseColor, real factor)

Renvoie une couleur plus foncée qu’ baseColor, d’un facteur factor.

La fonction convertit la couleur RVB actuelle en HSV, divise la composante de valeur (V) par le facteur, puis reconvertit la couleur en RVB.

Si le facteur est supérieur à 1,0, cette fonction renvoie une couleur plus foncée. En définissant le facteur sur 3,0, on obtient une couleur dont la luminosité est réduite d’un tiers. Si le facteur est inférieur à 1,0, la couleur renvoyée est plus claire, mais nous recommandons d’utiliser la fonction Color::lighter() à cette fin. Si le facteur est égal à 0 ou négatif, la valeur renvoyée n’est pas spécifiée.

bool equal(color lhs, color rhs)

Renvoie « true » si lhs et rhs sont égaux. Voir operator==().

color fromString(string name)

Renvoie la couleur correspondant à l'name on fournie (c'est-à-dire « rouge » ou #ff0000). Si cette couleur n'existe pas, une exception est levée.

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

Renvoie une couleur dont les composantes sont les suivantes : hue, saturation, lightness et alpha. Toutes les composantes doivent être comprises entre 0 et 1 (inclus).

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

Renvoie une couleur dont les composantes hue, saturation, value et alpha sont celles spécifiées. Toutes les composantes doivent être comprises entre 0 et 1 (inclus).

color lighter(color baseColor, real factor)

Renvoie une couleur plus claire qu'baseColor, selon le facteur de factor.

La fonction convertit la couleur RVB actuelle en HSV, multiplie la composante de valeur (V) par le facteur, puis reconvertit la couleur en RVB.

Si le facteur est supérieur à 1,0, cette fonction renvoie une couleur plus claire. Si le facteur est égal à 1,5, la couleur renvoyée est 50 % plus claire. Si le facteur est inférieur à 1,0, la couleur renvoyée est plus foncée, mais nous recommandons d’utiliser la fonction ` Color::darker()` à cette fin. Si le facteur est égal à 0 ou négatif, la valeur renvoyée n’est pas définie.

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

Renvoie une couleur dont les composantes red, green, blue et alpha sont celles spécifiées. Toutes les composantes doivent être comprises entre 0 et 1 (inclus).

color tint(color baseColor, color tintColor)

Cette fonction permet de teinter une couleur (baseColor) avec une autre (tintColor).

La couleur de teinte doit généralement être presque transparente, sinon vous ne pourrez pas voir la couleur sous-jacente. L'exemple ci-dessous apporte une légère teinte rouge en utilisant une couleur de teinte rouge pur, qui n'est opaque qu'à hauteur de 1/16e.

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

La teinte est particulièrement utile lorsqu'on souhaite exprimer un changement subtil lié à un événement donné ; vous pouvez alors utiliser la teinte pour ajuster plus efficacement la couleur visible.

color transparent(color color, real opacity)

Renvoie un objet de type « color » avec une valeur alpha de « opacity », comprise entre 0 (totalement transparent) et 1 (totalement opaque).