Files
siege_deck/Source/Engine/Time/SimClock.h
T
darmanandClaude Opus 5.5 384f1ed1f2 feat: engine skeleton (Build Order step 1) and siege_tests
Engine:
- SdlContext and Window: RAII, throwing constructors, non-movable
- FrameClock (real time, clamped dt) and SimClock (fixed 1/60 s steps,
  speed 0 = planning phase, backlog capped per frame)
- Application owns them in lifetime order, exposes EngineContext, and
  runs the fixed-timestep loop; AppConfig::FromArgs parses --frames,
  --seed and --fullscreen
- Temporary window-surface fill so Wayland maps the window until
  RenderDevice lands in step 2

Build:
- Split into the siege_engine static lib and the siege_deck exe
- check_engine_deps fails the build if Engine/ includes Game/
- ctest smoke test: siege_deck --frames 30 on the offscreen driver
- siege_tests on Catch2 v3.15.3 (nixpkgs + CPM pin), with SimClock,
  FrameClock and AppConfig tests

Docs:
- Decision Log: error handling split, Catch2 for unit tests
- Build Order step 1 done; Engine Overview, Main Loop and Time and
  README updated to match
- AGENTS.md with build, conventions and gotchas for coding agents
- .gitignore: .mcp.json (local CLion MCP port) and Obsidian's
  workspace.json (tab/pane state), now untracked

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-25 00:27:36 +02:00

55 lines
1.9 KiB
C++

//
// Created by darman on 9/24/26.
//
#pragma once
namespace SiegeDeck::Engine
{
// Fixed-timestep simulation time. Real time is fed in each frame, scaled by Speed(),
// and handed out again as whole steps of StepDt():
//
// sim.Accumulate(frame.Dt());
// while (sim.ConsumeStep())
// FixedUpdate(sim.StepDt());
// Render(sim.Alpha());
//
// Speed 0 is the planning phase. 2x and 3x run more steps per frame, never bigger ones,
// so fast projectiles can't skip past enemies at high speed.
class SimClock
{
public:
// maxStepsPerFrame caps catch-up work after a stall: past it, the backlog is dropped
// and the simulation slows down instead of freezing the frame (the spiral of death).
SimClock(double stepDt, int32 maxStepsPerFrame);
void Accumulate(double realDt);
// True if a whole step is available; consumes it and advances Time() and StepIndex().
bool ConsumeStep();
// 0 pauses. Negative values are treated as 0.
void SetSpeed(double newSpeed);
[[nodiscard]] double Speed() const { return speed; }
[[nodiscard]] bool Paused() const { return speed == 0.0; }
[[nodiscard]] double StepDt() const { return stepDt; }
// How far between the previous and the current step the renderer is, in [0, 1).
// Blend PrevTransform -> Transform3D by this.
[[nodiscard]] double Alpha() const { return accumulator / stepDt; }
// Simulated seconds and steps since construction. Stops advancing while paused.
[[nodiscard]] double Time() const { return static_cast<double>(stepIndex) * stepDt; }
[[nodiscard]] uint64 StepIndex() const { return stepIndex; }
private:
double stepDt;
double maxBacklog;
double speed = 1.0;
double accumulator = 0.0;
uint64 stepIndex = 0;
};
}