-
-

Документация GUI Библиотеки

-

Легковесная, кроссплатформенная (X11) библиотека для создания графических интерфейсов на C++. Поддерживает программный рендеринг, анимации, иерархию виджетов и событийно-ориентированную архитектуру.

-
- -
-

🚀 Быстрый старт

-

Минимальный пример создания окна с кнопкой и обработкой события.

-
-
- main.cpp - -
- 
#include "gui.h"
-
-int main() {
-    // 1. Создаем окно
-    gui::window win("Мое Приложение");
-    
-    // 2. Добавляем страницу
-    win.addPAGE("main");
-    
-    // 3. Настраиваем страницу виджетами
-    win.configur_page("main", [](gui::page& p) {
-        // Создаем кнопку
-        gui::WidgetData btnData;
-        btnData.id = "my_button";
-        btnData.text = "Нажми меня!";
-        btnData.x = 50; btnData.y = 50;
-        btnData.width = 150; btnData.height = 40;
-        btnData.bg_color = 0x2563EB; // Синий
-        btnData.fg_color = 0xFFFFFF; // Белый текст
-        
-        p.Button(btnData);
-    }, true); // true = сделать активной сразу
-
-    // 4. Подписываемся на событие
-    gui::EventBus::get().on("button.click", [](const gui::EventData& e) {
-        if (e.source_id == "my_button") {
-            std::cout << "Кнопка нажата!" << std::endl;
-        }
-    });
-
-    // 5. Главный цикл
-    while (true) {
-        win.update(); // Обработка событий X11 и отрисовка
-        // Добавьте std::this_thread::sleep_for для экономии CPU
-    }
-    
-    return 0;
-}
-
-
- -
-

🏛 Архитектура

-

Библиотека построена на строгой иерархии:

- - - - - - - - - - -
УровеньКлассОписание
1gui::windowУправляет соединением с X11, главным циклом (`update`) и вкладками.
2gui::pageПредставляет собой вкладку или экран. Наследуется от combat.
3gui::combatБазовый контейнер. Хранит коллекцию виджетов и предоставляет фабричные методы для их создания.
4gui::WidgetКонкретный элемент интерфейса (кнопка, ввод, слайдер). Также наследуется от combat, позволяя создавать вложенные структуры (например, деревья).
-
- -
-

📡 EventBus

-

Глобальная шина событий для слабой связи между компонентами. Реализована как Singleton.

-
-
Использование EventBus
- 
// Подписка на событие
-int token = gui::EventBus::get().on("slider.change", [](const gui::EventData& e) {
-    std::cout << "Widget: " << e.source_id << ", Value: " << e.value << std::endl;
-});
-
-// Генерация события (обычно делается внутри библиотеки, но можно и вручную)
-gui::EventBus::get().emit("custom.event", {"widget_id", "some text", 0.5f, 0, true});
-
-// Отписка
-gui::EventBus::get().off(token);
-
-

Структура EventData содержит: source_id (ID виджета), text, value (для слайдеров/прогресса), index (для списков), flag (для чекбоксов).

-
- -
-

🎨 RawPicture

-

Класс для программного рендеринга в буфер. Поддерживает 8, 16, 24 и 32-битные форматы.

- -
- -
-

🧩 Доступные виджеты

-

Все виджеты создаются через методы класса combat (или page) путем передачи структуры WidgetData.

- - - - - - - - - - - - - - - - -
МетодТипОписание
Button()BUTTONСтандартная кнопка. Поддерживает on_page_click и on_window_click.
Label()LABELТекстовая метка.
Input()INPUTПоле ввода текста. Перехватывает фокус клавиатуры.
Checkbox()CHECKBOXФлажок. Состояние в data.checked.
Radiobutton()RADIOРадиокнопка. Автоматически снимает выделение с других радио-кнопок с тем же id на странице.
Slider()SLIDERПолзунок. Значение 0.0 - 1.0 в data.value. Поддерживает перетаскивание.
Progressbar()PROGRESSИндикатор прогресса. Поддерживает анимацию indeterminate.
Listbox()LISTBOXСписок элементов. Элементы задаются через data.items.
Dropdown()DROPDOWNВыпадающий список с анимацией открытия.
TreeView()TREE_VIEWКонтейнер для древовидной структуры. Использует TreeNode как детей.
ScrollView()SCROLLОбласть с прокруткой содержимого.
RawPictureWidget()RAW_PICОтображает объект RawPicture из data.picture.
-
- -
-

📚 API Справочник: gui::window

-
- window(std::string title) -
-

Конструктор. Инициализирует соединение с X11, создает окно заданного размера (по умолчанию 1200x600) и настраивает маску событий.

-
-
-
- void update() -
-

Главный метод цикла. Обрабатывает все накопленные события X11, обновляет анимации виджетов (tick), очищает окно и перерисовывает вкладки и активную страницу. Должен вызываться постоянно.

-
-
-
- void addPAGE(std::string name) / void configur_page(...) -
-

addPAGE создает пустую страницу. configur_page создает (если нет), применяет лямбда-функцию для наполнения виджетами и может сделать её активной (active = true).

-
-
-
- void openPAGE(std::string name) -
-

Делает указанную страницу активной, деактивируя остальные. Генерирует событие "page.open".

-
-
-
- -
-

📚 API Справочник: gui::combat

-

Базовый класс для контейнеров. Все методы создания виджетов возвращают ссылку на созданный Widget, что позволяет сохранять его для последующего изменения.

-
- Фабричные методы (Button, Label, Input и т.д.) -
-

Принимают объект WidgetData. Автоматически устанавливают соответствующий WidgetType, добавляют виджет во внутренний вектор и возвращают на него ссылку.

-
-
-
- Widget* find(const std::string& id) -
-

Рекурсивный поиск виджета по его уникальному идентификатору id внутри контейнера и всех его дочерних элементов.

-
-
-
- void visit(const std::function& fn) -
-

Применяет переданную лямбда-функцию ко всем виджетам в иерархии. Удобно для массовой модификации (например, отключения всех кнопок).

-
-
-
- -
-

📚 API Справочник: gui::Widget

-
- void setValue(float v) / float getValue() -
-

Устанавливает целевое значение. Для прогресс-баров и слайдеров это запускает плавную анимацию изменения data.value к data.target_value внутри метода tick().

-
-
-
- Анимация и состояние -
-

Виджет содержит поля anim (для dropdown), phase (для неопределенного прогресса). Метод tick(float dt) автоматически вызывается из window::update() и интерполирует значения.

-
-
-
- -
-

💡 Советы и лучшие практики

- -
- - -