feat(perf): add a live runtime frame cap for Android captures #1101

Merged
SakulFlee merged 3 commits from sakulflee/android-runtime-frame-cap into main 2026-11-11 20:55:04 +00:00 AGit
Owner

Adds a live RenderSettings::fps_limit so the frame limiter and adaptive target can be changed at runtime, exposes it in the Rendering panel, records the active cap on every CSV row, and documents the VSync fallback. This completes the on-device frame-cap item from #1083 on top of the render scaling and capture metadata already merged in #1096 and #1097.

Adds a live RenderSettings::fps_limit so the frame limiter and adaptive target can be changed at runtime, exposes it in the Rendering panel, records the active cap on every CSV row, and documents the VSync fallback. This completes the on-device frame-cap item from #1083 on top of the render scaling and capture metadata already merged in #1096 and #1097.
RenderSettings now carries fps_limit so the frame limiter and adaptive target use the live value instead of the startup AppSettings. The active cap is recorded on every capture row.
The Rendering panel can toggle the cap and change it with a slider, so Android captures can be capped to a comparable rate without rebuilding.
docs(perf): document the runtime frame cap
All checks were successful
Lint / lint (pull_request) Successful in 1m25s
PR / test (pull_request) Successful in 13m20s
6337f319da
Describe the live cap, the VSync fallback, and the new per-row fps_limit capture column. Keep the analysis notebook's capture-field list in sync so the column is not treated as a render stage.

Smart test results

Result: PASS

Scope: full workspace

Reason: unmapped change: Tools/performance/performance_report.ipynb

Elapsed: 12m 52s

Workflow run

Overall: 537 tests, 527 passed, 0 failed, 10 skipped

Nextest: 526 tests, 526 passed, 0 failed, 0 skipped
Doctests: 11 tests, 1 passed, 0 failed, 10 skipped

Outcome charts are split between nextest and doctests. The timing chart covers nextest only.

Crate Nextest Passed Failed Skipped Doctests Time
orbital 1 1 0 0 - 0.67s
orbital-cli 3 3 0 0 - 0.04s
orbital_2d 29 29 0 0 0/1 0.16s
orbital_app 25 25 0 0 0/1 0.15s
orbital_billboard 11 11 0 0 - 3.42s
orbital_camera 8 8 0 0 - 0.04s
orbital_core 2 2 0 0 - 0.01s
orbital_debug_render 2 2 0 0 0/1 0.01s
orbital_debug_ui 58 58 0 0 0/1 0.36s
orbital_ecs 114 114 0 0 0/2 0.75s
orbital_ecs_bridge 46 46 0 0 - 0.32s
orbital_file_manager 5 5 0 0 - 0.03s
orbital_iced 26 26 0 0 - 0.14s
orbital_importer_gltf 16 16 0 0 - 0.15s
orbital_input 11 11 0 0 - 0.05s
orbital_light 8 8 0 0 - 0.04s
orbital_macros 0 0 0 0 0/1 0.00s
orbital_material_shader 2 2 0 0 - 0.01s
orbital_math 4 4 0 0 - 0.02s
orbital_mesh 2 2 0 0 - 0.01s
orbital_procgeo 3 3 0 0 - 0.02s
orbital_render_graph 6 6 0 0 - 0.03s
orbital_renderer 22 22 0 0 - 0.21s
orbital_resources 29 29 0 0 - 0.19s
orbital_shader_core 0 0 0 0 1/1 0.00s
orbital_shader_pbr 4 4 0 0 - 0.02s
orbital_shader_preprocessor 12 12 0 0 - 0.06s
orbital_shadow 3 3 0 0 - 0.02s
orbital_text 15 15 0 0 0/1 0.35s
orbital_texture 11 11 0 0 - 0.07s
orbital_touch_ui 1 1 0 0 0/1 0.01s
orbital_ui 32 32 0 0 0/1 0.17s
orbital_world_environment 13 13 0 0 - 0.07s
template_all_in_one 2 2 0 0 - 0.01s
pie showData
    title Nextest outcomes
    "Passed" : 526
pie showData
    title Doctest outcomes
    "Passed" : 1
    "Skipped" : 10
xychart-beta
    title "Slowest crates (nextest seconds)"
    x-axis ["orbital_billboard", "orbital_ecs", "orbital", "orbital_debug_ui", "orbital_text", "orbital_ecs_bridge", "orbital_renderer", "orbital_resources"]
    y-axis "Seconds" 0 --> 3.5
    bar [3.42, 0.75, 0.67, 0.36, 0.35, 0.32, 0.21, 0.19]
<!-- orbital-ci-test-results --> ## Smart test results **Result:** PASS **Scope:** full workspace **Reason:** unmapped change: Tools/performance/performance_report.ipynb **Elapsed:** 12m 52s [Workflow run](https://forgejo.sakul-flee.de/SakulFlee/Orbital/actions/runs/1253) **Overall:** 537 tests, 527 passed, 0 failed, 10 skipped **Nextest:** 526 tests, 526 passed, 0 failed, 0 skipped **Doctests:** 11 tests, 1 passed, 0 failed, 10 skipped _Outcome charts are split between nextest and doctests. The timing chart covers nextest only._ | Crate | Nextest | Passed | Failed | Skipped | Doctests | Time | | --- | ---: | ---: | ---: | ---: | ---: | ---: | | orbital | 1 | 1 | 0 | 0 | - | 0.67s | | orbital-cli | 3 | 3 | 0 | 0 | - | 0.04s | | orbital_2d | 29 | 29 | 0 | 0 | 0/1 | 0.16s | | orbital_app | 25 | 25 | 0 | 0 | 0/1 | 0.15s | | orbital_billboard | 11 | 11 | 0 | 0 | - | 3.42s | | orbital_camera | 8 | 8 | 0 | 0 | - | 0.04s | | orbital_core | 2 | 2 | 0 | 0 | - | 0.01s | | orbital_debug_render | 2 | 2 | 0 | 0 | 0/1 | 0.01s | | orbital_debug_ui | 58 | 58 | 0 | 0 | 0/1 | 0.36s | | orbital_ecs | 114 | 114 | 0 | 0 | 0/2 | 0.75s | | orbital_ecs_bridge | 46 | 46 | 0 | 0 | - | 0.32s | | orbital_file_manager | 5 | 5 | 0 | 0 | - | 0.03s | | orbital_iced | 26 | 26 | 0 | 0 | - | 0.14s | | orbital_importer_gltf | 16 | 16 | 0 | 0 | - | 0.15s | | orbital_input | 11 | 11 | 0 | 0 | - | 0.05s | | orbital_light | 8 | 8 | 0 | 0 | - | 0.04s | | orbital_macros | 0 | 0 | 0 | 0 | 0/1 | 0.00s | | orbital_material_shader | 2 | 2 | 0 | 0 | - | 0.01s | | orbital_math | 4 | 4 | 0 | 0 | - | 0.02s | | orbital_mesh | 2 | 2 | 0 | 0 | - | 0.01s | | orbital_procgeo | 3 | 3 | 0 | 0 | - | 0.02s | | orbital_render_graph | 6 | 6 | 0 | 0 | - | 0.03s | | orbital_renderer | 22 | 22 | 0 | 0 | - | 0.21s | | orbital_resources | 29 | 29 | 0 | 0 | - | 0.19s | | orbital_shader_core | 0 | 0 | 0 | 0 | 1/1 | 0.00s | | orbital_shader_pbr | 4 | 4 | 0 | 0 | - | 0.02s | | orbital_shader_preprocessor | 12 | 12 | 0 | 0 | - | 0.06s | | orbital_shadow | 3 | 3 | 0 | 0 | - | 0.02s | | orbital_text | 15 | 15 | 0 | 0 | 0/1 | 0.35s | | orbital_texture | 11 | 11 | 0 | 0 | - | 0.07s | | orbital_touch_ui | 1 | 1 | 0 | 0 | 0/1 | 0.01s | | orbital_ui | 32 | 32 | 0 | 0 | 0/1 | 0.17s | | orbital_world_environment | 13 | 13 | 0 | 0 | - | 0.07s | | template_all_in_one | 2 | 2 | 0 | 0 | - | 0.01s | ```mermaid pie showData title Nextest outcomes "Passed" : 526 ``` ```mermaid pie showData title Doctest outcomes "Passed" : 1 "Skipped" : 10 ``` ```mermaid xychart-beta title "Slowest crates (nextest seconds)" x-axis ["orbital_billboard", "orbital_ecs", "orbital", "orbital_debug_ui", "orbital_text", "orbital_ecs_bridge", "orbital_renderer", "orbital_resources"] y-axis "Seconds" 0 --> 3.5 bar [3.42, 0.75, 0.67, 0.36, 0.35, 0.32, 0.21, 0.19] ```
Author
Owner

Closes #1097

Closes #1097
Author
Owner

Closes #1096

Closes #1096
Author
Owner

Closes #1083

Closes #1083
Sign in to join this conversation.
No description provided.