Awesome

Simple Software Graphics Engine(SSGE): A real-time and interactive 3D Renderer built from scratch in C++

SSGE is the result of a two month long learning project with the aim of building a real-time 3D renderer from scratch in C++. It is capable of modern Physically Based Rendering(PBR) without making use of any third party graphics libraries such as OpenGL, DirectX or Vulkan. It is entirely software based and does not utilize any hardware acceleration throughout it's rendering pipeline. SSGE can run on both Windows and Linux machines by leveraging CMAKE for executable building and compiling and SDL2 for OS and hardware-level abstraction.

Performance wise, it is capable of running scenes containing medium size meshes of ~50k triangles and 4 light sources at a relatively stable frame rate of 30fps (Of course, your mileage may vary) while running the very demanding PBR shader. To achieve this it makes heavy use of multithreading, SIMD directives and various other optimizations such as early backface culling, frustum culling and texture tiling among others.

You can download a demo of it for your machine here:

Project is now on hold :(

Unfortunately this project is no longer maintained. I got hired to work at Rockstar Games as a Graphics Programmer shortly after posting this and don't have the time to work on a sideproject of this size anymore. I plan on keeping it up (as well as my other major graphics project HRE) so others can see what it took me to break into the industry. I will still be helping anyone who runs into any issues with it or has any questions about it. Feel free to reach me here or at my twitter about this or any other GFX topic you'd like to talk about! Thanks to everyone who checked this project out! :D

Render Samples

Louis XIV de France, Louvre, Paris. Scan by HoangHiepVu

Utah teapots with 5 different materials

Chest PBR Test model from @Emackey

Cerberus PBR test model by Andrew Maximov

Orbiting the chest

Development & Feedback

I am planning on starting a series of blog posts sometime soon that will explain some of the cooler components of the engine and how I went about implementing them. I also feel it would be helpful to other beginners if I were to elaborate on some of the components that gave me the most trouble, such as how to design the general architecture of the engine, how to profile, optimize and bug fix your code and lastly how I personally tackled learning Computer Graphics coming from a non-cs background.

Goals

Demonstrate my C++ Knowledge
Satisfy a life long curiosity about computer graphics
Keep the renderer Real-Time (original goal was 16ms actual ~29ms)
Minimize external library usage to minimum
Multiplatform development
Use modern computer graphics techniques
Learn to self-manage and architect "large" projects

I set these goals above as my learning targets for the project before I began and I have to say that I am very happy with how much progress I managed to make with most of them. If you're interested, I gave a talk that went more in detail about this and the journey in itself and you can find the slides for it here:

Talk Slides

Main Features

Rendering

Parallelized forward renderer
Programmable vertex & fragment shaders using C++ virtual functions
Physically Based Shading
Metallic workflow
Cook-Torrance specular BRDF ( w/lambert diffuse)
Perspective Correct Interpolation
Tangent Space Normal Mapping
Ambient Occlusion mapping
Reverse (AKA logarithmic) Z-Buffering [1,0]
Pre-vertex shader back-face Culling
View Frustrum culling
Gapless triangle rasterizer
Fast Gamma correction
Directional Lighting
Bilinear Texture Filtering
Seamless texture repeat
Flat, Gouraud, Phong, Blinn-Phong shaders (deprecated in favor of PBR)

Engine

SDL2 Backend
Multiplatform executables
Scene Switching
Free moving camera
Orbiting Camera mode
Camera FOV controls
Templated Vector Math / Linear algebra library
.Obj file parser
Scene content outlined in .txt file
Texture tiling to reduce cache misses
Multithreading per object and vectorization within lighting shader
Fully commented for future referencing
Image loading through stb-image
Axis aligned Bounding Box generation and reconstruction

Known Issues

Moire Pattern and specular aliasing due to lack of texture minification
Dark metallic objects due to lack of Image Based Lighting (or similar solution)
Jaggies from lack of antialiasing
No shadows causing undesired illumination in some models
Stuttering during slow rotations from lack of sub-pixel precision

References

I've moved most of the sources into a separate page on the wiki for easier navigation and indexing. However, here are some of the ones I utilized the most:

Model & Texture Acknowledgements

If any of the above textures or meshes have been mis-acknowledged, are misattributed, or missing a proper reference please send me a DM on Twitter or email me at the address inside the source files and I'll fix it immediately.

License

MIT License

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.