Потоки и таймеры
WUI не гарантирует произвольный конкурентный доступ к контролам. Обновляйте UI
в потоке обработки событий его окна. Внутренние блокировки подписок не делают
add_control(), отрисовку и состояние контролов в целом потокобезопасными.
| Платформа | Поток callback timer |
|---|---|
| Windows | Поток UI с очередью сообщений |
| Linux | Общий поток событий X11 |
| macOS | Главный поток UI |
| WASM | Главный поток браузера; фоновые вкладки могут замедлять таймеры |
Актуальный API: timer(callback), start(interval_ms), stop().
Конструктор не запускает таймер. Храните его, пока он нужен. Для переносимого UI
отправляйте уведомление окну и меняйте контролы в обработчике события, а не
непосредственно в callback таймера или рабочего потока.
#include <wui/system/timer.hpp>
wui::timer timer([weak = std::weak_ptr<wui::window>(window)] {
if (auto target = weak.lock()) target->emit_event(100, 0);
});
// Handle internal_event_type::user_emitted in the window subscription.
timer.start(100); // milliseconds
// Before captured state or the receiving window is destroyed:
timer.stop();
emit_event(x,y) доставляет событие internal_event_type::user_emitted.
Большие данные передавайте через хранилище приложения с нужной синхронизацией:
два целых аргумента не управляют владением объектами. Остановите таймеры и дождитесь
worker до уничтожения захваченных данных.
На Linux callback таймеров, события X11, уведомления об устройствах и отрисовка выполняются в общем потоке listener. Интервалы отсчитываются монотонными часами; пропущенные тики не накапливаются. Callback должны быть короткими: декодирование, ввод-вывод и другие долгие операции выполняйте в worker.
На Linux timer::stop() запрещает новые вызовы и при вызове из другого потока
ждёт завершения текущего callback. Из самого callback можно остановить,
перезапустить или удалить свой таймер. Останавливайте таймер до уничтожения
объектов, захваченных через сырой указатель: автоматически продлить их жизнь
таймер не может. Не держите блокировку, которая нужна callback, ожидая stop().
Для передачи работы из worker в UI используйте get_listener().post(callback)
из <wui/window/listener.h>. Захватывайте получателя через weak_ptr и проверяйте
его внутри callback. post() асинхронен и не делает остальные прямые обращения
к контролам потокобезопасными. Низкоуровневый listener::clear_timer() тоже
асинхронен; для синхронной отмены используйте wui::timer.
В WASM пока нет интеграции WUI с pthread/Worker. На macOS вся инициализация UI, обработка событий и отрисовка выполняются в главном потоке.
На Windows создавайте timer в потоке UI и поддерживайте работу его очереди
сообщений, пока нужны callback. start() и stop() можно вызывать из worker;
изменения системного таймера передаются потоку-владельцу. stop() сразу
запрещает обработку отложенных тиков и при вызове из другого потока ждёт
завершения текущего callback. Из callback можно остановить, перезапустить или
удалить свой таймер. Не держите блокировку, нужную callback, ожидая stop().
Долгие операции выполняйте в отдельном worker, а не в callback таймера.
Бэкенд Windows использует служебные окна и WM_TIMER с обычной для Windows
точностью планирования (как правило, не менее 10 мс). Сообщения от старого
запуска отбрасываются даже после перезапуска таймера. Анимация полос прокрутки
тоже выполняется короткими тиками UI, без ожидания фонового потока в
обработчиках мыши. После обновления реализации таймера пересоберите и
библиотеку, и приложения.