Rust & Vulkan test projects

Contains test projects for Rust & Vulkan

The first test project renders 1 million cubes, each containing a 950 MB (uncompressed) distance field volume. It uses an optimized cube renderer rendering only front faces of each cube.

The second test project is going to be using sparse octree storing a hierarchy of distance field volume bricks, each rasterized as a cube. This will both reduce the SDF volume memory consumption by 98% and make the runtime faster, as most rays missing the object will not be cast at at all, and the remaining rays will start very close to the surface.

These projects use a GPU-driven culling solution similar to the one we presented at SIGGRAPH 2015 (Media Molecule Dreams and UE5 Nanite also use similar culling): https://advances.realtimerendering.com/s2015/aaltonenhaar_siggraph2015_combined_final_footer_220dpi.pdf

Various optimization techniques will be tested on top of this prototype.

Todo

Conservative depth output
Command line tool for SDF processing (sdf.rs functionality)
Sparse SDF test project
More than one SDF volume (easy to implement for sparse SDF)

Install instructions

Install rustup: https://www.rust-lang.org/tools/install
Install Vulkan SDK: https://vulkan.lunarg.com/sdk/home
Install git LFS: https://git-lfs.github.com/
Run (cmd): git lfs install
Clone repository (cmd): git clone https://github.com/sebbbi/rust_test.git
IMPORTANT: Zip download does NOT support git LFS!
Run (cmd): cargo run --release
If you want to recompile shaders, Run (cmd): compile_shaders.bat

How to use the prototype

Start (cmd): cargo run --release
WASD = fly around
Drag mouse left button = rotate camera
Mouse wheel = jump backward / forward

How to import a new SDF (from .obj file)

Clone my SDFGen fork: https://github.com/sebbbi/SDFGen
This version of SDFGen has 16 bit binary output. Which is compatible with rust_test
Compile the project with a C++ compiler of your choice (use x64 target)
Run (cmd): SDFGen.exe your_file.obj 0.125 32 (the 0.125 is the voxel size, use larger value if the SDF resolution is too large)
Replace this line with load_sdf("your_file.sdf"): https://github.com/sebbbi/rust_test/blob/main/src/main.rs#L59

License

This repository contents are released under the MIT license. See LICENSE.md for full text.