Таймер#

Введение#

Класс timer используется для отсчета времени и взаимодействия с таймером, независимым от таймера мозга.

Конструктор класса#

timer();

Деструктор класса#

Уничтожает объект таймера timer и освобождает связанные с ним ресурсы.

~timer();

Параметры#

Этот конструктор не принимает никаких параметров.

Примеры#

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

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

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

  • reset — Resets the timer to zero.

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

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

Перед вызовом любых функций-членов таймера timer необходимо создать экземпляр таймера timer , как показано ниже:

/* 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#

Устанавливает таймер на ноль.

Available Functions
void reset();

Parameters

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

Return Values

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

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#

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

Available Functions
double value();

Parameters

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

Return Values

Число типа double, представляющее собой количество прошедшего времени в секундах.

Notes
  • Отсчет времени начинается с момента создания таймера.

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

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

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

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