GearsVK is a modern port of the classic OpenGL 'gears' demo to Vulkan using the VKK library. Designed as a learning resource for developers, this project provides a clear and concise demonstration of core Vulkan concepts. Building upon Brian Paul's original OpenGL implementation, GearsVK offers a solid foundation for understanding Vulkan graphics programming.
Beyond the core demo, this repository includes additional branches showcasing advanced techniques like upscaling and super sampling, as well as a detailed Vulkan tutorial for beginners. I hope GearsVK becomes an invaluable resource for aspiring graphics developers to learn about graphics and the Vulkan API.
Clone the GearsVK project https://github.com/jeffboody/gearsvk.
git clone git@github.com:jeffboody/gearsvk.git
git checkout -b main origin/main
git submodule update
Install library dependencies
sudo apt-get install libsdl2-2.0 libjpeg-dev
Install Vulkan libraries
sudo apt-get install libvulkan1 vulkan-utils
Install the LunarG Vulkan SDK
https://www.lunarg.com/vulkan-sdk/
Download and install Android Studio
https://developer.android.com/studio
Optionally install Java JDK to build with Gradle from command line
https://www.oracle.com/technetwork/java/javase/downloads/index.html
Note: if creating a new Android project set the minimum API level to API 24 (Android 7.0/Nougat) for Vulkan apps.
Edit profile as needed for your development environment before building.
Command line
source profile
cd app/src/main/cpp
make
./gearsvk
Android Studio
Import Project
Select the gearsvk folder
Build > Make Project
The following websites were useful in making this port.
https://www.khronos.org/vulkan
https://vulkan.lunarg.com
https://wiki.libsdl.org/CategoryVulkan
https://developer.android.com/ndk/guides/graphics
https://github.com/vinjn/awesome-vulkan
https://vulkan-tutorial.com
https://developer.nvidia.com/vulkan-shader-resource-binding
https://developer.nvidia.com/blog/vulkan-dos-donts
In addition to the "Vulkan Programming Guide: The Official Guide to Learning Vulkan" book.
This app was ported from the Gears2 implementation.
https://github.com/jeffboody/gears2
The Gears demo also depends on the following projects.
https://github.com/jeffboody/libbfs
https://github.com/jeffboody/libcc
https://github.com/jeffboody/libexpat
https://github.com/jeffboody/libsqlite3
https://github.com/jeffboody/libvkk
https://github.com/jeffboody/jpeg
https://github.com/jeffboody/texgz
https://github.com/lvandeve/lodepng
GIF created by ffmpeg.
sudo apt install ffmpeg
ffmpeg -i gearsvk.mp4 -s 256x256 -r 30 gearsvk.gif
This port of GearsVK was implemented by Jeff Boody under The MIT License.
Copyright (c) 2009-2010 Jeff Boody
Gears for Android is a heavily modified port of the famous "gears" demo.
As such, it is a derived work subject to the license requirements (below)
of the original work.
Copyright (c) 1999-2001 Brian Paul All Rights Reserved.
Permission is hereby granted, free of charge, to any person obtaining a
copy of this software and associated documentation files (the "Software"),
to deal in the Software without restriction, including without limitation
the rights to use, copy, modify, merge, publish, distribute, sublicense,
and/or sell copies of the Software, and to permit persons to whom the
Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included
in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.