Laikmatis#

Įvadas#

timer klasė yra kilusi iš brain bazinės klasės ir suteikia funkcionalumą praėjusiam laikui matuoti, leidžiantį sekti trukmę ir planuoti laiku pagrįstus įvykius VEX EXP programoje.

Prieiga#

Brain.Timer

Pastabos#

  • Brain.Timer yra timer klasės egzempliorius ir atlieka tą pačią funkciją.

Pavyzdys#

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

Narių funkcijos#

timer klasėje yra šios narių funkcijos:

  • clear — Atkuria laikmatį į nulį.

  • time — Grąžina praėjusį laiką nuo laikmačio pradžios.

  • event — Iškviečia funkciją po nurodyto milisekundžių skaičiaus su pasirenkamais argumentais.

Prieš iškviečiant bet kokias timer nario funkcijas, reikia sukurti brain egzempliorių, kaip parodyta žemiau:

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

clear#

Atkuria dabartinę laikmačio reikšmę į nulį. Po to laikmatis iš karto vėl pradeda skaičiuoti nuo nulio.

Available Functions
void clear();

Parameters

Ši funkcija nepriima jokių parametrų.

Return Values

Ši funkcija negrąžina reikšmės.

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#

Grąžina dabartinę laikmačio reikšmę.

Available Functions

1 — Grąžina praėjusį laiką milisekundėmis.

uint32_t time() const;

2 — Grąžina praėjusį laiką nurodytais laiko vienetais.

double time(
    timeUnits units ) const;

Parameters

Parametras

Tipas

Aprašymas

units

timeUnits

Praėjusio laiko grąžinimo vienetai:

  • seconds / sec — sekundės
  • msec — milisekundės

Return Values
  • Beparametrė funkcija (1) grąžina uint32_t reiškiantį praėjusį laiką milisekundėmis.

  • Funkcija su timeUnits parametru (2) grąžina skaičių double reiškiantį praėjusį laiką nurodytais vienetais.

Notes
  • Laikmatis pradeda skaičiuoti laiką, kai prasideda projektas.

  • Iškvietus clear, laikmačio reikšmė nustatoma į nulį.

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#

Registruoja atgalinio iškvietimo funkciją, kuri bus vykdoma po nurodyto uždelsimo.

Available Functions

1 — Registruoja grįžtamąjį iškvietimą, kuris būtų vykdomas po nurodyto uždelsimo, ir perduoda grįžtamajam iškvietimui vartotojo apibrėžtą reikšmę.

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

2 — Registruoja grįžtamąjį iškvietimą, kuris bus vykdomas po nurodyto uždelsimo.

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

Parameters

Parametras

Tipas

Aprašymas

callback

void ()(void)

Funkcija, kuri bus iškviečiama po nurodyto uždelsimo ir gaus vartotojo apibrėžtą argumentą.

callback

void (*)(void)

Funkcija, kuri bus iškviesta po nurodyto uždelsimo laiko.

value

uint32_t

Vėlavimas milisekundėmis prieš vykdant atgalinio iškvietimo funkciją.

Return Values

Ši funkcija negrąžina reikšmės.

Notes
  • Ši funkcija suplanuoja vienkartinį grįžtamąjį iškvietimą; ji automatiškai nesikartoja.

  • Atgalinio iškvietimo funkcija turi grąžinti void.

  • Gali būti suplanuoti keli renginiai vienu metu.

Examples

Apibrėžkite funkciją (už int main())

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

Užregistruokite funkciją viduje 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);
}