Color

Цвет, представленный в формате RGBA.

Описание

Цвет, представленный в формате RGBA компонентами красного (r), зеленого (g), синего (b) и альфа-канала (a). Каждый компонент представляет собой 32-битное значение с плавающей запятой, обычно в диапазоне от 0.0 до 1.0. Некоторые свойства (например, CanvasItem.modulate) могут поддерживать значения больше 1.0 для слишком ярких цветов или цветов HDR (High Dynamic Range).

Цвета могут быть созданы несколькими способами: с помощью различных конструкторов Color, с помощью статических методов, таких как from_hsv(), и с помощью имени из набора стандартизированных цветов, основанных на названиях цветов X11 с добавлением TRANSPARENT.

Шпаргалка по цветовым константам

Хотя Color может использоваться для хранения значений любой кодировки, Godot ожидает, что свойства красного (r), зеленого (g) и синего (b) из Color будут закодированы с использованием нелинейной функции преобразования sRGB, если не указано иное. Эта цветовая кодировка используется многими традиционными инструментами для работы с графикой и веб-контентом, что упрощает сопоставление цветов между Godot и этими инструментами. Godot использует Rec. Основные цвета ITU-R BT.709, используемые стандартом sRGB.

Все физические расчеты, такие как расчеты освещения, и преобразования колориметрии, такие как get_luminance(), должны выполняться над линейно закодированными значениями для получения корректных результатов. При выполнении этих расчетов преобразуйте Color в линейное кодирование и обратно, используя srgb_to_linear() и linear_to_srgb().

Примечание: В логическом контексте значение Color будет равно false, если оно равно Color(0, 0, 0, 1) (непрозрачный черный). В противном случае значение Color всегда будет равно true.

Примечание

Существуют заметные различия при использовании данного API с C#. Подробнее см. API различия C# и 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.9411765, 0.972549, 1, 1) 🔗

Синяя Элис.

ANTIQUE_WHITE = Color(0.98039216, 0.92156863, 0.84313726, 1) 🔗

Античный белый.

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

Цвет аква.

AQUAMARINE = Color(0.49803922, 1, 0.83137256, 1) 🔗

Цвет аквамарина.

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

Лазурный цвет.

BEIGE = Color(0.9607843, 0.9607843, 0.8627451, 1) 🔗

Бежевый цвет.

BISQUE = Color(1, 0.89411765, 0.76862746, 1) 🔗

Цвет бисквита.

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

Черный цвет. В GDScript это значение по умолчанию для любого цвета.

BLANCHED_ALMOND = Color(1, 0.92156863, 0.8039216, 1) 🔗

Цвет бланшированного миндаля.

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

Синий цвет.

BLUE_VIOLET = Color(0.5411765, 0.16862746, 0.8862745, 1) 🔗

Сине-фиолетовый.

BROWN = Color(0.64705884, 0.16470589, 0.16470589, 1) 🔗

Коричневый цвет.

BURLYWOOD = Color(0.87058824, 0.72156864, 0.5294118, 1) 🔗

Цвет бурливуда.

CADET_BLUE = Color(0.37254903, 0.61960787, 0.627451, 1) 🔗

Серо-синий.

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

Цвет шартрез.

CHOCOLATE = Color(0.8235294, 0.4117647, 0.11764706, 1) 🔗

Шоколадный цвет.

CORAL = Color(1, 0.49803922, 0.3137255, 1) 🔗

Коралловый цвет.

CORNFLOWER_BLUE = Color(0.39215687, 0.58431375, 0.92941177, 1) 🔗

Васильково-синий цвет.

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

Цвет кукурузных рылец.

CRIMSON = Color(0.8627451, 0.078431375, 0.23529412, 1) 🔗

Багровый цвет.

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

Голубой цвет.

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

Темно-синий цвет.

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

Тёмный циан.

DARK_GOLDENROD = Color(0.72156864, 0.5254902, 0.043137256, 1) 🔗

Темно-золотистый.

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

Темно-серый.

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

Темно-зеленый.

DARK_KHAKI = Color(0.7411765, 0.7176471, 0.41960785, 1) 🔗

Темный хаки.

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

Тёмный фуксин.

DARK_OLIVE_GREEN = Color(0.33333334, 0.41960785, 0.18431373, 1) 🔗

Цвет темно-оливково-зеленый.

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

Темно-оранжевый.

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

Темно-лиловый.

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

Темно-красный.

DARK_SALMON = Color(0.9137255, 0.5882353, 0.47843137, 1) 🔗

Тёмная лососина.

DARK_SEA_GREEN = Color(0.56078434, 0.7372549, 0.56078434, 1) 🔗

Цвет темно-зеленой морской волны.

DARK_SLATE_BLUE = Color(0.28235295, 0.23921569, 0.54509807, 1) 🔗

Цвет темно-синий.

DARK_SLATE_GRAY = Color(0.18431373, 0.30980393, 0.30980393, 1) 🔗

Цвет темно-серый.

DARK_TURQUOISE = Color(0, 0.80784315, 0.81960785, 1) 🔗

Темно-бирюзовый.

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

Темно-фиолетовый цвет.

DEEP_PINK = Color(1, 0.078431375, 0.5764706, 1) 🔗

Пурпурно-розовый.

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

Насыщенный небесно-голубой цвет.

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

Тускло-серый.

DODGER_BLUE = Color(0.11764706, 0.5647059, 1, 1) 🔗

Защитно-синий.

FIREBRICK = Color(0.69803923, 0.13333334, 0.13333334, 1) 🔗

Кирпичный цвет.

FLORAL_WHITE = Color(1, 0.98039216, 0.9411765, 1) 🔗

Цветочно-белый.

FOREST_GREEN = Color(0.13333334, 0.54509807, 0.13333334, 1) 🔗

Лесная зелень.

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

Цвет фуксии.

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

Цвет Гейнсборо.

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

Призрачно-белый.

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

Золотой цвет.

GOLDENROD = Color(0.85490197, 0.64705884, 0.1254902, 1) 🔗

Золотисто-рыжий цвет.

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

Серый цвет.

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

Зеленый цвет.

GREEN_YELLOW = Color(0.6784314, 1, 0.18431373, 1) 🔗

Жёлто-зелёный.

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

Цвет медовой росы.

HOT_PINK = Color(1, 0.4117647, 0.7058824, 1) 🔗

Ярко-розовый.

INDIAN_RED = Color(0.8039216, 0.36078432, 0.36078432, 1) 🔗

Индийский красный.

INDIGO = Color(0.29411766, 0, 0.50980395, 1) 🔗

Цвет индиго.

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

Цвет слоновой кости.

KHAKI = Color(0.9411765, 0.9019608, 0.54901963, 1) 🔗

Цвет хаки.

LAVENDER = Color(0.9019608, 0.9019608, 0.98039216, 1) 🔗

Цвет лаванды.

LAVENDER_BLUSH = Color(1, 0.9411765, 0.9607843, 1) 🔗

Лавандовый румянец.

LAWN_GREEN = Color(0.4862745, 0.9882353, 0, 1) 🔗

Зеленый газон.

LEMON_CHIFFON = Color(1, 0.98039216, 0.8039216, 1) 🔗

Лимонный шифон.

LIGHT_BLUE = Color(0.6784314, 0.84705883, 0.9019608, 1) 🔗

Светло-голубой.

LIGHT_CORAL = Color(0.9411765, 0.5019608, 0.5019608, 1) 🔗

Светло-коралловый.

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

Светло-синий.

LIGHT_GOLDENROD = Color(0.98039216, 0.98039216, 0.8235294, 1) 🔗

Светло-золотистый.

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

Светло-серый цвет.

LIGHT_GREEN = Color(0.5647059, 0.93333334, 0.5647059, 1) 🔗

Светло-зеленый.

LIGHT_PINK = Color(1, 0.7137255, 0.75686276, 1) 🔗

Светло-розовый.

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

Светло-лососевый.

LIGHT_SEA_GREEN = Color(0.1254902, 0.69803923, 0.6666667, 1) 🔗

Цвет светло-зеленой морской волны.

LIGHT_SKY_BLUE = Color(0.5294118, 0.80784315, 0.98039216, 1) 🔗

Цвет светло-голубой.

LIGHT_SLATE_GRAY = Color(0.46666667, 0.53333336, 0.6, 1) 🔗

Цвет светло-серый.

LIGHT_STEEL_BLUE = Color(0.6901961, 0.76862746, 0.87058824, 1) 🔗

Цвет светло-стальной синевы.

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

Светло-желтый.

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

Цвет лайма.

LIME_GREEN = Color(0.19607843, 0.8039216, 0.19607843, 1) 🔗

Зеленый лайм.

LINEN = Color(0.98039216, 0.9411765, 0.9019608, 1) 🔗

Цвет льна.

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

Пурпурный цвет.

MAROON = Color(0.6901961, 0.1882353, 0.3764706, 1) 🔗

Бордовый цвет.

MEDIUM_AQUAMARINE = Color(0.4, 0.8039216, 0.6666667, 1) 🔗

Умеренный аквамарин.

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

Умеренно-синий.

MEDIUM_ORCHID = Color(0.7294118, 0.33333334, 0.827451, 1) 🔗

Умеренный лиловый.

MEDIUM_PURPLE = Color(0.5764706, 0.4392157, 0.85882354, 1) 🔗

Средне-фиолетовый.

MEDIUM_SEA_GREEN = Color(0.23529412, 0.7019608, 0.44313726, 1) 🔗

Цвет морской волны средней насыщенности.

MEDIUM_SLATE_BLUE = Color(0.48235294, 0.40784314, 0.93333334, 1) 🔗

Цвет средне-синий.

MEDIUM_SPRING_GREEN = Color(0, 0.98039216, 0.6039216, 1) 🔗

Цвет средне-весенне-зеленый.

MEDIUM_TURQUOISE = Color(0.28235295, 0.81960785, 0.8, 1) 🔗

Средне-бирюзовый.

MEDIUM_VIOLET_RED = Color(0.78039217, 0.08235294, 0.52156866, 1) 🔗

Цвет средне-фиолетово-красный.

MIDNIGHT_BLUE = Color(0.09803922, 0.09803922, 0.4392157, 1) 🔗

Полуночно-синий.

MINT_CREAM = Color(0.9607843, 1, 0.98039216, 1) 🔗

Мятно-кремовый.

MISTY_ROSE = Color(1, 0.89411765, 0.88235295, 1) 🔗

Туманно-розовый.

MOCCASIN = Color(1, 0.89411765, 0.70980394, 1) 🔗

Цвет мокасин.

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

Белый навахо.

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

Темно-синий.

OLD_LACE = Color(0.99215686, 0.9607843, 0.9019608, 1) 🔗

Старое кружево.

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

Оливковый цвет.

OLIVE_DRAB = Color(0.41960785, 0.5568628, 0.13725491, 1) 🔗

Нежно-оливковый.

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

Оранжевый цвет.

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

Оранжево-красный.

ORCHID = Color(0.85490197, 0.4392157, 0.8392157, 1) 🔗

Цвет орхидеи.

PALE_GOLDENROD = Color(0.93333334, 0.9098039, 0.6666667, 1) 🔗

Бледно-золотистый.

PALE_GREEN = Color(0.59607846, 0.9843137, 0.59607846, 1) 🔗

Бледно-зеленый.

PALE_TURQUOISE = Color(0.6862745, 0.93333334, 0.93333334, 1) 🔗

Бледно-бирюзовый.

PALE_VIOLET_RED = Color(0.85882354, 0.4392157, 0.5764706, 1) 🔗

Бледно-фиолетово-красный цвет.

PAPAYA_WHIP = Color(1, 0.9372549, 0.8352941, 1) 🔗

Побег папайи.

PEACH_PUFF = Color(1, 0.85490197, 0.7254902, 1) 🔗

Тёмно-персиковый.

PERU = Color(0.8039216, 0.52156866, 0.24705882, 1) 🔗

Перуанский цвет.

PINK = Color(1, 0.7529412, 0.79607844, 1) 🔗

Розовый цвет.

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

Цвет сливы.

POWDER_BLUE = Color(0.6901961, 0.8784314, 0.9019608, 1) 🔗

Зеленовато-голубой.

PURPLE = Color(0.627451, 0.1254902, 0.9411765, 1) 🔗

Фиолетовый цвет.

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

Фиолетовый Ребекки.

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

Красный цвет.

ROSY_BROWN = Color(0.7372549, 0.56078434, 0.56078434, 1) 🔗

Розово-коричневый.

ROYAL_BLUE = Color(0.25490198, 0.4117647, 0.88235295, 1) 🔗

Королевский синий.

SADDLE_BROWN = Color(0.54509807, 0.27058825, 0.07450981, 1) 🔗

Кожаного седла.

SALMON = Color(0.98039216, 0.5019608, 0.44705883, 1) 🔗

Цвет лосося.

SANDY_BROWN = Color(0.95686275, 0.6431373, 0.3764706, 1) 🔗

Рыжеватый.

SEA_GREEN = Color(0.18039216, 0.54509807, 0.34117648, 1) 🔗

Морской волны.

SEASHELL = Color(1, 0.9607843, 0.93333334, 1) 🔗

Цвет морской раковины.

SIENNA = Color(0.627451, 0.32156864, 0.1764706, 1) 🔗

Цвет сиены.

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

Серебряный цвет.

SKY_BLUE = Color(0.5294118, 0.80784315, 0.92156863, 1) 🔗

Небесно-голубой цвет.

SLATE_BLUE = Color(0.41568628, 0.3529412, 0.8039216, 1) 🔗

Аспидно-синий.

SLATE_GRAY = Color(0.4392157, 0.5019608, 0.5647059, 1) 🔗

Серый шифер.

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

Цвет снега.

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

Зелёная весна.

STEEL_BLUE = Color(0.27450982, 0.50980395, 0.7058824, 1) 🔗

Голубовато-стальной.

TAN = Color(0.8235294, 0.7058824, 0.54901963, 1) 🔗

Цвет загара.

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

Цвет тила.

THISTLE = Color(0.84705883, 0.7490196, 0.84705883, 1) 🔗

Цвет чертополоха.

TOMATO = Color(1, 0.3882353, 0.2784314, 1) 🔗

Цвет томатов.

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

Прозрачный цвет (белый с нулевой альфа-каналом).

TURQUOISE = Color(0.2509804, 0.8784314, 0.8156863, 1) 🔗

Бирюзовый цвет.

VIOLET = Color(0.93333334, 0.50980395, 0.93333334, 1) 🔗

Фиолетовый цвет.

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

Серый.

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

Зеленый.

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

Бордовый.

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

Пурпурный.

WHEAT = Color(0.9607843, 0.87058824, 0.7019608, 1) 🔗

Цвет пшеницы.

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

Белый цвет.

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

Дымчатый.

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

Желтый цвет.

YELLOW_GREEN = Color(0.6039216, 0.8039216, 0.19607843, 1) 🔗

Желто-зеленый.

Описания свойств

float a = 1.0 🔗

Альфа-канал цвета обычно находится в диапазоне от 0 до 1. Значение 0 означает, что цвет полностью прозрачен. Значение 1 означает, что цвет полностью непрозрачен.

Примечание: Альфа-канал всегда хранится с линейным кодированием, независимо от кодирования других цветовых каналов. Методы linear_to_srgb() и srgb_to_linear() не влияют на альфа-канал.

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# это создает Color со всеми его компонентами, установленными на 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 Color(code: String)

Создает Color либо из кода цвета HTML, либо из стандартизированного имени цвета. Поддерживаемые имена цветов совпадают с константами.

Color Color(code: String, alpha: float)

Создает Color либо из кода цвета HTML, либо из стандартизированного имени цвета с alpha в диапазоне от 0,0 до 1,0. Поддерживаемые имена цветов совпадают с константами.

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

Создает Color из значений RGB, обычно в диапазоне от 0,0 до 1,0. a устанавливается в значение 1,0.

var color = Color(0.2, 1.0, 0.7) # Аналогично `Color.from_rgba8(51, 255, 178, 255)`

var color = new Color(0.2f, 1.0f, 0.7f); // Аналогично `Color.from_rgba8(51, 255, 178, 255)`

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

Создает Color из значений RGBA, обычно в диапазоне от 0,0 до 1,0.

var color = Color(0.2, 1.0, 0.7, 0.8) # Аналогично `Color.from_rgba8(51, 255, 178, 204)`

var color = new Color(0.2f, 1.0f, 0.7f, 0.8f); // Аналогично `Color.from_rgba8(51, 255, 178, 204)`

Описания метода

Color blend(over: Color) const 🔗

Возвращает новый цвет, полученный в результате наложения этого цвета на заданный цвет. В программе рисования вы можете представить его как цвет 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 🔗

Возвращает новый цвет со всеми компонентами, зажатыми между компонентами min и max, путем запуска @GlobalScope.clamp() для каждого компонента.

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 🔗

Возвращает Color, составленный из красного (r8), зеленого (g8), синего (b8) и, необязательно, альфа (a8) целочисленных каналов, каждый из которых делится на 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 🔗

Декодирует Color из целого числа формата RGBE9995. См. Image.FORMAT_RGBE9995.

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

Создает Color из заданной строки, которая может быть либо кодом цвета HTML, либо именованным цветом (без учета регистра). Возвращает default, если цвет не может быть выведен из строки.

Если вы хотите создать цвет из String в константном выражении, используйте вместо этого эквивалентный конструктор (т. е. Color("color string")).

float get_luminance() const 🔗

Возвращает интенсивность цвета в виде значения от 0,0 до 1,0 (включительно). Это полезно при определении светлого или темного цвета. Цвета с яркостью меньше 0,5 обычно считаются темными.

Примечание: Метод get_luminance() использует линейное кодирование для возврата точного значения относительной яркости. Если цвет использует нелинейное кодирование sRGB по умолчанию, сначала используйте srgb_to_linear() для преобразования его в линейное кодирование.

Color hex(hex: int) static 🔗

Возвращает Color, связанный с предоставленным целым числом hex в 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 🔗

Возвращает Color, связанный с предоставленным целым числом hex в 64-битном формате RGBA (16 бит на канал). Этот метод является обратным to_rgba64().

В GDScript и C# int лучше всего визуализировать с помощью шестнадцатеричной записи (префикс "0x", что делает его "0xRRRRGGGGBBBBAAAA").

Color html(rgba: String) static 🔗

Возвращает новый цвет из rgba, шестнадцатеричной строки цвета HTML. rgba не чувствителен к регистру и может иметь префикс в виде знака решетки (#).

rgba должен быть допустимой трехзначной или шестизначной шестнадцатеричной строкой цвета и может содержать значение альфа-канала. Если rgba не содержит значение альфа-канала, применяется значение альфа-канала 1.0. Если rgba недопустим, возвращает пустой цвет.

var blue = Color.html("#0000ff") # синий — это Color(0.0, 0.0, 1.0, 1.0)
var green = Color.html("#0F0")   # зеленый — это 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"); // синий — это Color(0.0, 0.0, 1.0, 1.0)
var green = Color.FromHtml("#0F0");   // зеленый — это 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 🔗

Возвращает true, если color является допустимой шестнадцатеричной строкой цвета HTML. Строка должна быть шестнадцатеричным значением (без учета регистра) из 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 🔗

Возвращает true, если этот цвет и to приблизительно равны, путем запуска @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(), который выполняет обратную операцию.

Примечание: Альфа-канал цвета (a) не затрагивается. Альфа-канал всегда хранится с линейным кодированием, независимо от цветового пространства других цветовых каналов.

Color srgb_to_linear() const 🔗

Возвращает копию цвета, использующую линейное кодирование. Для этого метода требуется, чтобы исходный цвет был закодирован с использованием нелинейной функции преобразования sRGB. См. также linear_to_srgb(), который выполняет обратную операцию.

Примечание: Альфа-канал цвета (a) не затрагивается. Альфа-канал всегда хранится с линейным кодированием, независимо от цветового пространства других цветовых каналов.

int to_abgr32() const 🔗

Возвращает цвет, преобразованный в 32-битное целое число в формате ABGR (каждый компонент — 8 бит). 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 🔗

Возвращает цвет, преобразованный в 64-битное целое число в формате ABGR (каждый компонент — 16 бит). 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 🔗

Возвращает цвет, преобразованный в 32-битное целое число в формате ARGB (каждый компонент — 8 бит). 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 🔗

Возвращает цвет, преобразованный в 64-битное целое число в формате ARGB (каждый компонент — 16 бит). 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 🔗

Возвращает цвет, преобразованный в шестнадцатеричный цвет HTML String в формате RGBA, без префикса решетки (#).

Установка with_alpha в false исключает альфа из шестнадцатеричной строки, используя формат 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 🔗

Возвращает цвет, преобразованный в 32-битное целое число в формате RGBA (каждый компонент — 8 бит). 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 🔗

Возвращает цвет, преобразованный в 64-битное целое число в формате RGBA (каждый компонент — 16 бит). 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 также инвертируется.