Regulator czasowy#

Wstęp#

Klasa timera timer jest używana do odmierzania czasu i interakcji z timerem niezależnym od timera mózgu.

Konstruktor klasy#

timer();

Destruktor klasy#

Niszczy obiekt o wartości timer i uwalnia powiązane zasoby.

~timer();

Parametry#

Ten konstruktor nie akceptuje żadnych parametrów.

Przykłady#

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

Funkcje członkowskie#

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

  • reset — Resets the timer to zero.

  • value — Returns the elapsed time since the timer started.

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

Before calling any timer member functions, a timer instance must be created, as shown below:

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

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

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

// Create the Brain to use Brain.Timer
brain Brain = brain();

reset#

Ustawia licznik na zero.

Available Functions
void reset();

Parameters

Ta funkcja nie przyjmuje żadnych parametrów.

Return Values

Ta funkcja nie zwraca wartości.

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

value#

Zwraca aktualną wartość timera.

Available Functions
double value();

Parameters

Ta funkcja nie przyjmuje żadnych parametrów.

Return Values

Liczba double oznacza ilość czasu, jaka upłynęła w sekundach.

Notes
  • Odliczanie czasu rozpoczyna się w momencie jego skonstruowania.

  • Calling reset resets the timer value to zero.

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

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

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