Part of the rerun family of crates.
A custom wgpu based renderer tailored towards re_viewer's needs. Nevertheless, it can be used standalone and comes with its own examples!
Some key features:
- Key primitives for visualization like lines and points are first class citizens
- Built with multiple independent views/cameras in mind
- WebGL compatible quality tier allows use in the browser without WebGPU support
- Hot shader reloading
- … and more to come!
Goals & philosophy:
- Handle fully dynamic data
- assumes that most data may change every frame!
- Automatic resource re-use & caching
- Lazy loading whenever possible for best startup performance
- Run great both on the desktop and web
- No dependencies on
re_vieweror Rerun chunk store libraries
In debug mode shaders are live-reloaded. If a failure occurs during live-reload, an error is logged and the previous shader is kept.
If RERUN_WGSL_SHADER_DUMP_PATH is set, all readily stitched (import resolve) and patched
wgsl shaders will be written to the specified directory.
Often you're also interested in the Naga translated shader. This can be done easily from command line using
cargo install naga-cli --all-featuresExample for translating a wgsl fragment shader to GL as used on WebGL:
naga ./wgsl_dump/rectangle_fs.wgsl ./wgsl_dump/rectangle_fs.frag --entry-point fs_main --profile es300Example for translating a wgsl vertex shader to GL as used on WebGL:
naga ./wgsl_dump/rectangle_vs.wgsl ./wgsl_dump/rectangle_vs.vert --entry-point vs_main --profile es300Note that a single shader entry point from wgsl maps to a single frag/vert file!
Example for translating a wgsl to MSL as used on MacOS. Note that a single metal file maps to a single wgsl file.
naga ./wgsl_dump/rectangle_fs.wgsl ./wgsl_dump/rectangle_fs.metal