see also Official homepage.

Key Features • How To Use • Download • Credits • Related • License

This project provides me a solid Vulkan/OpenGL renderer starting point for implementing modern established rendering techniques and getting quickly started in own research topics.
As this project evolved it gained additional functionality:

• collecting/using CMake best practices
• collecting/using C++ best practices and testing new lang features 😊
• collecting experience in fuzzy/benchmark testing in C++
• collecting experience in integrating 💌 Rust 💌 code in Cmake projects

Frequently tested under

• windows server 2025 x64 Clang 20.1.0 and MSVC
• ubuntu 24.04 x64 Clang 18.1.3
• ubuntu 24.04 ARM Clang 18.1.3

Legend:

• ✔️ - completed
• 🔶 - in progress
• ❌ - not started

• Vulkan 1.3
• OpenGL 4.6
• GLAD
• glm
• glfw
• tinyobjloader
• stb
• vma
• tinygltf
• gtest
• gbenchmark
• google fuzztest
• cmake
• gsl
• nlohmann_json
• SPDLOG

• Rust
• corrision-rs
• cxx
• uv

• NSIS
• doxygen
• cppcheck
• renderdoc
• nsightgraphics
• valgrind
• clangtidy
• visualstudio
• ClangPowerTools
• Codecov
• Ccache
• Sccache

• gperftools

• CMake format
• CMake tools
• CppTools

C++23 or higher required.
C17 or higher required.
CMake 4.0.2 or higher required.

1. Clone the repo

   git clone --recurse-submodules [email protected]:Kataglyphis/Kataglyphis-BeschleunigerBallett.git

2. Use the scripts (in the Scripts folder for installing dependencies on your system)
3. Then build your solution with [CMAKE] (https://cmake.org/)
   You can follow my steps from my CMake best practices repo.
   For now the features in Rust are experimental. If you want to use them install Rust and set RUST_FEATURES=ON on your CMake build.

Alternatively you can use the build scripts I use for my standard configuration:

• [buildEngine.sh]
• [buildEngine.bat]

$ {WORKING_DIR}/GraphicsEngineVulkan/buildEngine[.sh/.bat]

I provide two ways for compiling shaders with. Hence if you want to add new files as #include in your shaders you have to modify the files: (should be self-explanatory)

• [include/vulkan_base/ShaderIncludes.hpp]
• [cmake/CompileShadersToSPV.cmake]

appropriately.

I follow the test setup as descriped in: CMake best practices

Dockerfile stays at project root.

If you want to run it on NVIDIA GPUs you will have to
install the NVIDIA Container Toolkit
before you proceed with the next steps.

# build
docker build -t kataglphis_renderer_ubuntu24_04 .
# run container on wayland
# start docker in root of this repo 
xhost +local:root
docker run --rm -it \
  --gpus all \
  --network=host \
  -e QT_QPA_PLATFORM=wayland \
  -v /tmp/.X11-unix:/tmp/.X11-unix \
  -v $HOME/.Xauthority:/root/.Xauthority \
  --env DISPLAY=$DISPLAY \
  --env XDG_RUNTIME_DIR=$XDG_RUNTIME_DIR \
  -e WAYLAND_DISPLAY=$WAYLAND_DISPLAY \
  -v "$(pwd)":/workspace:rw \
  -w /workspace \
  kataglphis_renderer_ubuntu24_04 

NOTE: Pls for GPU accelerated Windows Docker have a look here

docker build -f docker/windows/Dockerfile -t my-windows-dev-image .

docker run --rm -it `
  -v "$($PWD.Path):C:\workdir" `
  my-windows-dev-image

Watch the refman generated by doxygen.

• Watch it here

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Distributed under the MIT-License. See LICENSE for more information.

Jonas Heinle - @Cataglyphis_ - [email protected]

Project Link: https://github.com/Kataglyphis/GraphicsEngineVulkan

You will find important links to information in the code. But here in general some good sources of information:

Thanks for free 3D Models:

• Morgan McGuire, Computer Graphics Archive, July 2017 (https://casual-effects.com/data)

• Viking room

• Loading Screen Image

Some very helpful literature, tutorials, etc.

• View Frustum Culling

OpenGL

• learnopengl.com
• ogldev.org
• Cascaded Shadow Maps
• Compute Shader in OpenGL

Clouds

• pbr-book
• Inigo Quilez
• Shadertoy Horizon Zero Dawn
• Sebastian Lague
• Horizon Zero Dawn
• Clouds and noise
• Shadertoy Clouds using 3D Perlin noise

Noise

• Worley noise online demo

Vulkan

• Udemy course by Ben Cook
• Vulkan Tutorial
• Vulkan Raytracing Tutorial
• Vulkan Tutorial; especially chapter about integrating imgui
• NVidia Raytracing tutorial with Vulkan
• Blog from Sascha Willems

Physically Based Shading

• Advanced Global Illumination by Dutre, Bala, Bekaert
• The Bible: PBR book
• Real shading in Unreal engine 4
• Physically Based Shading at Disney
• RealTimeRendering
• Understanding the Masking-Shadowing Function in Microfacet-Based BRDFs
• Sampling the GGX Distribution of Visible Normals

Path tracing

• NVIDIA Path tracing Tutorial

Docker

• Vulkan Minimal Docker setup
• scoop
• Docker container windows GPU
• Docker windows

• Problem: If Validation Layers could not be found:

  A value given directly by extern c function 322
  [XXXX-XX-XX 10:30:40.877] [error] Validation layers requested, but not available!
  [XXXX-XX-XX 10:30:40.879] [error] Failed to create a Vulkan instance!
  [XXXX-XX-XX 10:30:40.880] [error] Validation layers requested, but not available!
  [XXXX-XX-XX 10:30:40.882] [error] Failed to create a Vulkan instance!
  ERROR:             vkGetInstanceProcAddr: Invalid instance [VUID-vkGetInstanceProcAddr-instance-parameter]

  Solution for linux:

  sudo apt install libvulkan1 vulkan-tools vulkan-validationlayers

  Otherwise you would have to install them via sdk.