屏幕#

打印（）#

print(text, sep, precision) 方法使用当前光标位置在屏幕上打印文本。

参数

描述

文本

要打印的文本。

九月

**可选。**插入值之间的字符串。必须使用关键字参数 (sep=) 的形式。默认值为 ""。

精确

**可选。**打印简单数字时显示的小数位数。必须使用关键字参数 (precision=) 进行设置。默认值为 2。

**返回：**无。

# Print the number 1 on the Brain's screen at current
# cursor position.
brain.screen.print(1)

# Print the numbers 1, 2, 3 and 4 on the Brain's screen at
# current cursor position separated by a '-'.
brain.screen.print(1, 2, 3, 4, sep='-')

设置光标（）#

set_cursor(row, column) 方法设置光标位置。行距和列距会考虑所选字体。默认光标位置为第 1 行，第 1 列。

参数

描述

排

设置光标的行。

柱子

设置光标的列。

**返回：**无。

设置原点（）#

set_origin(x, y) 方法设置 Brain 屏幕上用于绘制图形的原点。绘图函数将 Brain 屏幕的左上角视为原点。此函数可以将原点移动到其他位置，例如 Brain 屏幕的中心。

参数

描述

x

原点相对于左上角的 x 位置。

y

原点相对于左上角的 y 位置。

**返回：**无。

设置字体（）#

set_font(fontname) 方法设置在 Brain 屏幕上打印文本所使用的字体类型。

参数

描述

字体名称

有效的 FontType。

**返回：**无。

# Set the font type to MONO40.
brain.screen.set_font(FontType.MONO40)

设置笔宽（）#

set_pen_width(width) 方法设置用于绘制线条、矩形和圆形的笔宽。

参数

描述

宽度

笔的宽度。

**返回：**无。

# Set the pen width to 5 pixels.
brain.screen.set_pen_width(5)

设置画笔颜色()#

set_pen_color(color) 方法设置用于绘制线条、矩形和圆形的画笔颜色。

参数

描述

颜色

有效的 ColorType、十六进制值或 Web 字符串。

**返回：**无。

# Set pen color red using a hex value.
brain.screen.set_pen_color(0xFF0000)

# Set pen color blue using predefined color.
brain.screen.set_pen_color(Color.BLUE)

# Set pen color green using web string.
brain.screen.set_pen_color("#00FF00")

设置填充颜色（）#

set_fill_color(color) 方法设置用于绘制矩形和圆形的填充颜色。

参数

描述

颜色

有效的 ColorType、十六进制值或 Web 字符串。

**返回：**无。

# Set pen color red using a hex value.
brain.screen.set_fill_color(0xFF0000)

# Set pen color blue using predefined color.
brain.screen.set_fill_color(Color.BLUE)

# Set pen color green using web string.
brain.screen.set_fill_color("#00FF00")

柱子（）#

column() 方法返回将打印文本的当前列。

**返回：**当前列位置。

排（）#

row() 方法返回将打印文本的当前行。

**返回：**当前行位置。

获取字符串宽度（）#

get_string_width(string) 方法获取字符串的宽度（以像素为单位），就像它在 Brain 屏幕上一样。字符串的宽度会根据字符串的长度和字体的大小而变化。

参数

描述

细绳

要测量的字符串。

**返回：**字符串的宽度（整数）。

获取字符串高度（）#

get_string_height(string) 方法获取字符串的高度（以像素为单位），就像它在 Brain 的屏幕上一样。字符串的高度会根据字符串的长度和字体的大小而变化。

这是一种非等待方法，允许下一个方法无延迟运行。

参数

描述

细绳

要测量的字符串。

**返回：**字符串的高度（整数）。

清除屏幕（）#

clear_screen(color) 方法将整个 Brain 的屏幕清除为单一颜色。

这是一种非等待方法，允许下一个方法无延迟运行。

参数

描述

颜色

**可选。**有效的 ColorType、十六进制值或 Web 字符串。

**返回：**无。

# Print VEXcode on the Brain's screen.
brain.screen.print("VEXcode")

# Clear screen to black.
brain.screen.clear_screen()

# Print VEXcode on the Brain's screen.
brain.screen.print("VEXcode")

# Clear screen to blue using predefined color.
brain.screen.clear_screen(Color.BLUE)

清除线（）#

clear_line() 方法清除一行文本。

**返回：**无。

清除行（）#

clear_row(row, color) 方法将一行清除为单一颜色。

参数

描述

排

**可选。**要清除的行。默认值为当前光标所在行。

颜色

**可选。**有效的 ColorType、十六进制值或 Web 字符串。

**返回：**无。

# Clear Brain's screen to black.
brain.screen.clear_row()

# Clear Brain's screen to blue using predefined color.
brain.screen.clear_row(2, Color.BLUE)

换行（）#

new_line() 方法将光标移动到新行。

**返回：**无。

下一行（）#

next_row() 方法将光标移动到下一行。

**返回：**无。

绘制像素（）#

draw_pixel(x, y) 方法使用当前笔颜色绘制一个像素。

参数

描述

x

绘制像素的 x 位置参考屏幕原点。

y

绘制像素的 y 位置参考屏幕原点。

**返回：**无。

# Draw a red pixel on the Brain's screen.
brain.screen.set_pen_color(Color.RED)
brain.screen.draw_pixel(10, 10)

绘制线（）#

draw_line(x1, y1, x2, y2) 方法使用当前笔颜色绘制一条线。

参数

描述

x1

线的起点相对于屏幕原点的 x 位置。

y1

线的起点相对于屏幕原点的 y 位置。

x2

线尾相对于屏幕原点的 x 位置。

y2

线末端相对于屏幕原点的 y 位置。

**返回：**无。

# Draw a red line on the Brain's screen.
brain.screen.set_pen_color(Color.RED)
brain.screen.draw_line(10, 10, 20, 20)

绘制矩形（）#

draw_rectangle(x, y, width, height) 方法使用当前的画笔和填充颜色在屏幕上绘制一个矩形。

参数

描述

x

矩形左上角相对于屏幕原点的 x 位置。

y

矩形左上角相对于屏幕原点的 y 位置。

宽度

矩形的宽度。

高度

矩形的高度。

颜色

可选。 有效的 ColorType、十六进制值或 Web 字符串。这是矩形的填充颜色。

**返回：**无。

# Draw a green rectangle on the screen that is filled using blue.
brain.screen.set_pen_color(Color.GREEN)
brain.screen.set_fill_color(Color.BLUE)
brain.screen.draw_rectangle(10, 10, 20, 20)

# Draw a green rectangle on the screen that is filled using red.
brain.screen.set_pen_color(Color.GREEN)
brain.screen.draw_rectangle(50, 50, 20, 20, Color.RED)

画圆（）#

draw_circle(x, y, radius, color) 方法使用当前的画笔和填充颜色绘制一个圆圈。

参数

描述

x

圆心相对于屏幕原点的 x 位置。

y

圆心相对于屏幕原点的 y 位置。

半径

圆的半径。

颜色

可选。 有效的 ColorType、十六进制值或 Web 字符串。这是圆圈的填充颜色。

**返回：**无。

# Draw a green circle on the Brain's screen that is filled using blue.
brain.screen.set_pen_color(Color.GREEN)
brain.screen.set_fill_color(Color.BLUE)
brain.screen.draw_circle(50, 50, 10)

# Draw a green circle on the Brain's screen that is filled using red.
brain.screen.set_pen_color(Color.GREEN)
brain.screen.draw_circle(100, 50, 10, Color.RED)

从文件绘制图像（）#

draw_image_from_file(filename, x, y) 方法从 SD 卡绘制图像。调用该方法时输入的文件名必须位于 SD 卡上。

参数

描述

文件名

图像的文件名。

x

屏幕上图像左上角的 x 坐标。

y

屏幕上图像左上角的 y 坐标。

**返回：**无。

# Draw the vex.bmp image on the Brain's screen at coordinate 0, 0.
brain.screen.draw_image_from_file('vex.bmp', 0, 0)

屏幕.渲染()#

render() 方法将绘图切换为双缓冲并渲染 Brain 的屏幕。一旦调用，后续绘图将不会出现在 Brain 的屏幕上，直到下次调用 render 时为止。

**返回：**如果缓冲区成功呈现到屏幕，则返回 True。

设置剪辑区域（）#

set_clip_region(x, y, width, height) 方法设置用于绘制所提供矩形的剪辑区域。

参数

描述

x

矩形左上角的 x 位置（参考屏幕原点）。

y

矩形左上角的 y 位置（参考屏幕原点）。

宽度

矩形的宽度。

高度

矩形的高度。

**返回：**无。

On this page