Atlas Engine
Realtime Sponza scene with raytraced GI, AO and reflections (model from Intel Graphics Research Sample Library)
Introduction
This is a cross platform toy engine developed in my spare time that is available on Linux, Windows and MacOS.
Note:
The current version (0.2.0) contains many API changes and is still an active WIP
Requirements
- Vulkan SDK
- C++20 compatible compiler
- CMake
- Vcpkg
Set up
Dependencies are managed through vcpkg. You can either install the packages manually
or while doing the build configuration with CMake. To use vcpkg together with CMake follow the steps described here.
Compiling the demo application
Run CMake with the option ATLAS_DEMO=ON to include the demo application in the project. For easier use, the vsbuild.bat does exactly
that and launches Visual Studio afterwards. After launching the IDE, set AtlasEngineDemo as your target.
Including the library into your own project
It is possible to compile the engine either as a shared or static library. Set the ATLAS_BUILD_SHARED option accordingly. To make
the library work with its dependencies, the root CMakeLists.txt of this repository has to be added as a subdirectory. As an entry
point to create an application from scratch take a look at the Hello World tutorial. For reference, the source folder contains an empty app header and an empty app source.
CMake build options
- ATLAS_BUILD_SHARED Force project to be build as a shared library
- ATLAS_EXPORT_MAIN Export the main file to be added as executable to parent project (only if main function cannot be found)
- ATLAS_NO_APP Disables the engines main function and app functionality. You have to code the main function and
initialize the engine yourself
- ATLAS_IMGUI Enables the ImGui integration. Is enabled by default if the demo project is build.
- ATLAS_ASSIMP Enables the Assimp integration. Is enabled by default.
- ATLAS_HEADLESS Enables the headless support, which means no window needs to be created. Is disabled by default.
- ATLAS_BINDLESS Enables support for bindless resources. Might be problematic on MacOS. Enabled by default.
- ATLAS_TESTS Generates the testing project and allows to target it.
- ATLAS_BUNDLE Allows the applications to be bundled and installed on MacOS. Disabled by default
Documentation
If you want more information have a look into the Documentation.
License
The source code is licensed under the MIT license. The copyright notices of the dependencies can be found
in the LICENSE.md file in the dependency directory.
Note:
The files in the data folder (except the shaders) use a different license.
Code Example
For a code example have a look at the demo application.
Latest executables
The latest non-release executables can be found in the latest run of the build pipeline. They contain both the demo application and the editor.
Screenshots
Sponza demo scene opened in the editor
Rasterized image using real time global illumination
Path traced scene
Island demo scene using the terrain and ocean systems
评论