3 releases

0.0.3 Oct 19, 2024
0.0.2 Oct 11, 2024
0.0.1 Oct 11, 2024

#19 in Rendering engine

Download history 230/week @ 2024-10-07 216/week @ 2024-10-14 27/week @ 2024-10-21 7/week @ 2024-11-04

270 downloads per month
Used in kiyo

MIT license

86KB
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

~41–58MB
~1M SLoC