feat(examples): add transparency acceptance example #960

Merged
SakulFlee merged 1 commit from feat/transparency-example into main 2026-10-28 19:52:53 +00:00
Owner

Summary

Adds a dedicated transparency acceptance example for the renderer overhaul.

  • Three overlapping alpha-blended PBR panes exercise back-to-front transparent sorting against an opaque backdrop.
  • Additive and multiplicative blend states are demonstrated with the same forward transparent queue.
  • One alpha-masked PBR object uses a procedural checker texture so the shadow pass discards transparent cells and produces a perforated shadow.
  • Includes an opaque reference object, a shadow-casting spotlight, directional fill, and the usual camera controller/environment setup.
  • Uses only public material APIs and procedural meshes; no new engine code or dependencies.

Validation

  • cargo test --workspace --no-fail-fast passes.
  • cargo check --workspace with the workspace clippy driver and -D warnings passes.
  • Rust formatting checks pass across Crates/ and Examples/.
  • Visual verification still needs a display/GPU machine; this environment cannot render a frame.
## Summary Adds a dedicated transparency acceptance example for the renderer overhaul. - Three overlapping alpha-blended PBR panes exercise back-to-front transparent sorting against an opaque backdrop. - Additive and multiplicative blend states are demonstrated with the same forward transparent queue. - One alpha-masked PBR object uses a procedural checker texture so the shadow pass discards transparent cells and produces a perforated shadow. - Includes an opaque reference object, a shadow-casting spotlight, directional fill, and the usual camera controller/environment setup. - Uses only public material APIs and procedural meshes; no new engine code or dependencies. ## Validation - `cargo test --workspace --no-fail-fast` passes. - `cargo check --workspace` with the workspace clippy driver and `-D warnings` passes. - Rust formatting checks pass across `Crates/` and `Examples/`. - Visual verification still needs a display/GPU machine; this environment cannot render a frame.
feat(examples): add transparency acceptance example
Some checks failed
Lint / lint (pull_request) Successful in 8m58s
PR / test (pull_request) Has been cancelled
Templates / templates (pull_request) Has been cancelled
a098ae612f
SakulFlee force-pushed feat/transparency-example from a098ae612f
Some checks failed
Lint / lint (pull_request) Successful in 8m58s
PR / test (pull_request) Has been cancelled
Templates / templates (pull_request) Has been cancelled
to a57a3b1441
Some checks failed
Lint / lint (pull_request) Has been cancelled
PR / test (pull_request) Has been cancelled
Templates / templates (pull_request) Has been cancelled
2026-10-28 05:22:02 +00:00
Compare
SakulFlee force-pushed feat/transparency-example from a57a3b1441
Some checks failed
Lint / lint (pull_request) Has been cancelled
PR / test (pull_request) Has been cancelled
Templates / templates (pull_request) Has been cancelled
to f6ac83ef05
All checks were successful
Lint / lint (pull_request) Successful in 1m38s
Templates / templates (pull_request) Successful in 5m24s
PR / test (pull_request) Successful in 19m38s
2026-10-28 05:30:23 +00:00
Compare

Smart test results

Result: PASS

Scope: full workspace

Reason: workspace-level change: Cargo.lock

Elapsed: 18m 41s

Workflow run

Overall: 474 tests, 464 passed, 0 failed, 10 skipped

Nextest: 463 tests, 463 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_2d 29 29 0 0 0/1 0.15s
orbital_app 10 10 0 0 0/1 0.05s
orbital_billboard 6 6 0 0 - 0.11s
orbital_camera 8 8 0 0 - 0.04s
orbital_core 2 2 0 0 - 0.02s
orbital_debug_render 0 0 0 0 0/1 0.00s
orbital_debug_ui 45 45 0 0 0/1 0.28s
orbital_ecs 114 114 0 0 0/2 0.69s
orbital_ecs_bridge 42 42 0 0 - 0.25s
orbital_file_manager 5 5 0 0 - 0.03s
orbital_iced 25 25 0 0 - 0.15s
orbital_importer_gltf 14 14 0 0 - 0.16s
orbital_input 11 11 0 0 - 0.05s
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 12 12 0 0 - 0.07s
orbital_resources 29 29 0 0 - 0.21s
orbital_shader_core 0 0 0 0 1/1 0.00s
orbital_shader_pbr 4 4 0 0 - 0.03s
orbital_shader_preprocessor 12 12 0 0 - 0.07s
orbital_shadow 3 3 0 0 - 0.02s
orbital_text 14 14 0 0 0/1 0.36s
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
pie showData
    title Nextest outcomes
    "Passed" : 463
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_resources", "orbital_ui", "orbital_importer_gltf"]
    y-axis "Seconds" 0 --> 1
    bar [0.69, 0.67, 0.36, 0.28, 0.25, 0.21, 0.17, 0.16]
<!-- orbital-ci-test-results --> ## Smart test results **Result:** PASS **Scope:** full workspace **Reason:** workspace-level change: Cargo.lock **Elapsed:** 18m 41s [Workflow run](https://forgejo.sakul-flee.de/SakulFlee/Orbital/actions/runs/804) **Overall:** 474 tests, 464 passed, 0 failed, 10 skipped **Nextest:** 463 tests, 463 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_2d | 29 | 29 | 0 | 0 | 0/1 | 0.15s | | orbital_app | 10 | 10 | 0 | 0 | 0/1 | 0.05s | | orbital_billboard | 6 | 6 | 0 | 0 | - | 0.11s | | orbital_camera | 8 | 8 | 0 | 0 | - | 0.04s | | orbital_core | 2 | 2 | 0 | 0 | - | 0.02s | | orbital_debug_render | 0 | 0 | 0 | 0 | 0/1 | 0.00s | | orbital_debug_ui | 45 | 45 | 0 | 0 | 0/1 | 0.28s | | orbital_ecs | 114 | 114 | 0 | 0 | 0/2 | 0.69s | | orbital_ecs_bridge | 42 | 42 | 0 | 0 | - | 0.25s | | orbital_file_manager | 5 | 5 | 0 | 0 | - | 0.03s | | orbital_iced | 25 | 25 | 0 | 0 | - | 0.15s | | orbital_importer_gltf | 14 | 14 | 0 | 0 | - | 0.16s | | orbital_input | 11 | 11 | 0 | 0 | - | 0.05s | | 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 | 12 | 12 | 0 | 0 | - | 0.07s | | orbital_resources | 29 | 29 | 0 | 0 | - | 0.21s | | orbital_shader_core | 0 | 0 | 0 | 0 | 1/1 | 0.00s | | orbital_shader_pbr | 4 | 4 | 0 | 0 | - | 0.03s | | orbital_shader_preprocessor | 12 | 12 | 0 | 0 | - | 0.07s | | orbital_shadow | 3 | 3 | 0 | 0 | - | 0.02s | | orbital_text | 14 | 14 | 0 | 0 | 0/1 | 0.36s | | 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 | ```mermaid pie showData title Nextest outcomes "Passed" : 463 ``` ```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_resources", "orbital_ui", "orbital_importer_gltf"] y-axis "Seconds" 0 --> 1 bar [0.69, 0.67, 0.36, 0.28, 0.25, 0.21, 0.17, 0.16] ```
SakulFlee deleted branch feat/transparency-example 2026-10-28 19:52:53 +00:00
Sign in to join this conversation.
No description provided.