Overlays vectoriais 2D (caminho RHI)
Linhas, círculos e rectângulos de debug e de gameplay em modo retained, desenhados por ImGui no editor e tesselados para um futuro passe RHI.
As primitivas de debug e gameplay do play mode são acumuladas em Render::Overlay2D
(line, circle, circleFilled, rect, polyline) e limpas por beginFrame().
Caminho ImGui (editor + runtime actual)#
Com CF_HAS_IMGUI definido, Overlay2D::draw(ImDrawList*, camera, screenOrigin, panelSize)
desenha depois do mundo e antes dos widgets de UI.
Shipping / sem ImGui#
- Os scripts registam primitivas via
caffeine.draw2d.*(mesmo buffer que o ImGui). Overlay2D::buildRhiMesh(camera, screenOrigin, vertices)tesselam os comandos em valoresRhiVertexem espaço de ecrã (x,y,r,g,b,a); os comandos em espaço de mundo são primeiro transformados com aCamera2D.Overlay2D::drawRhi(CommandBuffer*, camera, screenOrigin)é o ponto de entrada da submissão GPU.
Os shaders estão em src/caffeine/render/shaders/overlay2d.vert e overlay2d.frag. O drawRhi
só é compilado com CF_HAS_SDL3 e sem CF_HEADLESS.
Enquanto o pipeline não estiver registado, a tesselação continua a correr para que a lógica de
gameplay possa ser testada; o upload é um no-op (o drawRhi tesselam e descarta os vértices).
Espaços de coordenadas#
- world — valores em unidades de cena; transformados com a
Camera2D. - screen — deslocamentos em pixels relativos à origem do viewport; convertidos via
screenToWorldpara comandos em espaço de mundo.