屏幕

介绍

屏幕模块控制 EXP 大脑的屏幕，使你的机器人能够显示文本、数字和图形，并响应触摸输入。

默认情况下，打印到大脑的字体是等宽小号，它有7行20列。

大脑的绘图分辨率为 159 x 107 像素。

以下是可用模块列表：

光标打印 – 显示文本并管理打印光标。

• 在屏幕上打印 – 在 Brain 屏幕上打印文本、数字或变量值。

• 将光标设置到屏幕上的行列 – 将光标移动到指定的行和列。

• 将光标移至屏幕上的下一行 – 将光标移至下一行的第 1 列。

• 清除屏幕上的行 – 清除屏幕上指定的一行文本。

• 光标列 – 报告文本将打印到的列号。

• cursor row – 报告文本将打印到的行号。

设置 – 更改文本和图形的外观。

• 清除屏幕 – 清除屏幕上的所有文字和图画。

• 设置屏幕字体 – 更改文本显示的字体类型和大小。

• 设置屏幕上的打印精度 – 设置打印数字时显示的小数位数。

• 设置屏幕上的笔宽 – 设置绘制线条和形状轮廓的粗细。

• 设置屏幕上的笔/字体颜色 – 设置文本、像素、线条和形状轮廓的颜色。

• 设置屏幕填充颜色 – 设置绘制形状的填充颜色。

绘图 – 在大脑屏幕上创建形状、线条和图形。

• 在屏幕上绘制像素 – 在指定坐标处绘制单个像素。

• 在屏幕上绘制线条 – 在两点之间绘制一条线。

• 在屏幕上绘制矩形 – 使用两个角点绘制矩形。

• 在屏幕上绘制圆 – 绘制一个具有指定中心和半径的圆。

光标打印

屏幕打印

在屏幕上打印堆栈块会在 Brain 屏幕上以当前光标位置和字体打印文本、数字或变量值。

在大脑屏幕上显示文本

当开始
在屏幕上打印 [VEXcode]▶

参数	描述
价值	要在屏幕上打印的文本、数字或变量值。
并将光标移至下一行	选择箭头（▶）展开块，显示并将光标设置到下一行，这样打印后光标将移动到下一行的第 1 列。

例子

启动时，在屏幕上的起始光标位置显示消息“你好，机器人！”。

当开始
[Display a message at the starting cursor position.]
在屏幕上打印 [Hello, Robot!]▶

将光标设置到屏幕上的行列

“设置光标到屏幕上的行列”堆栈块会将光标移动到大脑屏幕上#print-on-screen特定行和列。下一个“在屏幕上打印”块将从该位置开始打印。

页面能容纳多少行和列取决于所选字体。使用默认的等宽中等字体，最多可以清晰显示 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.]
设定屏幕笔/字体颜色为 [orange v]
在屏幕 [20] [20] [75] [50] 上画矩形

设置屏幕填充颜色

设置屏幕填充颜色 堆栈块用于设置绘制形状时使用的填充颜色。

设置填充颜色堆叠块

设定屏幕填充色为 [红色 v]

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

示例

启动时，将填充颜色设置为紫色，并绘制一个矩形。矩形位于 (50, 130) 处，宽度为 100 像素，高度为 60 像素。

当开始
[Draw a purple rectangle.]
设定屏幕填充色为 [purple 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] 上画圆形