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.
touchled – Crea un 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
|
// 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:
|
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:
|
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();
establecer parpadeo#
setBlink
hace parpadear repetidamente el TouchLED en un patrón de encendido y apagado.
Nota: Llamar a off
no detendrá el parpadeo. Para detenerlo, configure el brillo del LED a 0 con setBrightness
.
Uso predeterminado:
setBlink(color, ontime, offtime)
Parámetros |
Descripción |
---|---|
color |
Un colorType válido:
|
a tiempo |
El período en segundos que el LED estará encendido en el patrón parpadeante en segundos. |
tiempo libre |
El período en segundos que el LED estará apagado en el patrón de parpadeo en segundos. |
// Blink the LED
while (true){
if (TouchLED1.pressing()){
TouchLED1.setBlink(colorType::green, 0.25, 0.25);
}
else{
TouchLED1.setBlink(colorType::red, 0.25, 0.25);
}
}
Sobrecargas
setBlink
también puede establecer el color usando un valor de tono o un vex::color
válido.
Usos de sobrecarga:
setBlink(hue, ontime, offtime)
setBlink(color, ontime, offtime)
Parámetros |
Descripción |
---|---|
matiz |
El tono del LED. También se puede representar mediante un valor hexadecimal. |
color |
Un color válido:
|
a tiempo |
El período en segundos que el LED estará encendido. |
tiempo libre |
El período en segundos que el LED estará apagado. |
// Blink the LED
while (true){
if (TouchLED1.pressing()){
// Using vex::color
TouchLED1.setBlink(color::green, 0.25, 0.25);
}
else{
// Using a hue value
TouchLED1.setBlink(0, 0.25, 0.25);
}
}
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 |
---|---|
|
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);