Екран#

Вступ#

Блоки екрана контролюють, як робот-кодувальник VEX AIM відображає текст, числа та графіку на екрані, а також як він реагує на натискання клавіш на екрані.

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

Друк курсора — керування відображенням тексту за допомогою системи курсорів у рядках і стовпцях.

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

Налаштування — Налаштування форматування тексту та відображення на екрані.

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

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

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

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

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

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

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

Блок стеку встановити курсор на рядок/стовпець на екрані переміщує курсор до певного рядка та стовпця на екрані робота. Наступний блок друкувати на екрані почне друкуватися в цьому місці. Кількість рядків та стовпців, які можуть зручно поміститися, залежить від вибраного шрифту. Зі стандартним моноширинним середнім шрифтом можна чітко відображати до 8 рядків та 13 стовпців. Текст, розміщений за межами цього діапазону, може бути обрізаний або його важко читати.

Моноширинні шрифти мають символи однакової ширини, що забезпечує узгоджене розміщення тексту. Натомість, пропорційні шрифти відрізняються шириною символів, тому деякі літери займають більше місця, ніж інші. Однак, незалежно від того, який тип використовується, блок стеку set cursor to row column on screen позиціонує курсор на основі розміру рядка та стовпця, а не стилю шрифту. Розмір шрифту можна налаштувати за допомогою блоку стеку set font on screen.

Встановити блок стека курсора#
встановити курсор на рядок [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] на екрані
вивести (стовпець курсора екрана) на екран ▶

Знімок екрана робота з білою цифрою 2, надрукованою біля центру верхнього лівого квадранта, у рядку 3, стовпці 2.

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

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

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

Параметри

Опис

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

Приклад

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

Знімок екрана робота з білою цифрою 3, надрукованою біля центру верхнього лівого квадранта, у рядку 3, стовпці 2.

Друк XY#

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

Блок стеку 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] на екрані

Знімок екрана робота з білим прямокутником, намальованим у лівому нижньому квадранті. Лівий верхній кут прямокутника — це центр екрана.

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

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

Блок стеку очистити екран очищає всі малюнки та текст з екрана робота та скидає позицію курсора до рядка 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]

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

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

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

Параметри

Опис

тип

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

розмір

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

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

Знімок екрана робота, на якому показано вибірку цифр і літер, надрукованих шрифтом Mono 12. Алфавіт займає 1 рядок тексту. Нижній рядок має 26 символів у ширину та 15 рядків.
моноширинний надмалий шрифт

Те саме зображення, що й попереднє, шрифтом Mono 15. Літери AT займають 1 рядок тексту. Нижній рядок має 20 символів завширшки та 12 рядків.
моноширинний надмалий шрифт

Те саме зображення, що й попереднє, шрифтом Mono 20. Літери AP займають 1 рядок тексту. Нижній рядок має 16 символів завширшки та 9 рядків.
моноширинний малий шрифт

Те саме зображення, що й попереднє, шрифтом Mono 24. Літери AM займають 1 рядок тексту. Нижній рядок має 13 символів завширшки та 8 рядків.
моноширинний середній

Те саме зображення, що й попереднє, шрифтом Mono 30. Літери AK займають 1 рядок тексту. Нижній рядок має 11 символів завширшки та 6 рядків.
великий моноширинний шрифт

Те саме зображення, що й попереднє, шрифтом Mono 40. Літери AH займають 1 рядок тексту. Нижній рядок читається з 8 символами в ширину та займає 5 рядків.
моноширинний дуже великий

Те саме зображення, що й попереднє, шрифтом Mono 60. Числа 1-6 займають 1 рядок тексту. Нижня частина читається в 3 рядках.
моноширинний дуже великий

Те саме зображення, що й попереднє, шрифтом Prop 20. Літери As займають 1 рядок тексту. Нижній рядок має 20 символів завширшки та 9 рядків.
пропорційний маленький

Те саме зображення, що й попереднє, шрифтом Prop 30. Літери AM займають 1 рядок тексту. Нижній рядок має 15 символів завширшки та 6 рядків.
пропорційний великий

Те саме зображення, що й попереднє, шрифтом Prop 40. Літери AJ займають 1 рядок тексту. Нижній рядок має 11 символів завширшки та 5 рядків.
пропорційний надвеликий

Знімок екрана робота, на якому показано вибірку чисел, надрукованих шрифтом Prop 60. Числа 1-7 займають 1 рядок тексту. Внизу написано 7 на 3.
пропорційний надвеликий

Приклад

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

Знімок екрана робота показує слово VEX шрифтом Mono 40, надруковане білим кольором у верхньому лівому куті.

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

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

встановити блок стека точності друку#
встановити точність друку [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]) на екран ▶

На знімку екрана робота у верхньому лівому куті видно 0,33 білим кольором.

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

Блок стеку встановити ширину пера на екрані встановлює товщину намальованих ліній та контурів фігур.

встановити блок стека ширини пера#
встановити ширину пера [10] на екрані

Параметри

Опис

ширина

Ширина пера, у пікселях, від 0 до 32.

Приклад

Після запуску встановлює ширину пера на 10 пікселів і малює прямокутник з верхнім лівим кутом у точці (50,50), шириною 130 пікселів і висотою 60 пікселів.#
коли запущено
[Draw a rectangle with a pen width of 10.]
встановити ширину пера [10] на екрані
намалювати прямокутник [50] [50] [130] [60] на екрані

Знімок екрана робота з товстим білим прямокутником, намальованим у верхній половині.

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

Блок стеку set pen / font color on screen встановлює колір тексту, пікселів, ліній та контурів фігур.

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

Знімок екрана робота показує напис «Виділити» білим текстом з фіолетовою підсвіткою навколо нього, починаючи з верхнього лівого кута.

Нічия#

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

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

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

Параметри

Опис

номер слота зображення

Власне зображення для використання, номер від 1 до 10. Номер зображення збігається з номером, що відображається на панелі керування AIM.

Приклад

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

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

Блок стеку малювання пікселя на екрані малює один піксель у вибраних координатах x та y, використовуючи поточний колір перо.

За замовчуванням початок координат розташований у верхньому лівому куті екрана в точці (0, 0). На осі x 0 знаходиться з лівого боку екрана, а 240 – з правого боку. На осі y 0 знаходиться у верхній частині екрана, а 240 – у нижній. Ви можете використовувати блок set screen origin, щоб перемістити початок координат в інше місце. Коли початок координат змінюється, діапазони координат 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] на екрані

Знімок екрана робота з одним білим пікселем у центрі.

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

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

За замовчуванням початок координат розташований у верхньому лівому куті екрана в точці (0, 0). На осі x 0 знаходиться з лівого боку екрана, а 240 – з правого боку. На осі y 0 знаходиться у верхній частині екрана, а 240 – у нижній. Ви можете використовувати блок set screen origin, щоб перемістити початок координат в інше місце. Коли початок координат змінюється, діапазони координат x та y також змінюються.

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

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

Параметри

Опис

х1

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

y1

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

х2

Координата 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] на екрані

Знімок екрана робота з тонкою білою діагональною лінією, проведеною від верхнього лівого кута до нижнього правого кута.

намалювати прямокутник на екрані#

Блок стеку малювати прямокутник на екрані малює прямокутник, використовуючи поточні значення ширина пера, колір пера та колір заливки.

За замовчуванням початок координат розташований у верхньому лівому куті екрана в точці (0, 0). На осі x 0 знаходиться з лівого боку екрана, а 240 – з правого боку. На осі y 0 знаходиться у верхній частині екрана, а 240 – у нижній. Ви можете використовувати блок set screen origin, щоб перемістити початок координат в інше місце. Коли початок координат змінюється, діапазони координат x та y також змінюються.

Наприклад, якщо початок координат встановлено на (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] на екрані

Знімок екрана робота з білим прямокутником, намальованим у верхній половині.

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

Блок стеку малювати коло на екрані малює коло, використовуючи поточні значення ширина пера, колір пера та колір заливки.

За замовчуванням початок координат розташований у верхньому лівому куті екрана в точці (0, 0). На осі x 0 знаходиться з лівого боку екрана, а 240 – з правого боку. На осі y 0 знаходиться у верхній частині екрана, а 240 – у нижній. Ви можете використовувати блок set screen origin, щоб перемістити початок координат в інше місце. Коли початок координат змінюється, діапазони координат x та y також змінюються.

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

  • True — На екран натискають.

  • Хибність — Екран не натискається.

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

Параметри

Опис

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

Приклад

Після запуску постійно перевіряє, чи натискається екран. Якщо натиснути, усі світлодіоди стають білими; в іншому випадку вони залишаються вимкненими.#
коли запущено
[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]