LED TÁCTIL#

Introducción #

El LED VEX IQ Touch es tanto una luz como un botón. Puede brillar en diferentes colores para dar retroalimentación, como indicar que el robot está listo, mostrar qué modo está seleccionado o hacer coincidir un color detectado por otro sensor, y puede detectar cuándo se está tocando, lo que le permite iniciar o cambiar el comportamiento de un robot con un toque.

Constructor de clases #

touchled( 
  int32_t index );

Destructor de clase #

Destruye el objeto touchled y libera los recursos asociados.

virtual ~touchled();

Parámetros #

Parámetro	Tipo	Descripción
`index`	`int32_t`	El puerto inteligente al que está conectado el LED táctil, escrito como `PORTx`, donde `x` es el número de puerto (por ejemplo, `PORT1`).

Ejemplo #

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

Funciones de los miembros #

La clase touchled incluye las siguientes funciones miembro:

pressing – Devuelve si se está presionando el LED táctil.
setColor – Establece el color del LED táctil.
setFade – Establece la velocidad con la que los colores se desvanecerán entre sí.
setBrightness – Establece el brillo del LED táctil.
pressed – Registra una función que se llamará cuando se presione el LED táctil.
released – Registra una función que se llamará cuando se suelte el LED táctil.
on – Enciende el LED táctil.
off – Apaga el LED táctil.
setBlink – Alterna el encendido y apagado del LED táctil indefinidamente.
installed – Devuelve si el LED táctil está conectado al cerebro.

Antes de llamar a cualquier función miembro touchled , se debe crear una instancia touchled , como se muestra a continuación:

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

Devuelve si el TouchLED se está presionando actualmente.

Available Functions

bool pressing();

Parameters

Esta función no acepta ningún parámetro.

Return Values

Devuelve un valor booleano bool que indica si se está presionando el LED táctil.

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

setColor #

Ajusta el LED del sensor LED táctil a un color específico.

Available Functions

1 — Establece el LED táctil en un color usando vex::color.
void setColor( 
  vex::color  color );

2 — Establece los colores del LED usando un colorType .
void setColor( 
  colorType   color );

Parameters

Parámetro

Tipo

Descripción

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

Un color personalizado válido.

Return Values

Esta función no devuelve un valor.

setFade #

Establece la configuración de desvanecimiento del sensor LED táctil. El sensor LED táctil cambiará a nuevos colores utilizando el tipo de fundido.

Available Functions

void setFade(
  fadeType  speed );

Parameters

Parámetro	Tipo	Descripción
`speed`	`fadeType`	Velocidad a la que se ajustará el desvanecimiento: `fast` `off` — sin desvanecimiento `slow`

Parámetro

Tipo

Descripción

speed

fadeType

Velocidad a la que se ajustará el desvanecimiento:

fast
off — sin desvanecimiento
slow

Return Values

Esta función no devuelve un valor.

setBrightness #

Establece el brillo del LED táctil.

Available Functions

void setBrightness(
  uint32_t  value );

Parameters

Parámetro	Tipo	Descripción
`value`	`uint32_t`	El brillo del LED táctil se ajusta como un porcentaje.

Return Values

Esta función no devuelve un valor.

pressed #

Registra una función que se llamará cuando se presione el LED táctil.

Available Functions

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

Parameters

Parámetro	Tipo	Descripción
`callback`	`void (*)(void)`	Un puntero a una función que se llamará cuando se presione el LED táctil. La función no debe tomar parámetros y devolver void.

Return Values

Esta función no devuelve un valor.

Examples

Defina la función de devolución de llamada (fuera de int main())

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

Registra la función de devolución de llamada dentro de 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 #

Registra una función que se llamará cuando se libere el LED táctil.

Available Functions

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

Parameters

Parámetro	Tipo	Descripción
`callback`	`void (*)(void)`	Un puntero a una función que se llamará cuando se libere el LED táctil. La función no debe tomar parámetros y devolver void.

Return Values

Esta función no devuelve un valor.

Examples

Defina la función de devolución de llamada (fuera de int main())

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

Registra la función de devolución de llamada dentro de 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 #

Enciende el LED del sensor TouchLED con colores y un brillo establecido.

Available Functions

1 — Establece el LED a un color usando vex::color.
void on( 
  vex::color    color, 
  uint32_t      brightness = 100 );

2 — Establece el color del LED usando el tono.
void on( 
  uint32_t hue, 
  uint32_t brightness = 100);

3 — Establece el color del LED por valores de rgb.
void on( 
  uint8_t   red, 
  uint8_t   green, 
  uint8_t   blue, 
  uint32_t  brightness = 100);

Parameters

Parámetro	Tipo	Descripción
`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`	Opcional. El brillo al que se ajusta el LED en porcentaje, por defecto a 100.
`hue`	`uint32_t`	El tono del LED. Esto también se puede representar como un valor de código hexadecimal (0x000000).
`red`	`uint8_t`	Un número entero que representa el valor rojo del LED.
`green`	`uint8_t`	Un número entero que representa el valor verde del LED.
`blue`	`uint8_t`	Un número entero que representa el valor azul del LED.

Return Values

Esta función no devuelve un valor.

off #

Apaga el LED táctil.

Available Functions

void off( void );

Parameters

Esta función no toma ningún parámetro.

Return Values

Esta función no devuelve un valor.

setBlink #

Parpadea repetidamente el LED táctil en un patrón de encendido y apagado.

Available Functions

1 — Establece el color de parpadeo usando un vex::color vex::color.
void setBlink( 
  vex::color    color, 
  double        onTime = 0.25,
  double        offTime = 0.25 );

2 — Establece el color de parpadeo usando un valor de color hexadecimal.
void setBlink( 
  uint32_t      hue, 
  double        onTime = 0.25,
  double        offTime = 0.25 );

3 — Establece el color de parpadeo usando un colorType .
void setBlink( 
  colorType     color, 
  double        onTime = 0.25,
  double        offTime = 0.25 );

Parameters

Parámetro	Tipo	Descripción
`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`	Opcional. La duración en segundos del LED estará encendida por ciclo de parpadeo, por defecto a 0,25 segundos.
`offTime`	`double`	Opcional. La duración en segundos del LED estará apagada por ciclo de parpadeo, por defecto a 0,25 segundos.
`hue`	`uint32_t`	El tono del LED. Esto también se puede representar mediante un valor de código hexadecimal.
`color`	`vex::color`	Un color personalizado válido.

Return Values

Esta función no devuelve un valor.

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 #

Devuelve si el LED táctil está conectado.

Available Functions

bool installed();

Parameters

Esta función no toma ningún parámetro.

Return Values

Devuelve un booleano que indica si el LED táctil está conectado:

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