屏幕#
介绍#
The Screen blocks control how the VEX AIM Coding Robot shows text, numbers, and graphics on its screen, and how it responds to screen presses.
以下是所有模块的列表：
光标打印 — 使用行列光标系统管理文本显示。
在屏幕上打印 — 在屏幕上当前光标位置显示文本。
将光标设置到屏幕上的行列 — 将光标移动到指定的行和列。
将光标设置到屏幕上的下一行 — 将光标移动到下一行的第 1 列。
清除屏幕上的行 — 清除指定的一行文本。
screen cursor column — Reports the column number where text will be printed.
screen cursor row — Reports the row number where text will be printed.
XY 打印 — 按像素坐标打印文本。
在屏幕上的坐标处打印 — 在指定的 x 和 y 坐标处显示文本。
设置屏幕原点 — 更改绘图和打印使用的原点。
设置 — 自定义文本格式和屏幕显示。
清除屏幕 — 清除屏幕上的所有文字和图画。
填充屏幕 — 清除屏幕上的所有文字和图形，然后设置屏幕的背景颜色。
设置屏幕字体 — 更改文本显示的字体类型和大小。
set print precision on screen — Sets how many decimal places to show when printing numbers.
set pen width on screen — Sets the thickness of drawn lines and shape outlines.
set pen / font color on screen — Sets the color of text, pixels, lines, and shape outlines.
set fill color on screen — Sets the fill color for drawn shapes.
绘图——创建图形和视觉元素。
在屏幕上显示图像文件 — 在屏幕上显示用户上传的图像。
在屏幕上绘制像素 — 在指定坐标处绘制单个像素。
在屏幕上绘制线条 — 在两点之间绘制一条线。
在屏幕上绘制矩形 — 绘制一个具有指定尺寸的矩形。
在屏幕上绘制圆 — 绘制一个具有给定半径的圆。
触摸 — 检测屏幕交互。
screen pressed — Reports whether the screen is currently being pressed.
screen position — Reports the selected x or y coordinate of the last screen press.
when screen event — Runs attached blocks when the screen is pressed or released.
光标打印#
屏幕打印#
The print on screen stack block prints text, numbers, or variable values on the robot’s screen at the current cursor position and font.
print [VEXcode] on screen ▶
参数 |
描述 |
|---|---|
价值 |
要在屏幕上显示的文本、数字或变量值。 |
and set cursor to next row |
Select the arrow ( ▶ ) to expand the block to say and set cursor to next row, so the cursor moves to column 1 of the next row after printing. |
例子
when started
[Display a message at the starting cursor position.]
print [Hello, Robot!] on screen ▶
将光标设置到屏幕上的行列#
The set cursor to row column on screen stack block moves the cursor to a specific row and column on the robot’s 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.
Monospaced fonts have characters that are all the same width, making text placement consistent. In contrast, proportional fonts vary in character width, so some letters take up more space than others. However, regardless of which type is used, the set cursor to row column on screen stack block positions the cursor based on row and column size, not font style. The font size can be adjusted using the set font on screen stack block.
set cursor to row [1] column [1] on screen
参数 |
描述 |
|---|---|
排 |
The row to move the cursor to. |
柱子 |
The column to move the cursor to. |
示例
when started
[Display text starting at Row 3 Column 2.]
set cursor to row (3) column (2) on screen
print [Row 3, Column 2] on screen ▶
when started
[Display cargo amounts in an organized list.]
set font to [proportional v] [large v] on screen
print [Sports Balls] on screen ◀ and set cursor to next row
print [Orange Barrels] on screen ◀ and set cursor to next row
print [Blue Barrels] on screen ▶
set cursor to row [1] column [11] on screen
print [2] on screen ▶
set cursor to row [2] column [11] on screen
print [3] on screen ▶
set cursor to row [3] column [11] on screen
print [3] on screen ▶
when started
[Display the ID of the detected AprilTag.]
set font to [proportional v] [extra large v] on screen
forever
clear screen
print [AprilTag] on screen ▶
get [all AprilTags v] data from AI Vision
if <AI Vision object exists?> then
set cursor to row [3] column [4] on screen
print (AI Vision object [tagID v]) on screen ▶
结束
wait [0.1] seconds
将光标移至屏幕上的下一行#
The set cursor to next row on screen stack block moves the cursor to column 1 on the next row on the robot’s screen.
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 ▶
屏幕上的清除行#
The clear row on screen stack block clears a single row of text on the robot’s screen.
clear row [1] on screen
参数 |
描述 |
|---|---|
排 |
要清除的行号。 |
例子
when started
[Display text on two rows.]
print [This text stays] on screen ▶
set cursor to next row on screen
print [This text disappears] on screen ▶
wait [3] seconds
clear row [2] on screen
屏幕光标列#
The screen cursor column reporter block reports the column number where text will be printed as a whole number.
(screen cursor column)
参数 |
描述 |
|---|---|
该块没有参数。 |
例子
when started
[Display the cursor's current column.]
set cursor to row [3] column [2] on screen
print (screen cursor column) on screen ▶
屏幕光标行#
The screen cursor row reporter block reports the row number where text will be printed as a whole number.
(screen cursor row)
参数 |
描述 |
|---|---|
该块没有参数。 |
例子
when started
[Display the cursor's current row.]
set cursor to row [3] column [2] on screen
print (screen cursor row) on screen ▶
XY打印#
在屏幕上的坐标处打印#
The print at coordinate on screen stack block prints text, numbers, or variable values on the robot’s screen at a specified x and y coordinate in pixels with the currently set font.
By default, the origin is located at the top-left corner of the screen at (0, 0). On the x-axis, 0 is on the left side of the screen, and 240 is on the right side. On the y-axis, 0 is at the top of the screen, and 240 is at the bottom. You can use the set screen origin block to move the origin to a different location. When the origin is changed, the x- and y-coordinate ranges will also change.
For example, if the origin is set to (120, 120), the x and y range will be from -120 to 120 for the x and y coordinates.
Note: The red circle shows which coordinates will be visible on the AIM robot’s circular screen. Coordinates that fall outside the red circle exist within the 0–240 range but will not appear on the screen.
print [VEXcode] at x:[80] y:[120] on screen
参数 |
描述 |
|---|---|
价值 |
要在屏幕上显示的文本、数字或变量值。 |
x |
The x-coordinate in pixels, from 0 to 240 with the default origin. |
y |
The y-coordinate in pixels, from 0 to 240 with the default origin. |
例子
when started
[Display a message in the middle of the screen.]
print [Hello, Robot!] at x:[40] y:[120] on screen
设置屏幕原点#
The set screen origin stack block changes the origin (0, 0) used for drawing or printing on the robot’s screen. By default, the origin is the top-left corner of the screen. This block can reset the origin to an alternate (x, y) screen coordinate location.
set screen origin x:[0] y:[0]
参数 |
描述 |
|---|---|
x |
The x-coordinate in pixels to set as the new origin. |
y |
The y-coordinate in pixels to set as the new origin. |
例子
when started
[Set the origin to the center of the screen.]
set screen origin x:[120] y:[120]
[Draw a rectangle at the new origin.]
draw rectangle [0] [0] [80] [40] on screen
设置#
清除屏幕#
The clear screen stack block clears all drawings and text from the robot’s screen and resets the cursor position to row 1, column 1.
clear screen
参数 |
描述 |
|---|---|
该块没有参数。 |
例子
when started
[Draw a circle, and clear it after 2 seconds.]
draw circle [120] [120] [40] on screen
wait [2] seconds
clear screen
填满屏幕#
The fill screen stack block clears all drawings and text from the robot’s screen, then changes the background to a specified color.
fill screen with [red v]
参数 |
描述 |
|---|---|
颜色 |
The background color to use:
|
例子
when started
[Say "Hello" then turn screen yellow.]
print [Hello] on screen ▶
wait [2] seconds
fill screen with [yellow v]
设置屏幕上的字体#
The set font on screen stack block sets the font and size used for displaying text on the robot’s screen. This font will apply to all subsequently printed text.
set font to [monospaced v] [super small v] on screen
参数 |
描述 |
|---|---|
类型 |
The font type: monospaced or proportional |
尺寸 |
The font size (shown below):
|
|
与上一张图片相同，但字体为 Mono 15。字母 AT 占据一行文字。底部文字为 20 个字符宽，12 行。(/_static/img/fonts/mono15.png) |
与上一张图片相同，但字体为 Mono 20。字母 AP 占据一行文字。底部文字为 16 个字符宽，共 9 行。(/_static/img/fonts/mono20.png) |
|---|---|---|
与上一张图片相同，但字体为 Mono 24。字母 AM 占据一行文字。底部文字横向 13 个字符，共 8 行。(/_static/img/fonts/mono24.png) |
|
|
|
|
|
|
|
例子
when started
[Display text using a larger font]
set font to [monospaced v] [extra large v] on screen
print [VEX] on screen ▶
设置屏幕打印精度#
The set print precision on screen stack block sets how many decimal places to show when printing numbers on the robot’s screen. This print precision will apply to all subsequently printed numbers.
set print precision to [0.1 v] on screen
参数 |
描述 |
|---|---|
精确 |
The print precision to use:
|
例子
when started
[Print 1/3 as 0.33.]
set print precision to [0.01 v] on screen
print ([1] [math_division v] [3]) on screen ▶
设置屏幕上的笔宽#
The set pen width on screen stack block sets the thickness of drawn lines and shape outlines.
set pen width to [10] on screen
参数 |
描述 |
|---|---|
宽度 |
The pen width, in pixels, from 0 to 32. |
例子
when started
[Draw a rectangle with a pen width of 10.]
set pen width to [10] on screen
draw rectangle [50] [50] [130] [60] on screen
设置屏幕上的笔/字体颜色#
The set pen / font color on screen stack block sets the color of text, pixels, lines, and shape outlines.
set pen / font color to [red v] on screen
参数 |
描述 |
|---|---|
颜色 |
The pen and font color to use:
|
例子
when started
[Draw a rectangle with a red pen.]
set pen / font color to [red v] on screen
draw rectangle [50] [50] [130] [60] on screen
设置屏幕填充颜色#
The set fill color on screen stack block sets the fill color used when shapes are drawn.
set fill color to [red v] on screen
参数 |
描述 |
|---|---|
颜色 |
The fill color to use:
|
示例
when started
[Draw two orange rectangles.]
set fill color to [orange v] on screen
draw rectangle [50] [50] [100] [60] on screen
draw rectangle [50] [130] [100] [60] on screen
when started
[Display text with a purple background.]
set fill color to [purple v] on screen
print [Highlight] on screen ▶
画#
在屏幕上显示图像文件#
The show image file on screen stack block draws a custom user-uploaded image on the robot’s screen.
show image file [1 v]
参数 |
描述 |
|---|---|
图像槽号 |
要使用的自定义图像，编号 1 到 10。图像编号与 AIM 控制面板中显示的数字一致。 |
例子
when started
[Draw uploaded Image 1.]
show image file [1 v]
在屏幕上绘制像素#
The draw pixel on screen stack block draws one pixel at the selected x and y coordinate using the current pen color.
By default, the origin is located at the top-left corner of the screen at (0, 0). On the x-axis, 0 is on the left side of the screen, and 240 is on the right side. On the y-axis, 0 is at the top of the screen, and 240 is at the bottom. You can use the set screen origin block to move the origin to a different location. When the origin is changed, the x- and y-coordinate ranges will also change.
For example, if the origin is set to (120, 120), the x and y range will be from -120 to 120 for the x and y coordinates.
draw pixel [0] [0] on screen
参数 |
描述 |
|---|---|
x |
The x-coordinate to draw the pixel, from 0 to 240 with the default origin. |
y |
The y-coordinate to draw the pixel, from 0 to 240 with the default origin. |
例子
when started
[Draw a pixel at the center of the screen.]
draw pixel [120] [120] on screen
在屏幕上画线#
The draw line on screen stack block draws a line from the first screen coordinate (x1, y1) to the second screen coordinate (x2, y2) using the current pen width and pen color.
By default, the origin is located at the top-left corner of the screen at (0, 0). On the x-axis, 0 is on the left side of the screen, and 240 is on the right side. On the y-axis, 0 is at the top of the screen, and 240 is at the bottom. You can use the set screen origin block to move the origin to a different location. When the origin is changed, the x- and y-coordinate ranges will also change.
For example, if the origin is set to (120, 120), the x and y range will be from -120 to 120 for the x and y coordinates.
draw line [0] [0] [10] [10] on screen
参数 |
描述 |
|---|---|
x1 |
The x-coordinate in pixels of the start of the line, from 0 to 240 with the default origin. |
y1 |
The y-coordinate in pixels of the start of the line, from 0 to 240 with the default origin. |
x2 |
The x-coordinate in pixels of the end of the line, from 0 to 240 with the default origin. |
y2 |
The y-coordinate in pixels of the end of the line, from 0 to 240 with the default origin. |
例子
when started
[Draw a line from the top left to bottom right of the screen.]
draw line [0] [0] [240] [240] on screen
在屏幕上绘制矩形#
The draw rectangle on screen stack block draws a rectangle using the current pen width, pen color, and fill color.
By default, the origin is located at the top-left corner of the screen at (0, 0). On the x-axis, 0 is on the left side of the screen, and 240 is on the right side. On the y-axis, 0 is at the top of the screen, and 240 is at the bottom. You can use the set screen origin block to move the origin to a different location. When the origin is changed, the x- and y-coordinate ranges will also change.
For example, if the origin is set to (120, 120), the x and y range will be from -120 to 120 for the x and y coordinates.
draw rectangle [0] [0] [10] [10] on screen
参数 |
描述 |
|---|---|
x |
The x-coordinate in pixels of the top-left corner of the rectangle, from 0 to 240 with the default origin. |
y |
The y-coordinate in pixels of the top-left corner of the rectangle, from 0 to 240 with the default origin. |
宽度 |
矩形的宽度（以像素为单位）。 |
高度 |
矩形的高度（以像素为单位）。 |
例子
when started
[Draw a rectangle on the screen.]
draw rectangle [50] [50] [130] [60] on screen
在屏幕上画一个圆#
The draw circle on screen stack block draws a circle using the current pen width, pen color, and fill color.
By default, the origin is located at the top-left corner of the screen at (0, 0). On the x-axis, 0 is on the left side of the screen, and 240 is on the right side. On the y-axis, 0 is at the top of the screen, and 240 is at the bottom. You can use the set screen origin block to move the origin to a different location. When the origin is changed, the x- and y-coordinate ranges will also change.
For example, if the origin is set to (120, 120), the x and y range will be from -120 to 120 for the x and y coordinates.
draw circle [0] [0] [10] on screen
参数 |
描述 |
|---|---|
x |
The x-coordinate in pixels of the center of the circle, from 0 to 240 with the default origin. |
y |
The y-coordinate in pixels of the center of the circle, from 0 to 240 with the default origin. |
半径 |
圆的半径（以像素为单位）。 |
例子
when started
[Draw a circle on the screen.]
draw circle [120] [120] [40] on screen
触碰#
screen pressed#
The screen pressed Boolean block reports whether the robot’s screen is currently being pressed.
True — The screen is being pressed.
False — The screen is not being pressed.
<screen pressed?>
参数 |
描述 |
|---|---|
该块没有参数。 |
例子
when started
[Turn LEDs white only when the screen is pressed.]
forever
if <screen pressed?> then
set [lightall v] LED color to [white v]
else
set [lightall v] LED color to [off v]
结束
结束
屏幕位置#
The screen position reporter block reports the selected coordinate of the last screen press. The x-coordinate is from 0 (left) to 240 (right). The y-coordinate is from 0 (top) to 240 (bottom).
(screen [x v] position)
参数 |
描述 |
|---|---|
协调 |
The coordinate of the last screen press to report: x reports the horizontal position, and y reports the vertical position. |
例子
when started
[Display the x and y coordinate of where the screen is pressed.]
forever
if <screen pressed?> then
clear screen
print (screen [x v] position) on screen ▶
set cursor to next row on screen
print (screen [y v] position) on screen ▶
结束
结束
当屏幕事件#
The when screen event hat block runs the attached stack of blocks when the robot’s screen is pressed or released.
when screen [pressed v]
参数 |
描述 |
|---|---|
行动 |
When to run the attached stack of blocks: pressed runs when the screen is pressed, and released runs when the screen is released. |
例子
when screen [pressed v]
[Set the LEDs to green when the screen is pressed.]
set [lightall v] LED color to [green v]