Dotykowa dioda LED#

Wstęp #

Dioda dotykowa VEX IQ Touch LED to jednocześnie światło i przycisk. Może świecić w różnych kolorach, aby przekazywać informacje zwrotne, na przykład sygnalizując gotowość robota, pokazując wybrany tryb lub dopasowując kolor do innego czujnika. Może również wykrywać dotyk, umożliwiając uruchomienie lub zmianę zachowania robota jednym dotknięciem.

Konstruktor klasy #

touchled( 
  int32_t index );

Destruktor klasy #

Niszczy touchled którego nie dotknięto, i uwalnia powiązane zasoby.

virtual ~touchled();

Parametry #

Parametr	Typ	Opis
`index`	`int32_t`	Smart Port, do którego podłączona jest dioda Touch LED, zapisany jako `PORTx`, gdzie `x` to numer portu (na przykład `PORT1`).

Przykład #

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

Funkcje członkowskie #

Klasa touchled zawiera następujące funkcje członkowskie:

pressing – Zwraca informację, czy dioda LED dotykowa jest naciśnięta.
setColor – Ustawia kolor diody LED dotykowej.
setFade – Ustawia szybkość, z jaką kolory będą przechodzić ze sobą.
setBrightness – Ustawia jasność diody LED dotykowej.
naciśniętopressed – Rejestruje funkcję, która ma zostać wywołana po naciśnięciu diody LED dotykowej.
released – Rejestruje funkcję, która ma zostać wywołana po zwolnieniu diody LED dotykowej.
on – Włącza diodę LED dotykową.
off – Wyłącza diodę LED dotykową.
setBlink – Naprzemiennie włącza i wyłącza diodę LED dotykową w nieskończoność.
zainstalowanoinstalled – Zwraca informację, czy dioda LED Touch jest podłączona do mózgu.

Przed wywołaniem jakiejkolwiek funkcji członkowskiej touchled należy utworzyć instancję touchled , jak pokazano poniżej:

/* 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 #

Zwraca informację, czy TouchLED jest aktualnie wciśnięty.

Available Functions

bool pressing();

Parameters

Ta funkcja nie przyjmuje żadnych parametrów.

Return Values

Zwraca wartość bool bool wskazującą, czy dioda LED Touch jest naciśnięta.

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

setColor #

Ustawia określony kolor diody LED czujnika dotykowego.

Available Functions

1 — Ustawia kolor diody LED Touch za pomocą vex::color.
void setColor( 
  vex::color  color );

2 — Ustawia kolory diod LED przy użyciu typu koloru colorType.
void setColor( 
  colorType   color );

Parameters

Parametr

Typ

Opis

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

Prawidłowy niestandardowy kolor.

Return Values

Ta funkcja nie zwraca wartości.

setFade #

Ustawia ustawienie zanikania czujnika dotykowego LED. Czujnik dotykowy LED zmieni kolor na nowy, korzystając z typu zanikania.

Available Functions

void setFade(
  fadeType  speed );

Parameters

Parametr	Typ	Opis
`speed`	`fadeType`	Prędkość zanikania będzie ustawiona na: `fast` `off` — brak zanikania `slow`

Parametr

Typ

Opis

speed

fadeType

Prędkość zanikania będzie ustawiona na:

fast
off — brak zanikania
slow

Return Values

Ta funkcja nie zwraca wartości.

setBrightness #

Ustawia jasność diody LED dotykowej.

Available Functions

void setBrightness(
  uint32_t  value );

Parameters

Parametr	Typ	Opis
`value`	`uint32_t`	Jasność diody LED dotykowej można ustawić w procentach.

Return Values

Ta funkcja nie zwraca wartości.

pressed #

Rejestruje funkcję, która ma zostać wywołana po naciśnięciu diody LED dotykowej.

Available Functions

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

Parameters

Parametr	Typ	Opis
`callback`	`void (*)(void)`	Wskaźnik do funkcji, która zostanie wywołana po naciśnięciu diody LED Touch. Funkcja nie może przyjmować żadnych parametrów i zwracać wartość void.

Return Values

Ta funkcja nie zwraca wartości.

Examples

Zdefiniuj funkcję wywołania zwrotnego (poza int main())

// Display a message when LED is pressed
void LEDPressed() {
  Brain.Screen.print("LED pressed");
}

Zarejestruj wywołanie zwrotne wewnątrz 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 #

Rejestruje funkcję, która ma zostać wywołana po zwolnieniu diody LED dotykowej.

Available Functions

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

Parameters

Parametr	Typ	Opis
`callback`	`void (*)(void)`	Wskaźnik do funkcji, która zostanie wywołana po zwolnieniu diody LED Touch. Funkcja nie może przyjmować żadnych parametrów i zwracać wartość void.

Return Values

Ta funkcja nie zwraca wartości.

Examples

Zdefiniuj funkcję wywołania zwrotnego (poza int main())

// Display a message when LED is released
void LEDReleased() {
  Brain.Screen.print("LED released");
}

Zarejestruj wywołanie zwrotne wewnątrz 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 #

Włącza diodę LED czujnika TouchLED, używając kolorów i ustawionej jasności.

Available Functions

1 — Ustawia kolor diody LED za pomocą vex::color.
void on( 
  vex::color    color, 
  uint32_t      brightness = 100 );

2 — Ustawia kolor diody LED za pomocą odcienia.
void on( 
  uint32_t hue, 
  uint32_t brightness = 100);

3 — Ustawia kolor diody LED według wartości RGB.
void on( 
  uint8_t   red, 
  uint8_t   green, 
  uint8_t   blue, 
  uint32_t  brightness = 100);

Parameters

Parametr	Typ	Opis
`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`	Opcjonalnie. Jasność, na jaką chcesz ustawić diodę LED w procentach, domyślnie 100.
`hue`	`uint32_t`	Odcień diody LED. Można go również przedstawić jako wartość szesnastkową (0x000000).
`red`	`uint8_t`	Liczba całkowita reprezentująca wartość czerwieni diody LED.
`green`	`uint8_t`	Liczba całkowita reprezentująca wartość zielonego światła diody LED.
`blue`	`uint8_t`	Liczba całkowita reprezentująca wartość niebieskiego koloru diody LED.

Return Values

Ta funkcja nie zwraca wartości.

off #

Wyłącza diodę LED dotykową.

Available Functions

void off( void );

Parameters

Funkcja ta nie przyjmuje żadnych parametrów.

Return Values

Ta funkcja nie zwraca wartości.

setBlink #

Wielokrotne miganie diody LED Touch zgodnie ze schematem włączania i wyłączania.

Available Functions

1 — Ustawia kolor migania za pomocą vex::color.

void setBlink( 
  vex::color    color, 
  double        onTime = 0.25,
  double        offTime = 0.25 );

2 — Ustawia kolor migania za pomocą wartości szesnastkowej.
void setBlink( 
  uint32_t      hue, 
  double        onTime = 0.25,
  double        offTime = 0.25 );

3 — Ustawia kolor migania przy użyciu typu koloru colorType.
void setBlink( 
  colorType     color, 
  double        onTime = 0.25,
  double        offTime = 0.25 );

Parameters

Parametr	Typ	Opis
`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`	Opcjonalnie. Czas trwania w sekundach, przez jaki dioda LED będzie włączona w jednym cyklu mignięcia, domyślnie 0,25 sekundy.
`offTime`	`double`	Opcjonalnie. Czas w sekundach, przez jaki dioda LED będzie wyłączona w każdym cyklu mignięcia, domyślnie 0,25 sekundy.
`hue`	`uint32_t`	Wartość szesnastkowa koloru (np. `0xFF0000` dla koloru czerwonego).
`color`	`vex::color`	Prawidłowy niestandardowy kolor.

Return Values

Ta funkcja nie zwraca wartości.

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 #

Zwraca informację, czy dioda LED Touch jest podłączona.

Available Functions

bool installed();

Parameters

Funkcja ta nie przyjmuje żadnych parametrów.

Return Values

Zwraca wartość logiczną wskazującą, czy dioda LED Touch jest podłączona:

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