Regulator czasowy#

Wstęp#

Klasa timera timer jest pochodną klasy bazowej brain i zapewnia funkcjonalność pomiaru czasu upłyniętego, umożliwiając śledzenie czasu trwania i planowanie zdarzeń opartych na czasie w programie VEX V5.

Dostęp#

Brain.Timer

Notatki#

  • Brain.Timer jest instancją klasy timer i zapewnia taką samą funkcjonalność.

Przykład#

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

Funkcje członkowskie#

Klasa timera timer zawiera następujące funkcje członkowskie:

  • clear — Resetuje licznik do zera.

  • time — Zwraca czas, który upłynął od uruchomienia timera.

  • event — Wywołuje funkcję po określonej liczbie milisekund, z opcjonalnymi argumentami.

Przed wywołaniem jakiejkolwiek funkcji członkowskiej timera timer należy utworzyć instancję brain brain , jak pokazano poniżej:

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

clear#

Resetuje bieżącą wartość timera do zera. Następnie timer natychmiast zaczyna odliczać od zera.

Available Functions 
void clear();
Parameters

Ta funkcja nie przyjmuje żadnych parametrów.

Return Values

Ta funkcja nie zwraca wartości.

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#

Zwraca aktualną wartość timera.

Available Functions

1 — Zwraca czas, który upłynął, w milisekundach.

uint32_t time() const;

2 — Zwraca czas, który upłynął, w określonych jednostkach czasu.

double time(
    timeUnits units ) const;
Parameters

Parametr

Typ

Opis

units

timeUnits

Jednostki używane do zwracania czasu upłyniętego:

  • seconds / sec — sekundy
  • msec — milisekundy
Return Values

  • Funkcja bezparametrowa (1) zwraca wartość uint32_t reprezentującą czas upłynięty w milisekundach.

  • Funkcja z parametrem timeUnits równym timeUnits 2) zwraca wartość double oznaczającą upływający czas w określonych jednostkach.

Notes

  • Licznik zaczyna odliczać czas w momencie rozpoczęcia projektu.

  • Wywołanie clear resetuje wartość timera do zera.

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#

Rejestruje funkcję wywołania zwrotnego, która ma zostać wykonana po określonym opóźnieniu.

Available Functions

1 — Rejestruje wywołanie zwrotne, które ma zostać wykonane po określonym opóźnieniu i przekazuje zdefiniowaną przez użytkownika wartość do wywołania zwrotnego.

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

2 — Rejestruje wywołanie zwrotne do uruchomienia po określonym opóźnieniu.

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

Parametr

Typ

Opis

callback

void ()(void)

Funkcja, która zostanie wywołana po określonym opóźnieniu i otrzyma argument zdefiniowany przez użytkownika.

callback

void (*)(void)

Funkcja, która zostanie wywołana po określonym opóźnieniu.

value

uint32_t

Opóźnienie (w milisekundach) przed wykonaniem funkcji wywołania zwrotnego.
Return Values

Ta funkcja nie zwraca wartości.

Notes

  • Ta funkcja planuje jednorazowe wywołanie zwrotne i nie powtarza się automatycznie.

  • Funkcja wywołania zwrotnego musi zwracać void.

  • Można zaplanować wiele wydarzeń w tym samym czasie.

Examples

Zdefiniuj funkcję (poza int main())

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

Zarejestruj funkcję wewnątrz 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);
}
On this page