Пример framebuffer_qr_writer

Пример демонстрирует организацию графического интерфейса пользователя (англ. Graphical User Interface, GUI) в решении на базе KasperskyOS с использованием набора кроссплатформенных библиотек: SDL2 для управления окном программы и обработки ввода данных от пользователя, Nuklear для построения графического интерфейса, Skia в качестве механизма отрисовки графики, а также ZXing для генерации QR-кодов.

Директория примера в SDK

Код примера и скрипты для сборки находятся по следующему пути:

/opt/KasperskyOS-Community-Edition-<platform>-<version>/examples/framebuffer_qr_writer

Список программ

• QrWriter – прикладная программа, которая преобразует введенный пользователем текст в QR-код, и отображает его в графическом интерфейсе.
• EntropyEntity – системная программа, реализующая генератор случайных чисел.
• VfsSdCardFs – системная программа, поддерживающая файловую систему SD-карт.
• BlobContainer – системная программа, необходимая для работы с динамическими библиотеками в разделяемой памяти.
• DCM – системная программа, предоставляющая функциональность для динамического создания IPC-каналов.
• SDCard – драйвер SD-карты.
• FB – драйвер,обеспечивающий взаимодействие с видеоплатой.
• Input – драйвер, обеспечивающий взаимодействие с USB-устройствами ввода (мышь, клавиатура).
• USB – драйвер для управления всеми типами USB-устройств.

При сборке примера для целевой аппаратной платформы в решение автоматически включаются платформенно-зависимые драйверы:

• GPIO – драйвер поддержки GPIO для Radxa ROCK 3A.
• PCIE – драйвер шины PCIe для Raspberry Pi 4 B.
• BSP – пакет поддержки аппаратной платформы (Board Support Package), обеспечивающий кросс-платформенную настройку периферии для Radxa ROCK 3A и Raspberry Pi 4 B.
• PinCtrl – драйвер низкоуровневой конфигурации мультиплексирования пинов (pinmux) для Radxa ROCK 3A.
• Bcm2711MboxArmToVc – драйвер для работы с сопроцессором VideoCore (VC6) через технологию mailbox для Raspberry Pi 4 B.

Описание инициализации

Файл описания инициализации решения init.yaml генерируется в процессе сборки решения на основе шаблона ./einit/src/init.yaml.in. Макросы вида @INIT_*@, которые содержатся в шаблоне, автоматически раскрываются в итоговом файле init.yaml. Подробнее см. "Шаблон init.yaml.in".

Описание политики безопасности

Файл security.psl содержит описание политики безопасности решения на базе KasperskyOS и находится в директории ./einit/src. Декларации в PSL-файле снабжены комментариями, которые поясняют назначение этих деклараций.

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

Ресурсы

В директории ./resources/hdd/etc содержится файл ProggyClean.ttf, который содержит информацию о шрифте (название, размер, стиль). Этот файл используется для отображения текста в графическом интерфейсе пользователя.

Сценарий работы

Программа QrWriter выполняет следующие действия:

1. Использует библиотеку SDL2 для инициализации видеоподсистемы и создания полноэкранного окна программы.
2. Использует библиотеку Skia для настройки графического контекста на основе информации о поверхности окна, полученной от SDL2.
3. Использует библиотеку Nuklear для инициализации графического интерфейса через реализацию nuklear_skia.
4. В бесконечном цикле:
   • Обрабатывает ввод: использует SDL2 для опроса системной очереди событий и Nuklear для преобразования событий в изменения состояния графического интерфейса.
   • Отрисовывает графический интерфейс: использует Nuklear для формирования команд отрисовки элементов управления в режиме Immediate Mode.
   • Генерирует QR-код: при нажатии кнопки использует библиотеку ZXing для преобразования текста в монохромное растровое изображение.
   • Рендерит кадр: использует библиотеку Skia для выполнения команд отрисовки и формирования итогового изображения в кадровом буфере.
   • Выводит на экран: использует SDL2 для обновления поверхности окна содержимым кадрового буфера.

Сборка и запуск примера

Для сборки и запуска примера используется система CMake из состава KasperskyOS Community Edition.

См. "Сборка и запуск примеров".