Časovač#

Zavedení#

Třída timer je odvozena od základní třídy brain a poskytuje funkce pro měření uplynulého času, což umožňuje sledovat trvání a plánovat události založené na čase v rámci programu VEX EXP.

Přístup#

Brain.Timer

Poznámky#

  • Brain.Timer je instancí třídy timer a poskytuje stejnou funkcionalitu.

Příklad#

/* This constructor is required when using VS Code.
A Brain is generated automatically at the start of
VEXcode projects. */

// Create the EXP Brain
brain Brain = brain();

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

  wait(50, msec);
}

Členské funkce#

Třída timer obsahuje následující členské funkce:

  • clear — Vynuluje časovač.

  • time — Vrátí uplynulý čas od spuštění časovače.

  • event — Volá funkci po zadaném počtu milisekund s volitelnými argumenty.

Před voláním jakékoli členské funkce timer musí být vytvořena instance brain , jak je znázorněno níže:

// Create the EXP Brain
brain Brain = brain();

clear#

Vynuluje aktuální hodnotu časovače. Poté časovač okamžitě začne znovu odpočítávat od nuly.

Available Functions
void clear();

Parameters

Tato funkce nepřijímá žádné parametry.

Return Values

Tato funkce nevrací hodnotu.

Examples
while (true) {
  // Reset the timer every time the check button is pressed
  if (Brain.buttonCheck.pressing()) {
    Brain.Timer.clear();
  }
  Brain.Screen.clearScreen();
  Brain.Screen.setCursor(1, 1);
  Brain.Screen.print("Time: %.2f", Brain.Timer.value());
  wait(50, msec);
}

time#

Vrátí aktuální hodnotu časovače.

Available Functions

1 — Vrátí uplynulý čas v milisekundách.

uint32_t time() const;

2 — Vrátí uplynulý čas v zadaných časových jednotkách.

double time(
    timeUnits units ) const;

Parameters

Parametr

Typ

Popis

units

timeUnits

Jednotky použité k vrácení uplynulého času:

  • seconds / sec sekund
  • msec milisekund

Return Values
  • Bezparametrická funkce (1) vrací hodnotu uint32_t která představuje uplynulý čas v milisekundách.

  • Funkce s parametrem timeUnits (2) vrací hodnotu double představující uplynulý čas v zadaných jednotkách.

Notes
  • Časovač začne odpočítávat, jakmile projekt začne.

  • Voláním clear se hodnota časovače vynuluje.

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

  wait(50, msec);
}

event#

Registruje funkci zpětného volání, která se má provést po zadané prodlevě.

Available Functions

1 — Zaregistruje zpětné volání, které se spustí po zadaném zpoždění, a předá zpětnému volání uživatelem definovanou hodnotu.

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

2 — Zaregistruje zpětné volání, které se spustí po zadané prodlevě.

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

Parameters

Parametr

Typ

Popis

callback

void ()(void)

Funkce, která bude volána po zadané prodlevě a obdrží uživatelem definovaný argument.

callback

void (*)(void)

Funkce, která bude volána po uplynutí zadané prodlevy.

value

uint32_t

Zpoždění v milisekundách před provedením funkce zpětného volání.

Return Values

Tato funkce nevrací hodnotu.

Notes
  • Tato funkce naplánuje jednorázové zpětné volání; neopakuje se automaticky.

  • Funkce zpětného volání musí vrátit void.

  • Více akcí může být naplánováno současně.

Examples

Definujte funkci (mimo int main())

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

Zaregistrujte funkci uvnitř int main()

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

  // Call turnOrange after 2 seconds
  Brain.Timer.event(turnOrange, 2000);
}