--- tags: - engine - rendering --- # Rendering The target is **rigid-part 3D** on **SDL_GPU**, with a 2D overlay for the card hand and HUD. See [[Decision Log#Rigid-part 3D on SDL_GPU]]. ## Layers ```mermaid flowchart TD Scene[Scene::Render] --> S3D[SceneRenderer3D] Scene --> R2D[Renderer2D] S3D --> Dev[RenderDevice] R2D --> Dev Dev --> GPU[SDL_GPU → Vulkan / D3D12 / Metal] ``` ### RenderDevice A thin wrapper over SDL_GPU: buffers, textures, samplers, pipelines, command buffers, upload staging and per-frame uniform data. Nothing outside `Render/` calls SDL_GPU directly. ### SceneRenderer3D - **Instanced meshes are required.** The render queue batches by (pipeline, material, mesh) and draws instances. - Lighting: one directional sun with a single shadow map, plus a few point lights. - Materials: PBR-lite or toon (art direction open, see [[Open Questions]]). - Opaque objects are sorted by pipeline and material; transparent objects back to front. ### Renderer2D - A command-and-sort-key sprite batch: `DrawSprite`, `DrawQuad`, `DrawText`, `DrawLine`. - Used for the card hand, HUD, menus, health bars, range indicators and damage numbers. - Draws after the 3D pass in screen space. ## Shaders SDL_GPU consumes **precompiled bytecode per backend**. 1. Write GLSL or HLSL in `Assets/Shaders`. 2. Compile to SPIR-V at build time with `glslang`. 3. Use the **Vulkan backend on both Linux and Windows**. 4. Add SDL_shadercross (for DXIL and MSL) only if D3D12 or macOS becomes a target. Shaders are hot-reloadable in debug builds (see [[Assets]]). ## Text and ImGui - Text: SDL_ttf 3's GPU text engine (`TTF_CreateGPUTextEngine`), with cached text objects for numbers that change constantly. - ImGui: the `imgui_impl_sdlgpu3` backend. ## Camera - A **fixed-pitch perspective** camera (about 50°) with limited zoom and optional 90° rotation steps. No free orbit: a tower defense must stay readable. - The alternative, an orthographic isometric camera, is noted in [[Open Questions]]. ## Picking - **Tiles:** cast a ray from the mouse onto the ground plane (y = 0) and convert the hit to a tile. No physics engine. - **Enemies** (for targeted cards): a ray test against bounding spheres. - **World-space UI** (health bars, range circles): project world positions to the screen and draw them with `Renderer2D`. Related: [[Rigid-Part Animation]], [[Assets]]