Mukautettu ajastin

Johdanto

timer -luokkaa käytetään ajan seuraamiseen ja vuorovaikutukseen ajastimen kanssa, joka on riippumaton aivojen ajastimesta.

Luokan rakentaja

timer();

Luokan tuhoaja

Tuhoaa timer -objektin ja vapauttaa siihen liittyvät resurssit.

~timer();

Parametrit

Tämä konstruktori ei hyväksy parametreja.

Esimerkkejä

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

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 timer -instanssi alla olevan mukaisesti:

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

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

clear

Asettaa ajastimen nollaan.

Available Functions

void clear();

Parameters

Tämä funktio ei hyväksy parametreja.

Return Values

Tämä funktio ei palauta arvoa.

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

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 mukautettu ajastin on rakennettu.

• 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", myTimer.time(sec));

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

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