Tiny Renderer or how OpenGL works: software rendering in 500 lines of code

Check the wiki for the detailed lessons. My source code is irrelevant. Read the wiki and implement your own renderer. Only when you suffer through all the tiny details you will learn what is going on.

I do want to get emails for feedback ([email protected]); do not hesitate to contact me if you have any questions.

If you are a teacher and want to use/adapt this material for your class - you are very welcome to do so, no authorization is needed. Simply inform me by mail, it will help me improve the course.

In this series of articles, I want to show the way OpenGL works by writing its clone (a much simplified one). Surprisingly enough, I often meet people who cannot overcome the initial hurdle of learning OpenGL / DirectX. Thus, I have prepared a short series of lectures, after which my students show quite good renderers.

So, the task is formulated as follows: using no third-party libraries (especially graphic ones), get something like this picture:

Warning: this is a training material that will loosely repeat the structure of the OpenGL library. It will be a software renderer. I do not want to show how to write applications for OpenGL. I want to show how OpenGL works. I am deeply convinced that it is impossible to write efficient applications using 3D libraries without understanding this.

I will try to make the final code about 500 lines. My students need 10 to 20 programming hours to begin making such renderers. At the input, we get a test file with a polygonal wire + pictures with textures. At the output, we’ll get a rendered model. No graphical interface, the program simply generates an image.

Since the goal is to minimize external dependencies, I give my students just one class that allows working with TGA files. It’s one of the simplest formats that supports images in RGB/RGBA/black and white formats. So, as a starting point, we’ll obtain a simple way to work with pictures. You should note that the only functionality available at the very beginning (in addition to loading and saving images) is the capability to set the color of one pixel.

There are no functions for drawing line segments and triangles. We’ll have to do all of this by hand. I provide my source code that I write in parallel with students. But I would not recommend using it, as this doesn’t make sense. The entire code is available on github, and here you will find the source code I give to my students.

#include "tgaimage.h"
const TGAColor white = TGAColor(255, 255, 255, 255);
const TGAColor red   = TGAColor(255, 0,   0,   255);
int main(int argc, char** argv) {
        TGAImage image(100, 100, TGAImage::RGB);
        image.set(52, 41, red);
        image.flip_vertically(); // i want to have the origin at the left bottom corner of the image
        return 0;

output.tga should look something like this:

Teaser: few examples made with the renderer

Related Repositories



Support c++ code for a short computer graphics course ...



Swift 3D render inspired by https://github.com/ssloy/tinyrenderer ...



Software renderer based on tinyrenderer ...



learning https://github.com/ssloy/tinyrenderer/wiki ...

Top Contributors

ssloy dmedov BG4444 erwincoumans


-   Chapter_Two_Final zip tar
-   Chapter_Three_Final zip tar
-   Chapter_Six_Final zip tar
-   Chapter_One_Final zip tar
-   Chapter_Five_Final zip tar