LED táctil

Introducción

La categoría LED táctil VEX IQ (2.ª generación) ofrece métodos para interactuar con el LED táctil.

For the examples below, the configured Touch LED will be named TouchLED1 and will be used in all subsequent examples throughout this API documentation when referring to touchled class methods.

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

Acciones – Interactuar con el LED táctil.

• pressed – Calls a function when the Touch LED is pressed.

• released – Calls a function when the Bumper Switch is released.

• on – Turns the Touch LED on.

• off – Turns the Touch LED off.

Mutadores: cambian los colores, el brillo y la configuración del LED táctil.

• setColor – Sets the color of the Touch LED.

• setFade – Sets how fast colors will fade to one another.

• setBrightness – Sets the brightness of the Touch LED.

• setBlink – Alternate the Touch LED on and off indefinitely.

Obtenedores: devuelven datos del LED táctil.

• pressing – Returns whether the Touch LED is being pressed.

• installed – Returns whether the Touch LED is connected to the Brain.

Constructores: inicializan manualmente un LED táctil.

• touchled – Create a Touch LED.

Comportamiento

pressed

pressed registers a function to be called when the Touch LED is pressed.

Usage:
TouchLED1.pressed(callback);

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

// Turn the LED red
void onTouchPressed() {
  TouchLED1.setColor(red);
}

int main() {
  // Initializing Robot Configuration. DO NOT REMOVE!
  vexcodeInit();

  // Call onTouchPressed when the Touch LED is pressed
  TouchLED1.pressed(onTouchPressed);
}

released

released registers a function to be called when the Touch LED is released.

Usage:
TouchLED1.released(callback);

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

// Turn the LED off
void onTouchReleased() {
  TouchLED1.off();
}

int main() {
  // Initializing Robot Configuration. DO NOT REMOVE!
  vexcodeInit();

  TouchLED1.setColor(blue);
  // Call onTouchReleased when the Touch LED is released
  TouchLED1.released(onTouchReleased);
}

on

on method turns the LED of the TouchLED Sensor on using predefined colors and a set brightness.

Default Usage:
TouchLED1.on(color, brightness);

Overload Usages:
TouchLED1.on(hue, brightness);
TouchLED1.on(r, g, b, brightness);

Parámetros	Descripción
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	Opcional. El brillo al que se configurará el LED en porcentaje, con un valor predeterminado de 100.
hue	The hue of the LED. This can also be represented as a Hexcode value (0x000000).
r	Un número entero que representa el valor rojo del LED.
g	Un número entero que representa el valor verde del LED.
b	Un número entero que representa el valor azul del LED.

int main() {
  // Initializing Robot Configuration. DO NOT REMOVE!
  vexcodeInit();

  // Turn LED on using a predefined color with 100 brightness
  TouchLED1.on(green, 100);
  wait(1, seconds);

  // Turn LED on using hexcode (FF2A00, 75 brightness)
  TouchLED1.on(0xFF2A00, 75);
  wait(1, seconds);

  // Turn LED on using RGB values (0, 30, 255, 50 brightness)
  TouchLED1.on(0, 30, 255, 50);
}

off

off turns the Touch LED off.

Usage:
TouchLED1.off();

Parámetros	Descripción
	Este método no tiene parámetros.

int main() {
  // Initializing Robot Configuration. DO NOT REMOVE!
  vexcodeInit();

  // Turn LED on, wait, then turn off
  TouchLED1.setColor(yellow);
  wait(2, seconds);
  TouchLED1.off();
}

Mutadores

setColor

setColor turns the LED of the Touch LED Sensor on to a specific color.

Usage:
TouchLED1.setColor(color);

Parámetros	Descripción
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

int main() {
  // Initializing Robot Configuration. DO NOT REMOVE!
  vexcodeInit();

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

setFade

setFade changes the fade setting of the Touch LED Sensor. The Touch LED Sensor will change to new colors using the fade type.

Usage:
TouchLED1.setFade(speed);

Parámetros	Descripción
speed	The speed the fade will be set to: fast off — no fade slow

int main() {
  // Initializing Robot Configuration. DO NOT REMOVE!
  vexcodeInit();

  // Set the fade speed to slow
  TouchLED1.setFade(slow);
}

setBrightness

setBrightness sets the brightness of the Touch LED.

Usage:
TouchLED1.setBrightness(value);

Parámetros	Descripción
value	El brillo del LED táctil se establecerá como porcentaje.

int main() {
  // Initializing Robot Configuration. DO NOT REMOVE!
  vexcodeInit();

  // Show different brightness levels
  TouchLED1.setColor(green);
  wait(1, seconds);

  TouchLED1.setBrightness(25);
  wait(1, seconds);

  TouchLED1.setBrightness(100);
}

setBlink

setBlink repeatedly blinks the TouchLED in an on and off pattern.

Note: Calling off will not stop the blinking behavior. To stop the blinking behavior, set the LED brightness to 0 with setBrightness.

Default Usage:
TouchLED1.setBlink(color, ontime, offtime);

Overload Usages:
TouchLED1.setBlink(hue, ontime, offtime);

Parámetros	Descripción
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
ontime	Opcional. El tiempo en segundos que el LED permanecerá encendido parpadeando, con un valor predeterminado de 0,25 segundos.
offtime	Opcional. El tiempo en segundos que el LED permanecerá apagado parpadeando, con un valor predeterminado de 0,25 segundos.
hue	El tono del LED. También se puede representar mediante un valor hexadecimal.

Captadores

pressing

pressing returns a Boolean indicating whether the Touch LED Sensor is currently being pressed.

• 1 – The Touch LED is currently bring pressed.

• 0 – The Touch LED is not currently being pressed.

Usage:
TouchLED1.pressing()

Parámetros	Descripción
	Este método no tiene parámetros.

int main() {
  // Initializing Robot Configuration. DO NOT REMOVE!
  vexcodeInit();

  // Only turn green when the Touch LED is being pressed
  while (true) {
    if (TouchLED1.pressing()) {
      TouchLED1.setColor(green);

    } else {
      TouchLED1.off();
    }
  }
}

installed

installed returns a Boolean indicating whether the Touch LED is currently connected to the Brain.

• 1 – The TouchLED is connected to the Brain.

• 0 – The TouchLED is not connected to the Brain.

Usage:
TouchLED1.installed()

Parámetros	Descripción
	Este método no tiene parámetros.

Constructores

touchled

touchled creates an object of the touchled Class in the specified port.

Usage:
touchled TouchLED1 = touchled(port);

Parámetro	Descripción
port	Which Smart Port that the Touch LED is connected to as PORT followed by the port number, ranging from 1 to 12.

int main() {
  // Initializing Robot Configuration. DO NOT REMOVE!
  vexcodeInit();

  // Create a Touch LED in Port 1
  touchled myTouchLED = touchled(PORT1);
}