Niestandardowy timer

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:

• 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.

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

clear

Ustawia licznik na zero.

Available Functions

void clear();

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.clear();
  }
  Brain.Screen.clearScreen();
  Brain.Screen.setCursor(1, 1);
  Brain.Screen.print("Time: %.2f", myTimer.time(msec));
  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

• Odliczanie czasu rozpoczyna się w momencie utworzenia niestandardowego licznika czasu.

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

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