屏幕#

介绍 #

“屏幕”类别包含一些模块，可让您的 VEX IQ（第二代）机器人在 Brain 的内置屏幕上显示文本、数值和图形。这些模块可用于打印传感器数据、创建自定义界面，或绘制线条、形状和文本等视觉元素，并可调整样式和颜色。

以下是可用块的列表：

打印——在大脑中显示文本和值。

print – 将值或文本打印到选定的屏幕。
将光标设置到行列 – 设置打印的行和列位置。
将光标设置到下一行 – 将光标移动到下一行。
清除行 – 清除特定行。
光标列 – 返回当前光标列号。
cursor row – 返回当前光标行号。

设置 – 配置屏幕显示属性。

清除屏幕 – 清除整个屏幕。
设置字体 – 设置打印文本的字体样式和大小。
设置打印精度 – 设置显示的小数位数。
设置笔宽 – 设置绘图的线条粗细。
设置笔颜色 – 设置用于轮廓和文本的颜色。
设置填充颜色 – 设置绘制形状的填充颜色。

绘图——在大脑屏幕上创建形状和图形。

绘制像素 – 在坐标处绘制单个像素。
画线 – 在两点之间画一条线。
绘制矩形 – 绘制一个矩形。
画圆 – 画一个圆。

打印 #

print 块在 Brain 屏幕上的当前光标位置和字体显示文本。

在屏幕上打印 [VEXcode]▶

参数	描述
价值	要显示的文本、数字或变量值。
扩大箭头	展开块来读取并将光标设置到下一行，并使光标移动到该块之后的下一行。

例子

当开始 :: hat events
[Display a message at the starting cursor position.]
在屏幕上打印 [Hello, Robot!]◀ 并设定光标为下一行

VEX IQ 机器人的俯视图，位于一个蓝色圆形图中，图中显示了基本方向。机器人面朝上（0°）。该图指示机器人向右旋转 90°，向下旋转 180°，向左旋转 270°。该机器人由橙色和灰色组件组成，前面板上可见“VEX3”字样。机器人两侧均可见轮子。

将光标设置到行列 #

使用“将光标置于行列”积木块时，光标会放置在 Brain 屏幕上的特定行和列上。实际可容纳的行数和列数取决于所选的字体。

等宽字体的字符宽度相同，使文本位置保持一致。相比之下，比例字体的字符宽度各不相同，因此某些字母比其他字母占用更多空间。但是，无论使用哪种类型，将光标设置为行列块都会根据行和列的大小（而不是字体样式）来定位光标。可以使用 设置字体块调整字体大小。

设置游标堆栈块#

在屏幕上设定光标至 [1] 行 [1] 列

参数	描述
排	游标所在行。
柱子	光标所在的列。

例子

当开始 :: hat events
[Repeatedly print the current timer at Row 1 Column 1]
永久循环
在屏幕上打印 (计时器秒数)◀ 并设定光标为下一行
等待 (1) 秒
清屏
在屏幕上设定光标至 (1) 行 (1) 列

替代文本

将光标设置到下一行 #

将光标设置到下一行块将光标移动到 Brain 屏幕上下一行的第 1 列。

在屏幕上设定光标至下一行

例子

当开始 :: hat events
[Display two lines of text.]
在屏幕上打印 [Line 1]▶
在屏幕上设定光标至下一行
在屏幕上打印 [Line 2]◀ 并设定光标为下一行

替代文本

清除行 #

清除行块用于清除 Brain 屏幕上的一行。

清除屏幕第 (1) 行

参数	描述
排	要清除的行号。

例子

当开始 :: hat events
[Display text on two rows, but only keep one.]
在屏幕上打印 [This text stays]◀ 并设定光标为下一行
在屏幕上打印 [This disappears]◀ 并设定光标为下一行
等待 (3) 秒
清除屏幕第 (2) 行

光标列 #

光标列块返回将以整数形式打印文本的列号。

光标列报告块#

(光标列数)

例子

启动时，将光标移动到屏幕上的第 3 行、第 2 列，并打印当前光标列号。#

当开始 :: hat events
[Display the cursor's current column.]
在屏幕上设定光标至 [3] 行 [2] 列
在屏幕上打印 (光标列数)▶

光标行 #

cursor row 块返回将以整数形式打印文本的行号。

游标行报告块#

(光标行数)

例子

启动后，将光标移动到屏幕上的第 6 行、第 2 列，并打印当前光标行号。#

当开始 :: hat events
[Display the cursor's current row.]
在屏幕上设定光标至 [3] 行 [2] 列
在屏幕上打印 (光标行数)▶

设置 #

清除屏幕 #

清除屏幕块清除大脑屏幕上的所有文本。

清屏

例子

当开始 :: hat events
[Fill the screen, then clear it after 2 seconds.]
重复 (5)
在屏幕上打印 [Line]◀ 并设定光标为下一行
结束
等待 (3) 秒
清屏

设置字体 #

设置字体 模块用于设置机器人屏幕上显示文本的字体和大小。此字体将应用于所有后续打印的文本。

设定屏幕字体为 [等宽字体 v] [中 v]

参数	描述
字体	使用的字体：等宽字体比例字体
尺寸	使用的尺寸：特小小中大特大超大

参数

描述

字体

使用的字体：

等宽字体
比例字体

尺寸

使用的尺寸：

特小
小
中
大
特大
超大

Mono Extra Small	Mono Small	Mono Medium
Mono Large	Mono Extra Large	单色超大
Prop Medium	Prop Large	Prop Extra Large
Prop Super Large

例子

当开始 :: hat events
[Display two different fonts on separate lines.]
设定屏幕字体为 [等宽字体 v] [中 v]
在屏幕上打印 [Mono Medium]◀ 并设定光标为下一行
设定屏幕字体为 [比例字体 v] [中 v]
在屏幕上打印 [Prop Medium]◀ 并设定光标为下一行

替代文本

设置打印精度 #

设置打印精度 模块用于设置 Brain 屏幕上显示数字的精度格式。此打印精度将应用于所有后续打印的数字。

在屏幕上设定打印精度为 [0.1 v]

参数	描述
精确	将打印精度设置为： 1 0.1 0.01 0.001 所有数字

例子

当开始 :: hat events
[Print 1/3 as 0.33.]
在屏幕上设定打印精度为 [0.01 v]
在屏幕上打印 ([1] / [3])◀ 并设定光标为下一行

替代文本

设置笔宽 #

设置笔宽块设置用于绘制线条和形状的笔宽。

设定屏幕笔宽为 [10]

参数	描述
宽度	笔的宽度（以像素为单位），范围从 0 到 32。

例子

当开始 :: hat events
[Draw two circles with different pen widths.]
在屏幕 (40) (70) (20) 上画圆形
设定屏幕笔宽为 (5)
在屏幕 (100) (70) (20) 上画圆形

替代文本

设置笔颜色 #

设置笔颜色块设置用于在大脑屏幕上绘制线条、形状和文本的笔颜色。

设定屏幕笔/字体颜色为 [红色 v]

参数	描述
颜色	将笔颜色设置为：红色绿色蓝色白色黄色橙色紫色红紫色紫色蓝紫色蓝绿色黄绿色黄橙色红橙色

例子

当开始 :: hat events
[Draw two rectangles with different colors.]
在屏幕 (100) (50) (10) (20) 上画矩形
设定屏幕笔/字体颜色为 [蓝色 v]
在屏幕 (50) (50) (10) (20) 上画矩形

替代文本

设置填充颜色 #

设置填充颜色块设置绘制形状时使用的填充颜色。

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

参数	描述
颜色	将填充颜色设置为：红色绿色蓝色白色黄色橙色紫色红紫色紫色蓝紫色蓝绿色黄绿色黄橙色红橙色

例子

当开始 :: hat events
[Draw a yellow circle.]
设定屏幕填充色为 [yellow v]
在屏幕 (50) (50) (20) 上画圆形

替代文本

画 #

绘制像素 #

绘制像素 块在当前画笔颜色中在指定的 (x, y) 屏幕坐标处绘制一个像素。

在屏幕 [0] [0] 上画点

参数	描述
x	绘制像素的 x 坐标。
y	绘制像素的 y 坐标。

例子

当开始 :: hat events
[Draw one pixel at the center of the screen.]
在屏幕 (80) (50) 上画点

画线 #

画线块使用当前笔宽和笔颜色从第一个指定的屏幕坐标 (x1, y1) 到第二个指定的屏幕坐标 (x2, y2) 绘制一条线。

在屏幕 [0] [0] [159] [107] 上画线段

参数	描述
x1	线起点的 x 坐标（以像素为单位）。
y1	线起点的 y 坐标（以像素为单位）。
x2	线末端的 x 坐标（以像素为单位）。
y2	线末端的 y 坐标（以像素为单位）。

例子

当开始 :: hat events
[Draw a line from the top left to bottom right of the screen.]
在屏幕 (0) (0) (159) (107) 上画线段

替代文本

绘制矩形 #

绘制矩形块使用当前的画笔宽度、画笔颜色和填充颜色绘制一个矩形。

在屏幕 [0] [0] [10] [10] 上画矩形

参数	描述
x	矩形左上角的 x 坐标（以像素为单位）。
y	矩形左上角的 y 坐标（以像素为单位）。
宽度	矩形的宽度（以像素为单位）。
高度	矩形的高度（以像素为单位）。

例子

当开始 :: hat events
[Draw a rectangle on the screen.]
在屏幕 (25) (25) (100) (50) 上画矩形

替代文本

画圆 #

画圆块使用当前的笔宽、笔颜色和填充颜色绘制一个圆圈。

在屏幕 [0] [0] [10] 上画圆形

参数	描述
x	圆心的 x 坐标（以像素为单位）。
y	圆心的 y 坐标（以像素为单位）。
半径	圆的半径（以像素为单位）。

例子

当开始 :: hat events
[Draw a circle on the screen.]
在屏幕 (80) (50) (20) 上画圆形

替代文本