Up to date

This page is up to date for Godot 4.2. If you still find outdated information, please open an issue.

Color

以 RGBA 格式表示的颜色。

描述

由红（r）、绿（g）、蓝（b）和 alpha（a）分量表示的 RGBA 格式的颜色。每个分量都是一个 16 位浮点值，通常介于 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 常量速查表

备注

通过 C# 使用这个 API 时有显著的不同。详见 C# API 与 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

r

0.0

int

r8

0

float

s

0.0

float

v

0.0

构造函数

Color

Color ( )

Color

Color ( Color from, float alpha )

Color

Color ( Color from )

Color

Color ( String code )

Color

Color ( String code, float alpha )

Color

Color ( float r, float g, float b )

Color

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

方法

Color

blend ( Color over ) const

Color

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

Color

darkened ( float amount ) const

Color

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

Color

from_ok_hsl ( float h, float s, float l, float alpha=1.0 ) static

Color

from_rgbe9995 ( int rgbe ) static

Color

from_string ( String str, Color default ) static

float

get_luminance ( ) const

Color

hex ( int hex ) static

Color

hex64 ( int hex ) static

Color

html ( String rgba ) static

bool

html_is_valid ( String color ) static

Color

inverted ( ) const

bool

is_equal_approx ( Color to ) const

Color

lerp ( Color to, float weight ) const

Color

lightened ( float amount ) 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 ( bool with_alpha=true ) const

int

to_rgba32 ( ) const

int

to_rgba64 ( ) const

操作符

bool

operator != ( Color right )

Color

operator * ( Color right )

Color

operator * ( float right )

Color

operator * ( int right )

Color

operator + ( Color right )

Color

operator - ( Color right )

Color

operator / ( Color right )

Color

operator / ( float right )

Color

operator / ( int right )

bool

operator == ( Color right )

float

operator [] ( int index )

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 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 ( Color from, float alpha )

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

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

Color Color ( Color from )

构造给定 Color 的副本。

Color Color ( String code )

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

Color Color ( String code, float alpha )

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

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

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

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

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

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

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

方法说明

Color blend ( Color over ) 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% 不透明的棕色

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

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

Color darkened ( float amount ) const

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

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

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

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

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

Color from_ok_hsl ( float h, float s, float l, float alpha=1.0 ) static

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