Экран#

Введение #

Класс screen является производным от базового класса brain. Он управляет тем, как IQ (1-го поколения) Brain отображает текст и значения на своем встроенном экране.

Тест IQ (1-го поколения) Brain поддерживает до 5 строк и 21 столбца текста.

Мозг VEX IQ (1-го поколения) с пронумерованной сеткой (столбцы 1–21 и строки 1–5). Красные линии наложения выделяют структуру сетки, стрелки указывают на столбец 1, столбец 21, строку 1, строку 2 и строку 5. В первой строке сверху отображаются числа от 1 до 21.

Доступ #

Доступ к классу screen можно получить следующим образом:

Brain.Screen

Примечания #

Объект screen предоставляется модулем Brain. Он не создается напрямую.
В проектах используется один глобальный объект Brain Brain , поэтому функции экрана вызываются с помощью Brain.Screen 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!");

Функции участников #

Класс screen включает следующие функции-члены:

print — Выводит отформатированный текст, числа или логические значения на экран Brain.
setCursor — Перемещает текстовый курсор в указанную строку и столбец.
newLine — Очищает оставшуюся часть текущей строки и перемещает курсор на следующую строку.
clearLine — Очищает оставшуюся часть текущей строки или очищает указанную строку.
row — Возвращает строку, в которой будет напечатан текст.
column — Возвращает столбец, в котором будет напечатан текст.
getStringHeight — Возвращает высоту строки в пикселях, используя текущий шрифт.
getStringWidth — Возвращает ширину строки в пикселях, используя текущий шрифт.
printAt — Выводит отформатированный текст в точке с координатами x, y (опционально непрозрачный).
clearScreen — Очищает весь экран (опционально до указанного цвета).
setFont — Устанавливает шрифт, используемый для печати на экране.
setPenWidth — Задает толщину нарисованных линий и контуров фигур.
setPenColor — Задает цвет текста, пикселей, линий и контуров фигур.
setFillColor — Задает цвет заливки для нарисованных фигур и фона печатного текста.
setOrigin — Устанавливает начало координат, используемое для экранных координат.
setClipRegion — Ограничивает вывод на экран прямоугольной областью.
drawPixel — Рисует один пиксель по заданной координате.
drawLine — Рисует линию между двумя точками.
drawRectangle — Рисует прямоугольник в точке x, y заданного размера.
drawCircle — Рисует круг в точке x, y с заданным радиусом.
render — Включает двойную буферизацию или выводит буфер обратно на экран.

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

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

print #

Отображает текст, числа или логические значения на экране IQ (1-го поколения) Brain.

Available Functions

1 — Выводит отформатированный текст, используя строковые литералы или строки в стиле C, доступные только для чтения.
void print(
    const char* format,
    ... );

2 — Выводит отформатированный текст, используя изменяемые массивы символов.
void print(
    char* format,
    ... );

Parameters

Параметр	Тип	Описание
`format`	`const char*`	Форматная строка, предоставленная в виде строкового литерала или строки в стиле C только для чтения (например, `“Score: %d”`).
`format`	`char*`	Форматная строка, представленная в виде изменяемого символьного массива.
`…`		Одно или несколько дополнительных значений, вставляемых в строку формата, разделенных запятыми.

Return Values

Эта функция не возвращает значения.

Notes

Вывод начинается с позиции курсора (текущая позиция на экране).
В печатном тексте используется текущий экранный шрифт размер шрифта.
В печатном тексте используется текущий цвет пера цвет пера.
Текст, напечатанный с помощью параметра print всегда печатается с фоном, а цвет фона определяется текущим цветом заливки .
При использовании строки формата количество и типы передаваемых значений должны соответствовать спецификаторам формата в строке.

Examples

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

setCursor #

Перемещает курсор в определенную строку и столбец на экране IQ (1-го поколения) Brain. Следующий вызов print начнет вывод с этого места.

Available Functions

void setCursor(
  int32_t row, 
  int32_t col );

Parameters

Параметр	Тип	Описание
`row`	`int32_t`	Строка, в которую нужно переместить курсор.
`col`	`int32_t`	Столбец, в который нужно переместить курсор.

Return Values

Эта функция не возвращает значения.

Notes

Влияет на то, где начинается последующий вывод текста при использовании print.
Строки и столбцы основаны на текущем установленном экранном шрифте.
Вызов функции setCursor setCursor влияет только на положение последующего текстового вывода.

Examples

// Print at row 3 column 7
Brain.Screen.setCursor(3, 7);
Brain.Screen.print("VEXcode!");

Экран IQ (1-го поколения) Brain отображает центрированный текст «VEXcode!».

newLine #

Перемещает курсор в начало следующей строки на экране «Мозг».

Available Functions

void newLine();

Parameters

Эта функция не принимает никаких параметров.

Return Values

Эта функция не возвращает значения.

Notes

Если курсор находится в середине предложения, то строка после курсора будет очищена newLine , после чего курсор перейдет к следующей строке.
После вызова функции newLineкурсор перемещается в первый столбец следующей строки.
Положение курсора и нумерация строк задаются с помощью setCursor.

Examples

// Display two lines of text
Brain.Screen.print("First message");
Brain.Screen.newLine();
Brain.Screen.print("Second message");

Экран IQ (1-го поколения) мозга, отображающий «Первое сообщение» и «Второе сообщение», на отдельных строках.

clearLine #

Очищает текст из строки на экране IQ (1-го поколения) Brain.

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`	Номер строки для очистки. Нумерация строк начинается с `1`.
`color`	`const color&`	Очищает строку, используя объект цвета `color` Предопределенные цвета включают: `black` `white` `red` `green` `blue` `yellow` `orange` `purple` `cyan` `transparent` Также можно использовать объект пользовательского цвета.
`color`	`const char*`	Очищает строку, используя шестнадцатеричное значение цвета (например, `“#000000”`).
`hue`	`int`	Очищает строку, используя целочисленное значение оттенка в диапазоне `0`до`359`, представляющее градусы на цветовом круге.

Return Values

Эта функция не возвращает значения.

Notes

Очистка строки не изменяет текущее положение курсора.
Положение курсора и нумерация строк задаются с помощью setCursor.
Экран IQ (1-го поколения) Brain — монохромный, поэтому указанные цвета на экране отображаться не будут.

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);

row #

Возвращает текущую позицию курсора в строке на экране IQ (1-го поколения) Brain.

Available Functions

int32_t row();

Parameters

Эта функция не принимает никаких параметров.

Return Values

Возвращает значение int32_t , представляющее строку, в которой будет выведен текст.

Нумерация строк начинается с 1.

Notes

The cursor position is based on the current screen font.
Возвращаемое значение указывает, где будет отображаться следующий печатный результат.
Значение строки изменяется при выводе текста или при вызове setCursor.

Examples

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

column #

Возвращает столбец, в котором будет выводиться текст на экран IQ (1-го поколения) Brain.

Available Functions

int32_t column();

Parameters

Эта функция не принимает никаких параметров.

Return Values

Возвращает значение int32_t представляющее столбец, в котором будет напечатан текст.

Нумерация столбцов начинается с 1.

Notes

The cursor position is based on the current screen font.
Возвращаемое значение указывает, где будет отображаться следующий печатный результат.
Значение столбца изменяется при выводе текста или при вызове setCursor.

Examples

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

getStringHeight #

Возвращает высоту строки в пикселях при отображении на экране IQ (1-го поколения) Brain.

Available Functions

int32_t getStringHeight( 
    const char* cstr );

Parameters

Параметр	Тип	Описание
`cstr`	`const char*`	Текст, подлежащий измерению, предоставляется в виде строки в стиле C (например, `“Hello”`).

Return Values

Возвращает значение int32_t представляющее высоту строки в пикселях при отображении на экране Brain.

Notes

Возвращаемая высота зависит от текущего выбранного шрифта на экране .
Эта функция измеряет строку, не отображая её на экране.
Возвращаемая высота отражает то, как строка будет выглядеть при выводе на экран.

getStringWidth #

Возвращает ширину строки в пикселях при отображении на экране IQ (1-го поколения) Brain.

Available Functions

int32_t getStringWidth( 
    const char* cstr );

Parameters

Параметр	Тип	Описание
`cstr`	`const char*`	Текст, подлежащий измерению, предоставляется в виде строки в стиле C (например, `“Hello”`).

Return Values

Возвращает значение int32_t , представляющее ширину строки в пикселях при отображении на экране Brain.

Notes

Возвращаемая ширина зависит от текущего выбранного шрифта экрана .
Эта функция измеряет строку, не отображая её на экране.
Возвращаемая ширина отражает то, как строка будет выглядеть при печати.

printAt #

Выводит текст, числа или логические значения в заданной точке на экране IQ (1-го поколения) Brain.

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`	Определяет, будет ли печатный текст отображаться непрозрачным или прозрачным: `true` — Фон печатного текста заполняется текущим цветом заливки. `false` — Текст отображается прозрачным, а фон не заполняется.
`format`	`const char*`	Строка формата, определяющая содержимое экрана (например, `“Score: %d”`).
`…`		Одно или несколько дополнительных значений, вставляемых в строку формата, разделенных запятыми.

Return Values

Эта функция не возвращает значения.

Notes

Координаты x и y являются относительными относительно текущего начала координат экрана, которое можно изменить с помощью setOrigin.
В печатном тексте используется текущий экранный шрифт размер шрифта.
В печатном тексте используется текущий цвет пера цвет пера.
При использовании строки формата количество и типы передаваемых значений должны соответствовать спецификаторам формата в строке.

Examples

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

clearScreen #

Удаляет все рисунки и текст с экрана Мозга.

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&`	Очищает экран, используя объект цвета `color` Предопределенные цвета включают: `black` `white` `red` `green` `blue` `yellow` `orange` `purple` `cyan` `transparent` Также можно использовать объект пользовательского цвета.
`color`	`const char*`	Очищает экран, используя шестнадцатеричное значение цвета, представленное в виде строки (например, `“#000000”`).
`hue`	`int`	Очищает экран, используя целочисленное значение оттенка в диапазоне `0`до`359`, представляющее градусы на цветовом круге.

Параметр

Тип

Описание

color

const color&

Очищает экран, используя объект цвета color Предопределенные цвета включают:

black
white
red
green
blue
yellow
orange
purple
cyan
transparent

Также можно использовать объект пользовательского цвета.

color

const char*

Очищает экран, используя шестнадцатеричное значение цвета, представленное в виде строки (например, “#000000”).

hue

int

Очищает экран, используя целочисленное значение оттенка в диапазоне 0до359, представляющее градусы на цветовом круге.

Return Values

Эта функция не возвращает значения.

Notes

Экран IQ (1-го поколения) Brain — монохромный, поэтому указанные цвета на экране отображаться не будут.

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);

setFont #

Задает шрифт, используемый для текста, отображаемого на экране IQ (1-го поколения) Brain.

Это управляет шрифтом, применяемым к последующему выводу текста при использовании функций вывода текста на экран, таких как print.

Available Functions

void setFont(
  fontType font );

Parameters

Параметр	Тип	Описание
`font`	`fontType`	Устанавливает шрифт на один из следующих вариантов: `mono12` `mono15` `mono20` `mono30` `mono40` `mono60` `prop20` `prop30` `prop40` `prop60` Эти параметры показаны ниже.

Параметр

Тип

Описание

font

fontType

Устанавливает шрифт на один из следующих вариантов:

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");

setPenWidth #

Задает толщину нарисованных линий и контуров фигур.

Available Functions

void setPenWidth(
  uint32_t width );

Parameters

Параметр	Тип	Описание
`width`	`uint32_t`	Ширина пера в пикселях, от 0 до 32.

Return Values

Эта функция не возвращает значения.

Notes

Ширина пера применяется к функциям рисования, таким как drawLine, drawRectangle и 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);

setPenColor #

Задает цвет текста, пикселей, линий и контуров фигур.

Available Functions

1 — Задает цвет пера, используя предопределенный или пользовательский цвет объект.
void setPenColor(
    const color& color );

2 — Задает цвет пера, используя шестнадцатеричное значение цвета.
void setPenColor(
    const char* color );

3 — Задает цвет пера, используя значение оттенка.
void setPenColor(
    int hue );

Parameters

Параметр	Тип	Описание
`color`	`const color&`	Задает цвет пера, используя объект цвета `color` Предопределенные цвета: `black` `white` `red` `green` `blue` `yellow` `orange` `purple` `cyan` `transparent`
`color`	`const char*`	Задает цвет пера, используя шестнадцатеричное значение цвета, представленное в виде строки (например, `“#FF0000”`).
`hue`	`int`	Задает цвет пера, используя целочисленное значение оттенка в диапазоне `0`до`359`, представляющее градусы на цветовом круге (например, `0` — красный, `120` — зеленый, а `240` — синий).

Параметр

Тип

Описание

color

const color&

Задает цвет пера, используя объект цвета color Предопределенные цвета:

black
white
red
green
blue
yellow
orange
purple
cyan
transparent

color

const char*

Задает цвет пера, используя шестнадцатеричное значение цвета, представленное в виде строки (например, “#FF0000”).

hue

int

Задает цвет пера, используя целочисленное значение оттенка в диапазоне 0до359, представляющее градусы на цветовом круге (например, 0 — красный, 120 — зеленый, а 240 — синий).

Return Values

Эта функция не возвращает значения.

Notes

Экран IQ (1-го поколения) Brain — монохромный, поэтому указанные цвета на экране отображаться не будут.

Examples

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

setFillColor #

Задает цвет заливки, используемый при рисовании фигур.

Available Functions

1 — Задает цвет заливки, используя предопределенный или пользовательский цвет объект.
void setFillColor(
    const color& color );

2 — Задает цвет заливки, используя шестнадцатеричное значение цвета.
void setFillColor(
    const char* color );

3 — Задает цвет заливки, используя значение оттенка.
void setFillColor(
    int hue );

Parameters

Параметр	Тип	Описание
`color`	`const color&`	Задает цвет заливки, используя объект цвета `color` Предопределенные цвета: `black` `white` `red` `green` `blue` `yellow` `orange` `purple` `cyan` `transparent`
`color`	`const char*`	Задает цвет заливки, используя шестнадцатеричное значение цвета, представленное в виде строки (например, `“#00FF00”`).
`hue`	`int`	Задает цвет заливки, используя целочисленное значение оттенка в диапазоне `0`до`359`, представляющее градусы на цветовом круге (например, `0` — красный, `120` — зеленый, а `240` — синий).

Параметр

Тип

Описание

color

const color&

Задает цвет заливки, используя объект цвета color Предопределенные цвета:

black
white
red
green
blue
yellow
orange
purple
cyan
transparent

color

const char*

Задает цвет заливки, используя шестнадцатеричное значение цвета, представленное в виде строки (например, “#00FF00”).

hue

int

Задает цвет заливки, используя целочисленное значение оттенка в диапазоне 0до359, представляющее градусы на цветовом круге (например, 0 — красный, 120 — зеленый, а 240 — синий).

Return Values

Эта функция не возвращает значения.

Notes

Экран IQ (1-го поколения) Brain — монохромный, поэтому указанные цвета на экране отображаться не будут.

Examples

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

setOrigin #

Задает точку отсчета, используемую для отрисовки графики на экране 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).
Начало координат применяется к функциям координат, таким как drawLine, drawRectangle, drawCircle и printAt.
Исходные данные остаются в силе до тех пор, пока не будут изменены или проект не будет перезапущен.

setClipRegion #

Определяет прямоугольную область на экране, в пределах которой будут отображаться все рисунки и текст. Любой контент за пределами этой области отображаться не будет.

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

Функции отрисовки продолжают выполняться, даже если они выходят за пределы области отсечения, но видимой остается только та часть, которая находится внутри этой области.
Координаты x и y являются относительными относительно текущего начала координат экрана, которое можно изменить с помощью 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!");

drawPixel #

Рисует один пиксель на экране IQ (1-го поколения) Brain в указанных координатах x и y.

Available Functions

void drawPixel(
  int x,
  int y );

Parameters

Параметр	Тип	Описание
`x`	`int`	Координата x, по которой будет нарисован пиксель, задается целым числом от 0 до 159.
`y`	`int`	Y-координата, по которой будет нарисован пиксель, задается целым числом от 0 до 107.

Return Values

Эта функция не возвращает значения.

Notes

Экран IQ (1-го поколения) Brain — монохромный, поэтому указанные цвета на экране отображаться не будут.
Координаты x и y заданы относительно текущего начала координат экрана, которое можно установить с помощью setOrigin.
Если указанное местоположение пикселя находится за пределами экрана, пиксель не отображается.

Examples

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

drawLine #

Рисует прямую линию, соединяющую две точки на экране теста IQ (1-го поколения) Brain.

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

Экран IQ (1-го поколения) Brain — монохромный, поэтому указанные цвета на экране отображаться не будут.
Ширина линии определяется текущей шириной пера, заданной с помощью setPenWidth.
Координаты x и y заданы относительно текущего начала координат экрана, которое можно установить с помощью setOrigin.
Если какой-либо участок линии выходит за пределы экрана, отображается только видимая часть.

Examples

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

drawRectangle #

Рисует прямоугольник на экране IQ (1-го поколения) 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&`	Заполняет прямоугольник, используя объект цвета `color` Предопределенные цвета включают: `black` `white` `red` `green` `blue` `yellow` `orange` `purple` `cyan` `transparent` Также можно использовать объект пользовательского цвета.
`color`	`const char*`	Заполняет прямоугольник шестнадцатеричным значением цвета (например, `“#FF0000”`).
`hue`	`int`	Заполняет прямоугольник, используя значение оттенка в диапазоне `0`–`359`.

Return Values

Эта функция не возвращает значения.

Notes

Экран IQ (1-го поколения) Brain — монохромный, поэтому указанные цвета на экране отображаться не будут.
Толщина контура определяется текущей шириной пера, заданной с помощью setPenWidth.
Координаты x и y являются относительными относительно текущего начала координат экрана, которое можно изменить с помощью setOrigin.
Если какая-либо часть прямоугольника выходит за пределы экрана, отображается только видимая часть.

Examples

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

drawCircle #

Рисует круг на экране IQ (1-го поколения) Brain в указанном месте и радиусе.

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&`	Заполняет круг, используя объект цвета `color` Предопределенные цвета включают: `black` `white` `red` `green` `blue` `yellow` `orange` `purple` `cyan` `transparent` Также можно использовать объект пользовательского цвета.
`color`	`const char*`	Заполняет круг шестнадцатеричным значением цвета (например, `“#FF0000”`).
`hue`	`int`	Заполняет круг, используя значение оттенка в диапазоне `0`–`359`.

Return Values

Эта функция не возвращает значения.

Notes

Экран IQ (1-го поколения) Brain — монохромный, поэтому указанные цвета на экране отображаться не будут.
Толщина контура определяется текущей шириной пера, заданной с помощью setPenWidth.
Координаты x и y являются относительными относительно текущего начала координат экрана, которое можно изменить с помощью setOrigin.

Examples

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

render #

Включает двойную буферизацию для экрана Brain. После вызова любые функции рисования (например, текст или фигуры) больше не будут отображаться немедленно до конца проекта. Вместо этого обновления будут отображаться только при повторном использовании рендеринга render Это обеспечивает более плавное и контролируемое обновление экрана, но означает, что ничего не будет видно до тех пор, пока не будет использован рендеринг render.

Available Functions

1 — Включает двойную буферизацию или выводит содержимое буфера обратно на экран.
bool render();

2 — Выводит буфер заднего плана на экран с управлением поведением вертикальной синхронизации и возможностью выполнения планировщиком.
bool render(
    bool bVsyncWait,
    bool bRunScheduler = true );

Parameters

Параметр	Тип	Описание
`bVsyncWait`	`bool`	`true` — Дождитесь вертикальной перезагрузки экрана перед рендерингом, чтобы уменьшить разрывы изображения. `false` — Не ждите вертикальной перезагрузки экрана перед рендерингом.
`bRunScheduler`	`bool`	Необязательно. `true` (по умолчанию) — Разрешить выполнение фоновых задач во время ожидания рендеринга. `false` — Не разрешать выполнение фоновых задач во время ожидания рендеринга.

Параметр

Тип

Описание

bVsyncWait

bool

true — Дождитесь вертикальной перезагрузки экрана перед рендерингом, чтобы уменьшить разрывы изображения.
false — Не ждите вертикальной перезагрузки экрана перед рендерингом.

bRunScheduler

bool

Необязательно.

true (по умолчанию) — Разрешить выполнение фоновых задач во время ожидания рендеринга.
false — Не разрешать выполнение фоновых задач во время ожидания рендеринга.

Return Values

Возвращает логическое значение, указывающее, были ли успешно отображены на экране сохраненные в буфере рисунки:

true — Рисунки были успешно отображены на экране.
false — Рисунки не удалось отобразить на экране.

Notes

Вызов функции render потребует использования функции render для остальной части проекта.

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();