Awesome

Rust & Vulkan test projects

Contains test projects and tools for Rust & Vulkan.

• rendersdf
• sdf2tilemap
• sdftool
• vbufferbench

rendersdf

SDF render test project (rendersdf) 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.

An improved version is coming using an 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.

The SDF renderer uses 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)

vbufferbench

A simple benchmark tool for comparing the performance of different V-buffer triangle-id rendering techniques.

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 --bin TEST_NAME
• If you want to recompile shaders, Run (cmd): compile_shaders.bat (or .sh for Mac)

How to use the prototypes

• Start (cmd): cargo run --release --bin TEST_NAME
• 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.