Home

Awesome

AnKi logo

Official website: anki3d.org

Twitter development news feed: twitter.com/anki3d

AnKi 3D engine is a Linux, Windows and Android opensource game engine that runs on Vulkan.

Video

1 License

AnKi's license is BSD. This practically means that you can use the source or parts of the source on proprietary and non proprietary products as long as you follow the conditions of the license.

See the LICENSE file for more info.

2 Building AnKi

Build Status Linux Build Status Windows Build Status Android

To checkout the source type:

git clone https://github.com/godlikepanos/anki-3d-engine.git anki

AnKi's build system is using CMake. A great effort was made to ease the building process that's why the number of external dependencies are almost none.

2.1 On Linux

Prerequisites:

To build the release version:

$cd path/to/anki
$mkdir build
$cd ./build
$cmake .. -DCMAKE_BUILD_TYPE=Release
$make

To view and configure the build options you can use ccmake tool or other similar tool:

$cd path/to/anki/build
$ccmake .

This will open an interface with all the available options.

2.2 On Windows

Prerequisites:

To build the release version open PowerShell and type:

$cd path/to/anki
$mkdir build
$cd build
$cmake .. -G "Visual Studio 15 2017 Win64" -DCMAKE_BUILD_TYPE=Release
$cmake --build . --config Release

Alternatively, recent Visual Studio versions support building CMake projects from inside the IDE:

2.3 For Android

Prerequisites:

Android builds work a bit differently from Linux and Windows. First you need to have built AnKi for your host operating system. That's because Android builds requires the ShaderCompiler/ShaderCompiler.exe to compile the shaders for Android. Then you have to generate a gradle project per build target.

For example, if you want to generate a project for the Sponza sample just type from a Linux terminal:

$cd path/to/anki
$./Samples/Sponza/GenerateAndroidProject.sh path/to/Binaries/ShaderCompiler

or from a PowerShell terminal on Windows:

$cd path/to/anki
$./Samples/Sponza/GenerateAndroidProject.bat path/to/Binaries/ShaderCompiler.exe

The GenerateAndroidProject scripts will generate a project in the root directory of AnKi. So for the Sponza sample the script will create a directory named AndroidProject_Sponza.

Then you can open the AndroidProject_Sponza project from Android Studio and build it, debug it, run it etc.

3 Next steps

This code repository contains 4 sample projects that are built by default (ANKI_BUILD_SAMPLES CMake option):

You can try running them and interacting with them. To run sponza, for example, execute the binary from any working directory.

On Linux:

$./path/to/build/Binaries/Sponza

On Windows just find the Sponza.exe and execute it. It's preferable to run the samples from a terminal because that prints some information, including possible errors.

4 Contributing

There are no special rules if you want to contribute. Just create a PR. But before you do that, carefully read the code style guide.