Користувацькі кольори#

Вступ #

VEX EXP підтримує використання власних кольорів для малювання, тексту та світлодіодів. Власні кольори можна створювати за допомогою значень RGB, шістнадцяткових кодів, значень HSV або попередньо визначених констант. “Власні кольори” містять методи як для створення, так і для оновлення кольорових об’єктів. Нижче наведено список доступних методів:

Конструктори – Створюють новий об’єкт Color.

Color(value) – Приймає попередньо визначену константу, шістнадцятковий рядок (наприклад “#FFF700”) або шістнадцяткове ціле число (наприклад 0xFFF700).
Color(r, g, b) – Створює колір, використовуючи значення червоного, зеленого та синього (0–255).

Мутатори – Оновлення існуючого об’єкта Color.

rgb – Оновлює колір, використовуючи нові значення RGB.
hsv – Оновлює колір за допомогою відтінку (0–360), насиченості та яскравості (0,0–1,0).
web – Оновлює колір за допомогою шістнадцяткового рядка кольору у веб-форматі (наприклад “#32C8B6”).

Створення власного кольору #

Щоб використовувати власний колір, спочатку потрібно створити об’єкт Color використовуючи один із наступних конструкторів:

Hexadecimal Integer #

Створює колір, використовуючи шестизначне шістнадцяткове ціле число.

Usage:
Color(value)

Параметр	Опис
`value`	Шестизначне ціле число у шістнадцятковому форматі (наприклад, `0xFFF700` для жовтого).

# Construct a yellow Color "yellow" using a
# hexadecimal value
yellow = Color(0xFFF700)

brain.screen.set_pen_color(yellow)
brain.screen.print("My Yellow")

RGB #

Створює колір, використовуючи окремі значення червоного, зеленого та синього.

Usage:
Color(r, g, b)

Параметр	Опис
`r`	Ціле число від 0 до 255, що представляє червоний компонент.
`g`	Ціле число від 0 до 255, що представляє зелений компонент.
`b`	Ціле число від 0 до 255, що представляє синій компонент.

# Construct a yellow Color "yellow" using
# RGB values
yellow = Color(255, 247, 0)

brain.screen.set_pen_color(yellow)
brain.screen.print("My Yellow")

Web Color #

Створює колір за допомогою веб-рядка кольору (шістнадцятковий код).

Usage:
Color(value)

Параметр	Опис
`value`	Веб-колір у вигляді рядка (шістнадцятковий код) (наприклад, `“#FFF700”`).

# Construct a yellow Color "yellow" using a
# web string
yellow = Color("#FFF700")

brain.screen.set_pen_color(yellow)
brain.screen.print("My Yellow")

Predefined Color #

Створює колір, використовуючи попередньо визначену константу Color.

Usage:
Color(value)

Параметр	Опис
`value`	Вбудована колірна константа: `BLACK`, `BLUE`, `CYAN`, `GREEN`, `ORANGE`, `PURPLE`, `RED`, `TRANSPARENT`, `WHITE`, `YELLOW`.

# Construct a yellow Color "yellow" using a
# predefined Color constant
yellow = Color.YELLOW

brain.screen.set_pen_color(yellow)
brain.screen.print("My Yellow")

Мутатори #

Ці методи оновлюють колір існуючого об’єкта Color Щоб їх використовувати, призначте змінній Color під час її створення, а потім викличте метод для цієї змінної, щоб змінити її колір.

rgb #

rgb оновлює колір існуючого об’єкта Color , використовуючи значення RGB.

Usage:
variable_name.rgb(r, g, b)

Параметри	Опис
`r`	Ціле число від 0 до 255, що представляє червоний компонент кольору.
`g`	Ціле число від 0 до 255, що представляє зелений компонент кольору.
`b`	Ціле число від 0 до 255, що представляє синій компонент кольору.

# Create a custom teal color and set it as the pen color
brain_color = Color(50, 200, 180)
brain.screen.set_pen_color(brain_color)

# Draw a rectangle with the teal outline
brain.screen.draw_rectangle(5, 10, 80, 40)

# Draw another rectangle with a magenta outline
brain_color.rgb(170, 40, 150)
brain.screen.set_pen_color(brain_color)
brain.screen.draw_rectangle(5, 60, 80, 40)

hsv #

hsv оновлює колір існуючого об’єкта Color , використовуючи значення HSV.

Примітка: hsv можна використовувати лише для зміни вже створеного об’єкта Color Його не можна використовувати для створення нового об’єкта Color.

Usage:
variable_name.hsv(h, s, v)

Параметри	Опис
`h`	Ціле число від 0 до 359, що представляє відтінок кольору.
`s`	Число з плаваючою комою від 0,0 до 1,0, що представляє насиченість кольору.
`v`	Число з плаваючою комою від 0.0 до 1.0, що представляє яскравість кольору.

# Create a custom teal color using RGB (HSV can't be used)
brain_color = Color(50, 200, 180)
brain.screen.set_pen_color(brain_color)

# Draw a rectangle with the teal outline
brain.screen.draw_rectangle(5, 10, 80, 40)

# Draw another rectangle with a magenta outline
brain_color.hsv(300, 0.75, 0.78)
brain.screen.set_pen_color(brain_color)
brain.screen.draw_rectangle(5, 60, 80, 40)

web #

web оновлює колір існуючого об’єкта Color , використовуючи веб-колір (шістнадцятковий код).

Usage:
variable_name.web(value)

Параметри	Опис
`value`	Веб-колір у вигляді рядка (шістнадцятковий код) (наприклад, `“#FFF700”`).

# Create a custom teal color and set it as the pen color
brain_color = Color("#32C8B6")
brain.screen.set_pen_color(brain_color)

# Draw a rectangle with the teal outline
brain.screen.draw_rectangle(5, 10, 80, 40)

# Draw another rectangle with the new magenta outline
brain_color.web("#AA2896")
brain.screen.set_pen_color(brain_color)
brain.screen.draw_rectangle(5, 60, 80, 40)