屏幕#

介绍#

The screen class is derived from the brain base class. It controls how the IQ (2nd gen) Brain shows text, numbers, and graphics on its built-in screen.

默认情况下，打印到大脑的字体是等宽小号。

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

使用权#

The screen class can be accessed by:

Brain.Screen

笔记#

The screen object is provided by the Brain. It is not constructed directly.
Projects use a single global Brain object, so screen functions are called using Brain.Screen.

例子#

/* This constructor is required when using VS Code.
A Brain is generated automatically at the start of
VEXcode projects. */

// Create the Brain
brain Brain = brain();

// Print text to the Brain screen
Brain.Screen.print("Hello!");

成员功能#

The screen class includes the following member functions:

print — Prints formatted text, numbers, or Boolean values to the Brain screen.
setCursor — Moves the text cursor to a specified row and column.
newLine — Clears the remainder of the current line and moves the cursor to the next line.
clearLine — Clears the remainder of the current line or clears a specified line.
row — Returns the row where text will be printed.
column — Returns the column where text will be printed.
getStringHeight — Returns the height of a string in pixels using the current font.
getStringWidth — Returns the width of a string in pixels using the current font.
printAt — Prints formatted text at an x, y pixel location (optionally opaque).
clearScreen — Clears the entire screen (optionally to a specified color).
setFont — Sets the font used for printing on the screen.
setPenWidth — Sets the thickness of drawn lines and shape outlines.
setPenColor — Sets the color of text, pixels, lines, and shape outlines.
setFillColor — Sets the fill color for drawn shapes and printed text backgrounds.
setOrigin — Sets the origin used for screen coordinates.
setClipRegion — Restricts screen output to a rectangular region.
drawPixel — Draws one pixel at a coordinate.
drawLine — Draws a line between two points.
drawRectangle — Draws a rectangle at an x, y location with a specified size.
drawCircle — Draws a circle at an x, y location with a specified radius.
drawImageFromFile — Draws an image from an SD card file onto the screen.
render — Enables double buffering or renders the back buffer to the screen.
pressing — Returns whether the screen is currently being pressed.
xPosition — Returns the x-coordinate of the most recent screen press.
yPosition — Returns the y-coordinate of the most recent screen press.
pressed — Registers a callback function to run when the screen is pressed.
released — Registers a callback function to run when the screen is released after being pressed.

Before calling any screen member functions, a brain instance must be created, as shown below:

// Create the Brain
brain Brain = brain();

打印#

在 IQ（第二代）大脑屏幕上显示文本、数字或布尔值。

Available Functions

1 — 使用字符串字面量或只读 C 风格字符串打印格式化文本。
void print(
    const char* format,
    ... );

2 — 使用可修改的字符数组打印格式化文本。
void print(
    char* format,
    ... );

Parameters

范围	类型	描述
`format`	`const char*`	A format string provided as a string literal or read-only C-style string (for example, `“Score: %d”`).
`format`	`char*`	以可修改字符数组形式提供的格式字符串。
`…`		插入到格式字符串中的一个或多个附加值，以逗号分隔。

Return Values

此函数不返回值。

Notes

输出从屏幕上的当前光标位置开始。

打印文本使用屏幕字体。
打印文本使用笔颜色。
Text printed with print is always printed with a background, and the background color is determined by the current fill color.
使用格式字符串时，传递的值的数量和类型必须与字符串中的格式说明符匹配。

Examples

// Display a message at the starting cursor
Brain.Screen.print("Hello, Robot!");

IQ（第二代）大脑的屏幕截图，显示屏幕左上角以白色文字打印着“Hello, Robot!”。

设置光标#

Moves the cursor to a specific row and column on the IQ (2nd gen) Brain screen. The next print call will start printing at that location.

Available Functions

void setCursor(
  int32_t row, 
  int32_t col );

Parameters

范围	类型	描述
`row`	`int32_t`	要将光标移动到的行。
`col`	`int32_t`	要将光标移动到的列。

Return Values

此函数不返回值。

Notes

Affects where subsequent text output begins when using print.
行和列基于当前设置的屏幕字体。
The default font (mono20) uses 5 rows and 16 columns.
Calling setCursor affects the position of subsequent text output only.

Examples

int main() {
  // Initializing Robot Configuration. DO NOT REMOVE!
  vexcodeInit();

  // Repeatedly print the Brain timer at top-left
  while (true) {
    Brain.Screen.print("%d", Brain.Timer.time(seconds));
    Brain.Screen.newLine();
    wait(1, seconds);
    Brain.Screen.clearScreen();
    Brain.Screen.setCursor(1, 1);
  }
}

IQ（第二代）大脑的屏幕截图，显示屏幕左上角打印着数字 25。

换行符#

将光标移动到大脑屏幕上下一行的开头。

Available Functions

void newLine();

Parameters

此函数不接受任何参数。

Return Values

此函数不返回值。

Notes

If the cursor is in the middle of a sentence, newLine will clear the rest of the row after the cursor before moving to the next row.
After calling newLine, the cursor is positioned at the first column of the next line.
The cursor position and row numbering are set using setCursor.

Examples

// Display two lines of text
Brain.Screen.print("Line 1");
Brain.Screen.newLine();
Brain.Screen.print("Line 2");

IQ（第二代）大脑屏幕的截图，左上角显示两行白色文字。上面一行是“第 1 行”，紧挨着它的第二行是“第 2 行”。

清晰线#

清除 IQ（第二代）大脑屏幕上某一行的文本。

Available Functions

1 — 清除光标位置的当前行剩余内容。
void clearLine();

2 — 使用当前配置的填充颜色清除指定的行。
void clearLine(
    int number );

3 — 使用预定义或自定义颜色对象清除指定的行。
void clearLine(
    int          number,
    const color& color );

4 — 使用十六进制颜色值清除指定的行。
void clearLine(
    int         number,
    const char* color );

5 — 使用色调值清除指定的行。
void clearLine(
    int number,
    int hue );

Parameters

范围	类型	描述
`number`	`int`	The row number to clear. Row numbering starts at `1`.
`color`	`const color&`	Clears the row using a `color` object. Predefined colors include: `black` `white` `red` `green` `blue` `yellow` `orange` `purple` `cyan` `transparent` This can also use a custom color object.
`color`	`const char*`	Clears the row using a hexadecimal color value (for example, `“#000000”`).
`hue`	`int`	Clears the row using an integer hue value in the range `0`–`359`, representing degrees around a color wheel.

Return Values

此函数不返回值。

Notes

清除一行不会改变当前光标位置。
The cursor position and row numbering are set using setCursor.
The hue parameter value is based on a circular color wheel, as shown below, where values represent degrees around the wheel (for example, red near 0°, green near 120°, and blue near 240°).

一个色轮，显示从 0 到 359 的颜色范围，其中红色为 0，绿色为 120，蓝色为 240。

Examples

// Display text on two rows
Brain.Screen.print("This text stays");
Brain.Screen.newLine();
Brain.Screen.print("This disappears");

// Wait 3 seconds before clearing row 2
wait(3, seconds);
Brain.Screen.clearLine(2);

排#

返回 IQ（第二代）Brain 屏幕上将打印文本的行。

Available Functions

int32_t row();

Parameters

此函数不接受任何参数。

Return Values

Returns an int32_t representing the row where text will be printed.

行号从1开始。

Notes

光标位置基于屏幕字体。
返回值指示下一个打印输出将显示在哪里。
The row value changes when text is printed or when setCursor is called.

Examples

// Display the cursor's current row
Brain.Screen.setCursor(3, 12);
Brain.Screen.print("row: ", Brain.Screen.row());

IQ（第二代）大脑屏幕的屏幕截图，显示屏幕左侧第 3 行第 12 列位置的白色文本“第 3 行”。

柱子#

返回 IQ（第二代）大脑屏幕上将打印文本的列。

Available Functions

int32_t column();

Parameters

此函数不接受任何参数。

Return Values

Returns an int32_t representing the column where text will be printed.

列编号从 1 开始。

Notes

光标位置基于屏幕字体。
返回值指示下一个打印输出将显示在哪里。
The column value changes when text is printed or when setCursor is called.

Examples

// Display the cursor's current column
Brain.Screen.print("column: ", Brain.Screen.column());

IQ（第二代）大脑屏幕的屏幕截图，显示屏幕顶部第 1 行第 9 列的白色数字：9。

获取字符串高度#

返回字符串在 IQ（第二代）Brain 屏幕上渲染时的高度（以像素为单位）。

Available Functions

int32_t getStringHeight( 
    const char* cstr );

Parameters

范围	类型	描述
`cstr`	`const char*`	The text to be measured, provided as a C-style string (for example, `“Hello”`).

Return Values

Returns an int32_t representing the height of the string in pixels when rendered on the Brain screen.

Notes

返回的高度取决于当前选定的屏幕。
该函数测量字符串的长度，但不将其绘制到屏幕上。
返回的高度反映了字符串打印时的外观。

获取字符串宽度#

返回字符串在 IQ（第二代）Brain 屏幕上渲染时的宽度（以像素为单位）。

Available Functions

int32_t getStringWidth( 
    const char* cstr );

Parameters

范围	类型	描述
`cstr`	`const char*`	The text to be measured, provided as a C-style string (for example, `“Hello”`).

Return Values

Returns an int32_t representing the width of the string in pixels when rendered on the Brain screen.

Notes

返回的取决于当前选定的屏幕字体。
该函数测量字符串的长度，但不将其绘制到屏幕上。
返回的宽度反映了字符串打印时的显示方式。

printAt#

在 IQ（第二代）大脑屏幕上的特定坐标处打印文本、数字或布尔值。

Available Functions

1 — 在指定的像素位置打印格式化的输出。
void printAt(
    int32_t    x,
    int32_t    y,
    const char* format,
    ... );

2 — 在指定的像素位置打印格式化的输出，并设置文本背景是不透明还是透明。
void printAt(
    int32_t    x,
    int32_t    y,
    bool       bOpaque,
    const char* format,
    ... );

Parameters

范围	类型	描述
`x`	`int32_t`	打印位置的 x 坐标，以屏幕原点为参考。
`y`	`int32_t`	打印位置的 y 坐标，以屏幕原点为参考。
`bOpaque`	`bool`	Controls whether the printed text is drawn opaquely or transparently: `true` — The background of the printed text is filled using the current fill color. `false` — The text is drawn transparently and the background is not filled.
`format`	`const char*`	A format string that controls what is printed on the screen (for example, `“Score: %d”`).
`…`		插入到格式字符串中的一个或多个附加值，以逗号分隔。

Return Values

此函数不返回值。

Notes

The x and y coordinates are relative to the current screen origin, which can be changed using setOrigin.
打印文本使用屏幕字体。
打印文本使用笔颜色。
使用格式字符串时，传递的值的数量和类型必须与字符串中的格式说明符匹配。

Examples

// Print the number 1 at pixel (100, 40)
Brain.Screen.printAt(100, 40, 1);

IQ（第二代）大脑屏幕的截图，白色文字显示为 1，打印位置为 (100, 40)。

清屏#

清除大脑屏幕上的所有图画和文字。

Available Functions

1 — 将屏幕清空至黑色。
void clearScreen();

2 — 使用预定义或自定义颜色对象清除屏幕。
void clearScreen(
    const color& color );

3 — 使用十六进制颜色值清除屏幕。
void clearScreen(
    const char* color );

4 — 使用色调值清除屏幕。
void clearScreen(
    int hue );

Parameters

范围	类型	描述
`color`	`const color&`	Clears the screen using a `color` object. Predefined colors include: `black` `white` `red` `green` `blue` `yellow` `orange` `purple` `cyan` `transparent` This can also use a custom color object.
`color`	`const char`	Clears the screen using a hexadecimal color value represented as a string (for example, `“#000000”`).
`hue`	`int`	Clears the screen using an integer hue value in the range `0`–`359`, representing degrees around a color wheel.

范围

类型

描述

color

const color&

Clears the screen using a color object. Predefined colors include:

black
white
red
green
blue
yellow
orange
purple
cyan
transparent

This can also use a custom color object.

color

const char

Clears the screen using a hexadecimal color value represented as a string (for example, “#000000”).

hue

int

Clears the screen using an integer hue value in the range 0–359, representing degrees around a color wheel.

Return Values

此函数不返回值。

Notes

The hue parameter value is based on a circular color wheel, as shown below, where values represent degrees around the wheel (for example, red near 0°, green near 120°, and blue near 240°).

一个色轮，显示从 0 到 359 的颜色范围，其中红色为 0，绿色为 120，蓝色为 240。

Examples

// Clear screen after 2 seconds
Brain.Screen.print("VEXcode");
wait(2, seconds);
Brain.Screen.clearScreen();

// Clear screen to blue after 2 seconds
Brain.Screen.print("VEXcode");
wait(2, seconds);
Brain.Screen.clearScreen(red);

IQ（第二代）大脑屏幕的截图，其中整个可打印区域呈亮红色。

设置字体#

设置 IQ（第二代）大脑屏幕上显示的文本所用的字体。

This controls the font applied to subsequent text output when using screen text functions such as print.

Available Functions

void setFont(
  fontType font );

Parameters

范围	类型	描述
`font`	`fontType`	Sets the font to one of the following: `mono12` `mono15` `mono20` `mono30` `mono40` `mono60` `prop20` `prop30` `prop40` `prop60` These options are shown below.

范围

类型

描述

font

fontType

Sets the font to one of the following:

mono12
mono15
mono20
mono30
mono40
mono60
prop20
prop30
prop40
prop60

These options are shown below.

`mono12`	`mono15`	`mono20`
`mono30`	`mono40`	`mono60`
`prop20`	`prop30`	`prop40`
`prop60`

Return Values

此函数不返回值。

Examples

// Display two different fonts on
// two separate lines
Brain.Screen.setFont(mono20);
Brain.Screen.print("Mono Medium");
Brain.Screen.newLine();
Brain.Screen.setFont(prop20);
Brain.Screen.print("Prop Medium");

IQ Brain 屏幕截图，左上角有两行白色文字。第一行是 Mono Medium，紧随其后的第二行字体较小，是 Prop Medium。

设置笔宽#

设置绘制线条和形状轮廓的粗细。

Available Functions

void setPenWidth(
  uint32_t width );

Parameters

范围	类型	描述
`width`	`uint32_t`	笔的宽度，以像素为单位，范围从 0 到 32。

Return Values

此函数不返回值。

Notes

The pen width applies to drawing functions such as drawLine, drawRectangle, and drawCircle.

Examples

// Draw a circle with a pen width of 5
Brain.Screen.drawCircle(40, 70, 20);
Brain.Screen.setPenWidth(5);
Brain.Screen.drawCircle(100, 70, 20);

IQ Brain 屏幕的截图，屏幕下半部分印有两个白色圆圈。左边的圆圈比右边的圆圈边框更窄。

设置画笔颜色#

设置文本、像素、线条和形状轮廓的颜色。

Available Functions

1 — 使用预定义或自定义颜色对象设置画笔颜色。
void setPenColor(
    const color& color );

2 — 使用十六进制颜色值设置画笔颜色。
void setPenColor(
    const char* color );

3 — 使用色调值设置画笔颜色。
void setPenColor(
    int hue );

Parameters

范围	类型	描述
`color`	`const color&`	Sets the pen color using a `color` object. Predefined colors include: `black` `white` `red` `green` `blue` `yellow` `orange` `purple` `cyan` `transparent`
`color`	`const char*`	Sets the pen color using a hexadecimal color value represented as a string (for example, `“#FF0000”`).
`hue`	`int`	Sets the pen color using an integer hue value in the range `0`–`359`, representing degrees around a color wheel (for example, `0` is red, `120` is green, and `240` is blue).

范围

类型

描述

color

const color&

Sets the pen color using a color object. Predefined colors include:

black
white
red
green
blue
yellow
orange
purple
cyan
transparent

color

const char*

Sets the pen color using a hexadecimal color value represented as a string (for example, “#FF0000”).

hue

int

Sets the pen color using an integer hue value in the range 0–359, representing degrees around a color wheel (for example, 0 is red, 120 is green, and 240 is blue).

Return Values

此函数不返回值。

Notes

The default pen color at the start of a project is white.
The pen color is used for outlines of shapes (such as with drawCircle or drawRectangle), text and numeric output (with print and printAt), and individual pixels drawn with drawPixel.
The hue parameter value is based on a circular color wheel, as shown below, where values represent degrees around the wheel (for example, red near 0°, green near 120°, and blue near 240°).

一个色轮，显示从 0 到 359 的颜色范围，其中红色为 0，绿色为 120，蓝色为 240。

Examples

Brain.Screen.drawRectangle(100, 50, 10, 20);
Brain.Screen.setPenColor(blue);
Brain.Screen.drawRectangle(50, 50, 10, 20);

IQ Brain 屏幕的截图，屏幕下半部分画有两个小矩形。左边的矩形是蓝色的，右边的矩形是白色的。

设置填充颜色#

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

Available Functions

1 — 使用预定义或自定义颜色对象设置填充颜色。
void setFillColor(
    const color& color );

2 — 使用十六进制颜色值设置填充颜色。
void setFillColor(
    const char* color );

3 — 使用色调值设置填充颜色。
void setFillColor(
    int hue );

Parameters

范围	类型	描述
`color`	`const color&`	Sets the fill color using a `color` object. Predefined colors include: `black` `white` `red` `green` `blue` `yellow` `orange` `purple` `cyan` `transparent`
`color`	`const char`	Sets the fill color using a hexadecimal color value represented as a string (for example, `“#00FF00”`).
`hue`	`int`	Sets the fill color using an integer hue value in the range `0`–`359`, representing degrees around a color wheel (for example, `0` is red, `120` is green, and `240` is blue).

范围

类型

描述

color

const color&

Sets the fill color using a color object. Predefined colors include:

black
white
red
green
blue
yellow
orange
purple
cyan
transparent

color

const char

Sets the fill color using a hexadecimal color value represented as a string (for example, “#00FF00”).

hue

int

Sets the fill color using an integer hue value in the range 0–359, representing degrees around a color wheel (for example, 0 is red, 120 is green, and 240 is blue).

Return Values

此函数不返回值。

Notes

The default fill color at the start of a project is black.
The fill color is used for interior of shapes (such as with drawCircle or drawRectangle).
The fill color is used as the background color for printed text (such as with print and printAt).
- If transparent is used with printed text, the background will be black.
The hue parameter value is based on a circular color wheel, as shown below, where values represent degrees around the wheel (for example, red near 0°, green near 120°, and blue near 240°).

一个色轮，显示从 0 到 359 的颜色范围，其中红色为 0，绿色为 120，蓝色为 240。

Examples

// Draw a circle filled with yellow
Brain.Screen.setFillColor(yellow);
Brain.Screen.drawCircle(50, 50, 20);

IQ Brain 屏幕的截图，屏幕左半部分画着一个亮黄色圆圈，圆圈边缘有细细的白色边框。

设置原点#

设置大脑屏幕上用于绘图和基于坐标的打印的原点。

Available Functions

void setOrigin(
  int32_t x,
  int32_t y );

Parameters

范围	类型	描述
`x`	`int32_t`	原点相对于大脑屏幕左上角的 x 坐标，取值范围为 0 到 159。
`y`	`int32_t`	原点相对于大脑屏幕左上角的 y 坐标，取值范围为 0 到 107。

Return Values

此函数不返回值。

Notes

默认原点位于屏幕左上角坐标 (0, 0)。
The origin applies to coordinate functions such as drawLine, drawRectangle, drawCircle, and printAt.
该原点设置将一直有效，直到再次更改或项目重置为止。

设置剪辑区域#

在屏幕上定义一个矩形区域，所有图形和文本都将限制在该区域内。该区域之外的任何内容都不会显示。

Available Functions

void setClipRegion(
  int x,
  int y,
  int width,
  int height );

Parameters

范围	类型	描述
`x`	`int`	剪辑区域左上角的 x 坐标，取值范围为 0 到 159 的整数。
`y`	`int`	剪辑区域左上角的 y 坐标，取值范围为 0 到 107 的整数。
`width`	`int`	裁剪区域的宽度（以像素为单位），取值范围为 0 到 159 的整数。
`height`	`int`	裁剪区域的高度（以像素为单位），取值范围为 0 到 107 的整数。

Return Values

此函数不返回值。

Notes

即使绘图函数超出裁剪区域，它们仍然会执行，但只有区域内的部分是可见的。
The x and y coordinates are relative to the current screen origin, which can be changed using setOrigin.
剪辑区域仅适用于当前线程。
设置新的剪辑区域会替换当前线程之前设置的任何剪辑区域。

Examples

// Restrict text and drawings to a specific region
Brain.Screen.setClipRegion(0, 0, 120, 120);
Brain.Screen.drawRectangle(60, 60, 100, 100, red);
Brain.Screen.printAt(60, 60, "Cut off!");

IQ（第二代）大脑屏幕的截图，白色文字显示“Cut of”，左上角象限下方有一个实心红色方块，反映了剪辑区域内打印的内容。

drawPixel#

在 IQ（第二代）大脑屏幕上选定的 x 和 y 像素位置绘制一个像素。

Available Functions

void drawPixel(
  int x,
  int y );

Parameters

范围	类型	描述
`x`	`int`	像素绘制位置的 x 坐标，取值范围为 0 到 159 之间的整数。
`y`	`int`	像素绘制位置的 y 坐标，取值范围为 0 到 107 之间的整数。

Return Values

此函数不返回值。

Notes

Pixels are drawn using the current pen color set with setPenColor.
The x and y coordinates are relative to the current screen origin, which can be set using setOrigin.
如果指定的像素位置在屏幕边界之外，则不会绘制该像素。

Examples

// Draw one pixel at the center 
// of the screen
Brain.Screen.drawPixel(80, 50);

IQ Brain 屏幕的截图，屏幕中央有一个小白点。

画线#

在 IQ（第二代）脑力测试屏幕上，画一条直线连接两点。

Available Functions

void drawLine(
  int x1,
  int y1,
  int x2,
  int y2 );

Parameters

范围	类型	描述
`x1`	`int`	直线的起始 x 坐标，取值范围为 0 到 159 的整数。
`y1`	`int`	直线的起始 y 坐标，取值范围为 0 到 107 的整数。
`x2`	`int`	直线的终点 x 坐标，取值范围为 0 到 159 的整数。
`y2`	`int`	直线的终点 y 坐标，取值范围为 0 到 107 的整数。

Return Values

此函数不返回值。

Notes

Lines are drawn using the current pen color set with setPenColor.
The width of the line is determined by the current pen width set with setPenWidth.
The x and y coordinates are relative to the current screen origin, which can be set using setOrigin.
如果线条的任何部分超出屏幕边界，则只绘制可见部分。

Examples

// Draw a line from the top left to 
// bottom right of the screen
Brain.Screen.drawLine(0, 0, 159, 107);

IQ Brain 屏幕截图，从左上角到右下角画了一条白色对角线。

绘制矩形#

在 IQ（第二代）Brain 屏幕上，按指定位置和大小绘制一个矩形。

Available Functions

1 — 使用当前配置的填充颜色绘制并填充矩形。
void drawRectangle(
    int x,
    int y,
    int width,
    int height );

2 — 使用预定义或自定义颜色对象绘制并填充矩形。
void drawRectangle(
    int           x,
    int           y,
    int           width,
    int           height,
    const color&  color );

3 — 使用十六进制颜色值绘制并填充矩形。

void drawRectangle(
    int           x,
    int           y,
    int           width,
    int           height,
    const char*   color );

4 — 使用色调值绘制并填充矩形。
void drawRectangle(
    int x,
    int y,
    int width,
    int height,
    int hue );

Parameters

范围	类型	描述
`x`	`int`	矩形左上角的 x 坐标，取值范围为 0 到 159 的整数。
`y`	`int`	矩形左上角的 y 坐标，取值范围为 0 到 107 的整数。
`width`	`int`	矩形的宽度，取值范围为 0 到 159 的整数。
`height`	`int`	矩形的高度，取值范围为 0 到 107 之间的整数。
`color`	`const color&`	Fills the rectangle using a `color` object. Predefined colors include: `black` `white` `red` `green` `blue` `yellow` `orange` `purple` `cyan` `transparent` This can also use a custom color object.
`color`	`const char*`	Fills the rectangle using a hexadecimal color value (for example, `“#FF0000”`).
`hue`	`int`	Fills the rectangle using a hue value in the range `0`–`359`.

Return Values

此函数不返回值。

Notes

The rectangle outline is drawn using the current pen color set with setPenColor.
The outline thickness is determined by the current pen width set with setPenWidth.
When no color parameter is provided, the rectangle interior is filled using the current fill color set with setFillColor.
The x and y coordinates are relative to the current screen origin, which can be changed using setOrigin.
如果矩形的任何部分位于屏幕边界之外，则只绘制可见部分。
The hue parameter value is based on a circular color wheel, as shown below, where values represent degrees around the wheel (for example, red near 0°, green near 120°, and blue near 240°).

一个色轮，显示从 0 到 359 的颜色范围，其中红色为 0，绿色为 120，蓝色为 240。

Examples

// Draw a red rectangle on the screen
Brain.Screen.drawRectangle(25, 25, 100, 50, red);

IQ Brain 屏幕的截图，屏幕上几乎居中处画着一个带有细白边框的红色大矩形。

画圆#

在 IQ（第二代）大脑屏幕上，按指定位置和半径画一个圆。

Available Functions

1 — 使用当前配置的填充颜色绘制并填充一个圆。
void drawCircle(
    int x,
    int y,
    int radius );

2 — 使用预定义或自定义颜色对象绘制并填充一个圆。
void drawCircle(
    int           x,
    int           y,
    int           radius,
    const color&  color );

3 — 使用十六进制颜色值绘制并填充一个圆。
void drawCircle(
    int           x,
    int           y,
    int           radius,
    const char*   color );

4 — 使用色相值绘制并填充圆形。
void drawCircle(
    int x,
    int y,
    int radius,
    int hue );

Parameters

范围	类型	描述
`x`	`int`	圆心的 x 坐标，取值范围为 0 到 159 之间的整数。
`y`	`int`	圆心的 y 坐标，取值范围为 0 到 107 的整数。
`radius`	`int`	圆的半径，取值范围为 0 到 107 像素的整数。
`color`	`const color&`	Fills the circle using a `color` object. Predefined colors include: `black` `white` `red` `green` `blue` `yellow` `orange` `purple` `cyan` `transparent` This can also use a custom color object.
`color`	`const char*`	Fills the circle using a hexadecimal color value (for example, `“#FF0000”`).
`hue`	`int`	Fills the circle using a hue value in the range `0`–`359`.

Return Values

此函数不返回值。

Notes

The circle outline is drawn using the current pen color set with setPenColor.
The outline thickness is determined by the current pen width set with setPenWidth.
When no color parameter is provided, the circle interior is filled using the current fill color set with setFillColor.
The x and y coordinates are relative to the current screen origin, which can be changed using setOrigin.
The hue parameter value is based on a circular color wheel, as shown below, where values represent degrees around the wheel (for example, red near 0°, green near 120°, and blue near 240°).

一个色轮，显示从 0 到 359 的颜色范围，其中红色为 0，绿色为 120，蓝色为 240。

Examples

// Draw a green circle on the screen
Brain.Screen.drawCircle(80, 50, 20, green);

IQ Brain 屏幕的截图，屏幕中央有一个带有细白边框的实心绿色圆圈。

从文件中绘制图像#

使用存储在 SD 卡中的图像文件，在 IQ（第二代）Brain 屏幕上绘制图像。

Available Functions

bool drawImageFromFile(
  const char* name,
  int x,
  int y );

Parameters

范围	类型	描述
`name`	`const char*`	The filename of the image on the SD card. The file must have a `.bmp` or `.png` extension.
`x`	`int`	图像左边缘的 x 坐标（像素值，范围从 0 到 159）。
`y`	`int`	图像顶部边缘的绘制位置的 y 坐标，以像素为单位，范围从 0 到 107。

Return Values

Returns a Boolean indicating whether the image was successfully drawn:

true — The image was successfully loaded and drawn on the screen.
false — The image could not be drawn (for example, if the file does not exist or is invalid).

Notes

Supported image formats are .bmp and .png.
The image file size must not exceed 512 KB.
- 建议使用 8 位 RLE 编码以最小化文件大小。
支持的最大图像尺寸为 Brain 屏幕尺寸（160 x 108 像素）。
The x and y coordinates are relative to the current screen origin, which can be changed using setOrigin.

Examples

// Draw a bmp file on the Brain's screen at coordinate 0, 0
Brain.Screen.drawImageFromFile("test_image.bmp", 0, 0);

使成为#

Enables double buffering for the Brain’s screen. Once called, any drawing functions (like text, shapes, or images) will no longer appear immediately for the rest of the project. Instead, updates will only be shown when render is used again. This allows for smoother and more controlled screen updates, but means nothing will be visible until render is used.

Available Functions

1 — 启用双缓冲或将后缓冲区渲染到屏幕。
bool render();

2 — 将后缓冲区渲染到屏幕上，并可控制垂直同步行为和可选的调度程序执行。
bool render(
    bool bVsyncWait,
    bool bRunScheduler = true );

Parameters

范围	类型	描述
`bVsyncWait`	`bool`	`true` — Wait for the screen’s vertical refresh before rendering to reduce visual tearing. `false` — Do not wait for the screen’s vertical refresh before rendering.
`bRunScheduler`	`bool`	Optional. `true` (default) — Allow background tasks to run while waiting to render. `false` — Do not allow background tasks to run while waiting to render.

范围

类型

描述

bVsyncWait

bool

true — Wait for the screen’s vertical refresh before rendering to reduce visual tearing.
false — Do not wait for the screen’s vertical refresh before rendering.

bRunScheduler

bool

Optional.

true (default) — Allow background tasks to run while waiting to render.
false — Do not allow background tasks to run while waiting to render.

Return Values

Returns a Boolean indicating whether the saved drawings in the buffer were successfully rendered to the screen:

true — The drawings were successfully rendered on the screen.
false — The drawings could not be rendered on the screen.

Notes

Calling render will require render to be used for the rest of the project.

Examples

Brain.Screen.render();

// Draw text to the back buffer
Brain.Screen.print("Render later...");

// Wait for a screen press to render drawings
while (!Brain.Screen.pressing()) {
  wait(20, msec);
}
Brain.Screen.render();