Skip to content
DnecLvPublic
forked from Patryk27/strolle

About

Experimental real-time renderer with support for dynamic global illumination

Resources

Stars

0 stars

Watchers

0 watching

Forks

 
 

Repository files navigation

Strolle

Strolle (from strålspårning) is a real-time renderer with support for dynamic global illumination:

Strolle's goal is to experiment with modern real-time lighting techniques such as ReSTIR and see how far we can go on consumer hardware, especially the one without dedicated ray-tracing cores.

Strolle comes integrated with Bevy, but can be also used on its own (through wgpu).

Status: Experimental, no official release yet (see the demo below, though!).
Platforms: Windows, Mac, Linux & WebGPU.

Gallery

Examples

Dungeon

$ cargo run --release --example demo

Shows a dungeon tech demo, as in the example above.

Use WASD to move and mouse to navigate the camera - extra controls include:

  • F: Toggle flashlight,
  • H/L: Adjust sun's azimuth,
  • J/K: Adjust sun's altitude,
  • T: Remove textures,
  • 1: Switch camera back to the default mode,
  • 2: Show direct lighting only,
  • 3: Show indirect diffuse lighting only,
  • 4: Show indirect specular lighting only,
  • 9: Switch camera to a path-traced reference mode (slow),
  • 0: Switch camera to Bevy's renderer,
  • ;: Toggle camera's controls on/off - useful for taking screenshots.

Model thanks to:
https://sketchfab.com/3d-models/low-poly-game-level-82b7a937ae504cfa9f277d9bf6874ad2

Cornell Box

$ cargo run --release --example cornell

Usage

Bevy

Currently supported Bevy version: 0.12.1.

  1. Add Strolle to your dependencies:

    [dependencies]
    bevy_strolle = { git = "https://github.com/patryk27/strolle" }
  2. Add a patch to work-around a bug in Naga:

    [patch."crates-io"]
    naga = { git = "https://github.com/Patryk27/naga", branch = "v0.13.0-strolle" }
  3. Setup & enjoy!

    App::new()
        /* ... */
        .add_plugins(StrollePlugin);
    
    commands
        .spawn(Camera3dBundle {
            camera_render_graph: CameraRenderGraph::new(
                bevy_strolle::graph::NAME,
            ),
            camera: Camera {
                hdr: true,
                ..default()
            },
            ..default()
        });

Note that Strolle completely overrides Bevy's camera graph, so you can't use a Strolle camera together with Bevy's effects such as bloom or TAA (yet); you also can't use custom vertex or fragment shaders.

Also, Strolle is not optimized well towards higher resolutions - on non-high-end GPUs, it's recommended to stick to ~800x600 and upscale the camera instead (see the demo.rs here).

(that's mostly because Strolle uses ray-tracing not only to compute indirect lighting, but direct as well, which is too heavy for smaller GPUs - this is on our roadmap, though!)

Roadmap

https://github.com/Patryk27/strolle/issues?q=is%3Aissue+is%3Aopen+label%3AC-bug%2CC-feature

Algorithms

Notable algorithms implemented in Strolle include:

License

MIT License

Copyright (c) 2022 Patryk Wychowaniec & Jakub Trąd

About

Experimental real-time renderer with support for dynamic global illumination

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages