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.
Опис
A color represented in RGBA format by a red (r), green (g), blue (b), and alpha (a) component. Each component is a 32-bit floating-point value, usually ranging from 0.0 to 1.0. Some properties (such as CanvasItem.modulate) may support values greater than 1.0, for overbright or HDR (High Dynamic Range) colors.
Colors can be created in a number of ways: By the various Color constructors, by static methods such as from_hsv(), and by using a name from the set of standardized colors based on X11 color names with the addition of TRANSPARENT.
Although Color may be used to store values of any encoding, the red (r), green (g), and blue (b) properties of Color are expected by Godot to be encoded using the nonlinear sRGB transfer function unless otherwise stated. This color encoding is used by many traditional art and web tools, making it easy to match colors between Godot and these tools. Godot uses Rec. ITU-R BT.709 color primaries, which are used by the sRGB standard.
All physical simulation, such as lighting calculations, and colorimetry transformations, such as get_luminance(), must be performed on linearly encoded values to produce correct results. When performing these calculations, convert Color to and from linear encoding using srgb_to_linear() and linear_to_srgb().
Note: In a boolean context, a Color will evaluate to false if it is equal to Color(0, 0, 0, 1) (opaque black). Otherwise, a Color will always evaluate to true.
Note: In C#, color constants are defined in the Colors static class instead of Color. Additionally, named colors use PascalCase syntax instead of UPPER_SNAKE_CASE. For example, Color.ALICE_BLUE in GDScript is Colors.AliceBlue in C#.
Примітка
Існують значні відмінності при використанні цього API із С#. Більше інформації: ref:doc_c_sharp_differences.
Посібники
Властивості
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
Конструктори
Color() |
|
Color(code: String) |
|
Методи
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_rgba8(r8: int, g8: int, b8: int, a8: int = 255) static |
|
from_rgbe9995(rgbe: int) static |
|
from_string(str: String, default: Color) static |
|
get_luminance() const |
|
html(rgba: String) static |
|
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 |
|
String |
|
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.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) 🔗
Колір мокасини.
Навахо білий колір.
Темно-синій колір.
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) 🔗
Жовтий зелений колір.
Описи властивостей
Альфа-компонент кольору, зазвичай у діапазоні від 0 до 1. Значення 0 означає, що колір повністю прозорий. Значення 1 означає, що колір повністю непрозорий.
Примітка: Альфа-канал завжди зберігається з лінійним кодуванням, незалежно від кодування інших колірних каналів. Методи linear_to_srgb() та srgb_to_linear() не впливають на альфа-канал.
Обгортувач для a, який використовує діапазон 0 до 255, замість 0 до 1.
Синій компонент кольору, як правило, на діапазоні 0 до 1.
Обгортувач для b, який використовує діапазон 0 до 255, замість 0 до 1.
Зелений компонент кольору, як правило, на діапазоні 0 до 1.
Обгортувач для g, який використовує діапазон 0 до 255, замість 0 до 1.
HSV відтінку цього кольору, на діапазоні 0 до 1.
Відтінок цього кольору за шкалою OKHSL у діапазоні від 0 до 1.
Яскравість цього кольору за шкалою OKHSL у діапазоні від 0 до 1.
Насиченість OKHSL цього кольору в діапазоні від 0 до 1.
Червоний компонент кольору, як правило, на діапазоні 0 до 1.
Обгортувач для r, який використовує діапазон 0 до 255, замість 0 до 1.
Насичення HSV цього кольору, на діапазоні 0 до 1.
HSV значення (яскравість) цього кольору, на діапазоні 0 до 1.
Описи конструкторів
Створює стандартний 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% непрозорий червоний.
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) # Similar to `Color.from_rgba8(51, 255, 178, 255)`
var color = new Color(0.2f, 1.0f, 0.7f); // Similar to `Color.Color8(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) # Similar to `Color.from_rgba8(51, 255, 178, 204)`
var color = new Color(0.2f, 1.0f, 0.7f, 0.8f); // Similar to `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")).
Повертає інтенсивність світла кольору як значення від 0,0 до 1,0 (включно). Це корисно для визначення світлого чи темного кольору. Кольори з яскравістю менше 0,5 зазвичай можна вважати темними.
Примітка: get_luminance() спирається на колір, використовуючи лінійне кодування, щоб повернути точне значення відносної яскравості. Якщо колір використовує нелінійне кодування sRGB за замовчуванням, спочатку використовуйте srgb_to_linear(), щоб перетворити його на лінійне кодування.
Повертає 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
Повертає колір з його р, 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) не змінюється. Альфа-канал завжди зберігається з лінійним кодуванням, незалежно від колірного простору інших колірних каналів.
Повертає колір, перетворений на 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
Повертає колір, який перетворюється на 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
Повертає колір, перетворений на 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
Повертає колір, перетворений на число 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"
Повертає колір, перетворений у 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
Повертає колір, перетворений у 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.WHITE - c або Color(1 - c.r, 1 - c.g, 1 - c.b, 1 - c.a). На відміну від inverted(), компонент a інвертується.