|
guillaume 2026.6.1
A C++ UI framework designed for modern desktop and extended reality (XR) applications.
|
Guillaume is primarily single-threaded. This document describes the concurrency guarantees so consumers can structure their applications safely.
The application main loop (Application::run) executes on a single thread:
All ECS registries, the event bus, and systems are used from this owner thread. They are not thread-safe and must not be accessed concurrently from other threads.
Storage is the only module safe for cross-thread use:
You may call setItem/getItem/removeItem/clear from any thread.
If you need to perform work off the main thread (e.g. loading assets, network I/O):
Do not mutate entities, components, or scenes from worker threads.
Entity::getNextIdentifier uses an atomic counter, so identifier generation is safe even if entities are created from multiple threads. However, the registries that own those entities are still single-threaded.