Temporizador personalizado

Introducción

La clase timer se utiliza para controlar el tiempo e interactuar con un temporizador independiente del temporizador del cerebro.

Constructor de clases

timer();

Destructor de clase

Destruye el objeto timer y libera los recursos asociados.

~timer();

Parámetros

Este constructor no acepta ningún parámetro.

Ejemplos

// Create a timer instance
timer myTimer = timer();

Funciones de los miembros

La clase timer incluye las siguientes funciones miembro:

• clear — Restablece el temporizador a cero.

• time — Devuelve el tiempo transcurrido desde que comenzó el temporizador.

• event — Llama a una función después de un número especificado de milisegundos, con argumentos opcionales.

Before calling any timer member functions, a timer instance must be created, as shown below:

/* This constructor is required to use a 
custom timer. Replace the values
as needed. */

// Create a timer instance
timer myTimer = timer();

clear

Ajusta el temporizador a cero.

Available Functions

void clear();

Parameters

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

Return Values

Esta función no devuelve un valor.

Examples

while (true) {
  // Clear the timer every time the screen is pressed
  if (Brain.Screen.pressing()) {
    myTimer.clear();
  }
  Brain.Screen.clearScreen();
  Brain.Screen.setCursor(1, 1);
  Brain.Screen.print("Time: %.2f", myTimer.time(msec));
  wait(50, msec);
}

time

Devuelve el valor actual del temporizador.

Available Functions

1 — Devuelve el tiempo transcurrido en milisegundos.

uint32_t time() const;

2 — Devuelve el tiempo transcurrido en las unidades de tiempo especificadas.

double time(
    timeUnits units ) const;

Parameters

Parámetro	Tipo	Descripción
units	timeUnits	Las unidades utilizadas para devolver el tiempo transcurrido: seconds / sec — segundos msec — milisegundos

Return Values

• La función sin parámetros (1) devuelve un uint32_t que representa el tiempo transcurrido en milisegundos.

• La función con un timeUnits parámetro timeUnits (2) devuelve un double que representa el tiempo transcurrido en las unidades especificadas.

Notes

• El temporizador comienza a contar cuando se construye el temporizador personalizado.

• Llamar a clear restablece el valor del temporizador a cero.

Examples

// Display the timer as it ticks up
while (true) {
  Brain.Screen.clearScreen();
  Brain.Screen.setCursor(1, 1);
  Brain.Screen.print("Time: %.2f", myTimer.time(sec));

  wait(50, msec);
}

event

Registra una función de devolución de llamada que se ejecutará después de un retraso especificado.

Available Functions

1 — Registra una devolución de llamada para que se ejecute después de un retraso especificado y pasa un valor definido por el usuario a la devolución de llamada.

static void event(
    void (*callback)(void *),
    uint32_t value );

2 — Registra una devolución de llamada para que se ejecute después de un retraso especificado.

static void event(
    void (*callback)(void),
    uint32_t value );

Parameters

Parámetro	Tipo	Descripción
callback	void (*)(void *)	Una función que se llamará después del retraso especificado y recibe un argumento definido por el usuario.
callback	void (*)(void)	Una función que se llamará después del retraso especificado.
value	uint32_t	El retardo, en milisegundos, antes de que se ejecute la función de devolución de llamada.

Return Values

Esta función no devuelve un valor.

Notes

• Esta función programa una devolución de llamada única; no se repite automáticamente.

• La función de devolución de llamada debe devolver void.

• Se pueden programar varios eventos al mismo tiempo.

Examples

Definir la función (fuera de int main())

// Create a function to turn the screen orange
void turnOrange() {
  Brain.Screen.clearScreen(orange);
}

Registrar la función dentro de int main()

int main() {
  /* vexcodeInit() is only required when using VEXcode.
  Remove vexcodeInit() if compiling in VS Code. */
  vexcodeInit();

  timer myTimer = timer();
  // Call turnOrange after 2 seconds
  myTimer.event(turnOrange, 2000);
}