Ajastin#

Johdanto#

timer -luokka on johdettu brain -perusluokasta ja tarjoaa toiminnon kuluneen ajan mittaamiseen, jolloin voit seurata kestoja ja ajoittaa aikaan perustuvia tapahtumia VEX V5 -ohjelmassa.

Pääsy#

Brain.Timer

Muistiinpanoja#

  • Brain.Timer on timer -luokan instanssi ja tarjoaa saman toiminnallisuuden.

Esimerkki#

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

// Create the V5 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);
}

Jäsenten toiminnot#

timer -luokka sisältää seuraavat jäsenfunktiot:

  • clear — Nollaa ajastimen.

  • time — Palauttaa kuluneen ajan ajastimen käynnistymisestä.

  • event — Kutsuu funktiota määritetyn millisekuntien määrän kuluttua, valinnaisilla argumenteilla.

Ennen minkään timer -jäsenfunktion kutsumista on luotava brain -instanssi alla olevan mukaisesti:

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

clear#

Nollaa ajastimen nykyisen arvon. Tämän jälkeen ajastin alkaa välittömästi laskea uudelleen nollasta.

Available Functions
void clear();

Parameters

Tämä funktio ei hyväksy parametreja.

Return Values

Tämä funktio ei palauta arvoa.

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

time#

Palauttaa ajastimen nykyisen arvon.

Available Functions

1 — Palauttaa kuluneen ajan millisekunteina.

uint32_t time() const;

2 — Palauttaa kuluneen ajan määritetyissä aikayksiköissä.

double time(
    timeUnits units ) const;

Parameters

Parametri

Tyyppi

Kuvaus

units

timeUnits

Kuluneen ajan palauttamiseen käytetyt yksiköt:

  • seconds / sec — sekuntia
  • msec — millisekuntia

Return Values
  • Parametriton funktio (1) palauttaa arvon uint32_t joka edustaa kulunutta aikaa millisekunteina.

  • The function with a timeUnits parameter (2) returns a double representing the elapsed time in the specified units.

Notes
  • Ajastin alkaa laskea aikaa, kun projekti käynnistyy.

  • Funktion clear kutsuminen nollaa ajastimen arvon.

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#

Rekisteröi takaisinkutsufunktion suoritettavaksi määritetyn viiveen jälkeen.

Available Functions

1 — Rekisteröi takaisinkutsun suoritettavaksi määritetyn viiveen jälkeen ja välittää käyttäjän määrittämän arvon takaisinkutsulle.

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

2 — Rekisteröi takaisinkutsutoiminnon suoritettavaksi määritetyn viiveen jälkeen.

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

Parameters

Parametri

Tyyppi

Kuvaus

callback

void ()(void)

Funktio, jota kutsutaan määritetyn viiveen jälkeen ja joka vastaanottaa käyttäjän määrittämän argumentin.

callback

void (*)(void)

Funktio, jota kutsutaan määritetyn viiveen jälkeen.

value

uint32_t

Viive millisekunteina ennen takaisinkutsufunktion suorittamista.

Return Values

Tämä funktio ei palauta arvoa.

Notes
  • Tämä funktio ajoittaa kertaluonteisen takaisinkutsun; se ei toistu automaattisesti.

  • Takaisinkutsufunktion on palautettava void.

  • Useita tapahtumia voidaan ajoittaa samaan aikaan.

Examples

Määrittele funktio ( int main())

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

Rekisteröi funktio int main() sisälle

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);
}