Цвет#
Введение#
Цветовой датчик — это оптический датчик, который позволяет вашему роботу определять наличие объекта, распознавать определенные цвета и возвращать визуальные данные, такие как яркость и оттенок.
Вы также можете настроить яркость внутренней подсветки датчика. Эти инструменты идеально подходят для программ, которым необходимо реагировать на цветные объекты, условия освещения или обратную связь от датчика в режиме реального времени.
На этой странице в качестве примера имени датчика цвета используется color_1 При необходимости замените его на собственное настроенное имя.
Ниже приведён список всех методов:
Действия — Обнаружение объектов с помощью цветового датчика.
object_detected— Регистрирует функцию, которая будет вызвана при обнаружении объекта.
Мутаторы — Изменяют параметры подсветки датчика цвета.
set_light— Включает, выключает или устанавливает уровень яркости светодиода датчика цвета.set_light_power— Устанавливает яркость светодиода датчика цвета.
Геттеры — возвращают данные объекта с помощью датчика цвета.
is_near_object— Возвращает значение, указывающее, находится ли объект в пределах досягаемости датчика.color— Возвращает шестнадцатеричный код обнаруженного цвета.brightness— Возвращает обнаруженную яркость.hue— Возвращает обнаруженное значение оттенка.installed— Возвращает значение, указывающее, подключен ли датчик цвета к мозгу.
Конструкторы — Вручную инициализируют и настраивают цветовой датчик.
ColorSensor— Создает датчик цвета.
Действия#
object_detected#
object_detected регистрирует функцию, которая будет вызываться, когда датчик цвета обнаружит объект.
Usage:
color_1.object_detected(callback, args)
Параметры |
Описание |
|---|---|
|
A function that is previously defined to execute when the Color Sensor detects an object. |
|
Необязательно. Кортеж, содержащий аргументы для передачи в функцию обратного вызова. См. Функции с параметрами для получения дополнительной информации. |
Мутаторы#
set_light#
set_light устанавливает светодиод датчика цвета в положение «включено», «выключено» или «заданный уровень яркости».
Usage:
color_1.set_light(value, units)
Параметры |
Описание |
|---|---|
|
Указывает, включать или выключать светодиод, используя одно из следующих значений:
|
|
Необязательно. Единица измерения яркости: |
# Turn the LED on and off forever
while True:
color_1.set_light(LedStateType.ON)
wait(0.5, SECONDS)
color_1.set_light(LedStateType.OFF)
wait(0.5, SECONDS)
# Turn the LED on and off forever
while True:
color_1.set_light(LedStateType.ON, 75)
wait(0.5, SECONDS)
color_1.set_light(0)
wait(0.5, SECONDS)
set_light_power#
set_light_power устанавливает яркость светодиода датчика цвета. Если светодиод еще не включен, этот метод также включит его.
Usage:
color_1.set_light_power(value)
Параметры |
Описание |
|---|---|
|
Яркость светодиода в процентах от 0 до 100. Значение 0 выключает светодиод. |
# Turn the LED light on at different intensities
color_1.set_light_power(10)
wait(2, SECONDS)
color_1.set_light_power(100)
Геттеры#
is_near_object#
is_near_object` возвращает логическое значение, указывающее, находится ли датчик цвета на расстоянии приблизительно 57 миллиметров (2,25 дюйма) от объекта. Обнаружение зависит от отраженного света, поэтому темные или неотражающие поверхности могут быть обнаружены ненадежно.
True— Обнаруженный объект находится на расстоянии приблизительно 57 миллиметров.False— Обнаруженный объект находится за пределами приблизительно 57 миллиметров.
Usage:
color_1.is_near_object()
Параметры |
Описание |
|---|---|
Этот метод не имеет параметров. |
color#
Функция color возвращает шестнадцатеричный код обнаруженного цвета в виде строки в формате “Цвет”, за которым следуют два нуля и шестнадцатеричное значение цвета.
Например, обнаружение красного цвета (#FF0000) вернет “Цвет 00FF0000”.
Usage:
color_1.color()
Параметры |
Описание |
|---|---|
Этот метод не имеет параметров. |
# Display the currently detected hex value
while True:
brain.screen.clear_screen()
brain.screen.set_cursor(1, 1)
brain.screen.print(color_1.color())
wait(0.5,SECONDS)
brightness#
Значение brightness возвращает яркость обнаруженного цвета в виде целого числа от 0% до 100%.
Более высокий процент означает, что датчик цвета обнаруживает больше света. Более низкий процент означает, что датчик цвета обнаруживает меньше света.
Usage:
color_1.brightness()
Параметры |
Описание |
|---|---|
Этот метод не имеет параметров. |
# Display the currently detected brightness
while True:
brain.screen.clear_screen()
brain.screen.set_cursor(1, 1)
brain.screen.print("Brightness:")
brain.screen.next_row()
brain.screen.print(color_1.brightness())
wait(0.5,SECONDS)
hue#
Параметр hue возвращает обнаруженное значение оттенка в виде числа с плавающей запятой в диапазоне от 0 до 359,99 градусов.
Оттенок — это способ описания цвета с помощью чисел на цветовом круге, как показано ниже.
Usage:
color_1.hue()
Параметры |
Описание |
|---|---|
Этот метод не имеет параметров. |
# Display the currently detected hue
while True:
brain.screen.clear_screen()
brain.screen.set_cursor(1, 1)
brain.screen.print("Hue: ")
brain.screen.print(color_1.hue())
wait(0.5,SECONDS)
installed#
installed возвращает логическое значение, указывающее, подключен ли датчик цвета к головному мозгу.
True— Цветовой датчик подключен к мозгу.False— Цветовой датчик не подключен к мозгу.
Usage:
color_1.installed()
Параметры |
Описание |
|---|---|
Этот метод не имеет параметров. |
Строители#
Constructors are used to manually create ColorSensor objects, which are necessary for configuring a Color Sensor outside of VEXcode.
ColorSensor#
ColorSensor создает датчик цвета.
Usage:
color_1 = ColorSensor(smartport)
Параметр |
Описание |
|---|---|
|
Интеллектуальный порт, к которому подключен датчик цвета, обозначается как PORTx, где x — номер порта. |
# Create a Color Sensor object in Port 3
color_1 = ColorSensor(Ports.PORT3)