Caffeine

Host ImGui (runtime e plugins legados)

Reference Engine Legacy Verificado em: Fonte: apps/runtime/ImGuiIntegration.hpp

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#

ModeloUsado porOnde
Retida, IcedEditor Doppio: docking, hierarchy, inspector, viewport, assets, console, geradoresdoppio/crates/ui/
Imediata, Dear ImGuicaffeine-runtime, Doppio C++ arquivado, plugins legadosapps/runtime/, include/caffeine/ui/, doppio-archived/
UI de jogo retidaHUD e menus in-gamesrc/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.

Páginas relacionadas#