Екран#

Вступ#

Блоки «Екран» керують екраном контролера дрона VEX AIR, дозволяючи вашому контролеру відображати текст, числа, графіку та зображення, а також реагувати на сенсорне введення.

Примітка: Якщо дрон VEX AIR підключено до контролера, у верхній частині екрана друку відображатиметься таймер, який показуватиме час виконання поточного проєкту. Будь-який текст або малюнки відображатимуться за таймером.

Нижче наведено список доступних блоків:

Друк курсора – відображення тексту та керування курсором друку.

Друк XY – Друк тексту за піксельними координатами.

Налаштування – Змінення вигляду тексту, графіки та відображення на екрані.

Малювання – створюйте графіку та візуальні елементи.

Сенсорний екран – виявлення взаємодій з ним.

  • натиснутий екран — Повідомляє, чи натиснуто екран у даний момент.

  • позиція екрана — Повідомляє координату x або y останнього натискання екрана.

  • when screen event — Виконується, коли екран натискається або відпускається.

Курсор друку#

встановити курсор на рядок-стовпець на екрані#

Блок стеку встановити курсор на рядок-стовпець на екрані переміщує курсор до певного рядка та стовпця на екрані контролера. Наступний блок друк на екрані почне друкувати з цього місця.

Кількість символів, що можуть поміститися на екрані, залежить від вибраного шрифту. Зі стандартним моноширинним середнім шрифтом можна чітко відобразити до 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 з білим текстом біля центру, що показує цифру 25, у рядку 7, стовпці 25.

рядок курсора на екрані#

Блок репортера рядок екранного курсора повідомляє номер рядка, в якому буде надруковано текст, у вигляді цілого числа.

блок репортера рядка екранного курсора#
(рядок курсора екрана)

Параметри

Опис

Цей блок не має параметрів.

Приклад

Після запуску переміщує курсор до рядка 7, стовпця 25 на екрані та друкує номер поточного рядка курсора.#
коли запущено
[Display the cursor's current row.]
встановити курсор на рядок [7] стовпець [25] на екрані
вивести (рядок курсора екрана) на екран ▶

Знімок екрана контролера дрона VEX AIR з білим текстом біля центру, що показує цифру 7, у рядку 7, стовпці 25.

Друк XY#

встановити походження екрана#

Блок стеку 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 з білим прямокутником, намальованим так, що верхній лівий кут є центром екрана.

Налаштування#

чистий екран#

Блок стека очистити екран очищає всі малюнки, текст і зображення з екрана контролера.

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

Параметри

Опис

Цей блок не має параметрів.

Приклад

Після запуску малює коло з центром (120,120) та радіусом 40 пікселів. Через 2 секунди екран очищається.#
коли запущено
[Draw a circle, and clear it after 2 seconds.]
намалювати коло [320] [240] [80] на екрані
чекати [2] секунд
очистити екран

зачекайте, поки відобразиться екран#

Блок стеку wait for screen to render перемикає малювання екрана в режим render-later (відрендеринг пізніше). Після виконання цього блоку наступні блоки екрана не з’являтимуться на екрані контролера, доки не запуститься наступний блок 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 з білим текстом «Screen rendered!» у верхньому лівому куті та білим колом, намальованим у центрі екрана.

заповнити екран#

Блок стеку fill screen очищає всі малюнки, текст і зображення з екрана контролера, а потім змінює фон на заданий колір.

Блок заповнення екрана#
заповнити екран [червоний v]

Параметри

Опис

колір

Колір, на який потрібно змінити фон:

  • червоний
  • зелений
  • синій
  • чорний
  • білий
  • жовтий
  • помаранчевий
  • фіолетовий
  • блакитний

Приклад

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

Знімок екрана контролера дрона VEX AIR, на якому вся область друку заповнена яскраво-зеленим кольором.

встановити шрифт на екрані#

Блок стеку set font on screen встановлює шрифт і розмір, що використовуються для відображення тексту на екрані контролера. Цей шрифт застосовуватиметься до всього тексту, що друкується після виконання цього блоку.

встановити блок стека шрифтів#
встановити шрифт [моноширинний v] [середній v] на екрані

Параметри

Опис

тип

Тип шрифту: моноширинний або пропорційний.

розмір

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

  • дуже малий
  • дуже малий
  • малий
  • середній
  • великий
  • дуже великий
  • дуже великий

Знімок екрана контролера дрона VEX AIR з набором літер і цифр, надрукованих білим кольором у верхньому лівому куті шрифтом Mono 12. Літери AZ розташовані в одному рядку та займають приблизно третину ширини екрана. У нижньому лівому куті читається 91 символ завширшки та 30 рядків.
monospaced super small

Те саме зображення, що й попереднє, тепер зі шрифтом Mono 15. Літери AZ розташовані в одному рядку та займають майже половину ширини екрана. У лівому нижньому куті читається 71 символ завширшки та 23 рядки.
monospaced extra small

Те саме зображення, що й попереднє, тепер зі шрифтом Mono 20. Літери AZ розташовані в одному рядку та займають половину ширини екрана. У лівому нижньому куті читається 53 символи завширшки та 18 рядків.
monospaced small

Те саме зображення, що й попереднє, тепер зі шрифтом Mono 24. Літери AZ розташовані в одному рядку та займають трохи більше половини ширини екрана. У лівому нижньому куті читається 45 символів завширшки та 15 рядків.
monospaced medium

Те саме зображення, що й попереднє, тепер зі шрифтом Mono 30. Літери AZ розташовані в одному рядку та займають приблизно три чверті ширини екрана. У лівому нижньому куті читається 35 символів завширшки та 12 рядків.
monospaced large

Те саме зображення, що й попереднє, тепер зі шрифтом Mono 40. Літери AZ розташовані в одному рядку, займаючи всю ширину екрана. У лівому нижньому куті читається 26 символів завширшки та 9 рядків.
monospaced extra large

Те саме зображення, що й попереднє, тепер зі шрифтом Mono 60. Літери AQ розташовані в одному рядку, займаючи всю ширину екрана. У лівому нижньому куті читається 17 символів завширшки та 6 рядків.
monospaced super large

Те саме зображення, що й попереднє, тепер зі шрифтом Prop 20. Літери AZ розташовані в одному рядку та займають трохи більше половини ширини екрана. У лівому нижньому куті читається 49 символів завширшки та 18 рядків.
proportional small

Те саме зображення, що й попереднє, тепер зі шрифтом Prop 24. Літери AZ розташовані в одному рядку та займають приблизно дві третини ширини екрана. У лівому нижньому куті читається 42 символи по горизонталі та 15 рядків.
proportional medium

Те саме зображення, що й попереднє, тепер зі шрифтом Prop 30. Літери AZ розташовані в одному рядку та займають три чверті ширини екрана. У лівому нижньому куті читається 33 символи по горизонталі та 12 рядків.
proportional large

Те саме зображення, що й попереднє, тепер зі шрифтом Prop 40. Літери AY розташовані в одному рядку, займаючи всю ширину екрана. У лівому нижньому куті читається 24 символи завширшки та 9 рядків.
proportional extra large

Те саме зображення, що й попереднє, тепер зі шрифтом Prop 60. Літери AQ розташовані в одному рядку, займаючи всю ширину екрана. У лівому нижньому куті читається 17 символів завширшки та 6 рядків.
proportional super large

Приклад

Після запуску встановлює шрифт «моноширинний дуже великий» та друкує на екрані «VEX».#
коли запущено
[Display text using a larger font.]
встановити шрифт [моноширинний v] [дуже великий v] на екрані
вивести [VEX] на екран ▶

Те саме зображення, що й попередні, тепер з білим текстом у верхньому лівому куті, на якому написано VEX — це шрифт Mono 40.

встановити точність друку на екрані#

Блок стеку set print precision on screen встановлює кількість знаків після коми, що відображаються під час друку чисел на екрані контролера. Ця точність друку застосовуватиметься до всіх чисел, що друкуються після виконання цього блоку.

встановити блок стека точності друку#
встановити точність друку [0.1 v] на екрані

Параметри

Опис

точність

Встановлює точність друку на:

  • 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 з білим прямокутником і товстою рамкою по центру.

встановити колір пера / шрифту на екрані#

Блок стеку set pen / font color on screen встановлює колір тексту, пікселів, ліній та контурів фігур. Колір за замовчуванням – білий.

встановити блок стека кольорів пера / шрифту#
встановити колір пера/шрифту [червоний 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] на екрані

Параметри

Опис

колір

Колір заливки тексту:

  • червоний
  • зелений
  • синій
  • чорний
  • білий
  • жовтий
  • помаранчевий
  • фіолетовий
  • блакитний
  • прозорий

Приклади

Після запуску встановлює колір заливки на помаранчевий та малює два прямокутники. Перший знаходиться на точці (50, 50), а другий — на точці (50, 130), обидва шириною 100 пікселів та висотою 60 пікселів.#
коли запущено :: hat events
[Display two colors behind text.]
встановити колір заливки тексту [червоний v] на екрані
вивести ["Red"] на екран ▶
перейти до наступного рядка на екрані
встановити колір заливки тексту [синій v] на екрані
вивести ["Blue"] на екран ▶

встановити колір заливки малювання на екрані#

Блок стеку встановити колір заливки, що малюється на екрані встановлює колір заливки, який використовується під час малювання фігур. Колір заливки за замовчуванням – чорний.

встановити блок стека кольору заливки малювання#
встановити колір заливки малюнка [червоний v] на екрані

Параметри

Опис

колір

Колір заливки фігури:

  • червоний
  • зелений
  • синій
  • чорний
  • білий
  • жовтий
  • помаранчевий
  • фіолетовий
  • блакитний
  • прозорий

Приклади

Після запуску встановлює колір заливки на помаранчевий та малює два прямокутники. Перший знаходиться на точці (50, 50), а другий — на точці (50, 130), обидва шириною 100 пікселів та висотою 60 пікселів.#
коли запущено
[Draw an orange-filled rectangle with text on top.]
встановити колір заливки малюнка [помаранчевий v] на екрані
намалювати прямокутник [200] [150] [240] [150] на екрані
вивести [VEXcode AIR] у x:[250] y:[220] на екрані

Знімок екрана контролера дрона VEX AIR із суцільним помаранчевим прямокутником з тонкою білою рамкою та білим текстом VEXcode AIR по центру.

Нічия#

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

Блок стеку показати файл зображення на екрані малює власне зображення, завантажене користувачем, на екрані контролера в точці встановити походження.

показати блок стека зображень користувача#
показати файл зображення [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] на екрані

Знімок екрана контролера дрона VEX AIR з 5 рівномірно розташованими пікселями, надрукованими діагональною лінією по центру екрана.

малювати лінію на екрані#

Блок стеку draw line on screen малює лінію від першої координати екрана (x1, y1) до другої координати екрана (x2, y2), використовуючи поточні значення width of pen та pen color.

блок стека ліній малювання#
намалювати лінію [0] [0] [10] [10] на екрані

Параметри

Опис

х1

Координата x у пікселях початку лінії від 0 до 640.

y1

Y-координата в пікселях початку лінії від 0 до 480.

х2

Координата 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 повідомляє, чи натискається екран контролера в даний момент.

  • True – На екрані наразі натискають кнопку.

  • Хибно – Екран не натискається

логічний блок, натиснутий на екрані#
<екран натиснуто?>

Параметри

Опис

Цей блок не має параметрів.

Приклад

коли запущено
[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 запускається, коли екран контролера натискається або відпускається.

Коли подія екрана блокує hat#
коли екран [натиснуто v]

Параметри

Опис

дія

Визначає, коли буде запущено приєднаний стек блоків: pressed запускається, коли екран натискається, а released запускається, коли екран відпускається.

Приклад

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