The saschawillems/vulkan repository is a comprehensive collection of open source C++ examples and demonstrations for the Vulkan graphics API, maintained primarily by Sascha Willems. The repository serves as an educational resource for developers learning Vulkan, offering practical implementations across a wide range of graphics programming concepts and techniques. While Khronos has since released an official Vulkan Samples repository that Willems has been involved with, this repository continues to be actively maintained and contains examples that may not fit within the official collection.
The repository is organized into multiple categories of examples, starting with foundational concepts in the Basics section. These include simple triangle rendering using both Vulkan 1.0 and Vulkan 1.3, pipeline state objects, descriptor sets, dynamic uniform buffers, push constants, and specialization constants. The texture mapping examples cover 2D textures, texture arrays, cube maps, cube map arrays, and 3D textures with various sampling techniques. Additional basic examples demonstrate input attachments, sub passes, offscreen rendering, particle systems, stencil buffers, and vertex attributes.
The glTF section provides detailed implementations of the glTF 2.0 3D format, including model loading and rendering, vertex skinning with animation data, and complete scene rendering with complex materials and normal mapping. The Advanced section covers more sophisticated rendering techniques such as multisample anti-aliasing, alpha to coverage, high dynamic range rendering with bloom and tone mapping, and shadow mapping with depth bias and PCF filtering.
The repository includes specialized examples for compute shaders, geometry shaders, tessellation shaders, hardware accelerated ray tracing, headless rendering, user interface integration, visual effects, and various Vulkan extensions. Additional miscellaneous examples round out the collection with diverse graphics programming scenarios.
Shader support is a key feature of this repository. Examples are provided with GLSL as the primary shader language, with most samples also including Slang and HLSL shader sources to facilitate comparison between different shading languages. The Rust GPU project maintains separate Rust shader sources in an external repository. All shaders are compiled to SPIR-V, Vulkan's intermediate representation format.
The repository supports building and running on multiple platforms including Windows, Android, iOS, and macOS using MoltenVK, with all examples requiring a C++ compiler supporting C++20. The codebase contains submodules for external dependencies and assets, and comprehensive build documentation is provided. Command line options allow users to select specific GPUs and configure example behavior at runtime.
GitGenius activity data shows that SaschaWillems has been the dominant contributor with 212 tracked events, while the repository has received contributions from lang-sec and SRSaunders among others. The median issue and pull request response latency is 2.9 hours with a mean of 162.2 hours across 82 tracked items. Validation issues have been the most frequently labeled category with 8 instances, followed by Android platform issues with 5 instances and macOS platform issues with 2 instances. The repository shares overlapping contributors with related Khronos projects including vulkan-validationlayers, vulkan-hpp, and moltenvk, indicating active participation in the broader Vulkan ecosystem.
