/vkr

🌋 Rust Vulkan renderer

Primary LanguageRustMIT LicenseMIT

VKR 🌋

VKR is a Vulkan experiment written in Rust to explore ash and rust-gpu

Cube

Features

  • Data-driven design
  • Scene graph
  • Rust shaders
  • Swapchain recreation on window resize
  • Concurrent frames drawing
  • Various rendering pipelines
  • Multiple subpasses

Requirements

VKR should work on Linux, MacOS, and Windows without issues, but if you need any help please do not hesitate to contact me.

Download and install Vulkan SDK 1.2.198.1 for your platform. Install Rust and SDL2.

Build

Run script/build-vkr.sh. This script will make sure you are using the right rust-gpu version, together with its rust-toolchain. The script also makes sure that cargo test runs to ensure that required files are generated.

Troubleshooting

  • If you see the following error message but your rustup version is 1.23 already, then uninstall and re-install it following the method suggested on rustup.rs.

    If you see this, run `rustup self update` to get rustup 1.23 or newer.
    
  • Before attempting to fix any kind of Vulkan validation error, make sure your Vulkan SDK version installed is aligned with the requirements and the rust-gpu version is correct as from .gitsubmodules together with its rust-toolchain file.

Screenshots

Simple start

Hello texture

Parallax