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。
备注
通过 C# 使用该 API 时会有显著不同，详见 C# API 与 GDScript 的差异。
教程¶
属性¶
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
构造函数¶
Color() |
|
方法¶
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_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 |
运算符¶
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) |
|
常量¶
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