Команди дисплея керують LCD-екраном вашого робота Sphero BOLT+. У той час як BOLT має матрицю світлодіодів 8x8, BOLT+ має LCD-екран 128x128. У BOLT дані анімації та зображень для матриці зберігаються в додатку та надсилаються на робот, коли програма виконується. Це означає, що кожного разу при запуску програми користувач повинен чекати, поки дані матриці передаються через Bluetooth. Це достатньо швидко для матричних активів, оскільки є лише 8x8 (або 64) "пікселя" даних для передачі на кожен кадр. Однак з BOLT+ потрібно передавати 128x128 (або 16 384) "пікселі" даних на кожен кадр. Передача цих активів через Bluetooth займе більше часу, тому всі зображення та анімації зберігаються безпосередньо в пам'яті робота BOLT+ для швидкого доступу. У результаті, немає етапу "передачі" активів при виконанні програми, що використовує команди дисплея BOLT+.

await setDisplayImage() відображає зображення на LCD-екрані Sphero BOLT+. 

Встановіть конкретний актив на дисплеї, використовуючи або asset ID (ID активу), або firmware ID (ID прошивки). 

Наприклад, використовуйте: await setDisplayImage("slightly-smiling") щоб вивести смайлик на екран. 

Або, використовуючи firmware ID: await setDisplayImage("287") щоб вивести той самий смайлик на екран за допомогою ID прошивки. 

Бібліотека всіх підтримуваних зображень і їх відповідних ID наведена нижче.

await setDisplayAnimation() відображає анімацію на LCD-екрані Sphero BOLT+. 

Встановіть конкретний актив на дисплеї, використовуючи або asset ID (ID активу), або firmware ID (ID прошивки). 

Наприклад, використовуйте asset ID (ID активу): await setDisplayAnimation("fireworks", true) щоб показати анімацію феєрверків на екрані. 

Або, використовуючи firmware ID (ID прошивки): await setDisplayAnimation("1029", true) щоб показати анімацію феєрверків на екрані. 

Якщо встановлено значення true, анімація буде циклічно повторюватися, і програма перейде до наступного рядка коду. Це дозволяє циклічно виконувати анімацію, поки надсилаються додаткові команди роботу. Якщо встановлено значення false, програма буде чекати, поки анімація виконається один раз, перш ніж перейти до наступного кроку в коді. 

Бібліотека всіх підтримуваних анімаційних активів і їх відповідних ID наведена нижче.

await setDisplayText() відображає текст, вибраний користувачем, на LCD-екрані Sphero BOLT+. 

Користувач може налаштувати: 

• Font size (розмір тексту) 
• Text string (рядки тексту) 
• Text color (колір тексту) 
• Background color (колір фону) 

Приклад: await setDisplayText(`Hello\\nWorld!`, { r: 255, g: 255, b: 255 }, { r: 0, g: 0, b: 0 }, 0 

To better understand the anatomy of a display text command, let's break this example down: 

`Hello\\nWorld!` — це рядок тексту. Це текст, який ви хочете відобразити на самому екрані. 

Весь текст має починатися і закінчуватися знаком ` для того, щоб правильно обробляти спецсимволи. На відміну від інших команд з рядками, ми використовуємо ` замість ", оскільки символ ", який є частиною рядка, є допустимим. \\n використовується для встановлення переносу рядка. 

У цьому прикладі, \\n забезпечить, що "Hello" з'явиться на першому рядку екрана, а "World!" — на другому рядку. 

Якщо це налаштування не буде правильно встановлено, текст вийде за межі правої частини екрана. 

Оскільки прошивка BOLT+ не автоматично обгортає символи, ці переноси рядка необхідні, щоб усі символи помістилися на екрані. 

{ r: 255, g: 255, b: 255 }, { r: 0, g: 0, b: 0 } — це значення RGB, які використовуються для налаштування кольору тексту та фону. 

У цьому прикладі текст буде білим на чорному фоні. Якщо колір тексту і фон будуть однаковими, текст буде нечитабельним. Перше значення RGB — це колір тексту, а друге — це колір фону. В кінці команди display text ви можете використати або 0, або 1, щоб налаштувати розмір шрифту. 

Є два розміри шрифтів, які ви можете встановити, і кожен із них впливає на кількість символів на рядок і кількість рядків на дисплеї. 

• Нормальний розмір шрифту дозволяє 6 рядків і 10 символів на рядок.
• Великий розмір шрифту дозволяє 5 рядків і 7 символів на рядок. 

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

Підтримувані символи: 

Як для нормального, так і для великого шрифтів, вони зберігаються в пам'яті BOLT+. Тому є обмеження на те, які символи підтримуються. 

Обидва шрифти підтримують розширені символи ASCII, як визначено в стандарті ISO/IEC 8859-1. Будь-які введені символи, які не є частиною стандарту, будуть відображені як символ помилки Sphero на екрані BOLT+. Нижче наведена таблиця підтримуваних символів стандарту ISO/IEC 8859-1.

clearDisplay() очищає LCD-екран Sphero BOLT+, роблячи його "off" (вимкненим, чорним). 

clearDisplay() також очистить будь-які зображення матриці, анімації чи текстові рядки, які використовуються з BOLT+. 

Прошивка BOLT+ імітує поведінку матриці світлодіодів BOLT, відображаючи 8x8 сітку кольорових кругів на дисплеї. 

Таким чином, всі команди матриці є підмножиною команд дисплея, що означає, що зображення та анімації матриці можна очистити за допомогою команди clear display (очистити дисплей), так само як і команди clear matrix (очистити матрицю).

setDisplayRotation() обертає напрямок дисплея LCD-екрана Sphero BOLT+ для всіх наступних зображень, анімацій і текстів. 0° — це стандартний напрямок, що відповідає передній частині. 90° — вправо, 270° — вліво, 180° — вниз головою. 

setDisplayRotation() також обертає будь-які зображення матриці, анімації або текстові рядки, які використовуються з BOLT+. 

Прошивка BOLT+ імітує поведінку матриці світлодіодів BOLT, відображаючи 8x8 сітку кольорових кругів на дисплеї. 

Таким чином, всі команди матриці є підмножиною команд дисплея, що означає, що зображення та анімації матриці можна контролювати за допомогою команди display rotation (обертання дисплея) та команди matrix rotation (обертання матриці).

await setLiveSensorData() відображає дані сенсорів в реальному часі на LCD-екрані Sphero BOLT+. 

Виведення даних безпосередньо на екран означає, що вони не передаються через Bluetooth до додатку Sphero Edu перед відображенням, що знижує затримку і підвищує частоту вибірки даних. Щоб налаштувати дані сенсорів на дисплеї, потрібно надіслати число роботу, щоб вказати, який сенсор використовувати. 

Чому ми передаємо число, а не рядок з назвою сенсора? Тому що ми використовуємо bitmask (бітову маску). 

Бітова маска — це простий і ефективний спосіб вибору серед кількох варіантів. Робот розуміє лише двійкові числа, або біти (від англ. "binary digit"). Двійкове числення використовує два цифри замість десяти, множачи числа на два. Наприклад, 1 у двійковій системі — це 00000001, 2 — це 00000010, а 64 — це 01000000. 

Бітова маска дозволяє використовувати двійкове представлення для вибору серії опцій. У нашому випадку ми вказуємо, який сенсор потрібно відобразити. 

Нижче наводиться таблиця доступних опцій сенсорів та їх відповідних бітових чисел, які можна використовувати в команді await setLiveSensorData(). 

На основі таблиці ви можете використовувати await setLiveSensorData(16) для відображення даних швидкості в реальному часі, і await setLiveSensorData(64) для відображення даних гіроскопа.

await setDisplayColor() налаштовує LCD-екран Sphero BOLT+ на вибраний користувачем колір. 

Наприклад, використовуйте: await setDisplayColor({ r: 0, g: 255, b: 0 }) щоб показати зелений колір. 

Щоб випадковим чином змінити колір дисплея, ви можете використовувати: await setDisplayColor(getRandomColor()). 

await setDisplayColor() не має відповідного блоку в block canvas (полотні блоків). Тому його можна використовувати лише в text canvas (текстовому полотні).