Color
Une couleur représentée au format RGBA (Red Green Blue Alpha, ou Rouge Vert Bleu Alpha en français).
Description
Une couleur représentée au format RGBA par une composante rouge (r), verte (g), bleue (b), et alpha (a). Chaque composante est une valeur flottante sur 32 bits, variant habituellement de 0.0 à 1.0. Certaines propriétés (comme CanvasItem.modulate) peuvent supporter des valeurs supérieures à 1.0, pour les couleurs overbright (litt. "surlumineuse") ou HDR (High Dynamic Range, "Grande plage dynamique").
Les couleurs peuvent être créées de différentes manières : Par les différents constructeurs Color, par des méthodes statiques telles que from_hsv(), et en utilisant un nom de l'ensemble des couleurs normalisées basées sur les noms de couleur X11 avec l'ajout de TRANSPARENT. GDScript fournit également @GDScript.Color8(), qui utilise des entiers de 0 à 255 et ne supporte pas les couleurs overbright.
Les données de couleur peuvent être stockées dans de nombreux espaces de couleurs et encodages. Les méthodes srgb_to_linear() et linear_to_srgb() peuvent convertir entre l'encodage non linéaire sRGB et l'encodage linéaire RGB.
Note : Dans un contexte booléen, une couleur évaluera à false si elle est égale à Color(0, 0, 0, 1) (noir opaque). Sinon, une couleur évaluera toujours à true.
Aide-mémoire des constantes de couleur
Note
Il y a des différences notables dans l'utilisation de cette API en C#. Voir Différences de l'API C# par rapport à GDScript pour plus d'informations.
Tutoriels
Propriétés
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
Constructeurs
Color() |
|
Méthodes
clamp(min: Color = Color(0, 0, 0, 0), max: Color = Color(1, 1, 1, 1)) const |
|
from_hsv(h: float, s: float, v: float, alpha: float = 1.0) static |
|
from_ok_hsl(h: float, s: float, l: float, alpha: float = 1.0) static |
|
from_rgba8(r8: int, g8: int, b8: int, a8: int = 255) static |
|
from_rgbe9995(rgbe: int) static |
|
from_string(str: String, default: Color) static |
|
get_luminance() const |
|
html_is_valid(color: String) static |
|
inverted() const |
|
is_equal_approx(to: Color) const |
|
linear_to_srgb() const |
|
srgb_to_linear() const |
|
to_abgr32() const |
|
to_abgr64() const |
|
to_argb32() const |
|
to_argb64() const |
|
to_rgba32() const |
|
to_rgba64() const |
Opérateurs
operator !=(right: Color) |
|
operator *(right: Color) |
|
operator *(right: float) |
|
operator *(right: int) |
|
operator +(right: Color) |
|
operator -(right: Color) |
|
operator /(right: Color) |
|
operator /(right: float) |
|
operator /(right: int) |
|
operator ==(right: Color) |
|
operator [](index: int) |
|
Constantes
ALICE_BLUE = Color(0.9411765, 0.972549, 1, 1) 🔗
Couleur bleu Alice.
ANTIQUE_WHITE = Color(0.98039216, 0.92156863, 0.84313726, 1) 🔗
Couleur blanc antique.
AQUA = Color(0, 1, 1, 1) 🔗
Couleur aqua.
AQUAMARINE = Color(0.49803922, 1, 0.83137256, 1) 🔗
Couleur aigue-marine.
AZURE = Color(0.9411765, 1, 1, 1) 🔗
Couleur azur.
BEIGE = Color(0.9607843, 0.9607843, 0.8627451, 1) 🔗
Couleur beige.
BISQUE = Color(1, 0.89411765, 0.76862746, 1) 🔗
Couleur bisque.
BLACK = Color(0, 0, 0, 1) 🔗
Couleur noire. Dans GDScript, c'est la valeur par défaut de chaque couleur.
BLANCHED_ALMOND = Color(1, 0.92156863, 0.8039216, 1) 🔗
Couleur amande blanchie.
BLUE = Color(0, 0, 1, 1) 🔗
Couleur bleue.
BLUE_VIOLET = Color(0.5411765, 0.16862746, 0.8862745, 1) 🔗
Couleur bleu violet.
BROWN = Color(0.64705884, 0.16470589, 0.16470589, 1) 🔗
Couleur marron.
BURLYWOOD = Color(0.87058824, 0.72156864, 0.5294118, 1) 🔗
Couleur bois dur.
CADET_BLUE = Color(0.37254903, 0.61960787, 0.627451, 1) 🔗
Couleur bleu cadet.
CHARTREUSE = Color(0.49803922, 1, 0, 1) 🔗
Couleur chartreuse.
CHOCOLATE = Color(0.8235294, 0.4117647, 0.11764706, 1) 🔗
Couleur chocolat.
CORAL = Color(1, 0.49803922, 0.3137255, 1) 🔗
Couleur corail.
CORNFLOWER_BLUE = Color(0.39215687, 0.58431375, 0.92941177, 1) 🔗
Couleur bleu bleuet.
CORNSILK = Color(1, 0.972549, 0.8627451, 1) 🔗
Couleur de la soie de maïs.
CRIMSON = Color(0.8627451, 0.078431375, 0.23529412, 1) 🔗
Couleur cramoisie.
CYAN = Color(0, 1, 1, 1) 🔗
Couleur cyan.
DARK_BLUE = Color(0, 0, 0.54509807, 1) 🔗
Couleur bleu foncé.
DARK_CYAN = Color(0, 0.54509807, 0.54509807, 1) 🔗
Couleur cyan foncé.
DARK_GOLDENROD = Color(0.72156864, 0.5254902, 0.043137256, 1) 🔗
Couleur verge d'or foncé.
DARK_GRAY = Color(0.6627451, 0.6627451, 0.6627451, 1) 🔗
Couleur gris foncé.
DARK_GREEN = Color(0, 0.39215687, 0, 1) 🔗
Couleur vert foncé.
DARK_KHAKI = Color(0.7411765, 0.7176471, 0.41960785, 1) 🔗
Couleur kaki foncé.
DARK_MAGENTA = Color(0.54509807, 0, 0.54509807, 1) 🔗
Couleur magenta foncé.
DARK_OLIVE_GREEN = Color(0.33333334, 0.41960785, 0.18431373, 1) 🔗
Couleur vert olive foncé.
DARK_ORANGE = Color(1, 0.54901963, 0, 1) 🔗
Couleur orange foncé.
DARK_ORCHID = Color(0.6, 0.19607843, 0.8, 1) 🔗
Couleur orchidée foncée.
DARK_RED = Color(0.54509807, 0, 0, 1) 🔗
Couleur rouge foncé.
DARK_SALMON = Color(0.9137255, 0.5882353, 0.47843137, 1) 🔗
Couleur saumon foncé.
DARK_SEA_GREEN = Color(0.56078434, 0.7372549, 0.56078434, 1) 🔗
Couleur vert mer foncé.
DARK_SLATE_BLUE = Color(0.28235295, 0.23921569, 0.54509807, 1) 🔗
Couleur bleu ardoise foncé.
DARK_SLATE_GRAY = Color(0.18431373, 0.30980393, 0.30980393, 1) 🔗
Couleur gris ardoise foncé.
DARK_TURQUOISE = Color(0, 0.80784315, 0.81960785, 1) 🔗
Couleur turquoise foncé.
DARK_VIOLET = Color(0.5803922, 0, 0.827451, 1) 🔗
Couleur violet foncé.
DEEP_PINK = Color(1, 0.078431375, 0.5764706, 1) 🔗
Couleur rose foncé.
DEEP_SKY_BLUE = Color(0, 0.7490196, 1, 1) 🔗
Couleur bleu ciel profond.
DIM_GRAY = Color(0.4117647, 0.4117647, 0.4117647, 1) 🔗
Couleur gris pâle.
DODGER_BLUE = Color(0.11764706, 0.5647059, 1, 1) 🔗
Couleur bleue Dodger.
FIREBRICK = Color(0.69803923, 0.13333334, 0.13333334, 1) 🔗
Couleur de brique feu.
FLORAL_WHITE = Color(1, 0.98039216, 0.9411765, 1) 🔗
Couleur blanche florale.
FOREST_GREEN = Color(0.13333334, 0.54509807, 0.13333334, 1) 🔗
Couleur vert forêt.
FUCHSIA = Color(1, 0, 1, 1) 🔗
Couleur fuchsia.
GAINSBORO = Color(0.8627451, 0.8627451, 0.8627451, 1) 🔗
Couleur Gainsboro.
GHOST_WHITE = Color(0.972549, 0.972549, 1, 1) 🔗
Couleur blanc fantôme.
GOLD = Color(1, 0.84313726, 0, 1) 🔗
Couleur or.
GOLDENROD = Color(0.85490197, 0.64705884, 0.1254902, 1) 🔗
Couleur verge d'or.
GRAY = Color(0.74509805, 0.74509805, 0.74509805, 1) 🔗
Couleur grise.
GREEN = Color(0, 1, 0, 1) 🔗
Couleur verte.
GREEN_YELLOW = Color(0.6784314, 1, 0.18431373, 1) 🔗
Couleur jaune verte.
HONEYDEW = Color(0.9411765, 1, 0.9411765, 1) 🔗
Couleur miel.
HOT_PINK = Color(1, 0.4117647, 0.7058824, 1) 🔗
Couleur rose vif.
INDIAN_RED = Color(0.8039216, 0.36078432, 0.36078432, 1) 🔗
Couleur rouge indienne.
INDIGO = Color(0.29411766, 0, 0.50980395, 1) 🔗
Couleur indigo.
IVORY = Color(1, 1, 0.9411765, 1) 🔗
Couleur ivoire.
KHAKI = Color(0.9411765, 0.9019608, 0.54901963, 1) 🔗
Couleur kaki.
LAVENDER = Color(0.9019608, 0.9019608, 0.98039216, 1) 🔗
Couleur lavande.
LAVENDER_BLUSH = Color(1, 0.9411765, 0.9607843, 1) 🔗
Couleur blush lavande.
LAWN_GREEN = Color(0.4862745, 0.9882353, 0, 1) 🔗
Couleur vert pelouse.
LEMON_CHIFFON = Color(1, 0.98039216, 0.8039216, 1) 🔗
Couleur mousseline citron.
LIGHT_BLUE = Color(0.6784314, 0.84705883, 0.9019608, 1) 🔗
Couleur bleu clair.
LIGHT_CORAL = Color(0.9411765, 0.5019608, 0.5019608, 1) 🔗
Couleur corail clair.
LIGHT_CYAN = Color(0.8784314, 1, 1, 1) 🔗
Couleur cyan clair.
LIGHT_GOLDENROD = Color(0.98039216, 0.98039216, 0.8235294, 1) 🔗
Couleur verge d'or clair.
LIGHT_GRAY = Color(0.827451, 0.827451, 0.827451, 1) 🔗
Couleur gris clair.
LIGHT_GREEN = Color(0.5647059, 0.93333334, 0.5647059, 1) 🔗
Couleur vert clair.
LIGHT_PINK = Color(1, 0.7137255, 0.75686276, 1) 🔗
Couleur rose clair.
LIGHT_SALMON = Color(1, 0.627451, 0.47843137, 1) 🔗
Couleur saumon clair.
LIGHT_SEA_GREEN = Color(0.1254902, 0.69803923, 0.6666667, 1) 🔗
Couleur vert mer clair.
LIGHT_SKY_BLUE = Color(0.5294118, 0.80784315, 0.98039216, 1) 🔗
Couleur bleu ciel clair.
LIGHT_SLATE_GRAY = Color(0.46666667, 0.53333336, 0.6, 1) 🔗
Couleur gris ardoise clair.
LIGHT_STEEL_BLUE = Color(0.6901961, 0.76862746, 0.87058824, 1) 🔗
Couleur bleu acier clair.
LIGHT_YELLOW = Color(1, 1, 0.8784314, 1) 🔗
Couleur jaune clair.
LIME = Color(0, 1, 0, 1) 🔗
Couleur citron vert.
LIME_GREEN = Color(0.19607843, 0.8039216, 0.19607843, 1) 🔗
Couleur vert citron.
LINEN = Color(0.98039216, 0.9411765, 0.9019608, 1) 🔗
Couleur lin.
MAGENTA = Color(1, 0, 1, 1) 🔗
Couleur magenta.
MAROON = Color(0.6901961, 0.1882353, 0.3764706, 1) 🔗
Couleur marron.
MEDIUM_AQUAMARINE = Color(0.4, 0.8039216, 0.6666667, 1) 🔗
Couleur bleu-marine moyenne.
MEDIUM_BLUE = Color(0, 0, 0.8039216, 1) 🔗
Couleur bleu moyen.
MEDIUM_ORCHID = Color(0.7294118, 0.33333334, 0.827451, 1) 🔗
Couleur orchidée moyenne.
MEDIUM_PURPLE = Color(0.5764706, 0.4392157, 0.85882354, 1) 🔗
Couleur violette moyenne.
MEDIUM_SEA_GREEN = Color(0.23529412, 0.7019608, 0.44313726, 1) 🔗
Couleur vert mer moyen.
MEDIUM_SLATE_BLUE = Color(0.48235294, 0.40784314, 0.93333334, 1) 🔗
Couleur bleu ardoise moyen.
MEDIUM_SPRING_GREEN = Color(0, 0.98039216, 0.6039216, 1) 🔗
Couleur vert printemps moyen.
MEDIUM_TURQUOISE = Color(0.28235295, 0.81960785, 0.8, 1) 🔗
Couleur turquoise moyenne.
MEDIUM_VIOLET_RED = Color(0.78039217, 0.08235294, 0.52156866, 1) 🔗
Couleur rouge violet moyen.
MIDNIGHT_BLUE = Color(0.09803922, 0.09803922, 0.4392157, 1) 🔗
Couleur bleu nuit.
MINT_CREAM = Color(0.9607843, 1, 0.98039216, 1) 🔗
Couleur crème menthe.
MISTY_ROSE = Color(1, 0.89411765, 0.88235295, 1) 🔗
Couleur rose brumeuse.
MOCCASIN = Color(1, 0.89411765, 0.70980394, 1) 🔗
Couleur mocassin.
Couleur blanche Navajo.
Couleur bleu marine.
OLD_LACE = Color(0.99215686, 0.9607843, 0.9019608, 1) 🔗
Couleur vieille dentelle.
OLIVE = Color(0.5019608, 0.5019608, 0, 1) 🔗
Couleur olive.
OLIVE_DRAB = Color(0.41960785, 0.5568628, 0.13725491, 1) 🔗
Couleur olive terne.
ORANGE = Color(1, 0.64705884, 0, 1) 🔗
Couleur orange.
ORANGE_RED = Color(1, 0.27058825, 0, 1) 🔗
Couleur rouge orangé.
ORCHID = Color(0.85490197, 0.4392157, 0.8392157, 1) 🔗
Couleur d’orchidée.
PALE_GOLDENROD = Color(0.93333334, 0.9098039, 0.6666667, 1) 🔗
Couleur verge d'or pâle.
PALE_GREEN = Color(0.59607846, 0.9843137, 0.59607846, 1) 🔗
Couleur vert pâle.
PALE_TURQUOISE = Color(0.6862745, 0.93333334, 0.93333334, 1) 🔗
Couleur turquoise pâle.
PALE_VIOLET_RED = Color(0.85882354, 0.4392157, 0.5764706, 1) 🔗
Couleur rouge violet pâle.
PAPAYA_WHIP = Color(1, 0.9372549, 0.8352941, 1) 🔗
Couleur de fouet de papaye.
PEACH_PUFF = Color(1, 0.85490197, 0.7254902, 1) 🔗
Couleur pêche bouffie.
PERU = Color(0.8039216, 0.52156866, 0.24705882, 1) 🔗
Couleur du Pérou.
PINK = Color(1, 0.7529412, 0.79607844, 1) 🔗
Couleur rose.
PLUM = Color(0.8666667, 0.627451, 0.8666667, 1) 🔗
Couleur prune.
POWDER_BLUE = Color(0.6901961, 0.8784314, 0.9019608, 1) 🔗
Couleur bleu poudre.
PURPLE = Color(0.627451, 0.1254902, 0.9411765, 1) 🔗
Couleur violette.
REBECCA_PURPLE = Color(0.4, 0.2, 0.6, 1) 🔗
Couleur violette Rebecca.
RED = Color(1, 0, 0, 1) 🔗
Couleur rouge.
ROSY_BROWN = Color(0.7372549, 0.56078434, 0.56078434, 1) 🔗
Couleur brun rosé.
ROYAL_BLUE = Color(0.25490198, 0.4117647, 0.88235295, 1) 🔗
Couleur bleu royal.
SADDLE_BROWN = Color(0.54509807, 0.27058825, 0.07450981, 1) 🔗
Couleur marron selle.
SALMON = Color(0.98039216, 0.5019608, 0.44705883, 1) 🔗
Couleur saumon.
SANDY_BROWN = Color(0.95686275, 0.6431373, 0.3764706, 1) 🔗
Couleur brun sable.
SEA_GREEN = Color(0.18039216, 0.54509807, 0.34117648, 1) 🔗
Couleur vert mer.
SEASHELL = Color(1, 0.9607843, 0.93333334, 1) 🔗
Couleur coquillage.
SIENNA = Color(0.627451, 0.32156864, 0.1764706, 1) 🔗
Couleur Sienne.
SILVER = Color(0.7529412, 0.7529412, 0.7529412, 1) 🔗
Couleur argent.
SKY_BLUE = Color(0.5294118, 0.80784315, 0.92156863, 1) 🔗
Couleur bleu ciel.
SLATE_BLUE = Color(0.41568628, 0.3529412, 0.8039216, 1) 🔗
Couleur bleu ardoise.
SLATE_GRAY = Color(0.4392157, 0.5019608, 0.5647059, 1) 🔗
Couleur gris ardoise.
SNOW = Color(1, 0.98039216, 0.98039216, 1) 🔗
Couleur neige.
SPRING_GREEN = Color(0, 1, 0.49803922, 1) 🔗
Couleur vert printanier.
STEEL_BLUE = Color(0.27450982, 0.50980395, 0.7058824, 1) 🔗
Couleur bleu acier.
TAN = Color(0.8235294, 0.7058824, 0.54901963, 1) 🔗
Couleur fauve.
TEAL = Color(0, 0.5019608, 0.5019608, 1) 🔗
Couleur sarcelle.
THISTLE = Color(0.84705883, 0.7490196, 0.84705883, 1) 🔗
Couleur chardon.
TOMATO = Color(1, 0.3882353, 0.2784314, 1) 🔗
Couleur tomate.
TRANSPARENT = Color(1, 1, 1, 0) 🔗
Couleur transparente (blanc avec alpha nul).
TURQUOISE = Color(0.2509804, 0.8784314, 0.8156863, 1) 🔗
Couleur turquoise.
VIOLET = Color(0.93333334, 0.50980395, 0.93333334, 1) 🔗
Couleur violette.
WEB_GRAY = Color(0.5019608, 0.5019608, 0.5019608, 1) 🔗
Couleur gris Web.
WEB_GREEN = Color(0, 0.5019608, 0, 1) 🔗
Couleur vert Web.
WEB_MAROON = Color(0.5019608, 0, 0, 1) 🔗
Couleur marron Web.
WEB_PURPLE = Color(0.5019608, 0, 0.5019608, 1) 🔗
Couleur violet Web.
WHEAT = Color(0.9607843, 0.87058824, 0.7019608, 1) 🔗
Couleur blé.
WHITE = Color(1, 1, 1, 1) 🔗
Couleur blanche.
WHITE_SMOKE = Color(0.9607843, 0.9607843, 0.9607843, 1) 🔗
Couleur fumée blanche.
YELLOW = Color(1, 1, 0, 1) 🔗
Couleur jaune.
YELLOW_GREEN = Color(0.6039216, 0.8039216, 0.19607843, 1) 🔗
Couleur vert jaune.
Descriptions des propriétés
La composante alpha de la couleur, généralement dans l’intervalle allant de 0 à 1. Une valeur de 0 signifie que la couleur est entièrement transparente. Une valeur de 1 signifie que la couleur est entièrement opaque.
Note : Le canal alpha est toujours stocké avec un encodage linéaire, peu importe l'espace de couleur des autres canaux de couleur. Les méthodes linear_to_srgb() et srgb_to_linear() n'affectent pas le canal alpha.
Wrapper pour le a qui utilise l'intervalle de 0 à 255 plutôt que de 0 à 1.
Le composant bleu de la couleur, généralement de 0 à 1.
Wrapper pour le b qui utilise l'intervalle de 0 à 255 plutôt que de 0 à 1.
Le composant vert de la couleur, généralement de 0 à 1.
Wrapper pour le g qui utilise l'intervalle de 0 à 255 plutôt que de 0 à 1.
La teinte TSV de cette couleur, dans l'intervalle de 0 à 1.
La teinte OKHSL de cette couleur, dans l'intervalle de 0 à 1.
La luminosité OKHSL de cette couleur, dans l'intervalle de 0 à 1.
La saturation OKHSL de cette couleur, dans l'intervalle de 0 à 1.
Le composant rouge de la couleur, généralement de 0 à 1.
Wrapper pour le r qui utilise l'intervalle de 0 à 255 plutôt que de 0 à 1.
La saturation TSV de cette couleur, dans l'intervalle de 0 à 1.
La valeur TSV (luminosité) de cette couleur, dans l'intervalle de 0 à 1.
Descriptions des constructeurs
Construit une Color par défaut depuis un noir opaque. Identique à BLACK.
Note : En C#, cela construit une Color avec toutes ses composantes définies à 0.0 (noir transparent).
Color Color(from: Color, alpha: float)
Construit une Color depuis une couleur existante avec a défini à la valeur d'alpha donnée.
var rouge = Color(Color.RED, 0.2) # Rouge 20% opaque.
var rouge = new Color(Colors.Red, 0.2f); // Rouge 20% opaque.
Construit une Color comme copie d'une Color donnée.
Construit une Color soit depuis un code de couleur HTML, soit depuis un nom standardisé de couleur. Les noms de couleur supportés sont les mêmes que les constantes.
Color Color(code: String, alpha: float)
Construit une Color soit depuis un code de couleur HTML, soit depuis un nom standardisé de couleur, avec un alpha entre 0.0 et 1.0. Les noms de couleur supportés sont les mêmes que les constantes.
Color Color(r: float, g: float, b: float)
Construit une Color depuis des valeurs Rouge Vertes Bleues, typiquement entre 0.0 et 1.0. a est défini à 1.0
var couleur = Color(0.2, 1.0, 0.7) # Similaire à `Color8(51, 255, 178, 255)`
var couleur = Color(0.2f, 1.0f, 0.7f); # Similaire à `Color.Color8(51, 255, 178, 255)`
Color Color(r: float, g: float, b: float, a: float)
Construit une Color depuis des valeurs Rouge Vertes Bleues Alpha, typiquement entre 0.0 et 1.0.
var couleur = Color(0.2, 1.0, 0.7, 0.8) # Similaire à `Color8(51, 255, 178, 204)`
var couleur = Color(0.2f, 1.0f, 0.7f, 0.8f); # Similaire à `Color.Color8(51, 255, 178, 204)`
Descriptions des méthodes
Color blend(over: Color) const 🔗
Renvoie une nouvelle couleur résultant de la superposition de cette couleur sur la couleur donnée. Dans un logiciel de peinture, vous pouvez imaginer cela comme la couleur over peinte sur cette couleur (y compris l'alpha).
var couleur_derriere = Color(0.0, 1.0, 0.0, 0.5) # Vert avec un alpha de 50%
var couleur_devant = Color(1.0, 0.0, 0.0, 0.5) # Rouge avec un alpha de 50%
var couleur_melangee = couleur_derriere .blend(couleur_devant) # Brun avec un alpha de 75%
var couleurDerriere = new Color(0.0f, 1.0f, 0.0f, 0.5f); // Vert avec un alpha de 50%
var couleurDevant = new Color(1.0f, 0.0f, 0.0f, 0.5f); // Rouge avec un alpha de 50%
Color couleurMelangee = couleurDerriere.Blend(couleurDevant); // Brun avec un alpha de 75%
Color clamp(min: Color = Color(0, 0, 0, 0), max: Color = Color(1, 1, 1, 1)) const 🔗
Renvoie une nouvelle couleur avec toutes les composantes bornées entre les composantes de min et max, en exécutant @GlobalScope.clamp() sur chaque composante.
Color darkened(amount: float) const 🔗
Renvoie une nouvelle couleur résultant du fait de rendre cette couleur plus foncée par la quantité amount spécifiée (ratio de 0.0 à 1.0). Voir aussi lightened().
var vert = Couleur(0.0, 1.0, 0.0)
var vertfonce= vert.darkened(0.2) # 20% plus foncé que le vert habituel
var vert = new Color(0.0f, 1.0f, 0.0f);
Color vertfonce = vert.Darkened(0,2f); // 20% plus foncé que le vert habituel
Color from_hsv(h: float, s: float, v: float, alpha: float = 1.0) static 🔗
Construit une couleur depuis un profil TSV (Hue Saturation Value, litt. Teinte Saturation Valeur). La teinte (h), la saturation (s) et la valeur (v) sont typiquement entre 0.0 et 1.0.
var couleur = Color.from_hsv(0.58, 0.5, 0.79, 0.8)
var couleur = Color.FromHsv(0.58f, 0.5f, 0.79f, 0.8f);
Color from_ok_hsl(h: float, s: float, l: float, alpha: float = 1.0) static 🔗
Construit une couleur depuis un profil OK TSL. La teinte (h), la saturation (s) et la lumière (l) sont typiquement entre 0.0 et 1.0.
var couleur = Color.from_ok_hsl(0.58, 0.5, 0.79, 0.8)
var couleur = Color.FromOkHsl(0.58f, 0.5f, 0.79f, 0.8f);
Color from_rgba8(r8: int, g8: int, b8: int, a8: int = 255) static 🔗
Renvoie une Color construite à partir de canaux entiers de rouge (r8), de vert (g8), de bleu (b8) et éventuellement de transparence (ou alpha : a8), chacun divisé par 255.0 pour obtenir sa valeur finale.
var rouge = Color.from_rgba8(255, 0, 0) # Identique à Color(1, 0, 0).
var bleu_fonce = Color.from_rgba8(0, 0, 51) # Identique à Color(0, 0, 0.2).
var ma_couleur = Color.from_rgba8(306, 255, 0, 102) # Identique à Color(1.2, 1, 0, 0.4).
Note : En raison de la précision inférieure de from_rgba8() par rapport au constructeur Color standard, une couleur créée avec from_rgba8() ne sera généralement pas égale à la même couleur créée avec le constructeur Color standard. Utilisez is_equal_approx() pour les comparaisons afin d'éviter les problèmes d'erreur de précision de virgule flottante.
Color from_rgbe9995(rgbe: int) static 🔗
Décode une Color depuis un format RGBE9995 entier. Voir Image.FORMAT_RGBE9995.
Color from_string(str: String, default: Color) static 🔗
Crée un Color depuis la chaîne donnée, qui peut être soit un code de couleur HTML ou une couleur nommée (insensible à la casse). Renvoie default si la couleur ne peut pas être déduite de la chaîne.
Si vous voulez créer une couleur depuis une chaîne dans une expression constante, utilisez plutôt le constructeur équivalent (c.-à-d. Color("chaîne de la couleur")).
Renvoie l'intensité lumineuse de la couleur, en tant que valeur entre 0.0 et 1.0 (inclusive). Ceci est utile pour déterminer si la couleur est claire ou foncée. Les couleurs avec une luminance inférieure à 0,5 peuvent généralement être considérées comme foncées.
Note : get_luminance() s'appuie sur la couleur étant dans l'espace de couleur linéaire pour renvoyer une valeur de luminosité relative exacte. Si la couleur est dans l'espace de couleur sRGB, utilisez srgb_to_linear() pour la convertir en l'espace de couleur linéaire d'abord.
Renvoie la Color associée à l'entier hex fourni en format RGBA 32 bits (8 bits par canal). Cette méthode est l'inverse de to_rgba32().
En GDScript et C#, la meilleure façon de visualiser l'int est avec la notation hexadécimale ("0x", ce qui fait "0xRRGGBBAA").
var rouge = Color.hex(0xff0000ff)
var cyan_fonce = Color.hex(0x008b8bff)
var ma_couleur = Color.hex(0xbbefd2a4)
var rouge = new Color(0xff0000ff);
var cyan_fonce = new Color(0x008b8bff);
var ma_couleur = new Color(0xbbefd2a4);
Si vous voulez utiliser la notation hexadécimale dans une expression constante, utilisez plutôt le constructeur équivalent (c.-à-d. Color(0xRRGGBBAA)).
Color hex64(hex: int) static 🔗
Renvoie la Color associée avec l’entier hex en format 64 bits RGBA spécifié (16 bits par canal). Cette méthode est l’inverse de to_rgba64().
En GDScript et en C#, l’entier int est mieux visualisé avec la notation hexadécimale (préfixe "0x", ce qui donne "0xRRRRGGGGBBBBAAAA").
Color html(rgba: String) static 🔗
Renvoie une nouvelle couleur depuis rgba, une chaîne de couleur hexadécimale HTML. rgba n'est pas sensible à la casse et peut être préfixée par un signe de croisillon (#).
rgba doit être une chaîne de couleur hexadécimale à trois ou six chiffres valide, et peut contenir une valeur de canal alpha. Si rgba ne contient pas de valeur de canal alpha, une valeur de canal alpha de 1,0 est appliquée. Si rgba est invalide, renvoie une couleur vide.
var bleu = Color.html("#0000ff") # bleu vaut Color(0.0, 0.0, 1.0, 1.0)
var vert = Color.html("#0F0") # vert vaut Color(0.0, 1.0, 0.0, 1.0)
var col = Color.html("663399cc") # col vaut Color(0.4, 0.2, 0.6, 0.8)
var bleu = Color.FromHtml("#0000ff"); // bleu vaut Color(0.0, 0.0, 1.0, 1.0)
var vert = Color.FromHtml("#0F0"); // vert vaut Color(0.0, 1.0, 0.0, 1.0)
var col = Couleur.FromHtml("663399cc"); // col vaut Color(0.4, 0.2, 0.6, 0.8)
bool html_is_valid(color: String) static 🔗
Renvoie true si color est une chaîne de couleur hexadécimale HTML valide. La chaîne doit être une valeur hexadécimale (insensible à la casse) de 3, 4, 6 ou 8 chiffres, et peut être préfixée par un signe de croisillon (#). Cette méthode est identique à String.is_valid_html_color().
Color.html_is_valid("#55aaFF") # Renvoie true
Color.html_is_valid("#55AAFF20") # Renvoie true
Color.html_is_valid("55AAFF") # Renvoie true
Color.html_is_valid("#F2C") # Renvoie true
Color.html_is_valid("#AABBC") # Renvoie false
Color.html_is_valid("#55aaFF5") # Renvoie false
Color.HtmlIsValid("#55AAFF"); // Renvoie true
Color.HtmlIsValid("#55AAFF20"); // Renvoie true
Color.HtmlIsValid("55AAFF"); // Renvoie true
Color.HtmlIsValid("#F2C"); // Renvoie true
Color.HtmlIsValid("#AABBC"); // Renvoie false
Color.HtmlIsValid("#55aaFF5"); // Renvoie false
Renvoie la couleur avec ses composantes r, g et b inversées ((1 - r, 1 - g, 1 - b, a)).
var noir = Color.WHITE.inverted()
var couleur = Color(0.3, 0.4, 0.9)
var couleur_inversee = couleur.inverted() # Équivalent à `Color(0.7, 0.6, 0.1)`
var noir = Colors.White.Inverted();
var couleur = new Color(0.3f, 0.4f, 0.9f);
Color couleurInversee = couleur.Inverted(); // Équivalent à `new Color(0.7f, 0.6f, 0.1f)`
bool is_equal_approx(to: Color) const 🔗
Renvoie true si cette couleur et to sont approximativement égales, en exécutant @GlobalScope.is_equal_approx() sur chaque composante.
Color lerp(to: Color, weight: float) const 🔗
Renvoie l'interpolation linéaire entre les composantes de cette couleur et les composantes de to. Le facteur d'interpolation weight devrait être compris entre 0,0 et 1,0 (inclusifs). Voir aussi @GlobalScope.lerp().
var rouge = Color(1.0, 0.0, 0.0)
var bleu_vert = Color(0.0, 1.0, 0.8)
rouge.lerp(bleu_vert, 0.2) # Renvoie Color(0.8, 0.2, 0.16)
rouge.lerp(bleu_vert, 0.5) # Renvoie Color(0.5, 0.5, 0.4)
rouge.lerp(bleu_vert, 1.0) # Renvoie Color(0.0, 1.0, 0.8)
var rouge = new Color(1.0f, 0.0f, 0.0f);
var bleuVert = new Color(0.0f, 1.0f, 0.8f);
rouge.Lerp(bleuVert, 0.2f); // Renvoie Color(0.8f, 0.2f, 0.16f)
rouge.Lerp(bleuVert, 0.5f); // Renvoie Color(0.5f, 0.5f, 0.4f)
rouge.Lerp(bleuVert, 1.0f); // Renvoie Color(0.0f, 1.0f, 0.8f)
Color lightened(amount: float) const 🔗
Renvoie une nouvelle couleur résultant du fait de rendre cette couleur plus claire par la quantité amount spécifiée (ratio de 0.0 à 1.0). Voir aussi darkened().
var vert = Couleur(0.0, 1.0, 0.0)
var vert_clair = vert.lightened(0.2) # 20% plus clair que le vert habituel
var vert = new Color(0.0f, 1.0f, 0.0f);
Color vertClair= vert.Lightened(0,2f); // 20% plus clair que le vert habituel
Color linear_to_srgb() const 🔗
Renvoie la couleur convertie dans l'espace de couleur sRGB. Cette méthode suppose que la couleur originale est dans l'espace de couleur linéaire. Voir aussi srgb_to_linear() qui effectue l'opération inverse.
Note : La couleur du canal alpha n'est pas affectée. Le canal alpha est toujours stocké dans un encodage linéaire, peu importe l'espace de couleur des autres canaux de couleur.
Color srgb_to_linear() const 🔗
Renvoie la couleur convertie dans l'espace de couleur linéaire. Cette méthode suppose que la couleur originale soit déjà dans l'espace de couleur sRGB. Voir aussi linear_to_srgb() qui effectue l'opération inverse.
Note : La couleur du canal alpha n'est pas affectée. Le canal alpha est toujours stocké dans un encodage linéaire, peu importe l'espace de couleur des autres canaux de couleur.
Renvoie la couleur convertie en entier 32 bits en format ABGR (chaque composante est sur 8 bits). ABGR est la version inversée du format RGBA par défaut.
var couleur = Color(1, 0.5, 0.2)
print(couleur.to_abgr32()) # Affiche 4281565439
var couleur = new Color(1.0f, 0.5f, 0.2f);
GD.Print(couleur.ToAbgr32()); // Affiche 4281565439
Renvoie la couleur convertie en entier 64 bits en format ABGR (chaque composante est sur 16 bits). ABGR est la version inversée du format RGBA par défaut.
var couleur = Color(1, 0.5, 0.2)
print(couleur.to_abgr64()) # Affiche -225178692812801
var couleur = new Color(1.0f, 0.5f, 0.2f);
GD.Print(couleur.ToAbgr64()); // Affiche -225178692812801
Renvoie la couleur convertie en entier 32 bits en format ABGR (chaque composante est sur 8 bits). ABGR est plus compatible avec DirectX.
var couleur = Color(1, 0.5, 0.2)
print(couleur.to_argb32()) # Affiche 4294934323
var couleur = new Color(1.0f, 0.5f, 0.2f);
GD.Print(couleur.ToArgb32()); // Affiche 4294934323
Renvoie la couleur convertie en entier 64 bits en format ABGR (chaque composante est sur 16 bits). ABGR est plus compatible avec DirectX.
var couleur = Color(1, 0.5, 0.2)
print(couleur.to_argb64()) # Affiche -2147470541
var couleur = new Color(1.0f, 0.5f, 0.2f);
GD.Print(couleur.ToArgb64()); // Affiche -2147470541
String to_html(with_alpha: bool = true) const 🔗
Renvoie la couleur convertie en une String de couleur hexadécimale HTML en format RGBA, sans le préfixe croisillon (#).
Définir with_alpha à false exclut l’alpha de la chaîne hexadécimale, en utilisant un format RGB, au lieu de RGBA.
var blanc = Color(1, 1, 1, 0,5)
var avec_alpha = blanc.to_html() # Renvoie "ffff7f"
var sans_alpha = blanc.to_html(false) # Renvoie "ffffff"
var blanc = new Color(1, 1, 1, 0,5f);
string avecAlpha = blanc.ToHtml(); // Renvoie "ffff7f"
string sansAlpha = blanc.ToHtml(false); // Renvoie "ffffff"
Renvoie la couleur convertie en un entier de 32 bits au format RGBA (chaque composante est sur 8 bits). RGBA est le format par défaut de Godot. Cette méthode est l'inverse de hex().
var couleur = Color(1, 0,5, 0,2)
print(couleur.to_rgba32()) # Affiche 4286526463
var couleur = new Color(1, 0,5f, 0,2f);
GD.Print(couleur.ToRgba32()); // Affiche 4286526463
Renvoie la couleur convertie en un entier de 64 bits au format RGBA (chaque composante est sur 16 bits). RGBA est le format par défaut de Godot. Cette méthode est l'inverse de hex64().
var couleur = Color(1, 0,5, 0,2)
print(couleur.to_rgba64()) # Affiche -140736629309441
var couleur = new Color(1, 0,5f, 0,2f);
GD.Print(couleur.ToRgba64()); // Affiche -140736629309441
Descriptions des opérateurs
bool operator !=(right: Color) 🔗
Renvoie true si les couleurs ne sont pas exactement égales.
Note : À cause des erreurs de précision des flottants, envisagez d'utiliser is_equal_approx() à la place, qui est plus fiable.
Color operator *(right: Color) 🔗
Multiplie chaque composante de la couleur Color par les composantes de la couleur Color donnée.
Color operator *(right: float) 🔗
Multiplie chaque composante de la couleur Color par le flottant float donné.
Color operator *(right: int) 🔗
Multiplie chaque composante de la couleur Color par l'entier int donné.
Color operator +(right: Color) 🔗
Ajoute chaque composante de cette Color avec les composantes de la Color donnée.
Color operator -(right: Color) 🔗
Soustrait chaque composante de cette Color par les composantes de la Color donnée.
Color operator /(right: Color) 🔗
Divise chaque composante de cette Color par les composantes de la Color donnée.
Color operator /(right: float) 🔗
Divise chaque composante de la Color par le flottant float donné.
Color operator /(right: int) 🔗
Divise chaque composante de la Color par l'entier int donné.
bool operator ==(right: Color) 🔗
Renvoie true si les couleurs sont exactement égales.
Note : À cause des erreurs de précision des flottants, envisagez d'utiliser is_equal_approx() à la place, qui est plus fiable.
float operator [](index: int) 🔗
Accède aux composantes de la couleur en utilisant leur index. [0] est équivalent à r, [1] est équivalent à g, [2] est équivalent à b, et [3] est équivalent à a.
Renvoie la même valeur comme si + n'était pas là. Le + unaire ne fait rien, mais peut parfois rendre votre code plus lisible.
Inverse la couleur donnée. Ceci est équivalent à Color.WHITE - c ou Color(1 - c.r, 1 - c.g, 1 - c.b, 1 - c.a). Contrairement a inverted(), la composante a est aussi inversée.