Host ImGui (runtime e plugins legados)
O Dear ImGui deixou de ser a UI do editor Doppio. Continua a ser o
host imediato do caffeine-runtime e do SDK legado de plugins C++. O editor
ativo é Rust/Iced.
Não construa painéis novos de editor em ImGui. O editor Rust usa componentes Iced. Painéis ImGui são para o runtime autónomo e plugins que ainda usam o SDK C++.
Dois modelos de UI#
| Modelo | Usado por | Onde |
|---|---|---|
| Retida, Iced | Editor Doppio: docking, hierarchy, inspector, viewport, assets, console, geradores | doppio/crates/ui/ |
| Imediata, Dear ImGui | caffeine-runtime, Doppio C++ arquivado, plugins legados | apps/runtime/, include/caffeine/ui/, doppio-archived/ |
| UI de jogo retida | HUD e menus in-game | src/caffeine/ui/, Game UI |
Integração no runtime#
apps/runtime/ImGuiIntegration.hpp detém o backend ImGui SDL3 + RHI usado pelo
executável de runtime:
init(window, device)— cria o contexto ImGui e os dados do backend.beginFrame()/endFrame(commandBuffer)— grava o draw data no RHI.processEvent(SDL_Event)— encaminha input SDL.wantsKeyboard()/wantsMouse()— diz ao runtime se o ImGui capturou o input.
O runtime desenha profiler, console e overlays de cena através deste host. O core
(caffeine-core) não tem dependência de ImGui; os adaptadores vivem em
caffeine-editor-support e no runtime.
UIKit para plugins#
Plugins C++ desenham com o kit imediato público em include/caffeine/ui/:
| Header | Conteúdo |
|---|---|
UI.hpp |
Umbrella do kit de elementos composáveis |
Widgets.hpp |
Botões, linhas de propriedades, cabeçalhos, empty states |
Theme.hpp |
Paleta e métricas |
Icons.hpp |
Glifos vetoriais |
PanelRegistry.hpp |
Ids estáveis e categorias de painéis |
Workspace.hpp |
Layout de docking JSON para o host de plugins |
Panel.hpp |
Descritores de painel |
Os painéis de plugins chamam Caffeine::UIKit e registam-se via PanelRegistry; não
ligam contra internals do Doppio. Veja Plugin SDK.
Profiler e console#
As janelas de profiler e console são ferramentas do runtime/editor legado. Consomem
dados de Debug::Profiler e Debug::LogSystem; o editor Rust tem o seu próprio painel
Console tipado e não embebe ImGui.