Колір

Вступ

Датчик кольору – це оптичний датчик, який дозволяє вашому роботу виявляти присутність об’єкта, розпізнавати певні кольори та повертати візуальні дані, такі як яскравість і відтінок.

Ви також можете налаштувати яскравість внутрішнього підсвічування датчика. Ці інструменти ідеально підходять для програм, яким потрібно реагувати на кольорові об’єкти, умови освітлення або зворотний зв’язок датчика в режимі реального часу.

На цій сторінці як приклад назви датчика кольору використовується 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)

Параметри	Опис
callback	Функція function, яка попередньо визначена для виконання, коли датчик кольору виявляє об’єкт.
args	Необов’язково. Кортеж, що містить аргументи для передачі функції зворотного виклику. Див. Функції з параметрами для отримання додаткової інформації.

Мутатори

set_light

set_light вмикає, вимикає або встановлює рівень яскравості світлодіода датчика кольору.

Usage:
color_1.set_light(value, units)

Параметри	Опис
value	Визначає, чи вмикати світлодіод, використовуючи один із наведених нижче параметрів: LedStateType.ON — Встановлює яскравість світлодіода на 100%. LedStateType.OFF — Встановлює яскравість світлодіода на 0%. Крім того, для встановлення яскравості світлодіода можна використовувати значення від 0 до 100. Значення 0 вимикає світлодіод; будь-яке значення вище 0 вмикає його з цією яскравістю.
units	Необов’язково. Одиниця вимірювання, що представляє значення яскравості: PERCENT.

# 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)

Параметри	Опис
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()

Параметри	Опис
	Цей метод не має параметрів.

Конструктори

Конструктори використовуються для ручного створення об’єктів ColorSensor , які необхідні для налаштування Color Sensor поза VEXcode.

ColorSensor

ColorSensor створює датчик кольору.

Usage:
color_1 = ColorSensor(smartport)

Параметр	Опис
smartport	Розумний порт, до якого підключено датчик кольору, записується як PORTx, де x – номер порту.

# Create a Color Sensor object in Port 3
color_1 = ColorSensor(Ports.PORT3)