Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

Color

Une couleur représentée au format RGBA (Red Green Blue Alpha, ou Rouge Vert Bleu Alpha en français).

Description

A color represented in RGBA format by a red (r), green (g), blue (b), and alpha (a) component. Each component is a 32-bit floating-point value, usually ranging from 0.0 to 1.0. Some properties (such as CanvasItem.modulate) may support values greater than 1.0, for overbright or HDR (High Dynamic Range) colors.

Colors can be created in a number of ways: By the various Color constructors, by static methods such as from_hsv(), and by using a name from the set of standardized colors based on X11 color names with the addition of TRANSPARENT.

Color constants cheatsheet

Although Color may be used to store values of any encoding, the red (r), green (g), and blue (b) properties of Color are expected by Godot to be encoded using the nonlinear sRGB transfer function unless otherwise stated. This color encoding is used by many traditional art and web tools, making it easy to match colors between Godot and these tools. Godot uses Rec. ITU-R BT.709 color primaries, which are used by the sRGB standard.

All physical simulation, such as lighting calculations, and colorimetry transformations, such as get_luminance(), must be performed on linearly encoded values to produce correct results. When performing these calculations, convert Color to and from linear encoding using srgb_to_linear() and linear_to_srgb().

Note: In a boolean context, a Color will evaluate to false if it is equal to Color(0, 0, 0, 1) (opaque black). Otherwise, a Color will always evaluate to true.

Note: In C#, color constants are defined in the Colors static class instead of Color. Additionally, named colors use PascalCase syntax instead of UPPER_SNAKE_CASE. For example, Color.ALICE_BLUE in GDScript is Colors.AliceBlue in C#.

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

float	a	`1.0`
int	a8	`255`
float	b	`0.0`
int	b8	`0`
float	g	`0.0`
int	g8	`0`
float	h	`0.0`
float	ok_hsl_h	`0.0`
float	ok_hsl_l	`0.0`
float	ok_hsl_s	`0.0`
float	r	`0.0`
int	r8	`0`
float	s	`0.0`
float	v	`0.0`

Constructeurs

Color	Color()
Color	Color(from: Color, alpha: float)
Color	Color(from: Color)
Color	Color(code: String)
Color	Color(code: String, alpha: float)
Color	Color(r: float, g: float, b: float)
Color	Color(r: float, g: float, b: float, a: float)

Méthodes

Color	blend(over: Color) const
Color	clamp(min: Color = Color(0, 0, 0, 0), max: Color = Color(1, 1, 1, 1)) const
Color	darkened(amount: float) const
Color	from_hsv(h: float, s: float, v: float, alpha: float = 1.0) static
Color	from_ok_hsl(h: float, s: float, l: float, alpha: float = 1.0) static
Color	from_rgba8(r8: int, g8: int, b8: int, a8: int = 255) static
Color	from_rgbe9995(rgbe: int) static
Color	from_string(str: String, default: Color) static
float	get_luminance() const
Color	hex(hex: int) static
Color	hex64(hex: int) static
Color	html(rgba: String) static
bool	html_is_valid(color: String) static
Color	inverted() const
bool	is_equal_approx(to: Color) const
Color	lerp(to: Color, weight: float) const
Color	lightened(amount: float) const
Color	linear_to_srgb() const
Color	srgb_to_linear() const
int	to_abgr32() const
int	to_abgr64() const
int	to_argb32() const
int	to_argb64() const
String	to_html(with_alpha: bool = true) const
int	to_rgba32() const
int	to_rgba64() const

Opérateurs

bool	operator !=(right: Color)
Color	operator *(right: Color)
Color	operator *(right: float)
Color	operator *(right: int)
Color	operator +(right: Color)
Color	operator -(right: Color)
Color	operator /(right: Color)
Color	operator /(right: float)
Color	operator /(right: int)
bool	operator ==(right: Color)
float	operator [](index: int)
Color	operator unary+()
Color	operator unary-()

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.

NAVAJO_WHITE = Color(1, 0.87058824, 0.6784314, 1) 🔗

Couleur blanche Navajo.

NAVY_BLUE = Color(0, 0, 0.5019608, 1) 🔗

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

float a = 1.0 🔗

The color's alpha component, typically on the range of 0 to 1. A value of 0 means that the color is fully transparent. A value of 1 means that the color is fully opaque.

Note: The alpha channel is always stored with linear encoding, regardless of the encoding of the other color channels. The linear_to_srgb() and srgb_to_linear() methods do not affect the alpha channel.

int a8 = 255 🔗

Wrapper pour le a qui utilise l'intervalle de 0 à 255 plutôt que de 0 à 1.

float b = 0.0 🔗

Le composant bleu de la couleur, généralement de 0 à 1.

int b8 = 0 🔗

Wrapper pour le b qui utilise l'intervalle de 0 à 255 plutôt que de 0 à 1.

float g = 0.0 🔗

Le composant vert de la couleur, généralement de 0 à 1.

int g8 = 0 🔗

Wrapper pour le g qui utilise l'intervalle de 0 à 255 plutôt que de 0 à 1.

float h = 0.0 🔗

La teinte TSV de cette couleur, dans l'intervalle de 0 à 1.

float ok_hsl_h = 0.0 🔗

La teinte OKHSL de cette couleur, dans l'intervalle de 0 à 1.

float ok_hsl_l = 0.0 🔗

La luminosité OKHSL de cette couleur, dans l'intervalle de 0 à 1.

float ok_hsl_s = 0.0 🔗

La saturation OKHSL de cette couleur, dans l'intervalle de 0 à 1.

float r = 0.0 🔗

Le composant rouge de la couleur, généralement de 0 à 1.

int r8 = 0 🔗

Wrapper pour le r qui utilise l'intervalle de 0 à 255 plutôt que de 0 à 1.

float s = 0.0 🔗

La saturation TSV de cette couleur, dans l'intervalle de 0 à 1.

float v = 0.0 🔗

La valeur TSV (luminosité) de cette couleur, dans l'intervalle de 0 à 1.

Descriptions des constructeurs

Color Color() 🔗

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.

Color Color(from: Color)

Construit une Color comme copie d'une Color donnée.

Color Color(code: String)

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 Vert Bleu Alpha, typiquement entre 0.0 et 1.0.

var couleur = Color(0.2, 1.0, 0.7, 0.8) # Similaire à `Color.from_rgba8(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")).

float get_luminance() const 🔗

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 le fait que la couleur utilise un encodage linéaire pour renvoyer une valeur de luminosité relative exacte. Si la couleur utilise l'encodage sRGB non-linéaire par défaut, utilisez srgb_to_linear() pour la convertir en encodage linéaire d'abord.

Color hex(hex: int) static 🔗

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

Color inverted() const 🔗

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 🔗

Returns a copy of the color that is encoded using the nonlinear sRGB transfer function. This method requires the original color to use linear encoding. See also srgb_to_linear() which performs the opposite operation.

Note: The color's alpha channel (a) is not affected. The alpha channel is always stored with linear encoding, regardless of the color space of the other color channels.

Color srgb_to_linear() const 🔗

Returns a copy of the color that uses linear encoding. This method requires the original color to be encoded using the nonlinear sRGB transfer function. See also linear_to_srgb() which performs the opposite operation.

Note: The color's alpha channel (a) is not affected. The alpha channel is always stored with linear encoding, regardless of the color space of the other color channels.

int to_abgr32() const 🔗

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

int to_abgr64() const 🔗

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

int to_argb32() const 🔗

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

int to_argb64() const 🔗

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"

int to_rgba32() const 🔗

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

int to_rgba64() const 🔗

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.

Color operator unary+() 🔗

Renvoie la même valeur comme si + n'était pas là. Le + unaire ne fait rien, mais peut parfois rendre votre code plus lisible.

Color operator unary-() 🔗

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.