螢幕

介紹

螢幕模組控制 V5 大腦的觸控屏，使你的機器人能夠顯示文字、數字和圖形，並回應觸控輸入。

預設情況下，列印到大腦的字體是等寬小號，它有 12 行 48 列。

大腦的繪圖解析度為 480 x 240 像素。

以下是可用模組列表：

遊標列印 – 顯示文字並管理列印遊標。

• 在螢幕上列印 – 在 Brain 螢幕上列印文字、數字或變數值。

• 將遊標設定到螢幕上的行列 – 將遊標移到指定的行和列。

• 將遊標移至螢幕上的下一行 – 將遊標移至下一行的第 1 列。

• 清除螢幕上的行 – 清除指定的一行文字。

• 螢幕遊標列 – 報告文字將列印到的列號。

• 螢幕遊標行 – 報告文字將列印到的行號。

設定 – 變更文字和圖形的外觀。

• 清除螢幕 – 清除螢幕上的所有文字和圖畫。

• 設定螢幕字體 – 變更文字顯示的字體類型和大小。

• 設定螢幕上的列印精確度 – 設定列印數字時顯示的小數位數。

• 設定畫面上的筆寬 – 設定繪製線條和形狀輪廓的粗細。

• 設定螢幕上的筆/字體顏色 – 設定文字、像素、線條和形狀輪廓的顏色。

• 設定螢幕填滿色彩 – 設定繪製形狀的填滿色彩。

繪圖 – 在大腦螢幕上建立形狀、線條和圖形。

• 在螢幕上繪製像素 – 在指定座標處繪製單一像素。

• 在螢幕上畫出線條 – 在兩點之間畫出一條線。

• 在螢幕上繪製一個矩形 – 使用兩個角點繪製一個矩形。

• 在螢幕上繪製圓 – 繪製一個具有指定中心和半徑的圓。

觸控 – 偵測大腦螢幕上的觸控輸入。

• 螢幕被按下 – 報告畫面目前是否被觸碰。

• 螢幕位置 – 報告上次畫面按下時所選取的 x 或 y 座標。

• 當螢幕 – 當螢幕被按下或釋放時執行附加的模組。

遊標列印

螢幕列印

在螢幕上列印堆疊區塊會在 Brain 螢幕上以目前遊標位置和字型列印文字、數字或變數值。

在大腦螢幕上顯示文字

當開始時
在螢幕上列印 [VEXcode] ▶

參數	描述
價值	若要在螢幕上顯示的文字、數字或變數值。
並將遊標移至下一行	選擇箭頭（▶）展開區塊，顯示並將遊標設定到下一行，這樣列印後遊標將移動到下一行的第 1 列。

例子

啟動時，在螢幕上的起始遊標位置顯示訊息「你好，機器人！」。

當開始時
[Display a message at the starting cursor position.]
在螢幕上列印 [Hello, Robot!] ▶

將遊標設定到螢幕上的行列

The set cursor to row column on screen stack block moves the cursor to a specific row and column on the Brain screen. The next print on screen block will start printing at that location. How many rows and columns can comfortably fit depends on the selected font. With the default monospaced medium font, up to 8 rows and 13 columns can be displayed clearly. Text placed beyond this range may be cut off or become difficult to read.

等寬字體的所有字元寬度相同，因此文字位置保持一致。相較之下，比例字體的字元寬度各不相同，因此有些字母佔用的空間比其他字母大。但是，無論使用哪種字體，set cursor to row column on screen 堆疊區塊都會根據行和列的大小（而不是字體樣式）來定位遊標。可以使用 set font on screen 堆疊區塊來調整字體大小。

設定遊標堆疊塊

將游標設定到螢幕第 [1] 列第 [1] 欄

參數	描述
排	要將遊標移到的行。
柱子	要將遊標移到的列。

例子

啟動時，將遊標移到螢幕上的第 3 行第 2 列，並列印「第 3 行，第 2 列」。

當開始時
[Display text starting at Row 3 Column 12.]
將游標設定到螢幕第 [3] 列第 [12] 欄
在螢幕上列印 [Row 3, Column 12] ▶

將遊標移至螢幕上的下一行

將遊標設定到螢幕上的下一行 堆疊區塊將遊標移動到大腦螢幕上下一行的第 1 列。

將遊標設定到下一行堆疊區塊

將游標移至螢幕下一列

參數	描述
	此程式碼區塊沒有參數。

例子

啟動時，螢幕上會列印“第 1 行”，將遊標移到下一行，然後列印“第 2 行”。

當開始時
[Display two lines of text.]
在螢幕上列印 [Line 1] ▶
將游標移至螢幕下一列
在螢幕上列印 [Line 2] ▶

螢幕上的清除行

清除螢幕上的行堆疊區塊清除大腦螢幕上的一行文字。

清除行堆疊區塊

清除螢幕第 [1] 列

參數	描述
排	要清除的行號。

例子

啟動後，文字會印在兩行上。第一行會一直顯示，而第二行會在 3 秒後消失。

當開始時
[Only keep the text on row 1.]
在螢幕上列印 [This text stays] ▶
將游標移至螢幕下一列
在螢幕上列印 [This text disappears] ▶
等待 [3] 秒
清除螢幕第 [2] 列

螢幕遊標列

螢幕遊標列 報告區塊以整數形式報告文字將要列印的列號。

螢幕遊標列報告區塊

(螢幕游標欄)

參數	描述
	此程式碼區塊沒有參數。

例子

啟動時，將遊標移到螢幕上的第 3 行第 2 列，並列印目前遊標所在的列號。

當開始時
[Display the cursor's current column.]
將游標設定到螢幕第 [3] 列第 [15] 欄
在螢幕上列印 (螢幕游標欄) ▶

螢幕遊標行

螢幕遊標行 報告區塊以整數形式報告文字將要列印的行號。

螢幕遊標行報告區塊

(螢幕游標列)

參數	描述
	此程式碼區塊沒有參數。

例子

啟動時，將遊標移到螢幕上的第 6 行第 2 列，並列印目前遊標所在的行號。

當開始時
[Display the cursor's current row.]
將游標設定到螢幕第 [3] 列第 [2] 欄
在螢幕上列印 (螢幕游標列) ▶

設定

清晰螢幕

清除螢幕堆疊塊會清除大腦螢幕上的所有圖形和文字。

清除螢幕堆疊塊

清除螢幕

參數	描述
	此程式碼區塊沒有參數。

例子

啟動時，繪製以 (120,120) 為圓心、半徑為 40 像素的圓。 2 秒後，螢幕清空。

當開始時
[Draw a circle, and clear it after 2 seconds.]
在螢幕上繪製圓形 [120] [120] [40]
等待 [2] 秒
清除螢幕

設定螢幕上的字體

「設定螢幕字體」堆疊區塊用於設定大腦螢幕上顯示的文字的字體和大小。此字體將套用於之後列印的所有文字。

設定字體堆疊塊

在螢幕上設定字型為 [等寬 v] [中 v]

參數	描述
風格	字體樣式：等寬字體或等寬字體
尺寸	字體大小（範例如下）： 特小 小 中 大 特大 超大 注意：比例字體不支援特小和小尺寸。

等寬超小號	monospaced small	monospaced medium
monospaced large	monospaced extra large	monospaced super large
proportional medium	比例大	比例超大
比例超大

例子

啟動時，將字體設定為“等寬特大號”，並在螢幕上列印“VEX”。

當開始時
[Display text using a larger font]
在螢幕上設定字型為 [等寬 v] [特大 v]
在螢幕上列印 [VEX] ▶

設定螢幕列印精度

設定螢幕列印精確度 堆疊區塊用於設定 Brain 螢幕上列印數字時顯示的小數位數。此列印精度將應用於之後列印的所有數字。

設定列印精度堆疊塊

在螢幕上設定列印精度為 [0.1 v]

參數	描述
精確	列印精度： 1 0.1 0.01 0.001 所有數字

例子

啟動時，將列印精度設定為小數點後兩位，並在螢幕上將 1/3 列印為 0.33。

當開始時
[Print 1/3 as 0.33.]
在螢幕上設定列印精度為 [0.01 v]
在螢幕上列印 ([1] [math_division v] [3]) ▶

設定螢幕上的筆寬

設定畫面上的筆寬 堆疊塊用於設定繪製線條和形狀輪廓的粗細。

設定筆寬堆疊塊

在螢幕上設定畫筆寬度為 [10]

參數	描述
寬度	筆的寬度，以像素為單位，範圍從 0 到 32。

例子

啟動時，將筆的寬度設為 10 像素，並繪製一個左上角位於 (50,50)、寬度為 130 像素、高度為 60 像素的矩形。

當開始時
[Draw a rectangle with a pen width of 10.]
在螢幕上設定畫筆寬度為 [10]
在螢幕上繪製矩形 [50] [50] [130] [60]

設定螢幕上的筆/字體顏色

設定螢幕上的筆/字體顏色 堆疊塊設定文字、像素、線條和形狀輪廓的顏色。

設定筆/字體顏色堆疊塊

在螢幕上設定畫筆／字型顏色為 [紅色 v]

參數	描述
顏色	要使用的笔和字体颜色： 红色 绿色 蓝色 黑色 白色 黄色 橙色 紫色 青色 透明

例子

啟動時，將畫筆顏色設為橘色，並繪製一個左上角位於 (50, 50) 的矩形，寬度為 130 像素，高度為 60 像素。

當開始時
[Draw a rectangle with orange borders.]
在螢幕上設定畫筆／字型顏色為 [橙色 v]
在螢幕上繪製矩形 [50] [50] [130] [60]

設定螢幕填滿顏色

設定螢幕填滿色彩 堆疊方塊用於設定繪製形狀時使用的填滿色彩。

設定填滿顏色堆疊塊

在螢幕上設定填色為 [紅色 v]

參數	描述
顏色	填滿顏色： 紅色 綠色 藍色 黑色 白色 黃色 橙色橙色 紫色 青色 1

範例

啟動時，將填滿顏色設為紫色，並繪製一個矩形。矩形位於 (50, 130) 處，寬度為 100 像素，高度為 60 像素。

當開始時
[Draw a purple rectangle.]
在螢幕上設定填色為 [紫色 v]
在螢幕上繪製矩形 [50] [130] [100] [60]

畫

在螢幕上繪製像素

在螢幕上繪製像素堆疊區塊使用目前的畫筆顏色在選取的x和y座標處繪製一個像素。

繪製像素堆疊塊

在螢幕上繪製像素 [0] [0]

參數	描述
x	繪製像素的 x 座標，範圍從 0 到 479。
是	繪製像素的 y 座標，範圍從 0 到 239。

例子

啟動時，繪製四個像素來標記一個小正方形的四個角落。

當開始時
[Draw the pixels marking the corners of a square.]
在螢幕上繪製像素 [250] [100]
在螢幕上繪製像素 [275] [100]
在螢幕上繪製像素 [250] [125]
在螢幕上繪製像素 [275] [125]

在螢幕上畫線

在螢幕上繪製線條堆疊區塊使用目前的筆寬和筆顏色從第一個螢幕座標(x1, y1)到第二個螢幕座標(x2, y2)繪製一條線。

畫線堆疊塊

在螢幕上繪製線段 [0] [0] [10] [10]

參數	描述
x1	行首的 x 座標（像素），範圍從 0 到 479。
y1	線段起始點的 y 座標（像素），取值範圍為 0 到 239。
x2	行尾的 x 座標（像素），範圍從 0 到 479。
y2	線段末端的 y 座標（像素），取值範圍為 0 到 239。

例子

啟動時，從螢幕左上角 (0, 0) 到右下角 (479, 239) 畫一條對角線。

當開始時
[Draw a line from the top left to bottom right of the screen.]
在螢幕上繪製線段 [0] [0] [479] [239]

在螢幕上繪製一個矩形

在螢幕上繪製矩形堆疊區塊使用目前的畫筆寬度、畫筆顏色和填滿色彩繪製矩形。

繪製矩形堆疊塊

在螢幕上繪製矩形 [0] [0] [10] [10]

參數	描述
x	矩形左上角的 x 座標（像素），取值範圍為 0 到 479。
是	矩形左上角的 y 座標（像素），取值範圍為 0 到 239。
寬度	矩形的寬度（以像素為單位）。
高度	矩形的高度（以像素為單位）。

例子

啟動時，在螢幕上繪製一個矩形，左上角位於 (50,50)，寬度為 130 像素，高度為 60 像素。

當開始時
[Draw a rectangle on the screen.]
在螢幕上繪製矩形 [50] [50] [130] [60]

在螢幕上畫一個圓

在螢幕上繪製圓形堆疊區塊使用目前的畫筆寬度、畫筆顏色和填滿色彩繪製圓形。

畫圓 堆疊方塊

在螢幕上繪製圓形 [0] [0] [10]

參數	描述
x	圓心的 x 座標（像素值），取值範圍為 0 到 479。
是	圓心的 y 座標（像素值），取值範圍為 0 到 239。
半徑	圓的半徑（以像素為單位）。

例子

啟動時，在螢幕上繪製一個圓，圓心位於 (120, 120)，半徑為 40 像素。

當開始時
[Draw a circle on the screen.]
在螢幕上繪製圓形 [120] [120] [40]

觸碰

螢幕按下

螢幕按下布林模組報告大腦的觸控螢幕目前是否被按下。

• 正確 – 螢幕被按下。

• 錯誤 – 螢幕沒有被按下。

螢幕按下布爾塊

<螢幕按下？>

參數	描述
	此程式碼區塊沒有參數。

啟動後，按下螢幕即可改變螢幕顏色。

當開始時
[Change the screen's color after it's pressed.]
等待直到 <螢幕按下？>
在螢幕上設定填色為 [綠色 v]
在螢幕上繪製矩形 [0] [0] [479] [239]

按下螢幕後，會顯示第一條訊息。然後，程式會等待螢幕放開，只有在再次按下螢幕後才會繼續顯示第二個訊息。

當開始時
[Display different messages after the screen is pressed.]
等待直到 <螢幕按下？>
在螢幕上列印 [First message!] ▶
將游標移至螢幕下一列
[Lift finger to press the screen again.]
等待直到 <非 <螢幕按下？>>
等待直到 <螢幕按下？>
在螢幕上列印 [Second message!] ▶

螢幕位置

螢幕位置報告模組會報告上次螢幕按鍵的選定座標。 x 座標範圍為 0（左）至 479（右）。 y 座標範圍為 0（上）至 239（下）。

螢幕位置報告區塊

(螢幕 [x v] 位置)

參數	描述
軸	報告上次畫面按鍵的座標：x – 水平位置 或 y – 垂直位置

按下大腦螢幕時，會在按下位置畫一個圓圈。

當開始時
[Display a circle where the screen is pressed.]
等待直到 <螢幕按下？>
在螢幕上設定填色為 [白色 v]
在螢幕上繪製圓形 (螢幕 [x v] 位置) (螢幕 [y v] 位置) [20]

螢幕

當按下或釋放 Brain 螢幕時，when screen 帽子模組會運行連接的模組堆疊。

當螢幕帽子阻擋

當 Brain 螢幕 [按下 v] 時 :: hat events

參數	描述
狀態	何時運行附加的積木棧：pressed 在螢幕被按下時運行，released 在螢幕被釋放時運行。

按下大腦螢幕時，會在按下位置畫一個圓圈。

當 Brain 螢幕 [按下 v] 時 :: hat events
[Color the screen with polka dots by pressing it repeatedly.]
在螢幕上設定填色為 [紅色 v]
在螢幕上繪製圓形 (螢幕 [x v] 位置) (螢幕 [y v] 位置) [20]