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

Введение #

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

Конструктор класса #

touchled( 
  int32_t index );

Деструктор класса #

Уничтожает объект, к которому touchled объект, освобождая связанные с ним ресурсы.

virtual ~touchled();

Параметры #

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

Пример #

// Create a touchled instance in Port 1
touchled TouchLED1 = touchled(PORT1);

Функции участников #

Класс touchled включает следующие функции-члены:

pressing – Возвращает значение, указывающее, нажат ли сенсорный светодиод.
setColor – Устанавливает цвет сенсорного светодиода.
setFade – Задает скорость перехода цветов друг в друга.
setBrightness – Устанавливает яркость сенсорного светодиода.
pressed – Регистрирует функцию, которая будет вызываться при нажатии на сенсорный светодиод.
released – Регистрирует функцию, которая будет вызвана при отпускании сенсорного светодиода.
on – Включает сенсорный светодиод.
off – Выключает сенсорный светодиод.
setBlink – Бесконечное попеременное включение и выключение сенсорного светодиода.
installed – Возвращает значение, указывающее, подключен ли сенсорный светодиод к блоку управления.

Перед вызовом любой функции-члена с параметрами touchled необходимо создать экземпляр с параметрами touchled , как показано ниже:

/* This constructor is required when using VS Code.
Touch LED configuration is generated automatically
in VEXcode using the Device Menu. Replace the values
as needed. */

// Create a Touch LED instance in Port 1
touchled TouchLED1 = touchled(PORT1);

pressing #

Возвращает значение, если в данный момент нажата кнопка TouchLED.

Available Functions

bool pressing();

Parameters

Эта функция не принимает никаких параметров.

Return Values

Возвращает значение bool , указывающее, нажата ли сенсорная кнопка.

true — The Touch LED is being pressed.
false — The Touch LED is not being pressed.

setColor #

Заменяет цвет светодиода сенсорного экрана на определенный.

Available Functions

1 — Устанавливает цвет сенсорного светодиода, используя vex::color.
void setColor( 
  vex::color  color );

2 — Устанавливает цвета светодиодов, используя colorType ).
void setColor( 
  colorType   color );

Parameters

Параметр

Тип

Описание

color

colorType

A valid color:

blue
blue_green
blue_violet
green
orange
purple
red
red_orange
red_violet
violet
white
yellow
yellow_green
yellow_orange
colorType::none
black
transparent

color

vex::color

Действительный пользовательский цвет.

Return Values

Эта функция не возвращает значения.

setFade #

Задает параметр затухания сенсорного светодиодного датчика. Сенсорный светодиодный датчик будет менять цвета в зависимости от выбранного типа затухания.

Available Functions

void setFade(
  fadeType  speed );

Parameters

Параметр	Тип	Описание
`speed`	`fadeType`	Скорость затухания будет установлена следующим образом: `fast` `off` — без затухания `slow`

Параметр

Тип

Описание

speed

fadeType

Скорость затухания будет установлена следующим образом:

fast
off — без затухания
slow

Return Values

Эта функция не возвращает значения.

setBrightness #

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

Available Functions

void setBrightness(
  uint32_t  value );

Parameters

Параметр	Тип	Описание
`value`	`uint32_t`	Яркость сенсорного светодиода устанавливается в процентах.

Return Values

Эта функция не возвращает значения.

pressed #

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

Available Functions

void pressed( void (* callback)(void) );

Parameters

Параметр	Тип	Описание
`callback`	`void (*)(void)`	Указатель на функцию, которая будет вызываться при нажатии на сенсорный светодиод. Функция не должна принимать параметров и должна возвращать значение void.

Return Values

Эта функция не возвращает значения.

Examples

Определите функцию обратного вызова (вне int main())
// Display a message when LED is pressed
void LEDPressed() {
  Brain.Screen.print("LED pressed");
}
Зарегистрируйте функцию обратного вызова внутри int main()
int main() {
  /* vexcodeInit() is only required when using VEXcode.
  Remove vexcodeInit() if compiling in VS Code. */
  vexcodeInit();

  // Run LEDPressed when the value of the Touch LED is pressed.
  TouchLED1.pressed(LEDPressed);
}

released #

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

Available Functions

void released( void (* callback)(void) );

Parameters

Параметр	Тип	Описание
`callback`	`void (*)(void)`	Указатель на функцию, которая будет вызвана при отпускании сенсорного светодиода. Функция не должна принимать параметров и должна возвращать значение void.

Return Values

Эта функция не возвращает значения.

Examples

Определите функцию обратного вызова (вне int main())
// Display a message when LED is released
void LEDReleased() {
  Brain.Screen.print("LED released");
}
Зарегистрируйте функцию обратного вызова внутри int main()
int main() {
  /* vexcodeInit() is only required when using VEXcode.
  Remove vexcodeInit() if compiling in VS Code. */
  vexcodeInit();

  // Run LEDReleased when the value of the Touch LED is released.
  TouchLED1.released(LEDReleased);
}

on #

Включает светодиод сенсорного экрана TouchLED, используя цвета и заданную яркость.

Available Functions

1 — Устанавливает цвет светодиода с помощью vex::color.
void on( 
  vex::color    color, 
  uint32_t      brightness = 100 );

2 — Устанавливает цвет светодиода с помощью оттенка.
void on( 
  uint32_t hue, 
  uint32_t brightness = 100);

3 — Устанавливает цвет светодиода по значениям RGB.
void on( 
  uint8_t   red, 
  uint8_t   green, 
  uint8_t   blue, 
  uint32_t  brightness = 100);

Parameters

Параметр	Тип	Описание
`color`	`vex::color`	A valid color: `blue` `blue_green` `blue_violet` `green` `orange` `purple` `red` `red_orange` `red_violet` `violet` `white` `yellow` `yellow_green` `yellow_orange` `colorType::none` `black` `transparent`
`brightness`	`uint32_t`	Необязательный параметр. Яркость светодиода в процентах, по умолчанию 100.
`hue`	`uint32_t`	Оттенок светодиода. Его также можно представить в виде шестнадцатеричного кода (0x000000).
`red`	`uint8_t`	Целое число, представляющее значение красного цвета светодиода.
`green`	`uint8_t`	Целое число, представляющее значение зеленого цвета светодиода.
`blue`	`uint8_t`	Целое число, представляющее значение синего цвета светодиода.

Return Values

Эта функция не возвращает значения.

off #

Выключает сенсорный светодиод.

Available Functions

void off( void );

Parameters

Эта функция не принимает никаких параметров.

Return Values

Эта функция не возвращает значения.

setBlink #

Сенсорный светодиод постоянно мигает, то включаясь, то выключаясь.

Available Functions

1 — Устанавливает цвет мигания, используя vex::color.
void setBlink( 
  vex::color    color, 
  double        onTime = 0.25,
  double        offTime = 0.25 );

2 — Задает цвет мигания, используя шестнадцатеричное значение цвета.
void setBlink( 
  uint32_t      hue, 
  double        onTime = 0.25,
  double        offTime = 0.25 );

3 — Устанавливает цвет мигания, используя colorType ).
void setBlink( 
  colorType     color, 
  double        onTime = 0.25,
  double        offTime = 0.25 );

Parameters

Параметр	Тип	Описание
`color`	`colorType`	A valid color: `blue` `blue_green` `blue_violet` `green` `orange` `purple` `red` `red_orange` `red_violet` `violet` `white` `yellow` `yellow_green` `yellow_orange` `colorType::none` `black` `transparent`
`onTime`	`double`	Необязательный параметр. Продолжительность мигания светодиода в секундах (по умолчанию 0,25 секунды).
`offTime`	`double`	Необязательный параметр. Продолжительность мигания светодиода в секундах (по умолчанию 0,25 секунды).
`hue`	`uint32_t`	Шестнадцатеричное значение цвета (например, `0xFF0000` для красного).
`color`	`vex::color`	Действительный пользовательский цвет.

Return Values

Эта функция не возвращает значения.

Notes - Calling [off](#off) will not stop the blinking behavior. To stop the blinking behavior, set the LED brightness to 0 with [setBrightness](#setbrightness).

installed #

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

Available Functions

bool installed();

Parameters

Эта функция не принимает никаких параметров.

Return Values

Возвращает логическое значение, указывающее, подключен ли сенсорный светодиод:

true — The sensor is connected and responding.
false — The sensor is not connected or not detected.