promeki::SDLAudioClock::Stats Struct Reference

Runtime counters for the clock's smoothing machinery. More...

#include <sdlaudioclock.h>

Public Attributes
int64_t	updateCount = 0
	Total nowNs calls.
int64_t	checkpointResyncs = 0
	Consumed-byte changes observed.
int64_t	forwardSnaps = 0
	Resyncs where the new raw base was at or ahead of interpolation.
int64_t	backDates = 0
	Resyncs where the new raw base landed behind interpolation and the wall anchor had to be back-dated.
int64_t	clampedRegressions = 0
	Times the final monotonicity clamp kicked in. Should be zero — non-zero means FP rounding in the back-date arithmetic would have produced a backward step but the clamp caught it.
int64_t	maxStepNs = 0
	Largest forward step between two consecutive nowNs values.
int64_t	maxBackDateNs = 0
	Largest absorbed interpolation overshoot, i.e. interpolated minus new raw base when back-dating.
int64_t	maxCallbackGapNs = 0
	Longest wall-clock gap observed between checkpoint resyncs.

Detailed Description

Runtime counters for the clock's smoothing machinery.

Populated as nowNs runs and snapshotable through stats. Cumulative since construction (or the last resetStats). Non-atomic — the clock is expected to be driven from a single thread, so external readers that call stats from a different thread may see a slightly inconsistent snapshot. Good enough for monitoring; not a synchronisation mechanism.

---

The documentation for this struct was generated from the following file:

• include/promeki/sdl/sdlaudioclock.h