Color

Колір представлений у форматі RGBA.

Опис

Колір, представлений у форматі RGBA червоним (r), зеленим (g), синім (b) та альфа-компонентом (a). Кожен компонент є 32-бітним значенням з плаваючою комою, зазвичай у діапазоні від 0.0 до 1.0. Деякі властивості (такі як CanvasItem.modulate) можуть підтримувати значення більше, ніж 1.0, для надто яскравих або HDR (розширений динамічний діапазон) кольорів.

Кольори можна створювати різними способами: за допомогою різних конструкторів Color, статичних методів, таких як from_hsv(), та за допомогою назви з набору стандартизованих кольорів на основі назв кольорів X11 з додаванням TRANSPARENT. GDScript також надає @GDScript.Color8(), який використовує цілі числа від 0 до 255 та не підтримує надто яскраві кольори.

Дані про колір можуть зберігатися в багатьох колірних просторах та кодуваннях. Методи srgb_to_linear() та linear_to_srgb() можуть конвертувати між нелінійним кодуванням sRGB та лінійним кодуванням RGB.

Примітка: У логічному контексті значення Color буде оцінено як false, якщо воно дорівнює Color(0, 0, 0, 1) (непрозорий чорний). В іншому випадку значення Color завжди буде оцінено як true.

Шпаргалка з кольорових констант

Примітка

Існують значні відмінності при використанні цього API із С#. Більше інформації: ref:doc_c_sharp_differences.

Посібники

Властивості

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

Колір Azure.

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

Cadet синій колір.

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

Темний колір magenta.

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

Fuchsia колір.

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 синій колір.

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)

Constructs a Color як копія даної Color.

Color Color(code: String)

Constructs a Color або з HTML-коду або з стандартизованого імені кольору. Підтримувані імена кольорів такі ж, як константи.

Color Color(code: String, alpha: float)

Constructs a 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) # Схоже на `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)

Constructs Color з значень RGBA, як правило, між 0.0 і 1.0.

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 🔗

Повертає новий колір, отриманий у результаті накладання цього кольору на заданий колір. У програмі для малювання ви можете уявити його як колір 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.0f, 0.5f); // Зелений з альфою 50%
var fg = new Color(1.0f, 0.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 profile. Хвиля (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 🔗

Decodes a 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, пов'язаний з наданим каблук цілим в форматі 32-bit RGBA (8 біт на канал). Цей метод є інверсом to_rgba32().

У GDScript і C#, int краще візуалізувати з шістнадцятковим позначенням ("0x" префікс, що робить його "0xRGBBAA"".

var червоний = Color.hex(0xff0000ff)
var dark_cyan = Color.hex(0x008b8b8bff)
var my_color = Color.hex(0xbbefd2a4)

var red = new color(0xff0000ff);
var dark_cyan = new color(0x008b8b8bff);
var my_color = new color(0xbbefd2a4);

Якщо ви хочете використовувати позначення шестигранної форми в постійному виразі, скористайтеся еквівалентним конструктором замість (тобто Color(0xRRGGBBAA)).

Color hex64(hex: int) static 🔗

Повертає Color, пов'язаний з наданим каблук цілим в форматі 64-bit RGBA (16 біт на канал). Цей метод є інверсом to_rgba64().

У GDScript і C#, int краще візуалізувати з Hexadecimal позначення ("0x" префікс, що робить його "0xRRRRGGGBBBBAAAA"".

Color html(rgba: String) static 🔗

IПовертає новий колір з [param rgba], HTML hexadecimal string. [param rgba] є нечутливим, і може бути префіксований знаком хешу ([code]#).

rgba повинен бути дійсний три-цифровий або шести гранний шестигранний колірний ряд, і може містити значення альфа каналу. Якщо rgba не містить альфа-каналу значення, альфа-канал значення 1,0 застосовується. Якщо rgba недійсний, повертає порожній колір.

var blue = Color.html("#0000ff") # синій колір(0.0, 0.0, 1.0, 1.0)
var green = Color.html("#0F0") # зелена колір(0.0, 1.0, 0.0, 1.0)
var col = Color.html("663399cc") # col — це колір(0.4, 0.2, 0.6, 0.8)

var blue = Color.З FromHtml("#0000ff"); // синій колір(0.0, 0.0, 1.0, 1.0)
var green = Color.З FromHtml("#0F0"); // зелений колір (0.0, 1.0, 0.0, 1.0)
var col = Color.З FromHtml("663399cc"); // col — це колір(0.4, 0.2, 0.6, 0.8)

bool html_is_valid(color: String) static 🔗

true if 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"); // Повернення
Color.HtmlIsValid("55AAFF"); // Повертає true
Color.HtmlIsValid("#F2C"); // Повернення

Color.HtmlIsValid("#AABBC"); // Повернення false
Color.HtmlIsValid("#55aaFF5"); // Повернення false

Color inverted() const 🔗

Повертає колір з його р, r, і g компоненти інвертовані ((1 - р, 1 - б, а)).

var black = Color.WHITE.inverted()
car 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_about() на кожному компоненті.

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) # Повертає колір(0.8, 0.2, 0.16)
red.lerp(aqua, 0.5) # Повертає колір(0.5, 0.5, 0,4)
red.lerp(aqua, 1.0) # Повертає Колір(0.0, 1.0, 0.8)

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

red.Lerp(aqua, 0.2f); // Повертає колір(0.8f, 0.2f, 0.16f)
red.Lerp(aqua, 0.5f); // Повертає колір(0.5f, 0.5f, 0.4f)
red.Lerp(aqua, 1.0f); // Повертає колір(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 to false, виключає альфа з шістнадцяткового рядка, використовуючи формат RGB замість формату RGBA

var white = Колір(1, 1, 0.5)
var whit_alpha = white.to_html() # Повернення ffffff7f"
var without_alpha = white.to_html(false) # Повертає "ffffffffff"

var white = new Color(1, 1, 0.5f);
string withAlpha = white.ToHtml(); // Повертає "ffffff7f"
string whitoutAlpha = white.ToHtml(false); // Повертає "ffffffffff"

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 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 інвертується.