Release State: Pre-Release/Beta

Engine Version: 0.10

Realtime 3D rendering engine. Expect bugs and instability as it is still under development. The engine is free and open source (licensed under MPL-2.0). Please feel free to contact me about any questions or issues you have!

(3D Model: Intel Sponza)

(3D Model: San Miguel)

(3D Model: Cornell Box)

-> Video Feature Reel

-> Graphics Image Feature Reel

-> High Level Architecture Overview

-> How A Frame Is Rendered

Purpose

This project was created as a hobby research project for learning low level engine development and implementing modern graphics techniques.

Use Cases

At its core Stratus is a rendering engine first with minimal features found in general purpose engines. Its focus is on modern 3D graphics capabilities. Because of this it has two main use cases:

People taking it and using it as a learning resource.
Integration into other general purpose engines (new or existing) and modeling tools.

Because of the MPL license, any community changes made to the rendering code will continue to help others in new and existing projects that use it.

Current Supported Features

Graphics

Physically based metallic-roughness pipeline
Realtime global illumination
Spatiotemporal image denoising
Raymarched volumetric lighting and shadowing
Cascaded shadow mapping
Deferred lighting
Mesh LOD generation and selection
GPU Frustum Culling
Screen Space Ambient Occlusion (SSAO)
Reinhard or ACES Tonemapping
Fog
Bloom
Fast Approximate Anti-Aliasing (FXAA)
Temporal Anti-Aliasing (TAA)

Engine

Pool allocators
GPU memory allocators/managers
Multi threaded utilities
Concurrent hash map
Entity-Component System (ECS)
Logging

Modern graphics API features used

Compute shaders
Direct state access
Programmable vertex pulling
Multi draw elements indirect
Shader storage buffer

Minimum Hardware Requirements

Type	Minimum
CPU	Ryzen 3 1200 (quad core)
RAM	8 GB
GPU	Nvidia GTX 1050 Ti

Building For Windows & Linux

This code base will currently not work on MacOS. Linux and Windows should both be fine so long as the graphics driver supports OpenGL 4.6 and the compiler supports C++17.

First set up the repo

git clone --recursive https://github.com/KTStephano/StratusGFX.git
cd StratusGFX

Build 3rd party dependencies -> should only need to do this once per clone

python3 ./dependency_build.py

Now build the StratusGFX source

mkdir build; cd build
cmake ..
cmake --build . -j 8 --config RelWithDebInfo

All executables will be put into StratusGFX/Bin. Make sure you run them while inside Bin/. Good ones to run to see if it worked are

Ex00_StartupShutdown.exe (runs through initialize, run one frame, shutdown sequence)
Ex01_StratusGFX.exe (you should see a forest of red cubes since textures aren't bundled with source)
StratusEngineUnitTests.exe
StratusEngineIntegrationTests.exe

First Places to Look

You can check High Level Architecture Overview, or you can start by looking through the code under Examples/ExampleEnv00 and Examples/ExampleEnv01. They both depend on code that is inside of Examples/Common which is another good place to look around.

None of the test scenes are bundled with this source so the rest of the environments will be completely blank when running.

Running Example Environments 2-7

When starting the examples will take a bit to load/process. You can see the status in the console. After starting you may experience some temporary frame drops but this will stabilize quickly.

-> More in depth explanation here: Examples

A zip file containing Sponza, Interrogation Room, San Miguel, Bistro and Bathroom can be found here: https://drive.google.com/file/d/1m56T8cWMwAOHTAIbxAn-891trehgJpzH/view?usp=drive_link
Extract the Resources.zip folder into the root of StratusGFX. It will then be at the same level as Bin/, Examples/, Source/, Tests/. Make sure that the folder structure looks like StratusGFX/Resources/* where * will be folders such as Sponza, Bistro, etc.
Change directory into Bin/ and run the example environments.

Example environment 01 will still be a forest of red cubes since its textures and models aren't part of the bundle.

Credits for the 3D assets used in the examples/demos are as follows: