Color¶

Color in RGBA format using floats on the range of 0 to 1.

Description¶

A color represented by red, green, blue, and alpha (RGBA) components. The alpha component is often used for opacity. Values are in floating-point and usually range from 0 to 1. Some properties (such as CanvasItem.modulate) may accept values greater than 1 (overbright or HDR colors).

You can also create a color from standardized color names by using@GDScript.ColorN or directly using the color constants defined here. The standardized color set is based on theX11 color names.

If you want to supply values in a range of 0 to 255, you should use@GDScript.Color8.

Note: In a boolean context, a Color will evaluate tofalse if it's equal toColor(0,0,0,1) (opaque black). Otherwise, a Color will always evaluate totrue.

Color constants cheatsheet

Tutorials¶

Properties¶

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	r	`0.0`
int	r8	`0`
float	s	`0.0`
float	v	`0.0`

Methods¶

Color	Color(String from)
Color	Color(int from)
Color	Color(float r,float g,float b)
Color	Color(float r,float g,float b,float a)
Color	blend(Color over)
Color	contrasted()
Color	darkened(float amount)
Color	from_hsv(float h,float s,float v,float a=1.0)
float	gray()
Color	inverted()
bool	is_equal_approx(Color color)
Color	lightened(float amount)
Color	linear_interpolate(Color to,float weight)
int	to_abgr32()
int	to_abgr64()
int	to_argb32()
int	to_argb64()
String	to_html(bool with_alpha=true)
int	to_rgba32()
int	to_rgba64()

Constants¶

aliceblue =Color( 0.94, 0.97, 1, 1 ) --- Alice blue color.
antiquewhite =Color( 0.98, 0.92, 0.84, 1 ) --- Antique white color.
aqua =Color( 0, 1, 1, 1 ) --- Aqua color.
aquamarine =Color( 0.5, 1, 0.83, 1 ) --- Aquamarine color.
azure =Color( 0.94, 1, 1, 1 ) --- Azure color.
beige =Color( 0.96, 0.96, 0.86, 1 ) --- Beige color.
bisque =Color( 1, 0.89, 0.77, 1 ) --- Bisque color.
black =Color( 0, 0, 0, 1 ) --- Black color.
blanchedalmond =Color( 1, 0.92, 0.8, 1 ) --- Blanche almond color.
blue =Color( 0, 0, 1, 1 ) --- Blue color.
blueviolet =Color( 0.54, 0.17, 0.89, 1 ) --- Blue violet color.
brown =Color( 0.65, 0.16, 0.16, 1 ) --- Brown color.
burlywood =Color( 0.87, 0.72, 0.53, 1 ) --- Burly wood color.
cadetblue =Color( 0.37, 0.62, 0.63, 1 ) --- Cadet blue color.
chartreuse =Color( 0.5, 1, 0, 1 ) --- Chartreuse color.
chocolate =Color( 0.82, 0.41, 0.12, 1 ) --- Chocolate color.
coral =Color( 1, 0.5, 0.31, 1 ) --- Coral color.
cornflower =Color( 0.39, 0.58, 0.93, 1 ) --- Cornflower color.
cornsilk =Color( 1, 0.97, 0.86, 1 ) --- Corn silk color.
crimson =Color( 0.86, 0.08, 0.24, 1 ) --- Crimson color.
cyan =Color( 0, 1, 1, 1 ) --- Cyan color.
darkblue =Color( 0, 0, 0.55, 1 ) --- Dark blue color.
darkcyan =Color( 0, 0.55, 0.55, 1 ) --- Dark cyan color.
darkgoldenrod =Color( 0.72, 0.53, 0.04, 1 ) --- Dark goldenrod color.
darkgray =Color( 0.66, 0.66, 0.66, 1 ) --- Dark gray color.
darkgreen =Color( 0, 0.39, 0, 1 ) --- Dark green color.
darkkhaki =Color( 0.74, 0.72, 0.42, 1 ) --- Dark khaki color.
darkmagenta =Color( 0.55, 0, 0.55, 1 ) --- Dark magenta color.
darkolivegreen =Color( 0.33, 0.42, 0.18, 1 ) --- Dark olive green color.
darkorange =Color( 1, 0.55, 0, 1 ) --- Dark orange color.
darkorchid =Color( 0.6, 0.2, 0.8, 1 ) --- Dark orchid color.
darkred =Color( 0.55, 0, 0, 1 ) --- Dark red color.
darksalmon =Color( 0.91, 0.59, 0.48, 1 ) --- Dark salmon color.
darkseagreen =Color( 0.56, 0.74, 0.56, 1 ) --- Dark sea green color.
darkslateblue =Color( 0.28, 0.24, 0.55, 1 ) --- Dark slate blue color.
darkslategray =Color( 0.18, 0.31, 0.31, 1 ) --- Dark slate gray color.
darkturquoise =Color( 0, 0.81, 0.82, 1 ) --- Dark turquoise color.
darkviolet =Color( 0.58, 0, 0.83, 1 ) --- Dark violet color.
deeppink =Color( 1, 0.08, 0.58, 1 ) --- Deep pink color.
deepskyblue =Color( 0, 0.75, 1, 1 ) --- Deep sky blue color.
dimgray =Color( 0.41, 0.41, 0.41, 1 ) --- Dim gray color.
dodgerblue =Color( 0.12, 0.56, 1, 1 ) --- Dodger blue color.
firebrick =Color( 0.7, 0.13, 0.13, 1 ) --- Firebrick color.
floralwhite =Color( 1, 0.98, 0.94, 1 ) --- Floral white color.
forestgreen =Color( 0.13, 0.55, 0.13, 1 ) --- Forest green color.
fuchsia =Color( 1, 0, 1, 1 ) --- Fuchsia color.
gainsboro =Color( 0.86, 0.86, 0.86, 1 ) --- Gainsboro color.
ghostwhite =Color( 0.97, 0.97, 1, 1 ) --- Ghost white color.
gold =Color( 1, 0.84, 0, 1 ) --- Gold color.
goldenrod =Color( 0.85, 0.65, 0.13, 1 ) --- Goldenrod color.
gray =Color( 0.75, 0.75, 0.75, 1 ) --- Gray color.
green =Color( 0, 1, 0, 1 ) --- Green color.
greenyellow =Color( 0.68, 1, 0.18, 1 ) --- Green yellow color.
honeydew =Color( 0.94, 1, 0.94, 1 ) --- Honeydew color.
hotpink =Color( 1, 0.41, 0.71, 1 ) --- Hot pink color.
indianred =Color( 0.8, 0.36, 0.36, 1 ) --- Indian red color.
indigo =Color( 0.29, 0, 0.51, 1 ) --- Indigo color.
ivory =Color( 1, 1, 0.94, 1 ) --- Ivory color.
khaki =Color( 0.94, 0.9, 0.55, 1 ) --- Khaki color.
lavender =Color( 0.9, 0.9, 0.98, 1 ) --- Lavender color.
lavenderblush =Color( 1, 0.94, 0.96, 1 ) --- Lavender blush color.
lawngreen =Color( 0.49, 0.99, 0, 1 ) --- Lawn green color.
lemonchiffon =Color( 1, 0.98, 0.8, 1 ) --- Lemon chiffon color.
lightblue =Color( 0.68, 0.85, 0.9, 1 ) --- Light blue color.
lightcoral =Color( 0.94, 0.5, 0.5, 1 ) --- Light coral color.
lightcyan =Color( 0.88, 1, 1, 1 ) --- Light cyan color.
lightgoldenrod =Color( 0.98, 0.98, 0.82, 1 ) --- Light goldenrod color.
lightgray =Color( 0.83, 0.83, 0.83, 1 ) --- Light gray color.
lightgreen =Color( 0.56, 0.93, 0.56, 1 ) --- Light green color.
lightpink =Color( 1, 0.71, 0.76, 1 ) --- Light pink color.
lightsalmon =Color( 1, 0.63, 0.48, 1 ) --- Light salmon color.
lightseagreen =Color( 0.13, 0.7, 0.67, 1 ) --- Light sea green color.
lightskyblue =Color( 0.53, 0.81, 0.98, 1 ) --- Light sky blue color.
lightslategray =Color( 0.47, 0.53, 0.6, 1 ) --- Light slate gray color.
lightsteelblue =Color( 0.69, 0.77, 0.87, 1 ) --- Light steel blue color.
lightyellow =Color( 1, 1, 0.88, 1 ) --- Light yellow color.
lime =Color( 0, 1, 0, 1 ) --- Lime color.
limegreen =Color( 0.2, 0.8, 0.2, 1 ) --- Lime green color.
linen =Color( 0.98, 0.94, 0.9, 1 ) --- Linen color.
magenta =Color( 1, 0, 1, 1 ) --- Magenta color.
maroon =Color( 0.69, 0.19, 0.38, 1 ) --- Maroon color.
mediumaquamarine =Color( 0.4, 0.8, 0.67, 1 ) --- Medium aquamarine color.
mediumblue =Color( 0, 0, 0.8, 1 ) --- Medium blue color.
mediumorchid =Color( 0.73, 0.33, 0.83, 1 ) --- Medium orchid color.
mediumpurple =Color( 0.58, 0.44, 0.86, 1 ) --- Medium purple color.
mediumseagreen =Color( 0.24, 0.7, 0.44, 1 ) --- Medium sea green color.
mediumslateblue =Color( 0.48, 0.41, 0.93, 1 ) --- Medium slate blue color.
mediumspringgreen =Color( 0, 0.98, 0.6, 1 ) --- Medium spring green color.
mediumturquoise =Color( 0.28, 0.82, 0.8, 1 ) --- Medium turquoise color.
mediumvioletred =Color( 0.78, 0.08, 0.52, 1 ) --- Medium violet red color.
midnightblue =Color( 0.1, 0.1, 0.44, 1 ) --- Midnight blue color.
mintcream =Color( 0.96, 1, 0.98, 1 ) --- Mint cream color.
mistyrose =Color( 1, 0.89, 0.88, 1 ) --- Misty rose color.
moccasin =Color( 1, 0.89, 0.71, 1 ) --- Moccasin color.
navajowhite =Color( 1, 0.87, 0.68, 1 ) --- Navajo white color.
navyblue =Color( 0, 0, 0.5, 1 ) --- Navy blue color.
oldlace =Color( 0.99, 0.96, 0.9, 1 ) --- Old lace color.
olive =Color( 0.5, 0.5, 0, 1 ) --- Olive color.
olivedrab =Color( 0.42, 0.56, 0.14, 1 ) --- Olive drab color.
orange =Color( 1, 0.65, 0, 1 ) --- Orange color.
orangered =Color( 1, 0.27, 0, 1 ) --- Orange red color.
orchid =Color( 0.85, 0.44, 0.84, 1 ) --- Orchid color.
palegoldenrod =Color( 0.93, 0.91, 0.67, 1 ) --- Pale goldenrod color.
palegreen =Color( 0.6, 0.98, 0.6, 1 ) --- Pale green color.
paleturquoise =Color( 0.69, 0.93, 0.93, 1 ) --- Pale turquoise color.
palevioletred =Color( 0.86, 0.44, 0.58, 1 ) --- Pale violet red color.
papayawhip =Color( 1, 0.94, 0.84, 1 ) --- Papaya whip color.
peachpuff =Color( 1, 0.85, 0.73, 1 ) --- Peach puff color.
peru =Color( 0.8, 0.52, 0.25, 1 ) --- Peru color.
pink =Color( 1, 0.75, 0.8, 1 ) --- Pink color.
plum =Color( 0.87, 0.63, 0.87, 1 ) --- Plum color.
powderblue =Color( 0.69, 0.88, 0.9, 1 ) --- Powder blue color.
purple =Color( 0.63, 0.13, 0.94, 1 ) --- Purple color.
rebeccapurple =Color( 0.4, 0.2, 0.6, 1 ) --- Rebecca purple color.
red =Color( 1, 0, 0, 1 ) --- Red color.
rosybrown =Color( 0.74, 0.56, 0.56, 1 ) --- Rosy brown color.
royalblue =Color( 0.25, 0.41, 0.88, 1 ) --- Royal blue color.
saddlebrown =Color( 0.55, 0.27, 0.07, 1 ) --- Saddle brown color.
salmon =Color( 0.98, 0.5, 0.45, 1 ) --- Salmon color.
sandybrown =Color( 0.96, 0.64, 0.38, 1 ) --- Sandy brown color.
seagreen =Color( 0.18, 0.55, 0.34, 1 ) --- Sea green color.
seashell =Color( 1, 0.96, 0.93, 1 ) --- Seashell color.
sienna =Color( 0.63, 0.32, 0.18, 1 ) --- Sienna color.
silver =Color( 0.75, 0.75, 0.75, 1 ) --- Silver color.
skyblue =Color( 0.53, 0.81, 0.92, 1 ) --- Sky blue color.
slateblue =Color( 0.42, 0.35, 0.8, 1 ) --- Slate blue color.
slategray =Color( 0.44, 0.5, 0.56, 1 ) --- Slate gray color.
snow =Color( 1, 0.98, 0.98, 1 ) --- Snow color.
springgreen =Color( 0, 1, 0.5, 1 ) --- Spring green color.
steelblue =Color( 0.27, 0.51, 0.71, 1 ) --- Steel blue color.
tan =Color( 0.82, 0.71, 0.55, 1 ) --- Tan color.
teal =Color( 0, 0.5, 0.5, 1 ) --- Teal color.
thistle =Color( 0.85, 0.75, 0.85, 1 ) --- Thistle color.
tomato =Color( 1, 0.39, 0.28, 1 ) --- Tomato color.
transparent =Color( 1, 1, 1, 0 ) --- Transparent color (white with no alpha).
turquoise =Color( 0.25, 0.88, 0.82, 1 ) --- Turquoise color.
violet =Color( 0.93, 0.51, 0.93, 1 ) --- Violet color.
webgray =Color( 0.5, 0.5, 0.5, 1 ) --- Web gray color.
webgreen =Color( 0, 0.5, 0, 1 ) --- Web green color.
webmaroon =Color( 0.5, 0, 0, 1 ) --- Web maroon color.
webpurple =Color( 0.5, 0, 0.5, 1 ) --- Web purple color.
wheat =Color( 0.96, 0.87, 0.7, 1 ) --- Wheat color.
white =Color( 1, 1, 1, 1 ) --- White color.
whitesmoke =Color( 0.96, 0.96, 0.96, 1 ) --- White smoke color.
yellow =Color( 1, 1, 0, 1 ) --- Yellow color.
yellowgreen =Color( 0.6, 0.8, 0.2, 1 ) --- Yellow green color.

Property Descriptions¶

floata

Default

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.

inta8

Default

255

Wrapper fora that uses the range 0 to 255 instead of 0 to 1.

floatb

Default

0.0

The color's blue component, typically on the range of 0 to 1.

intb8

Default

0

Wrapper forb that uses the range 0 to 255 instead of 0 to 1.

floatg

Default

0.0

The color's green component, typically on the range of 0 to 1.

intg8

Default

0

Wrapper forg that uses the range 0 to 255 instead of 0 to 1.

floath

Default

0.0

The HSV hue of this color, on the range 0 to 1.

floatr

Default

0.0

The color's red component, typically on the range of 0 to 1.

intr8

Default

0

Wrapper forr that uses the range 0 to 255 instead of 0 to 1.

floats

Default

0.0

The HSV saturation of this color, on the range 0 to 1.

floatv

Default

0.0

The HSV value (brightness) of this color, on the range 0 to 1.

Method Descriptions¶

ColorColor(String from)

Constructs a color from an HTML hexadecimal color string in ARGB or RGB format. See also@GDScript.ColorN.

# Each of the following creates the same color RGBA(178, 217, 10, 255).varc1=Color("#ffb2d90a")# ARGB format with "#".varc2=Color("ffb2d90a")# ARGB format.varc3=Color("#b2d90a")# RGB format with "#".varc4=Color("b2d90a")# RGB format.

ColorColor(int from)

Constructs a color from a 32-bit integer in RGBA format (each byte represents a color channel).

varc=Color(274)# Similar to Color(0.0, 0.0, 0.004, 0.07)

ColorColor(float r,float g,float b)

Constructs a color from RGB values, typically between 0 and 1. Alpha will be 1.

varcolor=Color(0.2,1.0,0.7)# Similar to Color8(51, 255, 178, 255)

ColorColor(float r,float g,float b,float a)

Constructs a color from RGBA values, typically between 0 and 1.

varcolor=Color(0.2,1.0,0.7,0.8)# Similar to Color8(51, 255, 178, 204)

Colorblend(Color over)

Returns a new color resulting from blending this color over another. If the color is opaque, the result is also opaque. The second color may have a range of alpha values.

varbg=Color(0.0,1.0,0.0,0.5)# Green with alpha of 50%varfg=Color(1.0,0.0,0.0,0.5)# Red with alpha of 50%varblended_color=bg.blend(fg)# Brown with alpha of 75%

Colorcontrasted()

Returns the most contrasting color.

varc=Color(0.3,0.4,0.9)varcontrasted_color=c.contrasted()# Equivalent to RGBA(204, 229, 102, 255)

Colordarkened(float amount)

Returns a new color resulting from making this color darker by the specified percentage (ratio from 0 to 1).

vargreen=Color(0.0,1.0,0.0)vardarkgreen=green.darkened(0.2)# 20% darker than regular green

Colorfrom_hsv(float h,float s,float v,float a=1.0)

Constructs a color from an HSV profile.h,s, andv are values between 0 and 1.

varc=Color.from_hsv(0.58,0.5,0.79,0.8)# Equivalent to HSV(210, 50, 79, 0.8) or Color8(100, 151, 201, 0.8)

floatgray()

Returns the color's grayscale representation.

The gray value is calculated as(r+g+b)/3.

varc=Color(0.2,0.45,0.82)vargray=c.gray()# A value of 0.466667

Colorinverted()

Returns the inverted color(1-r,1-g,1-b,a).

varcolor=Color(0.3,0.4,0.9)varinverted_color=color.inverted()# Equivalent to Color(0.7, 0.6, 0.1)

boolis_equal_approx(Color color)

Returnstrue if this color andcolor are approximately equal, by running@GDScript.is_equal_approx on each component.

Colorlightened(float amount)

Returns a new color resulting from making this color lighter by the specified percentage (ratio from 0 to 1).

vargreen=Color(0.0,1.0,0.0)varlightgreen=green.lightened(0.2)# 20% lighter than regular green

Colorlinear_interpolate(Color to,float weight)

Returns the linear interpolation with another color. The interpolation factorweight is between 0 and 1.

varc1=Color(1.0,0.0,0.0)varc2=Color(0.0,1.0,0.0)varli_c=c1.linear_interpolate(c2,0.5)# Equivalent to Color(0.5, 0.5, 0.0)

intto_abgr32()

Returns the color converted to a 32-bit integer in ABGR format (each byte represents a color channel). ABGR is the reversed version of the default format.

varcolor=Color(1,0.5,0.2)print(color.to_abgr32())# Prints 4281565439

intto_abgr64()

Returns the color converted to a 64-bit integer in ABGR format (each word represents a color channel). ABGR is the reversed version of the default format.

varcolor=Color(1,0.5,0.2)print(color.to_abgr64())# Prints -225178692812801

intto_argb32()

Returns the color converted to a 32-bit integer in ARGB format (each byte represents a color channel). ARGB is more compatible with DirectX.

varcolor=Color(1,0.5,0.2)print(color.to_argb32())# Prints 4294934323

intto_argb64()

Returns the color converted to a 64-bit integer in ARGB format (each word represents a color channel). ARGB is more compatible with DirectX.

varcolor=Color(1,0.5,0.2)print(color.to_argb64())# Prints -2147470541

Stringto_html(bool with_alpha=true)

Returns the color's HTML hexadecimal color string in ARGB format (ex:ff34f822).

Settingwith_alpha tofalse excludes alpha from the hexadecimal string.

varc=Color(1,1,1,0.5)vars1=c.to_html()# Returns "7fffffff"vars2=c.to_html(false)# Returns "ffffff"

intto_rgba32()

Returns the color converted to a 32-bit integer in RGBA format (each byte represents a color channel). RGBA is Godot's default format.

varcolor=Color(1,0.5,0.2)print(color.to_rgba32())# Prints 4286526463

intto_rgba64()

Returns the color converted to a 64-bit integer in RGBA format (each word represents a color channel). RGBA is Godot's default format.

varcolor=Color(1,0.5,0.2)print(color.to_rgba64())# Prints -140736629309441

Movatterモバイル変換

Color¶

Description¶

Tutorials¶

Properties¶

Methods¶

Constants¶

Property Descriptions¶

Method Descriptions¶