Software rendering engine with PBR. Built from scratch on C++.

Topics
#learning #c-plus-plus #prototype #cpp #shaders #graphics #software-rendering #sdl2 #parallelization #graphics-programming #rendering-engine #rendering-pipeline #3d-graphics #3d #rasterization #physically-based-rendering #pbr

Angel Ortiz c849ff0a2c Update README.md 7 years ago
include ce1941c0e4 Added test scenes. 7 years ago
libs 29eaf339fc Added texture mapping. 7 years ago
modules 29ce0b3cc7 Fixed windows SDL dll issues. 7 years ago
scenes ce1941c0e4 Added test scenes. 7 years ago
src ce1941c0e4 Added test scenes. 7 years ago
.gitattributes 5cd764e814 Added gitattributes file. 7 years ago
.gitignore 4c653b237a Added SDL and library support on CMAKE. 7 years ago
CMakeLists.txt ce1941c0e4 Added test scenes. 7 years ago
README.md c849ff0a2c Update README.md 7 years ago
_config.yml 39629761fc Set theme jekyll-theme-minimal 7 years ago

README.md

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, frustrum culling and texture tiling among others.

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

Render Samples

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

Utah teapots with 5 different materials

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

  1. Demonstrate my C++ Knowledge
  2. Satisfy a life long curiosity about computer graphics
  3. Keep the renderer Real-Time (original goal was 16ms actual ~29ms)
  4. Minimize external library usage to minimum
  5. Multiplatform development
  6. Use modern computer graphics techniques
  7. 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.