C Vulkan Renderer (or simply cvr) is a project initially inspired by raylib, but with a Vulkan twist. Essentially, it's a basic renderer I use in my research.
The header vk_ctx.h is meant to be a header-only-ish library that will work outside of cvr. I say "ish", because it does rely on linkage with glfw, but in the future I want to make this optional. cvr is essentially a few extra conveniences around vk_ctx.h (e.g. a matrix stack, frame timer, a few simple primitives etc.). However, if you are a minimalist, check out the header only example.
Some examples are going to look familiar to users of raylib like 3d-primitives, whereas other more complicated ones like point-raster are going to be more familiar to the avid Vulkan user.
Note: The
libfolder is only used for cross-compiling to windows. Also, theextfolder is synonymous to third party.
Install using a package manager e.g.
sudo apt install vulkan-tools libvulkan-dev vulkan-validationlayers-dev spirv-tools libxxf86vm-dev libxi-devHopefully, I didn't miss any, but if I did feel free to let me know.
Download glslc from here and copy (or symlink) it to your /usr/local/bin.
The build system we use is nob, hence the nob.c/nob.h.
cc -o nob nob.cInterested in nob?
To list available examples run the following:
./nob -lTo build and run an example use the -e flag, e.g.:
./nob -e 3d-primitivesNote: Examples
videoandgltfrely on assets that are not found in this repo, so they won't run properly until you download the assets (check their source code comments). The rest of the examples should work out-of-the-box.
Not yet supported.
Specify build target flag (-t), requires that the proper cross-compilers are installed (e.g. x86_64-w64-mingw32-gcc).
Note that the quest target doesn't work yet.
e.g. usage
./nob -e 3d-primitives -t windowsDebug launch flag (-g), uses gf2 and expects it to be in your path.
e.g. usage
./nob -eg 3d-primitivesRenderdoc launch (-r), expects renderdoccmd to be in your path.
e.g. usage
./nob -er 3d-primitivesThen, take a screen shot while launched (usually f11/f12), then hit escape. The example window will close, and a new one of renderdoc will launch.