Экран#

Введение #

Блоки управления экраном позволяют контроллеру VEX AIR Drone Controller отображать текст, цифры, графику и изображения, а также реагировать на сенсорный ввод.

Примечание: Если дрон VEX AIR сопряжен с контроллером, в верхней части экрана будет отображаться таймер, показывающий прошедшее время выполнения текущего проекта. Любой текст или чертежи будут отображаться за таймером.

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

Печать курсора — отображение текста и управление курсором печати.

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

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

вывести на экран в заданной координате — Выводит текст, числа или значения переменных в заданных координатах x и y.
установить начало координат экрана — Изменяет начало координат (0, 0), используемое для печати и рисования на основе координат.

Настройки — Изменение внешнего вида текста, графики и отображения на экране.

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

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

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

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

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

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

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

The print on screen stack block prints text, numbers, or variable values on the controller screen at the current cursor position and font.

print stack block#

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

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

Пример

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

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

Скриншот экрана контроллера дрона VEX AIR с белым текстом в верхнем левом углу, гласящим «Время летать!»

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

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

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

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

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

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

Примеры

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

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

Скриншот экрана контроллера дрона VEX AIR, с белым текстом в центре, который гласит «Строка 7, столбец 25» в этом положении экрана.

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

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

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

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

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

Пример

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

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

Скриншот экрана контроллера дрона VEX AIR с белым текстом в верхнем левом углу, где на верхней строке написано «Строка 1», а непосредственно под ней — «Строка 2».

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

Блок стека clear row on screen очищает строку текста на экране контроллера.

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

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

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

Пример

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

при запуске
[Clear only the second row of text.]
вывести [This text stays] на экран ▶
перенести курсор на следующую строку на экране
вывести [This text disappears] на экран ▶
ждать [3] секунд
очистить строку [2] на экране

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

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

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

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

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

Пример

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

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

Скриншот экрана контроллера дрона VEX AIR, с белым текстом около центра, находящимся в 7-й строке, 25-м столбце.

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

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

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

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

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

Пример

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

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

Скриншот экрана контроллера дрона VEX AIR, с белым текстом около центра, находящимся в 7-й строке, 25-м столбце.

Печать XY #

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

The print at coordinate on screen stack block prints text, numbers, or variable values on the controller screen at a specific (x, y) position in pixels, using the current font and origin. x sets how far from the left side the text begins, and y sets where the bottom of the letters sit. This block disregards the current cursor position.

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

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

Параметры	Описание
ценить	Текст, число или значение переменной для вывода на экран.
х	Координата x в пикселях (от 0 до 640, где 0 — влево, а 640 — вправо).
й	Координата Y в пикселях (от 0 до 480, где 0 — верхняя граница, а 480 — нижняя граница).

Пример

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

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

Скриншот экрана контроллера дрона VEX AIR с белым текстом «Привет, дрон!», начинающимся в центре экрана.

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

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

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

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

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

Пример

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

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

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

Настройки #

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

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

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

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

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

Пример

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

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

дождитесь отрисовки экрана #

Блок стека wait for screen to render переключает режим отрисовки экрана на отложенную отрисовку. После выполнения этого блока последующие блоки экрана не будут отображаться на экране контроллера до тех пор, пока не выполнится следующий блок wait for screen to render.

Примечание: Используйте этот блок перед рисованием группы текста, фигур или изображений, а затем используйте его снова, чтобы отобразить все обновление сразу.

ждать отрисовки экрана

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

Пример

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

при запуске
[Display text and images when button 7 is pressed.]
ждать отрисовки экрана
вывести [Screen rendered!] на экран ▶
нарисовать круг [320] [240] [80] на экране
ждать пока <кнопка контроллера [7 v] нажата?>
ждать отрисовки экрана

Скриншот экрана контроллера дрона VEX AIR с белым текстом «Экран отрисован!» в верхнем левом углу и белым кругом, нарисованным в центре экрана.

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

Блок заполнение экрана очищает все рисунки, текст и изображения с экрана контроллера, а затем изменяет цвет фона на указанный.

Блок заполнения экрана#

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

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

Пример

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

Скриншот экрана контроллера дрона VEX AIR, вся область экрана, доступная для печати, заполнена ярко-зеленым цветом.

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

Блок set font on screen задает шрифт и размер, используемые для отображения текста на экране контроллера. Этот шрифт будет применяться ко всему тексту, выводимому после выполнения этого блока.

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

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

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

Параметры

Описание

тип

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

размер

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

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

`monospaced super small`	`monospaced extra small`	`monospaced small`
`monospaced medium`	`monospaced large`	`monospaced extra large`
`monospaced super large`	`proportional small`	`proportional medium`
`proportional large`	`proportional extra large`	`proportional super large`

Пример

При запуске программа устанавливает шрифт на «моноширинный сверхбольшой» и выводит на экран «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]) на экран ▶

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

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

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

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

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

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

Пример

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

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

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

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

Блок Установка цвета пера/шрифта на экране задает цвет текста, пикселей, линий и контуров фигур. Цвет по умолчанию — белый.

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

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

Пример

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

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

при запуске
[Draw a rectangle with an orange outline.]
установить цвет пера/шрифта [оранжевый v] на экране
нарисовать прямоугольник [200] [150] [240] [150] на экране
установить цвет пера/шрифта [белый v] на экране
вывести [VEXcode AIR] по x:[250] y:[220] на экране

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

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

Блок Установка цвета заливки текста на экране задает цвет заливки за печатным текстом. Цвет заливки текста по умолчанию — прозрачный.

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

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

Параметры	Описание
цвет	The text fill color to use: red green blue black white yellow orange purple cyan transparent

Примеры

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

при запуске :: hat events
[Display two colors behind text.]
установить цвет заливки текста [красный v] на экране
вывести ["Red"] на экран ▶
перенести курсор на следующую строку на экране
установить цвет заливки текста [синий v] на экране
вывести ["Blue"] на экран ▶

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

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

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

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

Параметры	Описание
цвет	The shape fill color to use: red green blue black white yellow orange purple cyan transparent

Примеры

при запуске
[Draw an orange-filled rectangle with text on top.]
установить цвет заливки рисунка [оранжевый v] на экране
нарисовать прямоугольник [200] [150] [240] [150] на экране
вывести [VEXcode AIR] по x:[250] y:[220] на экране

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

Рисовать #

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

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

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

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

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

Пример

дело#

при запуске
[Display custom image on screen.]
показать файл изображения [IMAGE1 v]

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

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

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

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

Параметры	Описание
х	Координата x для отрисовки пикселя в диапазоне от 0 до 640.
й	Координата Y для отрисовки пикселя в диапазоне от 0 до 480.

Пример

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

при запуске
[Draw five pixels in a diagonal.]
нарисовать пиксель [360] [200] на экране
нарисовать пиксель [340] [220] на экране
нарисовать пиксель [320] [240] на экране
нарисовать пиксель [300] [260] на экране
нарисовать пиксель [280] [280] на экране

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

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

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

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

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

Пример

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

при запуске
[Make an X across the screen.]
нарисовать линию [0] [0] [640] [480] на экране
установить цвет пера/шрифта [голубой v] на экране
нарисовать линию [0] [480] [640] [0] на экране

Скриншот экрана контроллера дрона VEX AIR с белой линией, проведенной от верхнего левого угла к нижнему правому углу, и бирюзовой линией, проведенной от нижнего левого угла к верхнему правому углу и пересекающейся в центре.

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

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

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

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

Пример

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

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

при запуске
[Draw two rectangles on the screen.]
нарисовать прямоугольник [0] [0] [620] [460] на экране
установить цвет заливки рисунка [зелёный v] на экране
нарисовать прямоугольник [200] [180] [200] [100] на экране

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

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

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

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

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

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

Пример

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

при запуске
[Draw one green circle on the screen.]
установить цвет заливки рисунка [зелёный v] на экране
нарисовать круг [320] [240] [200] на экране

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

Трогать #

экран нажат #

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

Верно - В данный момент нажата кнопка «Экран».
Ложь - Нажатие на экран не происходит.

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

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

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

Пример

при запуске
[Play a sound when the screen is pressed.]
вечно
если <экран нажат?> то
воспроизвести ноту [низкий v] [C v] [note_eight v] ▶

При нажатии на экран отображается первое сообщение. Затем код ожидает, пока экран не будет отпущен, и продолжает выполнение только после повторного нажатия на экран, чтобы отобразить второе сообщение.#

при запуске
[Display different messages after the screen is pressed.]
ждать пока <экран нажат?>
вывести [First message!] на экран ▶
перенести курсор на следующую строку на экране
[Lift finger to press the screen again.]
ждать пока <не <экран нажат?>>
ждать пока <экран нажат?>
вывести [Second message!] на экран ▶

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

Блок обработки данных о положении экрана сообщает координаты x или y в пикселях в том месте, где экран был нажат в последний раз. Возвращаемое значение для x находится в диапазоне от 0 (слева) до 640 (справа). Возвращаемое значение для y находится в диапазоне от 0 (сверху) до 480 (снизу).

Контроллер дрона VEX AIR с обозначенной и выделенной красной рамкой областью экрана для печати. Координаты начинаются с (0,0) в верхнем левом углу и идут по часовой стрелке с (0, 640), (480, 640) и (480,0) в нижнем левом углу. Центральные координаты экрана обозначены как (240, 320).

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

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

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

Пример

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

при запуске
[Play high or low note based on where screen is pressed.]
вечно
если <экран нажат?> то
если <([x v] позиция на экране) [math_greater_than v] [320]> то
воспроизвести ноту [высокий v] [C v] [note_eight v] ▶
иначе
воспроизвести ноту [низкий v] [C v] [note_eight v] ▶

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

Блок when screen event запускается при нажатии или отпускании кнопки на экране контроллера.

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

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

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

Пример

когда экран [нажат v]
[Play a sound when the screen is pressed.]
воспроизвести звук [успех v] ▶