Files
RustRaptor/docs/performance.md
T

42 lines
2.2 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.
# Desktop display measurements
Local release measurements on 2026-10-10 used SDL's OpenGL renderer at
1920×1080 fullscreen output, aspect correction, Scale4, no scanlines, and all seven Iron Coast
packages. They include normal terrain, sprites, indexed shadows, effects and
mod scripting. They exclude Cargo compilation.
| Mode | Startup | Render work median | Render work 95th percentile | Frame median | Frame 95th percentile |
| --- | ---: | ---: | ---: | ---: | ---: |
| SD artwork | 2,345.82 ms | 7.40 ms | 8.76 ms | 7.52 ms | 8.88 ms |
| HD artwork | 2,375.56 ms | 8.67 ms | 14.66 ms | 8.79 ms | 14.78 ms |
Each run sampled 174 frames from a 180-frame flight, excluding five warmup
frames and the screenshot frame. Work time excludes the presentation call;
frame time includes it. Startup covers desktop-host construction and SDL setup;
the preceding CLI catalog registration is excluded. The explicit one-millisecond smoke-loop sleep is
outside both measurements. These short runs establish local performance for
this scene and machine, not worst-case performance across every boss or device.
The fixed 70/3 Hz simulation advances independently of display timing.
From `RustRaptor/`, prepare two isolated profile configurations with
`width = 1920`, `height = 1080`, `fullscreen = true`, `scale = 4`, `scanlines = false`, and
`hd_mode = false` or `true`. Enable the mission's six dependencies and mission
package in `enabled_mods`; see [Iron Coast](iron-coast.md). Run:
```sh
./run.sh --profile-root ../.reference/enemy-sd-profile \
--preview-mission iron_coast_mission_1:mission_01 \
--smoke-frames 180 --benchmark \
--screenshot ../.reference/rustraptor-sd-1080-final.png
./run.sh --profile-root ../.reference/enemy-hd-profile \
--preview-mission iron_coast_mission_1:mission_01 \
--smoke-frames 180 --benchmark \
--screenshot ../.reference/rustraptor-hd-1080-final.png
```
Both captures were checked to be exactly 1920×1080. The benchmark reports the
actual SDL output size, since a window manager can constrain a requested window.
Use a real SDL display. Dummy-video screenshots verify raster composition but
cannot measure GPU presentation. Frame-limited runs do not save pilots or
settings. Profiles, caches and screenshots remain ignored local files.