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

Введение#

Программируемый робот VEX AIM поддерживает использование пользовательских цветов для рисования, отображения и светодиодов. Пользовательские цвета можно создавать с помощью значений RGB, шестнадцатеричных кодов или предопределенных констант. В модуле «Пользовательские цвета» предусмотрены методы как для создания, так и для обновления цветовых объектов.

Ниже приведён список всех методов:

Конструкторы – Создают новый объект с цветом Color.

  • Color(value) – Принимает предопределенную константу, шестнадцатеричную строку или шестнадцатеричное целое число.

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

Мутаторы – Обновляют существующий объект с цветом Color.

  • rgb – Обновляет цвет, используя новые значения RGB.

  • hsv – Обновляет цвет, используя оттенок, насыщенность и яркость.

  • web – Обновляет цвет, используя шестнадцатеричную строку цвета из веб-браузера.

Создание пользовательского цвета#

Для использования пользовательского цвета необходимо сначала создать объект Color цветов), используя один из следующих конструкторов:

Hexadecimal Integer#

Создает цвет, используя шестизначное шестнадцатеричное целое число.

Usage:
Color(value)

Параметр

Описание

value

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

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

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

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

Web Color#

Создает цвет, используя строку веб-цвета (шестнадцатеричный код).

Usage:
Color(value)

Параметр

Описание

value

Цвет веб-сайта в виде строки (шестнадцатеричный код) (например, “#FFF700”).

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

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

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

# Draw a rectangle with the teal outline
robot.screen.draw_rectangle(30, 70, 80, 50)

# Draw another rectangle with a magenta outline
robot_color.rgb(170, 40, 150)
robot.screen.set_pen_color(robot_color)
robot.screen.draw_rectangle(130, 70, 80, 50)

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)
robot_color = Color(50, 200, 180)
robot.screen.set_pen_color(robot_color)

# Draw a rectangle with the teal outline
robot.screen.draw_rectangle(30, 70, 80, 50)

# Draw another rectangle with a magenta outline
robot_color.hsv(300, 0.75, 0.78)
robot.screen.set_pen_color(robot_color)
robot.screen.draw_rectangle(130, 70, 80, 50)

web#

web обновляет цвет существующего объекта Color , используя веб-цвет (шестнадцатеричный код).

Usage:
variable_name.web(value)

Параметры

Описание

value

Цвет веб-сайта в виде строки (шестнадцатеричный код) (например, “#FFF700”).

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

# Draw a rectangle with the teal outline
robot.screen.draw_rectangle(30, 70, 80, 50)

# Draw another rectangle with the new magenta outline
robot_color.web("#AA2896")
robot.screen.set_pen_color(robot_color)
robot.screen.draw_rectangle(130, 70, 80, 50)