Пользовательские цвета#

Введение#

Дрон 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())
На этой странице