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

Вступ#

Дрон VEX AIR підтримує використання власних кольорів для малювання та друку тексту. Власні кольори можна створювати за допомогою значень RGB або шістнадцяткових кодів. Власні кольори також включають методи для оновлення кольорових об’єктів під час проекту.

Нижче наведено список доступних конструкторів:

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

  • Color(value) – Створює колір, використовуючи шістнадцятковий рядок (наприклад, "#FFF700") або шістнадцяткове ціле число (наприклад 0xFFF700).

  • Color(r, g, b) – Створює колір, використовуючи значення червоного, зеленого та синього.

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

  • rgb – Встановлює для створеного кольорового об’єкта новий колір, використовуючи значення RGB.

  • hsv – Встановлює для створеного кольорового об’єкта новий колір, використовуючи значення відтінку, насиченості та яскравості.

  • web – Встановлює створений об’єкт кольору на новий колір, використовуючи шістнадцятковий рядок кольору веб-коду (наприклад, "#32C8B6").

Геттери – Повертають значення відтінку або насиченості кольорового об’єкта.

  • saturation – Повертає значення насиченості для власного кольору.

  • hue – Повертає значення відтінку для власного кольору.

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

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

Hexadecimal String#

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

Usage:
Color(value)

Параметр

Опис

value

Шестизначний шістнадцятковий код у вигляді рядка (наприклад, “#FF700” для жовтого).

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

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

Hexadecimal Integer#

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

Usage:
Color(value)

Параметр

Опис

value

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

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

controller.screen.set_pen_color(yellow)
controller.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)

controller.screen.set_pen_color(yellow)
controller.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
my_fill_color = Color(50, 200, 180)

# Draw a teal rectangle
controller.screen.draw_rectangle(x=30, y=70, width=80, height=50, color=my_fill_color)

# Draw a magenta rectangle
my_fill_color.rgb(170, 40, 150)
controller.screen.draw_rectangle(x=130, y=70, width=80, height=50, color=my_fill_color)

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
my_fill_color = Color(50, 200, 180)

# Draw a teal rectangle
controller.screen.draw_rectangle(x=30, y=70, width=80, height=50, color=my_fill_color)

# Draw a magenta rectangle
my_fill_color.hsv(300, 0.75, 0.78)
controller.screen.draw_rectangle(x=130, y=70, width=80, height=50, color=my_fill_color)

web#

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

Usage:
variable_name.web(value)

Параметри

Опис

value

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

 
# Create a custom teal color
my_fill_color = Color("#32C8B6")

# Draw a teal rectangle
controller.screen.draw_rectangle(x=30, y=70, width=80, height=50, color=my_fill_color)

# Draw a magenta rectangle
my_fill_color.web("#AA2896")
controller.screen.draw_rectangle(x=130, y=70, width=80, height=50, color=my_fill_color)

Геттери#

saturation#

saturation повертає значення насиченості для власного кольору у вигляді числа з плаваючою комою від 0 до 1.

Usage:
my_color.saturation()

Замініть my_color на назву об’єкта власного кольору.

Параметри

Опис

Цей метод не має параметрів.

 
# Create a custom teal color
color_teal = Color(50, 200, 180)

# Display the saturation value of teal
controller.screen.print(color_teal.saturation())

hue#

hue повертає значення відтінку для власного кольору у вигляді числа з плаваючою комою від 0 до 359.

Usage:
my_color.hue()

Замініть my_color на назву об’єкта власного кольору.

Параметри

Опис

Цей метод не має параметрів.

 
# Create a custom teal color
color_teal = Color(50, 200, 180)

# Display the hue value of teal
controller.screen.print(color_teal.hue())
On this page