屏幕

介绍

屏幕模块控制 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]

参数	描述
颜色	填充颜​​色： 红色 绿色 蓝色 黑色 白色 黄色 橙色 紫色 青色 透明

示例

启动时，将填充颜色设置为紫色，并绘制一个矩形。矩形位于 (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] 上画圆形