脑#

In VEX V5 C++, the Brain is represented by the brain class. You create (or use the default project-provided) Brain object and then access Brain features through its member objects.

派生类#

The brain class serves as a base class for the following derived classes:

  • Screen — This class provides access to the Brain’s built-in color touchscreen, allowing programs to display text, graphics, and receive touch input.

  • Timer — This class provides high-resolution timing utilities for measuring elapsed time and controlling time-based behavior in programs.

  • Battery — This class allows programs to monitor the Brain’s battery status, including voltage, current, capacity, and temperature.

  • ThreeWirePort (triport / 3-Wire Port) — This class provides access to the Brain’s 3-Wire ports for connecting and controlling legacy sensors and devices such as limit switches, potentiometers, and LEDs.

  • SDcard — This class enables reading from and writing to the Brain’s SD card for file storage, data logging, and loading external resources.

类构造函数#

brain();

参数#

The brain constructor uses no parameters.

笔记#

  • Only one brain object should be created in a project.

例子#

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

成员功能#

The brain class includes the following member functions:

  • programStop — Stops the currently running project on the V5 Brain.

  • timer — Returns the current value of the Brain’s internal timer in the specified units.

  • resetTimer — Resets the Brain’s internal timer to zero and restarts timing.

  • setTimer — Sets the Brain’s internal timer to a specified value and time unit.

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

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

程序停止#

停止 V5 大脑上当前正在运行的项目。

Available Functions 
void programStop();
Parameters

此函数不接受任何参数。

Return Values

此函数不返回值。

Examples 
// Stop the project when the Brain screen is pressed
while (true) {
  if (Brain.Screen.pressing()) {
    Brain.programStop();
  }
  wait(20, msec);
}

定时器#

返回大脑内部计时器的当前值，单位为指定单位。

Available Functions 
double timer(
  timeUnits units );
Parameters

范围

类型

描述

units

timeUnits

The unit of time to return:

  • seconds / sec — seconds
  • msec — milliseconds
Return Values

Returns a double representing the elapsed time since the program started, in the specified units.

Examples

  • 项目开始时，计时器会自动启动。

  • The timer can be reset with the use of resetTimer .

Examples 
// Stop the project after 3 seconds
while (Brain.timer(seconds) < 3) {
  wait(20, msec);
}

Brain.programStop();

重置计时器#

将大脑内部计时器重置为零，之后，计时器立即从零开始重新计数。

Available Functions 
void resetTimer();
Parameters

此函数不接受任何参数。

Return Values

此函数不返回值。

Notes

  • 计时器重置后会立即重新开始计时。

  • Calling resetTimer affects the value returned by subsequent calls to timer.

Examples 
// Reset the timer and measure elapsed time
Brain.resetTimer();

while (Brain.timer(sec) < 5) {
  wait(20, msec);
}

// 5 seconds have elapsed since reset
Brain.Screen.print("5 seconds passed");

设置定时器#

将大脑的内部计时器设置为指定的值和时间单位。

Available Functions 
void setTimer(
  double value,
  timeUnits units );
Parameters

范围

类型

描述

value

double

The time to set the timer to, based on the timeUnits provided in the units parameter.

units

timeUnits

The unit used to interpret the value parameter:

  • seconds / sec — seconds
  • msec — milliseconds
Return Values

此函数不返回值。

Notes

  • 计时器设定好后会继续向前计时。

  • Calling setTimer immediately changes the value returned by timer.

Examples 
// Set the timer to start at 10 seconds
Brain.setTimer(10, sec);

// Wait until the timer is at 3 seconds
while (Brain.timer(sec) < 3) {
  wait(20, msec);
}

// 5 seconds have elapsed since setTimer was called
Brain.Screen.print("5 seconds passed");
On this page