Basic graphics pipeline sample using Vulkan API
This project provides basic graphics applications samples:
- Forward rendering of a 3d scene in Hydra Renderer XML format (HydraAPI, Hydra renderer) located here. This sample has two renderers, which are selected directly in code (search for CreateRender):
- SIMPLE_FORWARD renders scene in diffuse material
- SIMPLE_TEXTURE renders scene in diffuse textured material
- Shadow map sample located in shadowmap
- Full screen quad render located in quad2d
You can also take a look at Chimera project which served as a base for these samples and implements other example renders including various approaches to using hardware accelerated ray tracing.
Build
Build as you would any other CMake-based project. For example on Linux:
cd vk_graphics_basic
mkdir build
cd build
cmake ..
make -j8
On Windows you can directly open CMakeLists.txt as a project in recent versions of Visual Studio. Mingw-w64 building is also supported.
Executable will be built in bin subdirectory - vk_graphics_basic/bin/renderer
Dependencies
Vulkan
SDK can be downloaded from https://vulkan.lunarg.com/
GLFW
Linux - you can install it as a package on most systems, for example:
sudo apt-get install libglfw3-dev
Windows - you don't need to do anything, binaries and headers are included in this repo (see external/glfw directory).
Additional dependencies
Can be installed by running provided clone_dependencies.bat script. So, if you clone this repo into vk_graphics_basic directory:
cd vk_graphics_basic
clone_dependencies.bat
Or you can get them manually:
volk:
cd vk_graphics_basic/external
git clone --depth 1 https://github.com/zeux/volk.git
imgui:
cd vk_graphics_basic/external
git clone --depth 1 https://github.com/ocornut/imgui.git
vkutils:
cd vk_graphics_basic/external
git clone --depth 1 https://github.com/msu-graphics-group/vk-utils.git vkutils
Single header libraries
This project also uses LiteMath and stb_image which are included in this repo.