feat(debug-ui): add rendering controls panel #970

Merged
SakulFlee merged 1 commit from feat/rendering-debug-panel into main 2026-10-29 03:45:21 +00:00
Owner

Summary

Adds a Rendering debug panel with live controls, and wires the debug UI into every example.

Runtime renderer settings

  • New RenderSettings ECS resource with anti_aliasing and smaa_quality.
  • ModuleRuntime initializes it from AppSettings and applies it before every redraw, so AA can change without restarting or recreating the renderer.
  • AppSettings remains the startup configuration.

Rendering panel

  • Anti-aliasing: Off / FXAA / SMAA.
  • SMAA quality: Low / Medium / High / Ultra.
  • Projection: Perspective / Orthographic dropdown for the active camera.
  • Volumetrics:
    • enabled toggle
    • density
    • height density
    • scattering
    • anisotropy
    • froxel quality (Low / Medium / High)
  • The panel mutates the existing VolumetricSettings resource and creates defaults when the app has not inserted it yet.

Examples

  • Added DebugUiModule to all examples: 2D, all-in-one, billboards, custom_shader, many_lights, minimal, orthographic, transparency, volumetrics.
  • all-in-one HUD now reads the live projection, AA and volumetrics settings instead of hardcoded text.
  • The O projection shortcut and the new dropdown both use the active camera's real projection mode, so they stay in sync.

Notes

  • The volumetrics injection currently uses the manual ambient_color plus punctual/directional lights. It does not sample the sky/environment/IBL yet. That is tracked as a separate volumetrics improvement so the settings can be tuned first.
  • Real-GPU visual validation of the panel and AA/volumetrics changes is still needed.

Validation

  • cargo test --workspace --no-fail-fast passes.
  • cargo check --workspace with the workspace clippy driver and -D warnings passes.
  • rustfmt --check passes for all Crates/ and Examples/ Rust sources.
  • No GPU/visual test was possible locally.

Related: #969.

## Summary Adds a **Rendering** debug panel with live controls, and wires the debug UI into every example. ### Runtime renderer settings - New `RenderSettings` ECS resource with `anti_aliasing` and `smaa_quality`. - `ModuleRuntime` initializes it from `AppSettings` and applies it before every redraw, so AA can change without restarting or recreating the renderer. - `AppSettings` remains the startup configuration. ### Rendering panel - Anti-aliasing: Off / FXAA / SMAA. - SMAA quality: Low / Medium / High / Ultra. - Projection: Perspective / Orthographic dropdown for the active camera. - Volumetrics: - enabled toggle - density - height density - scattering - anisotropy - froxel quality (Low / Medium / High) - The panel mutates the existing `VolumetricSettings` resource and creates defaults when the app has not inserted it yet. ### Examples - Added `DebugUiModule` to all examples: 2D, all-in-one, billboards, custom_shader, many_lights, minimal, orthographic, transparency, volumetrics. - `all-in-one` HUD now reads the live projection, AA and volumetrics settings instead of hardcoded text. - The `O` projection shortcut and the new dropdown both use the active camera's real projection mode, so they stay in sync. ### Notes - The volumetrics injection currently uses the manual `ambient_color` plus punctual/directional lights. It does **not** sample the sky/environment/IBL yet. That is tracked as a separate volumetrics improvement so the settings can be tuned first. - Real-GPU visual validation of the panel and AA/volumetrics changes is still needed. ## Validation - `cargo test --workspace --no-fail-fast` passes. - `cargo check --workspace` with the workspace clippy driver and `-D warnings` passes. - `rustfmt --check` passes for all `Crates/` and `Examples/` Rust sources. - No GPU/visual test was possible locally. Related: #969.
feat(debug-ui): add rendering controls panel
All checks were successful
Lint / lint (pull_request) Successful in 2m2s
Templates / templates (pull_request) Successful in 6m16s
PR / test (pull_request) Successful in 18m31s
5b509227dc

Smart test results

Result: PASS

Scope: full workspace

Reason: workspace-level change: Cargo.lock

Elapsed: 17m 23s

Workflow run

Overall: 482 tests, 472 passed, 0 failed, 10 skipped

Nextest: 471 tests, 471 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.66s
orbital_2d 29 29 0 0 0/1 0.20s
orbital_app 10 10 0 0 0/1 0.06s
orbital_billboard 6 6 0 0 - 0.13s
orbital_camera 8 8 0 0 - 0.06s
orbital_core 2 2 0 0 - 0.01s
orbital_debug_render 0 0 0 0 0/1 0.00s
orbital_debug_ui 48 48 0 0 0/1 0.33s
orbital_ecs 114 114 0 0 0/2 0.73s
orbital_ecs_bridge 42 42 0 0 - 0.27s
orbital_file_manager 5 5 0 0 - 0.03s
orbital_iced 25 25 0 0 - 0.16s
orbital_importer_gltf 14 14 0 0 - 0.15s
orbital_input 11 11 0 0 - 0.08s
orbital_light 6 6 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.03s
orbital_procgeo 2 2 0 0 - 0.01s
orbital_render_graph 6 6 0 0 - 0.04s
orbital_renderer 17 17 0 0 - 0.16s
orbital_resources 29 29 0 0 - 0.20s
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.07s
orbital_shadow 3 3 0 0 - 0.01s
orbital_text 14 14 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.18s
orbital_world_environment 13 13 0 0 - 0.08s
pie showData
    title Nextest outcomes
    "Passed" : 471
pie showData
    title Doctest outcomes
    "Passed" : 1
    "Skipped" : 10
xychart-beta
    title "Slowest crates (nextest seconds)"
    x-axis ["orbital_ecs", "orbital", "orbital_text", "orbital_debug_ui", "orbital_ecs_bridge", "orbital_2d", "orbital_resources", "orbital_ui"]
    y-axis "Seconds" 0 --> 1
    bar [0.73, 0.66, 0.35, 0.33, 0.27, 0.20, 0.20, 0.18]
<!-- orbital-ci-test-results --> ## Smart test results **Result:** PASS **Scope:** full workspace **Reason:** workspace-level change: Cargo.lock **Elapsed:** 17m 23s [Workflow run](https://forgejo.sakul-flee.de/SakulFlee/Orbital/actions/runs/837) **Overall:** 482 tests, 472 passed, 0 failed, 10 skipped **Nextest:** 471 tests, 471 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.66s | | orbital_2d | 29 | 29 | 0 | 0 | 0/1 | 0.20s | | orbital_app | 10 | 10 | 0 | 0 | 0/1 | 0.06s | | orbital_billboard | 6 | 6 | 0 | 0 | - | 0.13s | | orbital_camera | 8 | 8 | 0 | 0 | - | 0.06s | | orbital_core | 2 | 2 | 0 | 0 | - | 0.01s | | orbital_debug_render | 0 | 0 | 0 | 0 | 0/1 | 0.00s | | orbital_debug_ui | 48 | 48 | 0 | 0 | 0/1 | 0.33s | | orbital_ecs | 114 | 114 | 0 | 0 | 0/2 | 0.73s | | orbital_ecs_bridge | 42 | 42 | 0 | 0 | - | 0.27s | | orbital_file_manager | 5 | 5 | 0 | 0 | - | 0.03s | | orbital_iced | 25 | 25 | 0 | 0 | - | 0.16s | | orbital_importer_gltf | 14 | 14 | 0 | 0 | - | 0.15s | | orbital_input | 11 | 11 | 0 | 0 | - | 0.08s | | orbital_light | 6 | 6 | 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.03s | | orbital_procgeo | 2 | 2 | 0 | 0 | - | 0.01s | | orbital_render_graph | 6 | 6 | 0 | 0 | - | 0.04s | | orbital_renderer | 17 | 17 | 0 | 0 | - | 0.16s | | orbital_resources | 29 | 29 | 0 | 0 | - | 0.20s | | 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.07s | | orbital_shadow | 3 | 3 | 0 | 0 | - | 0.01s | | orbital_text | 14 | 14 | 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.18s | | orbital_world_environment | 13 | 13 | 0 | 0 | - | 0.08s | ```mermaid pie showData title Nextest outcomes "Passed" : 471 ``` ```mermaid pie showData title Doctest outcomes "Passed" : 1 "Skipped" : 10 ``` ```mermaid xychart-beta title "Slowest crates (nextest seconds)" x-axis ["orbital_ecs", "orbital", "orbital_text", "orbital_debug_ui", "orbital_ecs_bridge", "orbital_2d", "orbital_resources", "orbital_ui"] y-axis "Seconds" 0 --> 1 bar [0.73, 0.66, 0.35, 0.33, 0.27, 0.20, 0.20, 0.18] ```
Sign in to join this conversation.
No description provided.