Всё, что умеет библиотека, – на одной странице. Это не урок, а справка: открывайте, когда забыли название функции или порядок аргументов.
Полный список лежит в файле include/gui_library.h – там же комментарии к каждой функции. Ничего, кроме перечисленного ниже, коду задачи знать не нужно: внутренние структуры библиотеки убраны из заголовка нарочно.
| Функция | Что делает |
|---|---|
init_gui_library(заголовок, ширина, высота) |
создать окно. Вернула false – дальше идти нельзя |
set_calculation_function(функция) |
отдать библиотеке вашу функцию расчёта |
run_gui_library() |
запустить главный цикл. Ставится последней в main |
Имя функции в set_calculation_function пишется без скобок: передаём саму функцию, а не результат её вызова.
| Функция | Что делает |
|---|---|
add_float_param(имя, начальное, мин, макс, шаг, ползунок) |
дробная ручка |
add_int_param(имя, начальное, мин, макс, шаг, ползунок) |
целая ручка |
add_bool_param(имя, начальное) |
галочка |
add_string_param(имя, начальное) |
строка |
add_button_param(имя, функция) |
кнопка: по нажатию зовёт функцию |
Все аргументы после имени необязательны. Последний, ползунок, превращает поле ввода в ползунок – удобно, когда важен диапазон, а не точное число.
| Функция | Что делает |
|---|---|
add_output_float(имя, начальное) |
дробное показание |
add_output_int(имя, начальное) |
целое показание |
Показание рисуется такой же рамкой, что и ручка, но только для чтения: число можно выделить и скопировать в отчёт, изменить нельзя. Заводите так всё, что пишет расчёт: время, энергию, температуру.
| Функция | Что делает |
|---|---|
get_float_param(имя) |
прочитать дробное |
set_float_param(имя, значение) |
записать дробное |
get_int_param(имя) / set_int_param(имя, значение) |
то же для целых |
get_bool_param(имя) / set_bool_param(имя, значение) |
то же для галочек |
get_string_param(имя) / set_string_param(имя, значение) |
то же для строк |
Имя – это ключ. Опечатка в нём не ошибка компиляции: get_ вернёт ноль и напишет предупреждение. Если расчёт вдруг считает нулями – сверьте строки посимвольно.
Ручки и показания читаются и пишутся одними и теми же функциями, поэтому превратить ручку в показание – правка одного слова в add_.
| Функция | Что делает |
|---|---|
create_plot(имя, x_min, x_max, y_min, y_max, ширина, высота) |
создать график |
set_plot_axes(имя, подпись_x, подпись_y) |
подписать оси вместе с единицами |
set_plot_scale(имя, x_min, x_max, y_min, y_max) |
сменить границы на ходу |
Ширина и высота – размер полотна в пикселях; мышью его потом можно менять. Подписывайте оси всегда: график без «t, с» и «x, м» на уроке физики читать нельзя.
| Функция | Что рисует |
|---|---|
add_plot_point(график, x, y, подпись, цвет, размер) |
одну точку |
add_plot_points(график, вектор_x, вектор_y, подпись, цвет, размер) |
набор точек |
add_plot_line(график, вектор_x, вектор_y, подпись, цвет, толщина) |
линию через точки |
add_plot_disk(график, x, y, радиус, подпись, цвет) |
закрашенный круг |
add_plot_heatmap(график, значения, строк, столбцов, ...) |
тепловую карту |
clear_plot(график) |
стереть нарисованное в прошлом кадре |
Эти объекты живут один кадр. Порядок в расчёте всегда такой: сначала clear_plot, потом рисование заново.
У круга радиус задаётся в координатах графика, а не в пикселях. Если масштабы осей разные, круг выглядит эллипсом – это верно: форма сохраняется в координатах данных, а не на экране.
| Функция | Что делает |
|---|---|
add_plot_history_point(график, x, y, подпись, цвет, размер, максимум) |
добавить точку в накапливаемую серию |
clear_plot_history(график) |
стереть всю историю графика |
clear_plot_history(график, подпись) |
стереть одну серию |
История, в отличие от объектов кадра, копится сама, и clear_plot её не трогает. Библиотека хранит не более максимум последних точек – свой кольцевой буфер заводить не надо.
Серии различаются по подписи: две точки с одной подписью попадут в одну линию, с разными – в разные.
Шесть готовых: BLUE, RED, YELLOW, GREEN, WHITE, BLACK. Они подобраны так, чтобы соседние серии различались даже при дальтонизме, поэтому лучше брать их, а не задавать цвет своими числами.
| Функция | Что делает |
|---|---|
save_plot_csv(график, файл) |
сохранить историю графика в CSV |
set_auto_layout(доля) |
пульт слева, графики справа вкладками |
get_time() |
секунд с момента запуска |
Звать save_plot_csv из кода обычно не нужно: у каждого графика уже есть кнопка «Сохранить CSV». Функция пригодится, если сохранение должно случиться само – например, по окончании расчёта.
Если set_auto_layout не хватает и окна нужно расставить точно, есть отдельный заголовок gui_library_layout.h. Он вынесен из основного нарочно: там нужны лямбды и указатели, а обычному заданию хватает одной строки.
#include "gui_library.h"
// 1. Состояние – снаружи функций, чтобы пережить кадр
float t = 0.0f;
// 2. Кнопка «Заново»
void restart() {
t = 0.0f;
clear_plot_history("График");
}
// 3. Один шаг расчёта
void calculation_function() {
if (get_bool_param("Пауза")) return;
float dt = get_float_param("Шаг по времени");
t += dt;
set_float_param("Время", t);
clear_plot("График");
add_plot_history_point("График", t, 0.f, "y(t)", BLUE, 1.f, 20000);
}
// 4. Сборка пульта и запуск
int main() {
if (!init_gui_library("Моя задача")) return -1;
add_bool_param("Пауза", false);
add_button_param("Заново", restart);
add_float_param("Шаг по времени", 0.02f, 0.001f, 0.5f, 0.001f);
add_output_float("Время", 0.f);
create_plot("График", 0.f, 10.f, -1.f, 1.f, 750, 500);
set_plot_axes("График", "t, с", "y");
set_calculation_function(calculation_function);
set_auto_layout();
run_gui_library();
return 0;
}Этот же скелет лежит в репозитории готовым – папка Template. Чтобы сделать из неё свою задачу, нужно четыре шага. Ниже они с точностью до строчки; пусть задача называется MyTask.
Скопируйте папку Template целиком и переименуйте копию в MyTask. В ней два файла: main.cpp и CMakeLists.txt.
Имя папки – латиница, без пробелов. Оно же станет именем программы.
# было: add_executable(Template main.cpp)
add_executable(MyTask main.cpp)
set_target_properties(MyTask PROPERTIES RUNTIME_OUTPUT_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR})
target_link_libraries(MyTask gui_library)
configure_wasm_task(MyTask)Слово Template встречается здесь четыре раза, и все четыре нужно заменить на MyTask. Что делает каждая строка:
add_executable – объявляет программу и говорит, из какого файла её собирать;set_target_properties – кладёт готовую программу рядом с исходником, а не в глубину папки build;target_link_libraries – подключает нашу библиотеку;configure_wasm_task – добавляет настройки для сборки в браузер. В обычной сборке эта строка ничего не делает.# Первая вставка: в конец списка option, рядом с остальными
option(BUILD_TASK_0 "Собирать Task_0 (Движение под углом)" ON)
# ... остальные ...
option(BUILD_TEMPLATE "Собирать Template (заготовка своей задачи)" ON)
option(BUILD_MYTASK "Собирать MyTask" ON) # <-- ваша строка
# Вторая вставка: в конец списка if, следом за остальными
if(BUILD_TEMPLATE)
add_subdirectory(Template)
endif()
if(BUILD_MYTASK) # <-- ваши
add_subdirectory(MyTask) # три
endif() # строкиCMakeLists.txt в корне проекта состоит из блоков, и нужные два лежат в самом конце файла: сначала подряд идут все option, потом подряд все if. Добавляйте свои строки в конец каждого списка – порядок внутри значения не имеет.
Зачем вообще option: он заводит переключатель, которым задание можно отключить от сборки. Без него собирать пришлось бы всё сразу, а это бывает долго.
# в Git Bash
bash scripts/bootstrap.sh MyTask
# или без bash, прямо в cmd
cmake -S . -B build
cmake --build build --config Release --target MyTaskВажно про первую команду. cmake -S . -B build надо выполнить заново после того, как вы правили CMakeLists.txt – иначе сборка не узнает о новой задаче и скажет, что цели MyTask не существует. После правок только main.cpp хватает второй команды.
Если пользуетесь Visual Studio с открытой папкой, она перечитывает CMakeLists.txt сама, стоит его сохранить.
Готовая программа появится в MyTask/Release/MyTask.exe. Дальше правьте main.cpp, пересобирайте и смотрите, что получилось.