Files
NX2navi/tests/stutter_hitch_check.c
chrg6 2f640fb8ed Make the stutter map count runs of long frames as one hitch and the texture pool's area loads as loads.
In the 2026-11-13 session three frames of 87, 91 and 96 ms after an area load each counted as a change of pace, as each was followed by one as long, and loads that only the texture pool saw (no area file read, so no scene line) were charged to play. Consecutive long frames are now one episode, counted once with their summed time, its line giving that time and the first frame's parts; a run of more than 8 long frames none of which stands out is still a change of pace. The texture pool's start and end of an area load mark an area load for the map, as the game's own loads do.

With trace = perf, the slow write-watch queries and freezes past the 200 lines they may log are counted and given every 60 frames, so a late area load still shows them; the session's lines had run out by frame 36,387.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-13 15:57:52 -05:00

83 lines
3.8 KiB
C

// tests/stutter_hitch_check.py builds this: runtime/stutter_map.c's hitch rule on made-up frame times, with the few
// runtime functions it calls stubbed. A steady change of pace (the game drawing at 60 fps after 200) counts no hitch;
// isolated long frames each count one; a frame over SM_HITCH_SURE_NS counts whatever follows it.
#include <stdarg.h>
#include <stdio.h>
#include "../runtime/stutter_map.c"
static uint64_t clock_ns;
int cfg_bool(const char *name) { return !strcmp(name, "NX2NAVI_STUTTER_MAP"); }
uint64_t kern_now_ns(void) { return clock_ns; }
void plat_mutex_lock(PlatMutex *m) { (void)m; }
void plat_mutex_unlock(PlatMutex *m) { (void)m; }
static int logged;
void rt_log(const char *fmt, ...) {
(void)fmt;
logged++;
}
// perf.c's causes, in its order (FT_C_*)
static const char *const names[8] = {"pipeline", "translation", "texture", "fence", "pacing", "replay", "census",
"unattributed"};
static uint64_t frame_no;
static void frames(int n, double ms) {
uint64_t part[8] = {0};
for (int i = 0; i < n; i++) {
uint64_t d = (uint64_t)(ms * 1e6);
clock_ns += d;
part[7] = d;
stutter_frame(++frame_no, clock_ns, d, part, names, 8, 7);
}
}
static int fails;
static void expect(const char *what, uint64_t got, uint64_t want) {
if (got != want) printf("FAIL %s: %llu, expected %llu\n", what, (unsigned long long)got, (unsigned long long)want), fails++;
}
int main(void) {
stutter_map_init();
clock_ns = 10000000000ull; // well past any area load
frames(200, 5.0);
expect("steady 200 fps", areas[0].hitch, 0);
frames(300, 16.6); // the game's menus at 60 fps
expect("a change to 60 fps", areas[0].hitch, 0);
if (!paced_out) printf("FAIL the change of pace was not counted as one\n"), fails++;
frames(200, 7.0);
for (int k = 0; k < 5; k++) frames(1, 30.0), frames(60, 7.0); // five isolated spikes
expect("five isolated spikes", areas[0].hitch, 5);
frames(1, 150.0), frames(1, 150.0), frames(60, 7.0); // two long frames in a row: one episode of 300 ms
expect("two frames over the sure line", areas[0].hitch, 6);
expect("their episode's time", areas[0].worst_ns, 300000000ull);
frames(1, 40.0), frames(1, 40.0), frames(60, 7.0); // a double spike: one episode
expect("a double spike", areas[0].hitch, 7);
// three long frames, each followed by one as long, as after an area load in a session of 2026-11-13 (87, 91 and
// 96 ms): one episode, not three changes of pace
uint64_t paced0 = paced_out, charged0 = areas[0].cause_ns[7];
frames(1, 87.0), frames(1, 91.0), frames(1, 96.0), frames(60, 7.0);
expect("three slow frames in a row", areas[0].hitch, 8);
expect("not a change of pace", paced_out, paced0);
expect("the episode's time", areas[0].cause_ns[7] - charged0, 274000000ull);
// a change to 30 fps from 140: a run of long frames longer than SM_EPISODE_MAX, a change of pace
frames(200, 7.0);
frames(300, 33.3);
expect("a change to 30 fps", areas[0].hitch, 8);
frames(200, 7.0);
stutter_area("Kakariko"); // a load: what follows within SM_LOAD_NS is the load's
frames(1, 60.0), frames(30, 7.0);
expect("a spike right after a load (play)", areas[1].hitch, 0);
expect("a spike right after a load (load)", areas[1].load_hitch, 1);
clock_ns += 10000000000ull;
frames(60, 7.0);
stutter_load(); // the texture pool's load of an area, without the game's
frames(1, 60.0), frames(30, 7.0);
expect("a spike right after the pool's load (play)", areas[1].hitch, 0);
expect("a spike right after the pool's load (load)", areas[1].load_hitch, 2);
if (!logged) printf("FAIL nothing was logged\n"), fails++;
if (fails) return 1;
printf("stutter_hitch_check: all checks passed\n");
return 0;
}