Files
siege_deck/Docs/SiegeDeck/Engine/Main Loop and Time.md
T
darman 45b246c1d7 docs: Initialize comprehensive project documentation
Migrates existing GDD and engine design notes from HacknPlan into a new Obsidian vault.

This establishes a centralized, version-controlled knowledge base covering engine architecture, game constraints, design decisions, and open questions.
2026-09-24 23:55:48 +02:00

59 lines
2.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
tags:
- engine
- time
---
# Main Loop and Time
The simulation runs on a **fixed timestep**, and rendering, UI and tweens run at a **variable rate**. This directly supports the phased game (see [[Game Constraints]]).
## The loop
```cpp
while (running) {
frameClock.Tick(); // real dt, clamped to 0.25 s
input.BeginFrame(); PumpSdlEvents(); // ImGui sees events first and may capture them
scenes.Update(frameClock.Dt()); // UI, tweens, card hand, camera: real time
simClock.Accumulate(frameClock.Dt() * simClock.Speed());
int steps = 0;
while (simClock.ConsumeStep() && steps++ < kMaxStepsPerFrame) // spiral-of-death guard
scenes.FixedUpdate(kSimDt); // 1/60 s: movement, targeting, projectiles, damage
renderer.BeginFrame();
scenes.Render(renderer, simClock.Alpha()); // interpolate between the previous and current transform
debugUi.Render();
renderer.EndFrame();
}
```
## Two clocks
| Clock | Drives | Pausable | Scaled by game speed |
|---|---|---|---|
| `FrameClock` | UI, card hand, menus, camera, UI tweens | no | no |
| `SimClock` | combat simulation, gameplay tweens | **yes** (speed 0 = planning phase) | **yes** |
The planning phase is simply `simClock.SetSpeed(0)`. Cards still animate and hover because they run on `FrameClock`.
## Game speed
At 1×, 2× or 3× the loop runs **more fixed steps per frame, never bigger ones**. A 3× frame runs three 1/60 s steps, not one 1/20 s step, so fast projectiles can't skip past enemies at high speed.
`kMaxStepsPerFrame` caps the catch-up work after a stall (window drag, breakpoint). The simulation slows down rather than freezing the frame.
## Interpolation
- A `PrevTransform` component is copied from `Transform3D` before each fixed step.
- Rendering blends the two with `SimClock::Alpha()`, so motion stays smooth on high-refresh monitors while the simulation runs at 60 Hz.
- Entities that teleport (spawns, snaps) reset `PrevTransform` to avoid a one-frame smear.
## Timers and tweens
- `Timer` and `TweenSystem` let you choose which clock they run on.
- Tweens are engine-level because a deck-builder's feel is mostly tweens: fanning the hand, drawing, cards flying to targets, damage popups.
Related: [[Scenes and ECS]], [[Rigid-Part Animation]]