feat(volumetrics): add sky and IBL ambient contribution #975

Merged
SakulFlee merged 1 commit from feat/volumetric-ibl into main 2026-10-29 18:49:58 +00:00
Owner

Summary

Adds diffuse environment/sky radiance to volumetric in-scattering.

  • New VolumetricSettings::environment_intensity multiplier.
  • The volumetric injection shader now samples the world diffuse environment cube along the view direction and adds it to the manual ambient term.
  • The multiplier is packed into the unused ambient.w slot, so the inject uniform layout is unchanged.
  • The Rendering panel exposes an IBL ambient slider.
  • AiO and the volumetrics example enable a tuned amount of sky contribution.
  • Updated the volumetrics documentation in AGENTS.md.

This makes fog visible in rooms that are lit mainly by sky/IBL rather than punctual lights. Direct sun shafts are still a separate follow-up; this pass adds the diffuse environment radiance only.

Validation

  • cargo test -p orbital_renderer -p orbital_debug_ui --all-targets passes, including the noop volumetric pipeline tests.
  • cargo check --workspace with the workspace clippy driver and -D warnings passes.
  • rustfmt --check passes for all Rust sources.
  • No GPU visual validation was possible locally.

Related: #969, #971.

## Summary Adds diffuse environment/sky radiance to volumetric in-scattering. - New `VolumetricSettings::environment_intensity` multiplier. - The volumetric injection shader now samples the world diffuse environment cube along the view direction and adds it to the manual ambient term. - The multiplier is packed into the unused `ambient.w` slot, so the inject uniform layout is unchanged. - The Rendering panel exposes an **IBL ambient** slider. - AiO and the volumetrics example enable a tuned amount of sky contribution. - Updated the volumetrics documentation in `AGENTS.md`. This makes fog visible in rooms that are lit mainly by sky/IBL rather than punctual lights. Direct sun shafts are still a separate follow-up; this pass adds the diffuse environment radiance only. ## Validation - `cargo test -p orbital_renderer -p orbital_debug_ui --all-targets` passes, including the noop volumetric pipeline tests. - `cargo check --workspace` with the workspace clippy driver and `-D warnings` passes. - `rustfmt --check` passes for all Rust sources. - No GPU visual validation was possible locally. Related: #969, #971.
feat(volumetrics): add sky and IBL ambient contribution
All checks were successful
Lint / lint (pull_request) Successful in 1m42s
PR / test (pull_request) Successful in 7m33s
Templates / templates (pull_request) Successful in 2m26s
88a935770c

Smart test results

Result: PASS

Scope: orbital_debug_ui, orbital_ecs_bridge, orbital_renderer

Reason: directly changed crates

Elapsed: 6m 48s

Workflow run

Overall: 108 tests, 107 passed, 0 failed, 1 skipped

Nextest: 107 tests, 107 passed, 0 failed, 0 skipped
Doctests: 1 tests, 0 passed, 0 failed, 1 skipped

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

Crate Nextest Passed Failed Skipped Doctests Time
orbital_debug_ui 48 48 0 0 0/1 0.35s
orbital_ecs_bridge 42 42 0 0 - 0.33s
orbital_renderer 17 17 0 0 - 0.20s
pie showData
    title Nextest outcomes
    "Passed" : 107
pie showData
    title Doctest outcomes
    "Skipped" : 1
xychart-beta
    title "Slowest crates (nextest seconds)"
    x-axis ["orbital_debug_ui", "orbital_ecs_bridge", "orbital_renderer"]
    y-axis "Seconds" 0 --> 1
    bar [0.35, 0.33, 0.20]
<!-- orbital-ci-test-results --> ## Smart test results **Result:** PASS **Scope:** orbital_debug_ui, orbital_ecs_bridge, orbital_renderer **Reason:** directly changed crates **Elapsed:** 6m 48s [Workflow run](https://forgejo.sakul-flee.de/SakulFlee/Orbital/actions/runs/856) **Overall:** 108 tests, 107 passed, 0 failed, 1 skipped **Nextest:** 107 tests, 107 passed, 0 failed, 0 skipped **Doctests:** 1 tests, 0 passed, 0 failed, 1 skipped _Outcome charts are split between nextest and doctests. The timing chart covers nextest only._ | Crate | Nextest | Passed | Failed | Skipped | Doctests | Time | | --- | ---: | ---: | ---: | ---: | ---: | ---: | | orbital_debug_ui | 48 | 48 | 0 | 0 | 0/1 | 0.35s | | orbital_ecs_bridge | 42 | 42 | 0 | 0 | - | 0.33s | | orbital_renderer | 17 | 17 | 0 | 0 | - | 0.20s | ```mermaid pie showData title Nextest outcomes "Passed" : 107 ``` ```mermaid pie showData title Doctest outcomes "Skipped" : 1 ``` ```mermaid xychart-beta title "Slowest crates (nextest seconds)" x-axis ["orbital_debug_ui", "orbital_ecs_bridge", "orbital_renderer"] y-axis "Seconds" 0 --> 1 bar [0.35, 0.33, 0.20] ```
Sign in to join this conversation.
No description provided.