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

以 RGBA 格式表示的颜色。

描述

由红（r）、绿（g）、蓝（b）和 alpha（a）分量表示的 RGBA 格式的颜色。每个分量都是一个 32 位浮点值，通常介于 0.0 到 1.0 之间。某些属性（例如 CanvasItem.modulate）可能支持大于 1.0 的值，用于表示过亮或 HDR（High Dynamic Range，高动态范围）颜色。

创建颜色的方法有很多：可以使用 Color 的各种构造函数，from_hsv() 等静态方法，以及使用基于 X11 颜色名称的标准化颜色集外加 TRANSPARENT。GDScript 还提供了 @GDScript.Color8()，使用的是 0 到 255 之间的整数，且不支持过亮的颜色。

注意：在布尔上下文中，等于 Color(0, 0, 0, 1)（不透明的黑色）的 Color 将被评估为 false。否则，Color 将始终被评估为 true。

Color 常量速查表

Note

通过 C# 使用该 API 时会有显著不同，详见 C# API differences to GDScript。

教程

属性

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`

构造函数

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)

方法

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

运算符

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

常量

ALICE_BLUE = Color(0.941176, 0.972549, 1, 1) 🔗

爱丽丝蓝。

ANTIQUE_WHITE = Color(0.980392, 0.921569, 0.843137, 1) 🔗

古董白。

AQUA = Color(0, 1, 1, 1) 🔗

水色。

AQUAMARINE = Color(0.498039, 1, 0.831373, 1) 🔗

海蓝色。

AZURE = Color(0.941176, 1, 1, 1) 🔗

天蓝色。

BEIGE = Color(0.960784, 0.960784, 0.862745, 1) 🔗

米黄色。

BISQUE = Color(1, 0.894118, 0.768627, 1) 🔗

橘黄色。

BLACK = Color(0, 0, 0, 1) 🔗

黑色。在 GDScript 中，这是所有颜色的默认值。

BLANCHED_ALMOND = Color(1, 0.921569, 0.803922, 1) 🔗

杏仁白色。

BLUE = Color(0, 0, 1, 1) 🔗

蓝色。

BLUE_VIOLET = Color(0.541176, 0.168627, 0.886275, 1) 🔗

蓝紫色的颜色。

BROWN = Color(0.647059, 0.164706, 0.164706, 1) 🔗

棕色。

BURLYWOOD = Color(0.870588, 0.721569, 0.529412, 1) 🔗

硬木色。

CADET_BLUE = Color(0.372549, 0.619608, 0.627451, 1) 🔗

军服蓝。

CHARTREUSE = Color(0.498039, 1, 0, 1) 🔗

黄褐色。

CHOCOLATE = Color(0.823529, 0.411765, 0.117647, 1) 🔗

巧克力色。

CORAL = Color(1, 0.498039, 0.313726, 1) 🔗

珊瑚色。

CORNFLOWER_BLUE = Color(0.392157, 0.584314, 0.929412, 1) 🔗

矢车菊蓝色。

CORNSILK = Color(1, 0.972549, 0.862745, 1) 🔗

玉米须色。

CRIMSON = Color(0.862745, 0.0784314, 0.235294, 1) 🔗

绯红的颜色。

CYAN = Color(0, 1, 1, 1) 🔗

青色。

DARK_BLUE = Color(0, 0, 0.545098, 1) 🔗

深蓝色。

DARK_CYAN = Color(0, 0.545098, 0.545098, 1) 🔗

深青色。

DARK_GOLDENROD = Color(0.721569, 0.52549, 0.0431373, 1) 🔗

深色菊科植物的颜色。

DARK_GRAY = Color(0.662745, 0.662745, 0.662745, 1) 🔗

深灰色。

DARK_GREEN = Color(0, 0.392157, 0, 1) 🔗

深绿色。

DARK_KHAKI = Color(0.741176, 0.717647, 0.419608, 1) 🔗

深卡其色。

DARK_MAGENTA = Color(0.545098, 0, 0.545098, 1) 🔗

深洋红色。

DARK_OLIVE_GREEN = Color(0.333333, 0.419608, 0.184314, 1) 🔗

深橄榄绿色。

DARK_ORANGE = Color(1, 0.54902, 0, 1) 🔗

深橙色。

DARK_ORCHID = Color(0.6, 0.196078, 0.8, 1) 🔗

深色的兰花色。

DARK_RED = Color(0.545098, 0, 0, 1) 🔗

深红色。

DARK_SALMON = Color(0.913725, 0.588235, 0.478431, 1) 🔗

深鲑鱼色。

DARK_SEA_GREEN = Color(0.560784, 0.737255, 0.560784, 1) 🔗

深海绿色。

DARK_SLATE_BLUE = Color(0.282353, 0.239216, 0.545098, 1) 🔗

深板蓝的颜色。

DARK_SLATE_GRAY = Color(0.184314, 0.309804, 0.309804, 1) 🔗

暗石板灰色。

DARK_TURQUOISE = Color(0, 0.807843, 0.819608, 1) 🔗

深绿松石色。

DARK_VIOLET = Color(0.580392, 0, 0.827451, 1) 🔗

深紫罗兰色。

DEEP_PINK = Color(1, 0.0784314, 0.576471, 1) 🔗

深粉色。

DEEP_SKY_BLUE = Color(0, 0.74902, 1, 1) 🔗

深邃的天蓝色。

DIM_GRAY = Color(0.411765, 0.411765, 0.411765, 1) 🔗

暗灰色。

DODGER_BLUE = Color(0.117647, 0.564706, 1, 1) 🔗

道奇蓝色。

FIREBRICK = Color(0.698039, 0.133333, 0.133333, 1) 🔗

耐火砖红色。

FLORAL_WHITE = Color(1, 0.980392, 0.941176, 1) 🔗

花白色。

FOREST_GREEN = Color(0.133333, 0.545098, 0.133333, 1) 🔗

森林绿色。

FUCHSIA = Color(1, 0, 1, 1) 🔗

洋红色。

GAINSBORO = Color(0.862745, 0.862745, 0.862745, 1) 🔗

庚斯伯勒灰色。

GHOST_WHITE = Color(0.972549, 0.972549, 1, 1) 🔗

幽灵白颜色。

GOLD = Color(1, 0.843137, 0, 1) 🔗

金色。

GOLDENROD = Color(0.854902, 0.647059, 0.12549, 1) 🔗

金菊色。

GRAY = Color(0.745098, 0.745098, 0.745098, 1) 🔗

灰色。

GREEN = Color(0, 1, 0, 1) 🔗

绿色。

GREEN_YELLOW = Color(0.678431, 1, 0.184314, 1) 🔗

绿黄色。

HONEYDEW = Color(0.941176, 1, 0.941176, 1) 🔗

蜜露色。

HOT_PINK = Color(1, 0.411765, 0.705882, 1) 🔗

亮粉色。

INDIAN_RED = Color(0.803922, 0.360784, 0.360784, 1) 🔗

印度红色。

INDIGO = Color(0.294118, 0, 0.509804, 1) 🔗

靛青色。

IVORY = Color(1, 1, 0.941176, 1) 🔗

象牙色。

KHAKI = Color(0.941176, 0.901961, 0.54902, 1) 🔗

卡其色。

LAVENDER = Color(0.901961, 0.901961, 0.980392, 1) 🔗

薰衣草色。

LAVENDER_BLUSH = Color(1, 0.941176, 0.960784, 1) 🔗

薰衣草紫红色。

LAWN_GREEN = Color(0.486275, 0.988235, 0, 1) 🔗

草坪绿色。

LEMON_CHIFFON = Color(1, 0.980392, 0.803922, 1) 🔗

柠檬雪纺色。

LIGHT_BLUE = Color(0.678431, 0.847059, 0.901961, 1) 🔗

浅蓝色。

LIGHT_CORAL = Color(0.941176, 0.501961, 0.501961, 1) 🔗

浅珊瑚色。

LIGHT_CYAN = Color(0.878431, 1, 1, 1) 🔗

淡青色。

LIGHT_GOLDENROD = Color(0.980392, 0.980392, 0.823529, 1) 🔗

亮金菊黄色。

LIGHT_GRAY = Color(0.827451, 0.827451, 0.827451, 1) 🔗

浅灰色。

LIGHT_GREEN = Color(0.564706, 0.933333, 0.564706, 1) 🔗

浅绿色。

LIGHT_PINK = Color(1, 0.713726, 0.756863, 1) 🔗

浅粉色。

LIGHT_SALMON = Color(1, 0.627451, 0.478431, 1) 🔗

浅鲑鱼色。

LIGHT_SEA_GREEN = Color(0.12549, 0.698039, 0.666667, 1) 🔗

浅海绿色。

LIGHT_SKY_BLUE = Color(0.529412, 0.807843, 0.980392, 1) 🔗

浅天蓝色。

LIGHT_SLATE_GRAY = Color(0.466667, 0.533333, 0.6, 1) 🔗

浅板岩灰色。

LIGHT_STEEL_BLUE = Color(0.690196, 0.768627, 0.870588, 1) 🔗

浅钢蓝色。

LIGHT_YELLOW = Color(1, 1, 0.878431, 1) 🔗

浅黄色。

LIME = Color(0, 1, 0, 1) 🔗

青柠色。

LIME_GREEN = Color(0.196078, 0.803922, 0.196078, 1) 🔗

石灰绿色。

LINEN = Color(0.980392, 0.941176, 0.901961, 1) 🔗

亚麻色。

MAGENTA = Color(1, 0, 1, 1) 🔗

洋红色。

MAROON = Color(0.690196, 0.188235, 0.376471, 1) 🔗

栗色。

MEDIUM_AQUAMARINE = Color(0.4, 0.803922, 0.666667, 1) 🔗

中等海蓝宝石色。

MEDIUM_BLUE = Color(0, 0, 0.803922, 1) 🔗

中蓝色。

MEDIUM_ORCHID = Color(0.729412, 0.333333, 0.827451, 1) 🔗

中等兰色。

MEDIUM_PURPLE = Color(0.576471, 0.439216, 0.858824, 1) 🔗

中等紫色。

MEDIUM_SEA_GREEN = Color(0.235294, 0.701961, 0.443137, 1) 🔗

中海绿色。

MEDIUM_SLATE_BLUE = Color(0.482353, 0.407843, 0.933333, 1) 🔗

中等板岩蓝色。

MEDIUM_SPRING_GREEN = Color(0, 0.980392, 0.603922, 1) 🔗

中等春天绿色。

MEDIUM_TURQUOISE = Color(0.282353, 0.819608, 0.8, 1) 🔗

中等绿松石色。

MEDIUM_VIOLET_RED = Color(0.780392, 0.0823529, 0.521569, 1) 🔗

中等紫红色。

MIDNIGHT_BLUE = Color(0.0980392, 0.0980392, 0.439216, 1) 🔗

午夜蓝色。

MINT_CREAM = Color(0.960784, 1, 0.980392, 1) 🔗

薄荷奶油色。

MISTY_ROSE = Color(1, 0.894118, 0.882353, 1) 🔗

朦胧的玫瑰色。

MOCCASIN = Color(1, 0.894118, 0.709804, 1) 🔗

鹿皮鞋颜色。

NAVAJO_WHITE = Color(1, 0.870588, 0.678431, 1) 🔗

纳瓦白。

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

藏青色。

OLD_LACE = Color(0.992157, 0.960784, 0.901961, 1) 🔗

旧蕾丝色。

OLIVE = Color(0.501961, 0.501961, 0, 1) 🔗

橄榄色。

OLIVE_DRAB = Color(0.419608, 0.556863, 0.137255, 1) 🔗

暗淡橄榄色。

ORANGE = Color(1, 0.647059, 0, 1) 🔗

橙色。

ORANGE_RED = Color(1, 0.270588, 0, 1) 🔗

橘红色。

ORCHID = Color(0.854902, 0.439216, 0.839216, 1) 🔗

兰花色。

PALE_GOLDENROD = Color(0.933333, 0.909804, 0.666667, 1) 🔗

淡金色。

PALE_GREEN = Color(0.596078, 0.984314, 0.596078, 1) 🔗

淡绿色。

PALE_TURQUOISE = Color(0.686275, 0.933333, 0.933333, 1) 🔗

淡绿松石色。

PALE_VIOLET_RED = Color(0.858824, 0.439216, 0.576471, 1) 🔗

淡紫红色。

PAPAYA_WHIP = Color(1, 0.937255, 0.835294, 1) 🔗

木瓜鞭色。

PEACH_PUFF = Color(1, 0.854902, 0.72549, 1) 🔗

桃花粉。

PERU = Color(0.803922, 0.521569, 0.247059, 1) 🔗

秘鲁色。

PINK = Color(1, 0.752941, 0.796078, 1) 🔗

粉红色。

PLUM = Color(0.866667, 0.627451, 0.866667, 1) 🔗

梅花色。

POWDER_BLUE = Color(0.690196, 0.878431, 0.901961, 1) 🔗

浅蓝色。

PURPLE = Color(0.627451, 0.12549, 0.941176, 1) 🔗

紫色。

REBECCA_PURPLE = Color(0.4, 0.2, 0.6, 1) 🔗

丽贝卡紫色。

RED = Color(1, 0, 0, 1) 🔗

红色。

ROSY_BROWN = Color(0.737255, 0.560784, 0.560784, 1) 🔗

玫瑰棕。

ROYAL_BLUE = Color(0.254902, 0.411765, 0.882353, 1) 🔗

宝蓝色。

SADDLE_BROWN = Color(0.545098, 0.270588, 0.0745098, 1) 🔗

鞍棕色。

SALMON = Color(0.980392, 0.501961, 0.447059, 1) 🔗

鲑鱼色。

SANDY_BROWN = Color(0.956863, 0.643137, 0.376471, 1) 🔗

沙褐色。

SEA_GREEN = Color(0.180392, 0.545098, 0.341176, 1) 🔗

海绿色。

SEASHELL = Color(1, 0.960784, 0.933333, 1) 🔗

贝壳色。

SIENNA = Color(0.627451, 0.321569, 0.176471, 1) 🔗

西恩娜色。

SILVER = Color(0.752941, 0.752941, 0.752941, 1) 🔗

银色。

SKY_BLUE = Color(0.529412, 0.807843, 0.921569, 1) 🔗

天蓝色。

SLATE_BLUE = Color(0.415686, 0.352941, 0.803922, 1) 🔗

石板蓝色。

SLATE_GRAY = Color(0.439216, 0.501961, 0.564706, 1) 🔗

石板灰。

SNOW = Color(1, 0.980392, 0.980392, 1) 🔗

雪白。

SPRING_GREEN = Color(0, 1, 0.498039, 1) 🔗

春绿。

STEEL_BLUE = Color(0.27451, 0.509804, 0.705882, 1) 🔗

钢蓝色。

TAN = Color(0.823529, 0.705882, 0.54902, 1) 🔗

棕褐色。

TEAL = Color(0, 0.501961, 0.501961, 1) 🔗

青色。

THISTLE = Color(0.847059, 0.74902, 0.847059, 1) 🔗

蓟色。

TOMATO = Color(1, 0.388235, 0.278431, 1) 🔗

番茄色。

TRANSPARENT = Color(1, 1, 1, 0) 🔗

透明色（Alpha 为零的白色）。

TURQUOISE = Color(0.25098, 0.878431, 0.815686, 1) 🔗

松石绿。

VIOLET = Color(0.933333, 0.509804, 0.933333, 1) 🔗

紫罗兰色。

WEB_GRAY = Color(0.501961, 0.501961, 0.501961, 1) 🔗

网格灰。

WEB_GREEN = Color(0, 0.501961, 0, 1) 🔗

网络绿。

WEB_MAROON = Color(0.501961, 0, 0, 1) 🔗

网络栗。

WEB_PURPLE = Color(0.501961, 0, 0.501961, 1) 🔗

网络紫。

WHEAT = Color(0.960784, 0.870588, 0.701961, 1) 🔗

小麦色。

WHITE = Color(1, 1, 1, 1) 🔗

白色。

WHITE_SMOKE = Color(0.960784, 0.960784, 0.960784, 1) 🔗

白烟色。

YELLOW = Color(1, 1, 0, 1) 🔗

黄色。

YELLOW_GREEN = Color(0.603922, 0.803922, 0.196078, 1) 🔗

黄绿色。

属性说明

float a = 1.0 🔗

颜色的 Alpha 分量，一般在 0 到 1 的范围内。0 表示该颜色完全透明。1 表示该颜色完全不透明。

int a8 = 255 🔗

对 a 的封装，使用 0 到 255 的范围而不是 0 到 1。

float b = 0.0 🔗

颜色的蓝色分量，一般在 0 到 1 的范围内。

int b8 = 0 🔗

对 b 的封装，使用 0 到 255 的范围而不是 0 到 1。

float g = 0.0 🔗

颜色的绿色分量，一般在 0 到 1 的范围内。

int g8 = 0 🔗

对 g 的封装，使用 0 到 255 的范围而不是 0 到 1。

float h = 0.0 🔗

这个颜色的 HSV 色相，范围是 0 到 1。

float ok_hsl_h = 0.0 🔗

这个颜色的 OKHSL 色相，范围是 0 到 1。

float ok_hsl_l = 0.0 🔗

这个颜色的 OKHSL 亮度，范围为 0 到 1。

float ok_hsl_s = 0.0 🔗

这个颜色的 OKHSL 饱和度，范围为 0 到 1。

float r = 0.0 🔗

颜色的红色分量，通常在 0 到 1 的范围内。

int r8 = 0 🔗

对 r 的封装，使用 0 到 255 的范围而不是 0 到 1。

float s = 0.0 🔗

这个颜色的 HSV 饱和度，范围为 0 到 1。

float v = 0.0 🔗

这个颜色的 HSV 值（亮度），范围为 0 至 1。

构造函数说明

Color Color() 🔗

用不透明的黑色构造默认的 Color，与 BLACK 相同。

注意：在 C# 中构造的是所有分量都为 0.0 的颜色（透明黑）。

Color Color(from: Color, alpha: float)

从现有的颜色构造 Color，a 设置为给定的 alpha 值。

var red = Color(Color.RED, 0.2) # 20% 不透明红色。

var red = new Color(Colors.Red, 0.2f); // 20% 不透明红色。

Color Color(from: Color)

构造给定 Color 的副本。

Color Color(code: String)

从 HTML 颜色代码或标准化的颜色名称中构建 Color。支持的颜色名称与常量名相同。

Color Color(code: String, alpha: float)

从 HTML 颜色代码或标准化的颜色名称中构建 Color，alpha 的范围为 0.0 到 1.0。支持的颜色名称与常量名相同。

Color Color(r: float, g: float, b: float)

从通常介于 0.0 和 1.0 之间的 RGB 值构造一个 Color。a 被设置为 1.0。

var color = Color(0.2, 1.0, 0.7) # 类似于 `Color8(51, 255, 178, 255)`

var color = new Color(0.2f, 1.0f, 0.7f); // 类似于 `Color.Color8(51, 255, 178, 255)`

Color Color(r: float, g: float, b: float, a: float)

从通常介于 0.0 和 1.0 之间的 RGBA 值构造一个 Color。

var color = Color(0.2, 1.0, 0.7, 0.8) # 类似于 `Color8(51, 255, 178, 204)`

var color = new Color(0.2f, 1.0f, 0.7f, 0.8f); // 类似于 `Color.Color8(51, 255, 178, 255, 204)`

方法说明

Color blend(over: Color) const 🔗

返回将该颜色混合到给定颜色上所产生的新颜色。在绘画程序中，你可以将其想象为在该颜色（包括 alpha）上绘制的 over 颜色。

var bg = Color(0.0, 1.0, 0.0, 0.5) # 50% 不透明的绿色
var fg = Color(1.0, 0.0, 0.0, 0.5) # 50% 不透明的红色
var blended_color = bg.blend(fg) # 75% 不透明的棕色

var bg = new Color(0.0f, 1.0f, 0.0f, 0.5f); // 50% 不透明的绿色
var fg = new Color(1.0f, 0.0f, 0.0f, 0.5f); // 50% 不透明的红色
Color blendedColor = bg.Blend(fg); // 75% 不透明的棕色

Color clamp(min: Color = Color(0, 0, 0, 0), max: Color = Color(1, 1, 1, 1)) const 🔗

通过在每个分量上运行 @GlobalScope.clamp()，返回一种新颜色，其中所有分量都被钳制在 min 和 max 的分量之间。

Color darkened(amount: float) const 🔗

返回通过指定 amount（从 0.0 到 1.0 的比率）使该颜色变暗而产生的新颜色。另见 lightened()。

var green = Color(0.0, 1.0, 0.0)
var darkgreen = green.darkened(0.2) # 比普通的绿色深 20%

var green = new Color(0.0f, 1.0f, 0.0f);
Color darkgreen = green.Darkened(0.2f); // 比普通的绿色深 20%

Color from_hsv(h: float, s: float, v: float, alpha: float = 1.0) static 🔗

根据 HSV 配置构建颜色。色相（h）、饱和度（s）和值（v）通常在 0.0 和 1.0 之间。

var color = Color.from_hsv(0.58, 0.5, 0.79, 0.8)

var color = 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 🔗

根据 OK HSL 配置构建颜色。色相（h）、饱和度（s）和亮度（l）通常在 0.0 和 1.0 之间。

var color = Color.from_ok_hsl(0.58, 0.5, 0.79, 0.8)

var color = Color.FromOkHsl(0.58f, 0.5f, 0.79f, 0.8f);

Color from_rgba8(r8: int, g8: int, b8: int, a8: int = 255) static 🔗

返回一个由整数红通道（r8）、整数绿通道（g8）、整数蓝通道（b8）和可选的整数 Alpha 通道（a8）构造的 Color，每个通道的最终值都是除以 255.0 后得到的。

var red = Color.from_rgba8(255, 0, 0)             # 与 Color(1, 0, 0) 相同。
var dark_blue = Color.from_rgba8(0, 0, 51)        # 与 Color(0, 0, 0.2) 相同。
var my_color = Color.from_rgba8(306, 255, 0, 102) # 与 Color(1.2, 1, 0, 0.4) 相同。

注意：因为 from_rgba8() 的精度比标准 Color 构造函数低，所以使用 from_rgba8() 创建的颜色通常与使用标准 Color 构造函数创建的相同颜色不相等。请使用 is_equal_approx() 进行比较，避免浮点数精度误差。

Color from_rgbe9995(rgbe: int) static 🔗

从 RGBE9995 格式的整数解码 Color。见 Image.FORMAT_RGBE9995。

Color from_string(str: String, default: Color) static 🔗

从给定的字符串创建 Color，该字符串可以是 HTML 颜色代码，也可以是颜色名称（不区分大小写）。如果无法从字符串中推断出颜色，则返回 default。

如果你想要在常量表达式中使用 String 创建颜色，请改用对应的构造函数（即 Color("颜色字符串")）。

float get_luminance() const 🔗

将颜色的光照强度返回为一个介于 0.0 和 1.0（包含）之间的值。这在确定浅色或深色时很有用。亮度小于 0.5 的颜色通常可以认为是深色。

注意：get_luminance() 依赖于线性色彩空间中的颜色，以返回准确的相对亮度值。如果颜色在 sRGB 色彩空间，请先使用 srgb_to_linear() 将其转换为线性色彩空间。

Color hex(hex: int) static 🔗

返回与提供的整数 hex 相关联的 Color，使用 32 位 RGBA 格式（每通道 8 位）。该方法是 to_rgba32() 的逆方法。

在 GDScript 和 C# 中，展示该 int 的最好方法是十六进制表示法（使用 "0x" 前缀，得到 "0xRRGGBBAA"）。

var red = Color.hex(0xff0000ff)
var dark_cyan = Color.hex(0x008b8bff)
var my_color = Color.hex(0xbbefd2a4)

var red = new Color(0xff0000ff);
var dark_cyan = new Color(0x008b8bff);
var my_color = new Color(0xbbefd2a4);

如果你想要在常量表达式中使用十六进制表示，请改用对应的构造函数（即 Color(0xRRGGBBAA)）。

Color hex64(hex: int) static 🔗

返回与提供的整数 hex 相关联的 Color，使用 64 位 RGBA 格式（每通道 8 位）。该方法是 to_rgba64() 的逆方法。

在 GDScript 和 C# 中，展示该 int 的最好方法是十六进制表示法（使用 "0x" 前缀，得到 "0xRRRRGGGGBBBBAAAA"）。

Color html(rgba: String) static 🔗

从 HTML 十六进制颜色字符串 rgba 返回一个新颜色。rgba 不区分大小写，可以使用哈希符号（#）作为前缀。

rgba 必须是有效的三位或六位十六进制颜色字符串，并且可以包含 alpha 通道值。如果 rgba 不包含 alpha 通道值，则应用 alpha 通道值 1.0。如果 rgba 无效，则返回一个空颜色。

var blue = Color.html("#0000ff") # blue 为 Color(0.0, 0.0, 1.0, 1.0)
var green = Color.html("#0F0")   # green 为 Color(0.0, 1.0, 0.0, 1.0)
var col = Color.html("663399cc") # col 为 Color(0.4, 0.2, 0.6, 0.8)

var blue = Color.FromHtml("#0000ff"); // blue 为 Color(0.0, 0.0, 1.0, 1.0)
var green = Color.FromHtml("#0F0");   // green 为 Color(0.0, 1.0, 0.0, 1.0)
var col = Color.FromHtml("663399cc"); // col 为 Color(0.4, 0.2, 0.6, 0.8)

bool html_is_valid(color: String) static 🔗

如果 color 是一个有效的 HTML 十六进制颜色字符串，则返回 true。该字符串必须是一个由 3、4、6 或 8 位数字组成的十六进制值（不区分大小写），并且可以以井号 (#) 作为前缀。该方法与 String.is_valid_html_color() 相同。

Color.html_is_valid("#55aaFF")   # 返回 true
Color.html_is_valid("#55AAFF20") # 返回 true
Color.html_is_valid("55AAFF")    # 返回 true
Color.html_is_valid("#F2C")      # 返回 true

Color.html_is_valid("#AABBC")     # 返回 false
Color.html_is_valid("#55aaFF5")  # 返回 false

Color.HtmlIsValid("#55AAFF");   // 返回 true
Color.HtmlIsValid("#55AAFF20"); // 返回 true
Color.HtmlIsValid("55AAFF");    // 返回 true
Color.HtmlIsValid("#F2C");      // 返回 true

Color.HtmlIsValid("#AABBC");    // 返回 false
Color.HtmlIsValid("#55aaFF5");  // 返回 false

Color inverted() const 🔗

返回将 r、g、b 分量翻转后的颜色（(1 - r, 1 - g, 1 - b, a)）。

var black = Color.WHITE.inverted()
var color = Color(0.3, 0.4, 0.9)
var inverted_color = color.inverted() # 等价于 `Color(0.7, 0.6, 0.1)`

var black = Colors.White.Inverted();
var color = new Color(0.3f, 0.4f, 0.9f);
Color invertedColor = color.Inverted(); // 等价于 `new Color(0.7f, 0.6f, 0.1f)`

bool is_equal_approx(to: Color) const 🔗

如果该颜色和 to 近似相等，则返回 true，判断近似相等的方法是通过在每个分量上运行 @GlobalScope.is_equal_approx()。

Color lerp(to: Color, weight: float) const 🔗

返回将该颜色的分量和 to 的分量进行线性插值的结果。插值系数 weight 应该在 0.0 和 1.0 之间（闭区间）。另见 @GlobalScope.lerp()。

var red = Color(1.0, 0.0, 0.0)
var aqua = Color(0.0, 1.0, 0.8)

red.lerp(aqua, 0.2) # 返回 Color(0.8, 0.2, 0.16)
red.lerp(aqua, 0.5) # 返回 Color(0.5, 0.5, 0.4)
red.lerp(aqua, 1.0) # 返回 Color(0.0, 1.0, 0.8)

var red = new Color(1.0f, 0.0f, 0.0f);
var aqua = new Color(0.0f, 1.0f, 0.8f);

red.Lerp(aqua, 0.2f); // 返回 Color(0.8f, 0.2f, 0.16f)
red.Lerp(aqua, 0.5f); // 返回 Color(0.5f, 0.5f, 0.4f)
red.Lerp(aqua, 1.0f); // 返回 Color(0.0f, 1.0f, 0.8f)

Color lightened(amount: float) const 🔗

返回通过指定 amount（从 0.0 到 1.0 的比率）使该颜色变亮而产生的新颜色。另见 darkened()。

var green = Color(0.0, 1.0, 0.0)
var light_green = green.lightened(0.2) # 比普通的绿色要淡 20%

var green = new Color(0.0f, 1.0f, 0.0f);
Color lightGreen = green.Lightened(0.2f); // 比普通的绿色要淡 20%

Color linear_to_srgb() const 🔗

返回转换到 sRGB 色彩空间的颜色。该方法假定原始颜色位于线性色彩空间中。另见执行相反操作的 srgb_to_linear()。

Color srgb_to_linear() const 🔗

返回转换到线性色彩空间的颜色。该方法假定原始颜色已经在 sRGB 色彩空间中。另请参见执行相反操作的 linear_to_srgb()。

int to_abgr32() const 🔗

返回转换为 ABGR 格式（每个分量为 8 位）的 32 位整数的颜色。ABGR 是默认 RGBA 格式的反转版本。

var color = Color(1, 0.5, 0.2)
print(color.to_abgr32()) # 输出 4281565439

var color = new Color(1.0f, 0.5f, 0.2f);
GD.Print(color.ToAbgr32()); // 输出 4281565439

int to_abgr64() const 🔗

返回转换为 ABGR 格式（每个分量为 16 位）的 64 位整数的颜色。ABGR 是默认 RGBA 格式的反转版本。

var color = Color(1, 0.5, 0.2)
print(color.to_abgr64()) # 输出 -225178692812801

var color = new Color(1.0f, 0.5f, 0.2f);
GD.Print(color.ToAbgr64()); // 输出 -225178692812801

int to_argb32() const 🔗

返回转换为 ARGB 格式（每个分量为 8 位）的 32 位整数的颜色。ARGB 与 DirectX 更兼容。

var color = Color(1, 0.5, 0.2)
print(color.to_argb32()) # 输出 4294934323

var color = new Color(1.0f, 0.5f, 0.2f);
GD.Print(color.ToArgb32()); // 输出 4294934323

int to_argb64() const 🔗

返回转换为 ARGB 格式（每个分量为 16 位）的 64 位整数的颜色。ARGB 与 DirectX 更兼容。

var color = Color(1, 0.5, 0.2)
print(color.to_argb64()) # 输出 -2147470541

var color = new Color(1.0f, 0.5f, 0.2f);
GD.Print(color.ToArgb64()); // 输出 -2147470541

String to_html(with_alpha: bool = true) const 🔗

返回将该颜色转换为 RGBA 格式的 HTML 十六进制颜色 String，不带（#）前缀。

将 with_alpha 设置为 false，会从十六进制字符串中排除 alpha，使用 RGB 格式而不是 RGBA 格式。

var white = Color(1, 1, 1, 0.5)
var with_alpha = white.to_html() # 返回 "ffffff7f"
var without_alpha = white.to_html(false) # 返回 "ffffff"

var white = new Color(1, 1, 1, 0.5f);
string withAlpha = white.ToHtml(); // 返回 "ffffff7f"
string withoutAlpha = white.ToHtml(false); // 返回 "ffffff"

int to_rgba32() const 🔗

返回转换为 RGBA 格式（每个分量为 8 位）的 32 位整数的颜色。RGBA 是 Godot 的默认格式。该方法是 hex() 的逆方法。

var color = Color(1, 0.5, 0.2)
print(color.to_rgba32()) # 输出 4286526463

var color = new Color(1, 0.5f, 0.2f);
GD.Print(color.ToRgba32()); // 输出 4286526463

int to_rgba64() const 🔗

返回转换为 RGBA 格式（每个分量为 16 位）的 64 位整数的颜色。RGBA 是 Godot 的默认格式。该方法是 hex64() 的逆方法。

var color = Color(1, 0.5, 0.2)
print(color.to_rgba64()) # 输出 -140736629309441

var color = new Color(1, 0.5f, 0.2f);
GD.Print(color.ToRgba64()); // 输出 -140736629309441

运算符说明

bool operator !=(right: Color) 🔗

如果颜色不完全相等，则返回 true。

注意：由于浮点数精度误差，请考虑改用 is_equal_approx()，会更可靠。

Color operator *(right: Color) 🔗

将该 Color 的每个分量乘以给定 Color 的对应分量。

Color operator *(right: float) 🔗

将该 Color 的每个分量乘以给定的 float。

Color operator *(right: int) 🔗

将该 Color 的每个分量乘以给定的 int。

Color operator +(right: Color) 🔗

将该 Color 的每个分量加上给定 Color 的对应分量。

Color operator -(right: Color) 🔗

将该 Color 的每个分量减去给定 Color 的对应分量。

Color operator /(right: Color) 🔗

将该 Color 的每个分量除以给定 Color 的每个分量。

Color operator /(right: float) 🔗

将该 Color 的每个分量除以给定的 float。

Color operator /(right: int) 🔗

将该 Color 的每个分量除以给定的 int。

bool operator ==(right: Color) 🔗

如果颜色完全相同，则返回 true。

注意：由于浮点精度误差，请考虑改用更可靠的 is_equal_approx()。

float operator [](index: int) 🔗

使用索引访问颜色分量。[0] 相当于 r，[1] 相当于 g，[2] 相当于 b，[3] 相当于 a.

Color operator unary+() 🔗

返回与 + 不存在时相同的值。单目 + 没有作用，但有时可以使你的代码更具可读性。

Color operator unary-() 🔗

反转给定的颜色。这相当于 Color.WHITE - c 或 Color(1 - c.r, 1 - c.g, 1 - c.b, 1 - c.a)。与 inverted() 不同，a 分量也将被反转。