Экран#

Введение #

Блоки управления экраном контролируют отображение текста, цифр и графики на экране робота-программиста VEX AIM, а также его реакцию на нажатия на экран.

Ниже приведён список всех блоков:

Cursor Print — Управление отображением текста с помощью системы курсоров по строкам и столбцам.

вывести на экран — Отображает текст на экране в текущей позиции курсора.
установить курсор в строку и столбец на экране — Перемещает курсор в определенную строку и столбец.
установить курсор на следующую строку на экране — Перемещает курсор в столбец 1 следующей строки.
очистить строку на экране — Очищает указанную строку текста.
столбец экранного курсора — Указывает номер столбца, в котором будет напечатан текст.
строка курсора на экране — Указывает номер строки, в которой будет напечатан текст.

XY Print — Печать текста в пиксельных координатах.

вывести на экран в заданных координатах — Отображает текст в заданных координатах x и y.
установить точку отсчета экрана — Изменяет точку отсчета, используемую для рисования и печати.

Настройки — Настройка форматирования текста и отображения на экране.

очистка экрана — Удаляет весь текст и рисунки с экрана.
заполнить экран — Удаляет весь текст и рисунки с экрана, затем устанавливает цвет фона экрана.
установить шрифт на экране — Изменяет тип и размер шрифта для отображения текста.
Установка точности печати на экране — Задает количество десятичных знаков, отображаемых при печати чисел.
установить ширину пера на экране — Задает толщину нарисованных линий и контуров фигур.
установить цвет пера/шрифта на экране — Устанавливает цвет текста, пикселей, линий и контуров фигур.
установить цвет заливки на экране — Устанавливает цвет заливки для нарисованных фигур.

Рисование — Создание графики и визуальных элементов.

показать файл изображения на экране — Отображает загруженное пользователем изображение на экране.
рисовать пиксель на экране — Рисует один пиксель в заданной координате.
рисовать линию на экране — Рисует линию между двумя точками.
рисовать прямоугольник на экране — Рисует прямоугольник с заданными размерами.
рисовать круг на экране — Рисует круг с заданным радиусом.

Сенсорное управление — распознавание взаимодействий с экраном.

экран нажат — Сообщает, нажат ли экран в данный момент.
позиция на экране — Сообщает выбранную координату x или y последнего нажатия на экран.
событие экрана — Запускает прикрепленные блоки при нажатии или отпускании экрана.

Печать курсора #

печать на экране #

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 stack block#

вывести [VEXcode] на экран ▶

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

Пример

При запуске в начальной позиции курсора на экране отображается сообщение «Привет, робот!».#

при запуске
[Display a message at the starting cursor position.]
вывести [Hello, Robot!] на экран ▶

Скриншот экрана робота с надписью "Привет, робот!" белым цветом вверху.

установить курсор на строку/столбец на экране #

Блок установить курсор в строку и столбец на экране перемещает курсор в определенную строку и столбец на экране робота. Следующий блок печать на экране начнет печать с этого места. Количество строк и столбцов, которые могут удобно поместиться, зависит от выбранного шрифта. При использовании стандартного моноширинного шрифта среднего размера можно четко отобразить до 8 строк и 13 столбцов. Текст, расположенный за пределами этого диапазона, может быть обрезан или стать трудночитаемым.

Моноширинные шрифты имеют одинаковую ширину символов, что обеспечивает единообразное размещение текста. В отличие от них, пропорциональные шрифты различаются по ширине символов, поэтому некоторые буквы занимают больше места, чем другие. Однако, независимо от используемого типа, блок стека установить курсор в строку/столбец на экране позиционирует курсор на основе размера строки и столбца, а не стиля шрифта. Размер шрифта можно отрегулировать с помощью блока стека установить шрифт на экране.

Установить блок стека курсора#

установить курсор на строку [1] столбец [1] на экране

Параметры	Описание
ряд	Строка, в которую нужно переместить курсор.
столбец	Столбец, в который нужно переместить курсор.

Примеры

При запуске программа перемещает курсор в строку 3, столбец 2 на экране и выводит «Строка 3, столбец 2».#

при запуске
[Display text starting at Row 3 Column 2.]
установить курсор на строку (3) столбец (2) на экране
вывести [Row 3, Column 2] на экран ▶

Скриншот экрана робота, на котором белым цветом чуть выше центра экрана напечатана строка 3, столбец 2, начиная со строки 3, столбца 2.

при запуске
[Display cargo amounts in an organized list.]
установить шрифт [пропорциональный v] [большой v] на экране
вывести [Sports Balls] на экран ◀ и перенести курсор на следующую строку
вывести [Orange Barrels] на экран ◀ и перенести курсор на следующую строку
вывести [Blue Barrels] на экран ▶
установить курсор на строку [1] столбец [11] на экране
вывести [2] на экран ▶
установить курсор на строку [2] столбец [11] на экране
вывести [3] на экран ▶
установить курсор на строку [3] столбец [11] на экране
вывести [3] на экран ▶

На скриншоте экрана робота показаны три строки белого текста, в которых перечислены спортивные мячи 2, оранжевые бочки 3 и синие бочки 3. Числа выровнены справа от каждой метки, и список начинается вверху экрана.

при запуске
[Display the ID of the detected AprilTag.]
установить шрифт [пропорциональный v] [очень большой v] на экране
вечно
очистить экран
вывести [AprilTag] на экран ▶
получить данные [все AprilTags v] из AI Vision
если <объект AI Vision существует?> то
установить курсор на строку [3] столбец [4] на экране
вывести (объект AI Vision [tagID v]) на экран ▶
конец
ждать [0.1] секунд

Скриншот экрана робота с белым текстом, напечатанным в центре, на первой строке которого написано AprilTag, а на второй – 4.

переместить курсор на следующую строку на экране #

Блок установка курсора на следующую строку на экране перемещает курсор в столбец 1 следующей строки на экране робота.

установить курсор на следующую строку блока стека#

перенести курсор на следующую строку на экране

Параметры	Описание
	Этот блок не имеет параметров.

Пример

При запуске программа выводит на экран «Строка 1», перемещает курсор на следующую строку, а затем выводит «Строка 2».#

при запуске
[Display two lines of text.]
вывести [Line 1] на экран ▶
перенести курсор на следующую строку на экране
вывести [Line 2] на экран ▶

Скриншот экрана робота с белым текстом. На экране отображается строка 1 в верхней строке, выровненная по левому краю, и строка 2 непосредственно под ней.

очистить строку на экране #

Блок очистка строки на экране очищает одну строку текста на экране робота.

Очистить блок стека строк#

очистить строку [1] на экране

Параметры	Описание
ряд	Номер строки для очистки.

Пример

При запуске программа выводит текст в две строки. Первая строка остается видимой, а вторая исчезает через 3 секунды.#

при запуске
[Display text on two rows.]
вывести [This text stays] на экран ▶
перенести курсор на следующую строку на экране
вывести [This text disappears] на экран ▶
ждать [3] секунд
очистить строку [2] на экране

столбец экранного курсора #

Блок обработки данных столбца курсора на экране сообщает номер столбца, в котором будет выводиться текст в виде целого числа.

блок репортера колонки курсора на экране#

(столбец курсора на экране)

Параметры	Описание
	Этот блок не имеет параметров.

Пример

При запуске программа перемещает курсор в строку 3, столбец 2 на экране и выводит номер столбца, в котором находится курсор.#

при запуске
[Display the cursor's current column.]
установить курсор на строку [3] столбец [2] на экране
вывести (столбец курсора на экране) на экран ▶

Скриншот экрана робота, на котором в центре верхнего левого квадранта, в строке 3 и столбце 2, напечатана белая цифра 2.

строка экранного курсора #

Блок обработки данных строки курсора на экране сообщает номер строки, в которой будет выводиться текст в виде целого числа.

блок репортера строки курсора экрана#

(строка курсора на экране)

Параметры	Описание
	Этот блок не имеет параметров.

Пример

При запуске программа перемещает курсор в строку 6, столбец 2 на экране и выводит номер строки, в которой находится курсор.#

при запуске
[Display the cursor's current row.]
установить курсор на строку [3] столбец [2] на экране
вывести (строка курсора на экране) на экран ▶

Скриншот экрана робота, на котором белая цифра 3 напечатана в центре верхнего левого квадранта, в строке 3, столбце 2.

Печать XY #

печать по координатам на экране #

Блок стека print at coordinate on screen выводит текст, числа или значения переменных на экран робота в заданных координатах x и y в пикселях с текущим установленным шрифтом font.

По умолчанию начало координат находится в верхнем левом углу экрана в точке (0, 0). По оси X, 0 находится слева от экрана, а 240 — справа. По оси Y, 0 находится в верхней части экрана, а 240 — в нижней. Вы можете использовать блок установить начало координат экрана, чтобы переместить начало координат в другое место. При изменении начала координат диапазоны координат X и Y также изменятся.

Например, если начало координат установлено в точке (120, 120), диапазон координат x и y будет от -120 до 120.

Вид сверху на верхнюю часть робота VEX AIM Coding Robot, показывающий ограничивающую рамку экрана в виде белого прямоугольника. По часовой стрелке, начиная с верхнего левого угла, координаты (0,0), (240,0), (0,240) и (240,240) показывают четыре угла. Внутри квадрата находится красный круг, показывающий видимую область, с белой пунктирной линией, пересекающей точку (120, 120) в центре экрана.

Примечание: Красный круг показывает, какие координаты будут отображаться на круглом экране робота AIM. Координаты, выходящие за пределы красного круга, находятся в диапазоне 0–240, но не будут отображаться на экране.

печать в блоке стека#

вывести [VEXcode] по x:[80] y:[120] на экране

Параметры	Описание
ценить	Текст, число или значение переменной для отображения на экране.
х	Координата x в пикселях, от 0 до 240, с началом координат по умолчанию.
й	Координата Y в пикселях, от 0 до 240, с началом координат по умолчанию.

Пример

При запуске в начальной позиции курсора на экране отображается сообщение «Привет, робот!».#

при запуске
[Display a message in the middle of the screen.]
вывести [Hello, Robot!] по x:[40] y:[120] на экране

Скриншот экрана робота с белым текстом «Привет, робот!», расположенным по центру экрана.

установить источник экрана #

Блок set screen origin изменяет начало координат (0, 0), используемое для рисования или печати на экране робота. По умолчанию начало координат находится в верхнем левом углу экрана. Этот блок позволяет сбросить начало координат на альтернативное местоположение в координатах (x, y) экрана.

установить исходный блок стека экрана#

установить начало координат экрана x: [0] y: [0]

Параметры	Описание
х	Координата x в пикселях, которая будет установлена в качестве новой точки отсчета.
й	Координата Y в пикселях, которая будет установлена в качестве новой точки отсчета.

Пример

При запуске программа устанавливает начало координат экрана в точку (120, 120) и рисует прямоугольник в новой точке начала координат с верхним левым углом в точке (0,0), шириной 80 пикселей и высотой 40 пикселей.#

при запуске
[Set the origin to the center of the screen.]
установить начало координат экрана x: [120] y: [120]
[Draw a rectangle at the new origin.]
нарисовать прямоугольник [0] [0] [80] [40] на экране

Скриншот экрана робота с белым прямоугольником, нарисованным в нижнем левом квадранте. Верхний левый угол прямоугольника — центр экрана.

Настройки #

чистый экран #

Блок clear screen удаляет все рисунки и текст с экрана робота и сбрасывает положение курсора в строку 1, столбец 1.

блок стека очистки экрана#

очистить экран

Параметры	Описание
	Этот блок не имеет параметров.

Пример

При запуске рисует круг с центром (120,120) и радиусом 40 пикселей. Через 2 секунды экран очищается.#

при запуске
[Draw a circle, and clear it after 2 seconds.]
нарисовать круг [120] [120] [40] на экране
ждать [2] секунд
очистить экран

заполнить экран #

Блок fill screen удаляет все рисунки и текст с экрана робота, а затем меняет фон на указанный цвет.

блок заполнения экрана стека#

заполнить экран [красный v]

Параметры	Описание
цвет	Цвет фона: красный зеленый синий черный белый желтый оранжевый фиолетовый голубой

Пример

при запуске
[Say "Hello" then turn screen yellow.]
вывести [Hello] на экран ▶
ждать [2] секунд
заполнить экран [жёлтый v]

установить шрифт на экране #

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

установить блок стека шрифтов#

установить шрифт [моноширинный v] [сверхмалый v] на экране

Параметры	Описание
тип	Тип шрифта: моноширинный или пропорциональный
размер	Размер шрифта (указан ниже): очень маленький очень маленький маленький средний большой очень большой очень большой

Параметры

Описание

тип

Тип шрифта: моноширинный или пропорциональный

размер

Размер шрифта (указан ниже):

очень маленький
очень маленький
маленький
средний
большой
очень большой
очень большой

моноширинный супермаленький	моноширинный очень малый	моноширинный малый
моноширинный средний	моноширинный большой	моноширинный очень большой
моноширинный очень большой	пропорциональный маленький	пропорционально большой
пропорциональный очень большой	пропорциональный сверхбольшой

Пример

При запуске программа устанавливает шрифт на «моноширинный сверхбольшой» и выводит на экран «VEX».#

при запуске
[Display text using a larger font]
установить шрифт [моноширинный v] [очень большой v] на экране
вывести [VEX] на экран ▶

На скриншоте экрана робота в верхнем левом углу белым цветом напечатано слово VEX шрифтом Mono 40.

установить точность печати на экране #

Блок установка точности печати на экране задает количество десятичных знаков, отображаемых при выводе чисел на экран робота. Эта точность печати будет применяться ко всем последующим числам.

установить точность печати стековый блок#

установить точность печати [0.1 v] на экране

Параметры	Описание
точность	Точность печати: 1 0.1 0.01 0.001 Все цифры

Параметры

Описание

точность

Точность печати:

1
0.1
0.01
0.001
Все цифры

Пример

При запуске точность печати устанавливается на два знака после запятой, а значение 1/3 отображается на экране как 0,33.#

при запуске
[Print 1/3 as 0.33.]
установить точность печати [0.01 v] на экране
вывести ([1] [math_division v] [3]) на экран ▶

На скриншоте экрана робота в верхнем левом углу белым цветом отображается 0.33.

установить ширину пера на экране #

Блок Установка ширины пера на экране задает толщину рисуемых линий и контуров фигур.

установить ширину пера стековый блок#

установить ширину пера [10] на экране

Параметры	Описание
ширина	Ширина пера в пикселях, от 0 до 32.

Пример

При запуске программа устанавливает ширину пера на 10 пикселей и рисует прямоугольник с верхним левым углом в точке (50,50), шириной 130 пикселей и высотой 60 пикселей.#

при запуске
[Draw a rectangle with a pen width of 10.]
установить ширину пера [10] на экране
нарисовать прямоугольник [50] [50] [130] [60] на экране

Скриншот экрана робота с толстым белым прямоугольником, нарисованным в верхней половине.

установить цвет пера/шрифта на экране #

Блок Установка цвета пера/шрифта на экране задает цвет текста, пикселей, линий и контуров фигур.

установить ручку / блок цвета шрифта#

установить цвет пера/шрифта [красный v] на экране

Параметры	Описание
цвет	Цвет пера и шрифта: красный зеленый синий черный белый желтый оранжевый фиолетовый голубой прозрачный

Пример

При запуске программа устанавливает цвет пера на красный и рисует прямоугольник с верхним левым углом в точке (50, 50), шириной 130 пикселей и высотой 60 пикселей.#

при запуске
[Draw a rectangle with a red pen.]
установить цвет пера/шрифта [красный v] на экране
нарисовать прямоугольник [50] [50] [130] [60] на экране

Скриншот экрана робота с красным прямоугольником, обведенным тонкой рамкой в верхней половине.

установить цвет заливки экрана #

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

установить цвет заливки стекового блока#

установить цвет заливки [красный v] на экране

Параметры	Описание
цвет	Цвет заливки: красный зеленый синий черный белый желтый оранжевый фиолетовый голубой прозрачный

Примеры

При запуске программа устанавливает оранжевый цвет заливки и рисует два прямоугольника. Первый находится в точке (50, 50), а второй — в точке (50, 130), оба шириной 100 пикселей и высотой 60 пикселей.#

при запуске
[Draw two orange rectangles.]
установить цвет заливки [оранжевый v] на экране
нарисовать прямоугольник [50] [50] [100] [60] на экране
нарисовать прямоугольник [50] [130] [100] [60] на экране

Скриншот экрана робота с двумя параллельными оранжевыми прямоугольниками с тонкими белыми контурами, расположенными слева по центру экрана.

При запуске программа устанавливает фиолетовый цвет заливки фона и выводит на экран слово «Выделено».#

при запуске
[Display text with a purple background.]
установить цвет заливки [фиолетовый v] на экране
вывести [Highlight] на экран ▶

На скриншоте экрана робота белым текстом выделено «Выделение» с фиолетовой обводкой, начиная с верхнего левого угла.

Рисовать #

показать файл изображения на экране #

Блок стека show image file on screen отображает на экране робота пользовательское изображение, загруженное пользователем.

показать блок стека изображений пользователя#

показать файл изображения [1 v]

Параметры	Описание
номер слота изображения	Пользовательское изображение для использования, номер от 1 до 10. Номер изображения соответствует номеру, отображаемому в панели управления AIM.

Пример

при запуске
[Draw uploaded Image 1.]
показать файл изображения [1 v]

нарисовать пиксель на экране #

Блок стека рисовать пиксель на экране рисует один пиксель в выбранных координатах x и y, используя текущий цвет пера.

Например, если начало координат установлено в точке (120, 120), диапазон координат x и y будет от -120 до 120.

отрисовать блок стека пикселей#

нарисовать пиксель [0] [0] на экране

Параметры	Описание
х	Координата x для отрисовки пикселя, от 0 до 240, с началом координат по умолчанию.
й	Y-координата для отрисовки пикселя, от 0 до 240, с началом координат по умолчанию.

Пример

При запуске программа рисует пиксель в центре экрана по координатам (120, 120).#

при запуске
[Draw a pixel at the center of the screen.]
нарисовать пиксель [120] [120] на экране

нарисуйте линию на экране #

Блок стека рисовать линию на экране рисует линию от первой экранной координаты (x1, y1) до второй экранной координаты (x2, y2), используя текущие ширина пера и цвет пера.

Например, если начало координат установлено в точке (120, 120), диапазон координат x и y будет от -120 до 120.

нарисовать линию стека блок#

нарисовать линию [0] [0] [10] [10] на экране

Параметры	Описание
x1	Координата x в пикселях начала линии, от 0 до 240, с началом координат по умолчанию.
y1	Y-координата в пикселях начала линии, от 0 до 240, с началом координат по умолчанию.
x2	Координата x в пикселях конца линии, от 0 до 240, с началом координат по умолчанию.
y2	Координата Y в пикселях конца линии, от 0 до 240, с началом координат по умолчанию.

Пример

При запуске рисует диагональную линию от верхнего левого угла (0,0) до нижнего правого угла (240,240) экрана.#

при запуске
[Draw a line from the top left to bottom right of the screen.]
нарисовать линию [0] [0] [240] [240] на экране

Скриншот экрана робота с тонкой белой диагональной линией, проведенной от верхнего левого угла к нижнему правому углу.

нарисуйте прямоугольник на экране #

Блок рисовать прямоугольник на экране рисует прямоугольник, используя текущие значения ширина пера, цвет пера и цвет заливки.

Например, если начало координат установлено в точке (120, 120), диапазон координат x и y будет от -120 до 120.

нарисовать прямоугольник, сложить блок#

нарисовать прямоугольник [0] [0] [10] [10] на экране

Параметры	Описание
х	Координата x в пикселях верхнего левого угла прямоугольника, от 0 до 240, с началом координат по умолчанию.
й	Координата Y в пикселях верхнего левого угла прямоугольника, от 0 до 240, с началом координат по умолчанию.
ширина	Ширина прямоугольника в пикселях.
высота	Высота прямоугольника в пикселях.

Пример

При запуске программа рисует на экране прямоугольник с верхним левым углом в точке (50,50), шириной 130 пикселей и высотой 60 пикселей.#

при запуске
[Draw a rectangle on the screen.]
нарисовать прямоугольник [50] [50] [130] [60] на экране

Скриншот экрана робота с белым прямоугольником, нарисованным в верхней половине.

нарисуйте круг на экране #

Блок рисовать круг на экране рисует круг, используя текущие значения ширина пера, цвет пера и цвет заливки.

Например, если начало координат установлено в точке (120, 120), диапазон координат x и y будет от -120 до 120.

нарисовать круг, сложить блок#

нарисовать круг [0] [0] [10] на экране

Параметры	Описание
х	Координата x в пикселях центра окружности, от 0 до 240, с началом координат по умолчанию.
й	Координата Y в пикселях центра круга, от 0 до 240, с началом координат по умолчанию.
радиус	Радиус круга в пикселях.

Пример

При запуске рисует на экране круг с центром в точке (120,120) и радиусом 40 пикселей.#

при запуске
[Draw a circle on the screen.]
нарисовать круг [120] [120] [40] на экране

Скриншот экрана робота с белым кругом, нарисованным в центре.

Трогать #

экран нажат #

Логический блок screen pressed сообщает, нажата ли в данный момент кнопка на экране робота.

Верно — Нажата кнопка на экране.
Неверно — Нажатие на экран не происходит.

Нажатие на экране Логический блок#

<экран нажат?>

Параметры	Описание
	Этот блок не имеет параметров.

Пример

При запуске система постоянно проверяет, нажата ли кнопка на экране. Если кнопка нажата, все светодиоды загораются белым цветом; в противном случае они остаются выключенными.#

при запуске
[Turn LEDs white only when the screen is pressed.]
вечно
если <экран нажат?> то
установить цвет LED [lightall v] [белый v]
иначе
установить цвет LED [lightall v] [выкл v]
конец
конец

положение экрана #

Блок отчета о положении на экране сообщает выбранные координаты последнего нажатия на экран. Координата x находится в диапазоне от 0 (слева) до 240 (справа). Координата y находится в диапазоне от 0 (сверху) до 240 (снизу).

блок репортера положения экрана#

([x v] позиция на экране)

Параметры	Описание
координата	Координаты последнего нажатия кнопки на экране, о которых сообщается: x обозначает горизонтальное положение, а y — вертикальное положение.

Пример

При запуске постоянно проверяет наличие нажатий на экран. В случае нажатия очищает экран и выводит координаты x и y точки касания.#

при запуске
[Display the x and y coordinate of where the screen is pressed.]
вечно
если <экран нажат?> то
очистить экран
вывести ([x v] позиция на экране) на экран ▶
перенести курсор на следующую строку на экране
вывести ([y v] позиция на экране) на экран ▶
конец
конец

когда событие экрана #

Блок when screen event запускает прикрепленный к нему набор блоков при нажатии или отпускании кнопки на экране робота.

когда событие экрана блок шляпы#

когда экран [нажат v]

Параметры	Описание
действие	Когда следует запускать прикрепленный набор блоков: pressed запускается при нажатии на экран, а released — при отпускании экрана.

Пример

При нажатии на экран все светодиоды загораются зеленым цветом.#

когда экран [нажат v]
[Set the LEDs to green when the screen is pressed.]
установить цвет LED [lightall v] [зелёный v]