4 releases

0.0.4 Nov 26, 2024
0.0.3 Oct 19, 2024
0.0.2 Oct 11, 2024
0.0.1 Oct 11, 2024

#22 in Rendering engine

Download history 243/week @ 2024-10-08 211/week @ 2024-10-15 19/week @ 2024-10-22 1/week @ 2024-10-29 6/week @ 2024-11-05 4/week @ 2024-11-19 146/week @ 2024-11-26

157 downloads per month
Used in kiyo

MIT license

91KB
2K SLoC

Cen

build crate

A lightweight vulkan window backend using ash.

Cen aims to provide abstractions around Vulkan handles and window management. Current features include:

  • Winit-backed window setup
  • Vulkan wrappers with memory dependencies
  • Hot-swappable shader storage, compiled at runtime

Building & running

Make sure you have the Vulkan SDK installed.
Then build and run cen examples:

git clone https://github.com/angelocarly/cen.git
cd cen
cargo run --example basic

GPU debugging

Windows & Linux

Renderdoc!

Mac

Mac only has XCode's Metal debugger. In order to use it you need to provide the following environment variables:

VULKAN_SDK=$HOME/VulkanSDK/<version>/macOS
DYLD_FALLBACK_LIBRARY_PATH=$VULKAN_SDK/lib
VK_ICD_FILENAMES=$VULKAN_SDK/share/vulkan/icd.d/MoltenVK_icd.json
VK_LAYER_PATH=$VULKAN_SDK/share/vulkan/explicit_layer.d

Then you should be able to launch your cen application and capture a frame.
This video does a nice job explaining the process.

References

  • myndgera - Pipeline caching and reloading
  • paya - Vulkan memory dependencies and ash wrappers

Libraries

Dependencies

~60MB
~1M SLoC