螢幕

介紹

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

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

大腦的繪圖解析度為 159 x 107 像素。

以下是可用模組列表：

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

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

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

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

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

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

• cursor row – 報告文字將列印到的行號。

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

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

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

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

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

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

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

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

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

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

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

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

遊標列印

螢幕列印

在螢幕上列印堆疊區塊會在 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.

頁面能容納多少行和列取決於所選字體。使用預設的等寬中等字體，最多可清晰顯示 8 行 13 列。超出此範圍的文字可能會被截斷或難以閱讀。

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

設定遊標堆疊塊

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

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

例子

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

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

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

將遊標設定到螢幕上的下一行 堆疊區塊將遊標移動到大腦螢幕上下一行的第 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] 列第 [10] 欄
在螢幕上列印 (游標欄) ▶

遊標行

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

遊標行報告區塊

(游標列)

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

例子

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

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

設定

清晰螢幕

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

清除螢幕堆疊塊

清除螢幕

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

例子

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

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

設定螢幕上的字體

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

設定字體堆疊塊

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

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

等寬特小號	等寬小號	等寬中等字體
等寬大號	等寬特大號	等寬超大
比例中等	比例大	比例超大
比例超大

例子

啟動時，將字體設定為“等寬特大號”，並在螢幕上列印“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 像素，並繪製一個左上角位於 (20, 20)、寬度為 75 像素、高度為 50 像素的矩形。

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

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

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

設定筆/字體顏色堆疊塊

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

參數	描述
顏色	要使用的筆和字體顏色： 紅色 綠色 藍色 黑色 白色 黃色 橙色 紫色 綠色

例子

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

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

設定螢幕填滿顏色

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

設定填滿顏色堆疊塊

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

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

範例

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

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

畫

在螢幕上繪製像素

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

繪製像素堆疊塊

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

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

例子

啟動時，在螢幕中心座標 (120, 120) 處繪製一個像素。

當開始時
[Draw the pixels marking the corners of a square.]
在螢幕上繪製像素 [50] [50]
在螢幕上繪製像素 [50] [75]
在螢幕上繪製像素 [75] [50]
在螢幕上繪製像素 [75] [75]

在螢幕上畫線

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

畫線堆疊塊

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

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

例子

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

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

在螢幕上繪製一個矩形

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

繪製矩形堆疊塊

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

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

例子

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

當開始時
[Draw a rectangle on the screen.]
在螢幕上繪製矩形 [20] [20] [80] [30]

在螢幕上畫一個圓

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

畫圓堆疊塊

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

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

例子

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

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