Сенсорный светодиод#

Введение #

VEX IQ Touch LED — это одновременно и световой индикатор, и кнопка. Он может светиться разными цветами, предоставляя обратную связь, например, сигнализируя о готовности робота, указывая выбранный режим или совпадая с цветом, обнаруженным другим датчиком. Кроме того, он может определять касание, позволяя запускать или изменять поведение робота одним касанием.

На этой странице в качестве примера имени сенсорного светодиода используется touchled_1 При необходимости замените его на собственное имя.

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

Действия — Взаимодействие с сенсорным светодиодом.

pressed — Регистрирует функцию, которая будет вызываться при нажатии сенсорного светодиода.
released — Регистрирует функцию, которая будет вызвана при отпускании сенсорного светодиода.
on — Включает сенсорный светодиод.
off — Выключает сенсорный светодиод.
toggle — Включает или выключает сенсорный светодиод.

Мутаторы — Изменяют цвета, яркость и настройки сенсорного светодиода.

set_color — Устанавливает цвет сенсорного светодиода.
set_fade — Задает скорость плавного перехода цветов друг в друга.
set_brightness — Устанавливает яркость сенсорного светодиода.
set_blink — Бесконечно попеременно включать и выключать сенсорный светодиод.

Геттеры — возвращают данные с сенсорного светодиода.

pressing — Возвращает значение, указывающее, нажат ли сенсорный светодиод.
installed — Возвращает значение, указывающее, подключен ли сенсорный светодиод к блоку управления.

Конструкторы — Вручную инициализируйте и настройте сенсорный светодиод.

Touchled — Создать сенсорный светодиод.

Действия #

pressed #

pressed регистрирует функцию, которая будет вызываться при нажатии на сенсорный светодиод.

Usage:
touchled_1.pressed(callback, arg)

Параметры	Описание
`callback`	A function that is previously defined to execute when the Touch LED is being pressed.
`arg`	Optional. A tuple containing arguments to pass to the callback function. See Functions with Parameters for more information.

# Turn blue while the Touch LED is pressed
def light_blue():
    touchled_1.set_color(Color.BLUE)

touchled_1.pressed(light_blue)

released #

released регистрирует функцию, которая будет вызвана при отпускании сенсорного светодиода.

Usage:
touchled_1.released(callback, arg)

Параметры	Описание
`callback`	A function that is previously defined to execute when the Touch LED is released.
`arg`	Optional. A tuple containing arguments to pass to the callback function. See Functions with Parameters for more information.

# Turn red when the Touch LED is released
def light_red():
    touchled_1.set_color(Color.RED)

touchled_1.released(light_red)

on #

Нажатие клавиши on включает сенсорный светодиод, устанавливая его яркость на 100%.

Usage:
touchled_1.on(value)

Параметры	Описание
`value`	Необязательный. Устанавливает цвет светодиода: `Color.RED` `Color.GREEN` `Color.BLUE` `Color.WHITE` (по умолчанию) `Color.YELLOW` `Color.ORANGE` `Color.PURPLE` `Color.RED_VIOLET` `Color.VIOLET` `Color.BLUE_VIOLET` `Color.BLUE_GREEN` `Color.YELLOW_GREEN` `Color.YELLOW_ORANGE` `Color.RED_ORANGE` Вы также можете указать пользовательский цвет.

Параметры

Описание

value

Необязательный. Устанавливает цвет светодиода:

Color.RED
Color.GREEN
Color.BLUE
Color.WHITE (по умолчанию)
Color.YELLOW
Color.ORANGE
Color.PURPLE
Color.RED_VIOLET
Color.VIOLET
Color.BLUE_VIOLET
Color.BLUE_GREEN
Color.YELLOW_GREEN
Color.YELLOW_ORANGE
Color.RED_ORANGE

Вы также можете указать пользовательский цвет.

# Turn green when the robot is moving
touchled_1.on(Color.GREEN)
drivetrain.drive_for(FORWARD, 5)
touchled_1.off()

off #

Параметр off отключает сенсорный светодиод, устанавливая его яркость на 0%.

Usage:
touchled_1.off()

Параметры	Описание
	Этот метод не имеет параметров.

# Turn off Touch LED when movement is over
touchled_1.on(Color.GREEN)
drivetrain.drive_for(FORWARD, 5)
touchled_1.off()

toggle #

Кнопка toggle включает или выключает сенсорный светодиод. Если светодиод в данный момент включен, кнопка toggle устанавливает его яркость на 0%, выключая его. Если светодиод выключен, кнопка toggle устанавливает его яркость на 100%, выключая его.

Usage:
touchled_1.toggle()

Параметры	Описание
	Этот метод не имеет параметров.

# Turn the Touch LED off and on
touchled_1.set_color(Color.RED)
while True:
    touchled_1.toggle()
    wait(0.5,SECONDS)

Мутаторы #

set_color #

Параметр set_color задает цвет сенсорного светодиода. Если сенсорный светодиод еще не включен при использовании этого метода, яркость будет установлена на 100%, чтобы включить его.

Usage:
touchled_1.set_color(color)

Параметры	Описание
`color`	Необязательный. Устанавливает цвет светодиода: `Color.RED` `Color.GREEN` `Color.BLUE` `Color.WHITE` (по умолчанию) `Color.YELLOW` `Color.ORANGE` `Color.PURPLE` `Color.RED_VIOLET` `Color.VIOLET` `Color.BLUE_VIOLET` `Color.BLUE_GREEN` `Color.YELLOW_GREEN` `Color.YELLOW_ORANGE` `Color.RED_ORANGE` Если не указано, `set_color` включит сенсорный светодиод ранее установленным цветом. Вы также можете указать пользовательский цвет.

Параметры

Описание

color

Необязательный. Устанавливает цвет светодиода:

Color.RED
Color.GREEN
Color.BLUE
Color.WHITE (по умолчанию)
Color.YELLOW
Color.ORANGE
Color.PURPLE
Color.RED_VIOLET
Color.VIOLET
Color.BLUE_VIOLET
Color.BLUE_GREEN
Color.YELLOW_GREEN
Color.YELLOW_ORANGE
Color.RED_ORANGE

Если не указано, set_color включит сенсорный светодиод ранее установленным цветом.
Вы также можете указать пользовательский цвет.

# Change colors between blue and green
while True:
    touchled_1.set_color(Color.BLUE)
    wait(0.5, SECONDS)
    touchled_1.set_color(Color.GREEN)
    wait(0.5, SECONDS)

set_fade #

Параметр set_fade изменяет способ перехода сенсорного светодиода к новым цветам.

Usage:
touchled_1.set_fade(type)

Параметры	Описание
`type`	Скорость перехода цвета от одного к другому: `FadeType.FAST` — Цвета будут быстро меняться. `FadeType.OFF` — Цвета будут меняться мгновенно. `FadeType.SLOW` — Цвета будут меняться медленно.

Параметры

Описание

type

Скорость перехода цвета от одного к другому:

FadeType.FAST — Цвета будут быстро меняться.
FadeType.OFF — Цвета будут меняться мгновенно.
FadeType.SLOW — Цвета будут меняться медленно.

# No fade to red, then slow fade to purple
touchled_1.set_fade(FadeType.OFF)
touchled_1.set_color(Color.RED)
wait(2, SECONDS)
touchled_1.set_fade(FadeType.SLOW)
touchled_1.set_color(Color.PURPLE)

set_brightness #

set_brightness устанавливает яркость сенсорного светодиода.

Usage:
touchled_1.set_brightness(brightness)

Параметры	Описание
`brightness`	Яркость сенсорного светодиода устанавливается целым числом от 0% до 100%.

# Show green at different brightness levels
touchled_1.set_color(Color.GREEN)
wait(1, SECONDS)
touchled_1.set_brightness(10)
wait(1, SECONDS)
touchled_1.set_brightness(100)

set_blink #

set_blink многократно мигает сенсорным светодиодом, чередуя включение и выключение.

Примечание: Вызов off не остановит мигание. Чтобы остановить мигание, установите яркость светодиода на 0 с помощью set_brightness.

Usage:
set_blink(color, ontime, offtime)

Параметры	Описание
`color`	Sets the Touch LED’s color to: `Color.RED` `Color.GREEN` `Color.BLUE` `Color.WHITE` `Color.YELLOW` `Color.ORANGE` `Color.PURPLE` `Color.RED_VIOLET` `Color.VIOLET` `Color.BLUE_VIOLET` `Color.BLUE_GREEN` `Color.YELLOW_GREEN` `Color.YELLOW_ORANGE` `Color.RED_ORANGE` You can also specify a custom color.
`ontime`	Длительность мигания светодиода в секундах (по умолчанию 0,25 секунды).
`offtime`	Продолжительность выключения светодиода во время каждого мигания (в секундах). Значение по умолчанию — 0,25 секунды.

Параметры

Описание

color

Sets the Touch LED’s color to:

Color.RED
Color.GREEN
Color.BLUE
Color.WHITE
Color.YELLOW
Color.ORANGE
Color.PURPLE
Color.RED_VIOLET
Color.VIOLET
Color.BLUE_VIOLET
Color.BLUE_GREEN
Color.YELLOW_GREEN
Color.YELLOW_ORANGE
Color.RED_ORANGE

You can also specify a custom color.

ontime

Длительность мигания светодиода в секундах (по умолчанию 0,25 секунды).

offtime

Продолжительность выключения светодиода во время каждого мигания (в секундах). Значение по умолчанию — 0,25 секунды.

# Blink green for 2 seconds then stop
touchled_1.set_blink(Color.GREEN, 0.5, 0.5)
wait(2, SECONDS)
touchled_1.set_brightness(0)

Геттеры #

pressing #

Нажатие клавиши pressing возвращает целое число, указывающее, нажата ли в данный момент сенсорная кнопка.

1 — Нажата кнопка TouchLED.
0 — Сенсорный светодиод не нажат.

Usage:
touchled_1.pressing()

Параметры	Описание
	Этот метод не имеет параметров.

# Turn TouchLED green when touched
while True:
    if touchled_1.pressing():
        touchled_1.set_color(Color.GREEN)
    else:
        touchled_1.set_color(Color.RED)
    wait(50, MSEC)

installed #

installed возвращает логическое значение, указывающее, подключен ли сенсорный светодиод к блоку управления.

True — Сенсорный светодиод подключен к «мозгу».
False — Сенсорный светодиод не подключен к блоку управления.

Usage:
touchled_1.installed()

Параметры	Описание
	Этот метод не имеет параметров.

Строители #

Конструкторы используются для ручного создания объектов Touchled Touchled , необходимых для настройки сенсорного светодиода вне VEXcode.

Touchled #

Touchled создает сенсорный светодиод.

Usage:
touchled_1 = Touchled(smartport)

Параметр	Описание
`smartport`	Интеллектуальный порт, к которому подключен сенсорный светодиод, обозначается как PORTx, где x — номер порта.

# Create a Touchled in Port 1
touchled_1 = Touchled(Ports.PORT1)