NOTE!!!

This project has been archived, a improved version is here

About this project

This is the C-implementation code of vulkan triangle based on vulkan-tutorial.com

Why use C instead of C++?

Because some newcomers don't know C++ or STL. Implement the code with C will help them have a better understanding with the tutorial.

How many chapters this code had actually implemented?

From chapter 1 to chapter 16, you can view comments from the source code to see how they're implemented.

How to build it?

You shouldn't stick to the Original Tutorial because this code contains VLA(Variable Length Array) features, which is not supported in C++, especially Visual C++.

FOR WINDOWS USERS

You need to install VulkanSDK, MinGW(GNU C/C++ Compiler for Windows), CMake. Then download and extract GLFW prebuild library for windows (and move it under C:/ if possible).

Now fetch this source code through Git or Direct-Download.

Then you should read through CMakeLists.txt and modify the path to suit your needs.

Then open the project folder press Shift + Right Click and select open in terminal, Type the following command(change argument with <> to what you want):


cmake -G "MinGW Makefiles" -B <your-build-dir>

cmake --build <your-build-dir> --target all -j<numbers-of-threads>

If you don't like typing command line, Double Click 'Windows_Build.bat' and it will automatically build inside a subdirectory named 'build'.

FOR LINUX USERS

You need to install a Desktop Environment, vulkan driver for your GPU, gcc, glslang, cmake and glfw, they should be included inside your package manager if you're using popular distro. If not, fetch their source code, build and install them manually.

Now fetch this source code through Git or Direct-Download.

Then read through CMakeLists.txt, confirm that the path was absolutely correct.

Then open the terminal by pressing Ctrl + Alt + T to open the terminal(If your Desktop Environment doesn't support this shortcut, open it manually through application launcher), Type the following command:


cd <project-path>

cmake -B <your-build-dir>

cmake --build <your-build-dir> --target all -j<numbers-of-threads>

Where is the program after the build steps?

Open file manager(or use cd if you like typing command) and open your build folder, double click the program named 'vulkan-triangle', a colorful triangle with purple background will pop up.

How to change the color of The Background or The Triangle ?

BACKGROUND COLOR:

Search "VkClearValue" in main.c, the four-floating-number-array after clear_val is the background color, represents "R", "G", "B" and "A", curretly only RGB value has effect.

TRIANGLE COLOR:

Search "vec3 colors" in shader.vert, there are three three-floating-number-array after that. It's the RGB value of three vertex colors of the triangle.

lonelydevil / vulkan-tutorial-C-implementation