The fps line of the performance overlay stops at the display's rate,
60 on most screens. It does not tell how much room a game has left.
The new top line answers that from the times the overlay measures.
- possibleFps in src/editor/frameMeter.ts is 1000 ms over the sum of
the five areas, rounded down. It has no number while nothing took
any time, and the overlay shows a dash then.
- The editor's share is in the sum, because it costs time while
playing in the editor. A released game can do a little better.
- It is an upper bound. The GPU's time is not measured and not in it.
- e2e 59e reads the lines one further down and checks the new line
against the times it measured itself.
Tests:
- Unit frame-meter: 11 passed (+2 for possibleFps)
- Gate: 197 files, 2855 tests, CHECK EXIT 0 (2853 + 2)
- e2e 59: ALL PASSED, 19 checks (+1), on melektaus-atx
- Counter-check: possibleFps without the editor's share fails the
unit test
- The e2e total of 1602 is counted (1601 + 1), not measured
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
A game that stutters gave no hint where the frame goes. The Game tab
now has a Performance switch. It shows a small overlay in the top left
corner of the Game View while a game runs: fps, the number of entities
and the mean milliseconds per frame for each area, averaged over half
a second like the fps counter.
- src/editor/frameMeter.ts holds the pure rule. FrameMeter sums the
areas per frame, closes a window every 0.5 s and formats the lines.
- World.timeSystem times every system the world ticks. PlaySession
maps the systems to Behaviors, Physics and Animation and sets the
hook again after Load scene.
- Animation has its own line. Counting the AnimationSystem under
Behaviors would have skewed that number.
- Drawing is the build of the game picture plus app.render(). It is
main thread time only. The GPU work after it is not in the number,
and app.render() draws the whole canvas including the panels.
- Editor is the rest of the editor tick after the systems and the game
picture: mirroring into the model, panels and console.
- The overlay lets clicks through to the game. It shows dashes until
the first window closes. The switch is off by default and is not
saved. The released game (#266) runs without a meter.
Tests:
- Unit frame-meter: 9 passed.
- Gate on melektaus-atx: 197 files, 2853 tests, CHECK EXIT 0.
- e2e 59 on melektaus-atx: ALL PASSED, 18 checks (13 before, +5 in
59e with a real mouse on the switch). Run twice.
- Three mutations were caught: the editor share not subtracting the
systems (2 unit tests), systems running in pause not reported
(1 unit test), the overlay getting no times (59e).
- The e2e total of 1601 is computed (1596 + 5), not measured.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>