Таймер#

Введение#

Класс timer является производным от базового класса brain и предоставляет функциональность для измерения прошедшего времени, позволяя отслеживать длительность и планировать события, привязанные ко времени, в программе VEX V5.

Доступ#

Brain.Timer

Примечания#

  • Brain.Timer является экземпляром класса timer и предоставляет ту же функциональность.

Пример#

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

Функции участников#

Класс timer включает следующие функции-члены:

  • clear — Сбрасывает таймер на ноль.

  • time — Возвращает прошедшее время с момента запуска таймера.

  • event — Вызывает функцию через указанное количество миллисекунд с необязательными аргументами.

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

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

clear#

Сбрасывает текущее значение таймера на ноль. После этого таймер немедленно начинает отсчет заново с нуля.

Available Functions 
void clear();
Parameters

Эта функция не принимает никаких параметров.

Return Values

Эта функция не возвращает значения.

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#

Возвращает текущее значение таймера.

Available Functions

1 — Возвращает прошедшее время в миллисекундах.

uint32_t time() const;

2 — Возвращает прошедшее время в указанных единицах измерения.

double time(
    timeUnits units ) const;
Parameters

Параметр

Тип

Описание

units

timeUnits

Единицы измерения прошедшего времени:

  • seconds / sec — секунд
  • msec — миллисекунд
Return Values

  • Функция без параметров (1) возвращает uint32_t , представляющее прошедшее время в миллисекундах.

  • Функция с параметром timeUnits timeUnits 2) возвращает double , представляющий прошедшее время в указанных единицах.

Notes

  • Отсчет времени начинается с момента запуска проекта.

  • Вызов clear сбрасывает значение таймера до нуля.

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#

Регистрирует функцию обратного вызова, которая будет выполнена после указанной задержки.

Available Functions

1 — Регистрирует функцию обратного вызова, которая будет выполняться после указанной задержки, и передает в нее заданное пользователем значение.

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

2 — Регистрирует функцию обратного вызова, которая будет выполнена после указанной задержки.

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

Параметр

Тип

Описание

callback

void ()(void)

Функция, которая будет вызвана после указанной задержки и принимает заданный пользователем аргумент.

callback

void (*)(void)

Функция, которая будет вызвана после указанной задержки.

value

uint32_t

Задержка в миллисекундах до выполнения функции обратного вызова.
Return Values

Эта функция не возвращает значения.

Notes

  • Эта функция планирует однократный обратный вызов; он не повторяется автоматически.

  • Функция обратного вызова должна возвращать void.

  • Одновременно может быть запланировано несколько мероприятий.

Examples

Определите функцию (вне int main())

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

Зарегистрируйте функцию внутри 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);
}
На этой странице