tocado#

Introducción#

La API Touch LED para VEX IQ (2.ª generación) proporciona métodos para controlar el Touch LED de IQ. Estos bloques permiten configurar el color, el brillo y la velocidad de atenuación, además de detectar cuándo se presiona el Touch LED.

A continuación se muestra una lista de todos los métodos:

Métodos – Controlar el comportamiento del LED táctil.

  • presionando – Devuelve si se está presionando el LED táctil.

  • setColor – Establece el color del LED táctil.

  • setFade – Establece qué tan rápido se desvanecerán los colores entre sí.

  • setBrightness – Establece el brillo del LED táctil.

  • presionado – Llama a una función cuando se presiona el LED táctil.

  • liberado – Llama a una función cuando se suelta el interruptor de parachoques.

  • on – Enciende el LED táctil.

  • off – Apaga el LED táctil.

  • setBlink – Alterna el encendido y apagado del LED táctil indefinidamente.

  • instalado – Devuelve si el LED táctil está conectado al cerebro.

Constructores: inicializan y configuran manualmente el LED táctil.

Métodos#

prensado#

pressing indica si el sensor TouchLED está siendo presionado actualmente.

  • 1 – El TouchLED se encuentra actualmente presionado.

  • 0 – El TouchLED no está presionado actualmente.

Uso:
presionando()

Parámetros

Descripción

Este método no tiene parámetros.

while (true){
  // Change LED color when it is being pressed
  if (TouchLED1.pressing()){
    TouchLED1.setColor(colorType::green);
  }
  else{
    TouchLED1.setColor(colorType::red);
  }
}

establecerColor#

setColor enciende el LED del sensor TouchLED. Este método tiene una funcionalidad similar a la del método on(), pero utiliza el nivel de brillo anterior en lugar de un valor especificado.

Uso:
setColor(color)

Parámetros

Descripción

color

Un tipo de color válido:

// Alternate colors forever
while (true){
  TouchLED1.setColor(colorType::blue_violet);
  wait(0.5, seconds);
  TouchLED1.setColor(colorType::blue_green);
  wait(0.5, seconds);
}

Desvanecerse#

setFade cambia la configuración de desvanecimiento del sensor TouchLED. El sensor TouchLED cambiará a nuevos colores usando el tipo de desvanecimiento.

Uso:
setFade(speed)

Parámetros

Descripción

velocidad

Un fadeType válido:

  • rápido
  • apagado
  • lento
// Turn of LED with no fade and slow fade
TouchLED1.setColor(colorType::blue_violet);
TouchLED1.setFade(off);
wait(2,seconds);
TouchLED1.off();
wait(1,seconds);
TouchLED1.setColor(colorType::blue_violet);
TouchLED1.setFade(slow);
wait(2,seconds);
TouchLED1.off();

establecerBrillo#

setBrightness establece el brillo del LED táctil.

Uso:
setBrightness(brightness)

Parámetros

Descripción

brillo

El brillo del LED táctil se establecerá como porcentaje.

// Turn the LED green with different brightnesses
// Default brightness
TouchLED1.setColor(colorType::green);
wait(2,seconds);
// Low brightness
TouchLED1.setBrightness(10);
wait(2,seconds);
// Max brightness
TouchLED1.setBrightness(100);

apretado#

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

Uso:
pressed(callback)

Parámetros

Descripción

llamar de vuelta

Una función que se define previamente para ejecutarse cuando se presiona el LED táctil.

void touchLEDPressed(){
  TouchLED1.setColor(colorType::red);
}

int main(){
  vexcodeInit();
  // Turn LED on when pressed
  TouchLED1.pressed(touchLEDPressed);
}

liberado#

released registra una función que se llamará cuando se suelte el LED táctil.

Uso:
liberado(devolución de llamada)

Parámetros

Descripción

llamar de vuelta

Una función que se define previamente para ejecutarse cuando se suelta el LED táctil.

void touchLEDReleased(){
  TouchLED1.off();
}

int main(){
  vexcodeInit();
  TouchLED1.setColor(colorType::red);
  // Turn LED off when released
  TouchLED1.released(touchLEDReleased);
}

en#

El método on enciende el LED del sensor TouchLED utilizando colores predefinidos y un brillo establecido.

Uso predeterminado:
on(color, brillo)

Parámetros

Descripción

color

Un colorType válido:

  • ninguno
  • rojo
  • verde
  • azul
  • blanco
  • amarillo
  • naranja
  • púrpura
  • cian
  • rojo_violeta
  • violeta
  • azul_violeta
  • azul_verde
  • amarillo_verde
  • amarillo_naranja
  • rojo_naranja
  • negro
  • transparente

brillo

El brillo en el que se debe configurar el LED en porcentaje.

while (true){
  // Turn on the LED with a colorType
  if (TouchLED1.pressing()){
    TouchLED1.on(colorType::red_orange, 100);
  }
  else{
    TouchLED1.off();
  }
}

Sobrecargas

on también puede establecer el color del TouchLED con un valor de tono, valores rgb o un vex::color.

Usos de sobrecarga:
on(tono, brillo) on(r, g, b, brillo) on(color, brillo)

Parámetros

Descripción

matiz

El tono del LED. También se puede representar como un valor hexadecimal.

o

Un entero de 8 bits sin signo que representa el valor rojo del LED.

gramo

Un entero de 8 bits sin signo que representa el valor verde del LED.

b

Un entero de 8 bits sin signo que representa el valor azul del LED.

color

Un color válido:

  • ninguno
  • rojo
  • verde
  • azul
  • blanco
  • amarillo
  • naranja
  • púrpura
  • cian
  • rojo_violeta
  • violeta
  • azul_violeta
  • azul_verde
  • amarillo_verde
  • amarillo_naranja
  • rojo_naranja
  • negro
  • transparente

brillo

El brillo con el que se debe configurar el LED.

// Turn the LED on with different parameters
TouchLED1.on(0xF3DFC1, 100);
wait(2,seconds);
TouchLED1.on(255, 161, 159, 100);
wait(2, seconds);
TouchLED1.on(color::blue, 100);

apagado#

off apaga el LED del sensor TouchLED.

Uso:
off()

Parámetros

Descripción

Este método no tiene parámetros.

// Turn off the LED
TouchLED1.setColor(colorType::green);
wait(5, seconds);
TouchLED1.off();

instalado#

instalado regresa si el TouchLED está conectado al Brain.

  • 1 – El TouchLED está conectado al cerebro IQ (2.ª generación).

  • 0 – El TouchLED no está conectado al cerebro IQ (2.ª generación).

Uso:
installed()

Parámetros

Descripción

Este método no tiene parámetros.

// Display a message if the Bumper Switch is detected
if (TouchLED1.installed()){
  Brain.Screen.print("Installed!");
}

Constructores#

Los constructores se utilizan para crear manualmente objetos “touchled”, que son necesarios para configurar un TouchLED fuera de VEXcode.

Para el ejemplo siguiente, el TouchLDE configurado se llamará “TouchLED1” y se utilizará en todos los ejemplos posteriores en esta documentación de API cuando se haga referencia a los métodos de la clase “touchled”.

LED táctil#

touchled crea un interruptor de parachoques.

Uso:
touchled(puerto)

Parámetro

Descripción

puerto

A qué puerto inteligente está conectado el sensor de color se llama “PUERTO” seguido del número de puerto, que va del 1 al 12.

// Construct the Brain.
brain Brain;
// Construct a TouchLED Sensor "touch" with the
// TouchLED class.
touchled touch = touchled(PORT1);

// Default brightness
TouchLED1.setColor(colorType::green);
wait(2,seconds);
// Low brightness
TouchLED1.setBrightness(10);
wait(2,seconds);
// Max brightness
TouchLED1.setBrightness(100);