屏幕

介绍

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

大脑的绘图分辨率为 160 x 108 像素。

以下是所有模块的列表：

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

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

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

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

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

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

• cursor row — 报告将要打印文本的行号。

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

• 清除屏幕 — 清除整个屏幕。

• 设置屏幕上的字体 — 设置打印文本的字体样式和大小。

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

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

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

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

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

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

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

• 在屏幕上绘制矩形 — 绘制一个矩形。

• 在屏幕上绘制圆形 — 绘制一个圆形。

打印

屏幕打印

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

print [VEXcode] on screen ▶

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

例子

when started
[Display a message at the starting cursor position.]
print [Hello, Robot!] on screen ◀ and set cursor to next row

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

“将光标设置到屏幕上的行和列”堆栈块会将光标移动到 Brain 屏幕上的特定行和列。下一个“在屏幕上打印”块将从#print-on-screen位置开始打印。可容纳的行数和列数取决于所选字体。

等宽字体的所有字符宽度相同，因此文本位置保持一致。相比之下，比例字体的字符宽度各不相同，因此有些字母占用的空间比其他字母大。但是，无论使用哪种字体，set cursor to row column on screen 堆栈块都会根据行和列的大小（而不是字体样式）来定位光标。可以使用 set font on screen 堆栈块来调整字体大小。

设置游标堆栈块

set cursor to row [1] column [1] on screen

参数	描述
排	要将光标移动到的行号（取整数）。
柱子	要将光标移动到的列（取整数）。

例子

when started
[Repeatedly print the current timer at Row 1 Column 1]
forever
print (timer in seconds) on screen ◀ and set cursor to next row
wait (1) seconds
clear screen
set cursor to row (1) column (1) on screen

将光标移至屏幕上的下一行

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

set cursor to next row on screen

参数	描述
	此代码块没有参数。

例子

when started
[Display two lines of text.]
print [Line 1] on screen ▶
set cursor to next row on screen
print [Line 2] on screen ◀ and set cursor to next row

屏幕上的清除行

清除屏幕上的行堆栈块清除大脑屏幕上的一行文本。

clear row (1) on screen

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

例子

when started
[Display text on two rows, but only keep one.]
print [This text stays] on screen ◀ and set cursor to next row
print [This disappears] on screen ◀ and set cursor to next row
wait (3) seconds
clear row (2) on screen

光标列

光标列 报告块会以整数形式报告文本将要打印的列号。

光标列报告块

(cursor column)

参数	描述
	此代码块没有参数。

例子

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

when started
[Display the cursor's current column.]
set cursor to row [3] column [2] on screen
print (cursor column) on screen ▶

光标行

光标行报告块会以整数形式报告文本将要打印的行号。

游标行报告块

(cursor row)

参数	描述
	此代码块没有参数。

例子

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

when started
[Display the cursor's current row.]
set cursor to row [3] column [2] on screen
print (cursor row) on screen ▶

设置

清除屏幕

清除屏幕堆栈块会清除大脑屏幕上的所有文本和图形。

clear screen

参数	描述
	此代码块没有参数。

例子

when started
[Fill the screen, then clear it after 2 seconds.]
repeat (5)
print [Line] on screen ◀ and set cursor to next row
结束
wait (3) seconds
clear screen

设置屏幕上的字体

“设置屏幕字体”堆栈块用于设置大脑屏幕上显示的文本的字体和大小。此字体将应用于之后打印的所有文本。

set font to [monospaced v] [medium v] on screen

参数	描述
字体	字体选择：等宽字体或比例字体
尺寸	尺码说明： 特小号 小号 中号 大号 特大号 超大号

Mono Extra Small	Mono Small	Mono Medium
Mono Large	Mono Extra Large	Mono Super Large
Prop Medium	Prop Large	Prop 特大号
超大号提案

例子

when started
[Display two different fonts on separate lines.]
set font to [monospaced v] [medium v] on screen
print [Mono Medium] on screen ◀ and set cursor to next row
set font to [proportional v] [medium v] on screen
print [Prop Medium] on screen ◀ and set cursor to next row

设置屏幕打印精度

设置屏幕打印精度 堆栈块用于设置 Brain 屏幕上打印数字时显示的小数位数。此打印精度将应用于之后打印的所有数字。

set print precision to [0.1 v] on screen

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

例子

when started
[Print 1/3 as 0.33.]
set print precision to [0.01 v] on screen
print ([1] / [3]) on screen ◀ and set cursor to next row

设置屏幕上的笔宽

设置屏幕上的笔宽 堆栈块用于设置绘制线条和形状轮廓的粗细。

set pen width to [10] on screen

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

例子

when started
[Draw two circles with different pen widths.]
draw circle (40) (70) (20) on screen
set pen width to (5) on screen
draw circle (100) (70) (20) on screen

设置屏幕上的笔/字体颜色

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

set pen / font color to [red v] on screen

参数	描述
颜色	要使用的笔和字体颜色： 红色 绿色 蓝色 白色 黄色 橙色 紫色 红紫色 紫色 蓝紫色 蓝绿色 黄绿色 黄橙色 红橙色

例子

when started
[Draw two rectangles with different colors.]
draw rectangle (100) (50) (10) (20) on screen
set pen / font color to [blue v] on screen
draw rectangle (50) (50) (10) (20) on screen

设置屏幕填充颜色

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

set fill color to [red v] on screen

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

例子

when started
[Draw a yellow circle.]
set fill color to [yellow v] on screen
draw circle (50) (50) (20) on screen

画

在屏幕上绘制像素

在屏幕上绘制像素堆栈块使用当前的画笔颜色在选定的x和y坐标处绘制一个像素。

draw pixel [0] [0] on screen

参数	描述
x	绘制像素的 x 坐标，范围从 0 到 159。
y	绘制像素的 y 坐标，范围从 0 到 107。

例子

when started
[Draw one pixel at the center of the screen.]
draw pixel (80) (50) on screen

在屏幕上画线

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

draw line [0] [0] [159] [107] on screen

参数	描述
x1	行首的 x 坐标（以像素为单位），范围从 0 到 159。
y1	行首的 y 坐标（以像素为单位），范围从 0 到 107。
x2	行尾的 x 坐标（像素），范围从 0 到 159。
y2	行尾的 y 坐标（以像素为单位），范围从 0 到 107。

例子

when started
[Draw a line from the top left to bottom right of the screen.]
draw line (0) (0) (159) (107) on screen

在屏幕上绘制矩形

在屏幕上绘制矩形堆栈块使用当前的画笔宽度、画笔颜色和填充颜色绘制矩形。

draw rectangle [0] [0] [10] [10] on screen

参数	描述
x	矩形左上角的 x 坐标（以像素为单位），范围从 0 到 159。
y	矩形左上角的 y 坐标（以像素为单位），范围从 0 到 107。
宽度	矩形的宽度（以像素为单位）。
高度	矩形的高度（以像素为单位）。

例子

when started
[Draw a rectangle on the screen.]
draw rectangle (25) (25) (100) (50) on screen

在屏幕上画一个圆

在屏幕上绘制圆形堆栈块使用当前的画笔宽度、画笔颜色和填充颜色绘制圆形。

draw circle [0] [0] [10] on screen

参数	描述
x	圆心的 x 坐标（以像素为单位），范围从 0 到 159。
y	圆心的 y 坐标（以像素为单位），范围从 0 到 107。
半径	圆的半径（以像素为单位）。

例子

when started
[Draw a circle on the screen.]
draw circle (80) (50) (20) on screen