腦

介紹

在 VEX V5 C++ 中，大腦由 brain 表示。您可以建立（或使用項目提供的預設）Brain 對象，然後透過其成員對象存取大腦功能。

衍生類別

brain 類別作為以下衍生類別的基底類別：

• Screen - 此類別提供對 Brain 內建彩色觸控螢幕的訪問，允許程式顯示文字、圖形並接收觸控輸入。

• Timer - 此類別提供高解析度計時工具，用於測量經過的時間和控製程序中基於時間的行為。

• Battery - 此類允許程式監控大腦的電池狀態，包括電壓、電流、容量和溫度。

• ThreeWirePort (triport / 三線連接埠) - 此類別提供對大腦的 3 線連接埠的訪問，用於連接和控制傳統感測器和設備，例如限位開關、電位器和 LED。

• SDcard - 此類別允許從大腦的 SD 卡讀取和寫入文件，用於檔案儲存、資料記錄和載入外部資源。

類別建構函數

brain();

參數

brain 建構函數不使用任何參數。

筆記

• 一個專案中只能建立一個 brain 物件。

例子

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

成員功能

brain 類別包含以下成員函數：

• programStop - 停止 V5 Brain 上目前正在運作的項目。

• timer - 傳回大腦內部計時器的目前值，單位為指定單位。

• resetTimer - 將大腦的內部計時器重設為零並重新開始計時。

• setTimer - 將大腦的內部計時器設定為指定的值和時間單位。

在呼叫任何 brain 成員函數之前，必須先建立一個 brain 實例，如下所示：

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

傳回一個 double 表示自程式啟動以來經過的時間，單位為指定值。

Examples

• 專案開始時，計時器會自動啟動。

• 可以使用 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

• 計時器重置後會立即重新開始計時。

• 呼叫 resetTimer 會影響後續對 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	根據參數 units 中提供的 timeUnits ，設定定時器的時間。
units	timeUnits	The unit used to interpret the value parameter: seconds / sec - seconds msec - milliseconds

Return Values

此函數不傳回值。

Notes

• 計時器設定好後會繼續向前計時。

• 呼叫 setTimer 立即改變 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");