torre de señales#

Inicializando la clase signaltower#

Una torre de señales se crea utilizando el siguiente constructor:

El constructor signaltower crea un objeto signaltower.

Parámetro

Descripción

puerto

Un Puerto inteligente válido al que está conectado SignalTower.

 
// Construct a Signal Tower "SignalTower" with the
// signaltower class.
signaltower SignalTower = signaltower(PORT1);

Este objeto SignalTower se utilizará en todos los ejemplos posteriores a lo largo de esta documentación de API cuando se haga referencia a los métodos de la clase signaltower.

Métodos de clase#

establecerColor()#

Este método se llama de las siguientes maneras:

El método setColor(color, state) enciende o apaga uno o más LED en la torre de señalización usando colores predefinidos o un código hexadecimal.

Parámetro

Descripción

color

Un signalTowerColorType, colorType o código hexadecimal válido.

estado

Un signalTowerStateType válido.

Devoluciones: Ninguna.

// Set the Signal Tower to start blinking blue.
SignalTower.setColor(signaltower::blue, signaltower::blink);

El método setColor(rgb, yx) enciende o apaga uno o más LED en la torre de señal usando valores de 32 bits.

Parámetro

Descripción

RGB

Un valor de código hexadecimal que representa el brillo de los LED rojo, verde y azul.

yw

Un valor de código hexadecimal que representa el brillo de los LED amarillo y blanco.

Devoluciones: Ninguna.

// Set the red, blue and white LEDs to on.
// 0xFF00FF sets the red and blue LEDs on 
SignalTower.setColor(0xFF00FF, 0x00FF);

El método setColor(id, value) enciende o apaga un LED en la torre de señal según el ID del LED.

Identificadores de LED:

  • rojo: 0

  • verde: 1

  • azul: 2

  • blanco: 3

  • amarillo: 4

  • ninguno: 99

Parámetro

Descripción

identificación

El identificador de uno de los LED de la torre de señales.

valor

El valor del brillo del LED en el rango 0 - 255.

Devoluciones: Ninguna.

// Set the green LEDs to on.
SignalTower.setColor(1, 255);

El método setColor(r, y, g, b, w) establece los niveles de brillo para cada LED en la torre de señal.

Parámetro

Descripción

o

El valor del brillo del LED en el rango 0 - 255.

y

El valor del brillo del LED en el rango 0 - 255.

gramo

El valor del brillo del LED en el rango 0 - 255.

b

El valor del brillo del LED en el rango 0 - 255.

o

El valor del brillo del LED en el rango 0 - 255.

Devoluciones: Ninguna.

// Set all LEDs to on.
SignalTower.setColor(255, 255, 255, 255, 255);

establecerColores()#

El método setColors(r, y, g, b, w) enciende o apaga todos los LED de la torre de señal.

Parámetro

Descripción

o

Un signalTowerStateType válido para establecer el LED rojo.

y

Un signalTowerStateType válido para establecer el LED amarillo.

gramo

Un signalTowerStateType válido para establecer el LED verde.

b

Un signalTowerStateType válido para establecer el LED azul.

o

Un signalTowerStateType válido para establecer el LED blanco.

Devoluciones: Ninguna

// Turn on all LEDs.
SignalTower.setColors(signaltower::on, signaltower::on, signaltower::on, signaltower::on, signaltower::on);

establecerTiempoDeParpadeo()#

El método setBlinkTime(onTime, offTime) establece el tiempo de parpadeo de los LED en la torre de señales.

Parámetro

Descripción

a tiempo

El tiempo en milisegundos que el LED debe estar encendido al parpadear. El máximo es de 2500 milisegundos. Un valor de 0 es 500 milisegundos por defecto.

fuera de tiempo

El tiempo en milisegundos que el LED debe estar apagado al parpadear. El máximo es de 2500 milisegundos. Un valor de 0 utilizará el tiempo establecido para onTime. El valor predeterminado es 0.

Devoluciones: Ninguna.

prensado()#

El método pressing() devuelve si el botón de la torre de señales está siendo presionado actualmente.

Devuelve: true si el botón de la torre de señales está siendo presionado actualmente. false si no lo está.

apretado()#

El método pressed(callback) registra una función que se llamará cuando se presione el botón de la torre de señales.

Parámetro

Descripción

llamar de vuelta

Una función que se llamará cuando se presione el botón

Devoluciones: Ninguna.

// Define the towerButtonPressed function with a void 
// return type, showing it doesn't return a value.
void towerButtonPressed() {
  // The Brain will print that the tower button was
  // pressed on the Brain's screen.
  Brain.Screen.print("tower button pressed");
}

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

  // Run towerButtonPressed when the tower button 
  // is pressed.
  SignalTower.pressed(towerButtonPressed);
}

liberado()#

El método released(callback) registra una función que se llamará cuando se suelte el botón de la torre de señales.

Parámetro

Descripción

llamar de vuelta

Una función que se llamará cuando se suelte el botón

Devoluciones: Ninguna.

// Define the towerButtonReleased function with a void 
// return type, showing it doesn't return a value.
void towerButtonReleased() {
  // The Brain will print that the tower button was 
  // released on the Brain's screen.
  Brain.Screen.print("tower button released");
}

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

  // Run towerButtonReleased when the tower 
  // button is released.
  SignalTower.released(towerButtonReleased);
}

marca de tiempo()#

El método timestamp() solicita la marca de tiempo del último paquete de estado recibido de la torre de señales.

Devuelve: Marca de tiempo del último paquete de estado como un entero de 32 bits sin signo en milisegundos.

instalado()#

El método installed() devuelve si la torre de señal está conectada o no.

Devuelve: true si el dispositivo está conectado. false si no lo está.

En esta página