Repository files navigation

The code itself is of little interest. Check the course notes:

1. Introduction
2. Bresenham’s line drawing algorithm
3. Triangle rasterization
4. Primer on barycentric coordinates
5. Hidden faces removal
6. A crude (but simple) approach to camera handling
7. Better camera handling
8. Shading
9. More data!
10. Tangent space normal mapping
11. Shadow mapping
12. Indirect lighting
13. Bonus: toon shading
14. Afterword

In this series of articles, I aim to demonstrate how OpenGL, Vulkan, Metal, and DirectX work by writing a simplified clone from scratch.Surprisingly, many people struggle with the initial hurdle of learning a 3D graphics API.To help with this, I have prepared a short series of lectures, after which my students are able to produce quite capable renderers.

The task is as follows: using no third-party libraries (especially graphics-related ones), we will generate an image like this:

Warning: This is a training material that loosely follows the structure of modern 3D graphics libraries.It is asoftware renderer.I do not intend to show how to write GPU applications — I want to show how they work.I firmly believe that understanding this is essential for writing efficient applications using 3D libraries.

The final code consists of about 500 lines.My students typically require 10 to 20 hours of programming to start producing such renderers.The input is a 3D model composed of a triangulated mesh and textures.The output is a rendereding.There is no graphical interface, the program simply generates an image.

To minimize external dependencies, I provide my students with a single class for handlingTGA files —one of the simplest formats supporting RGB, RGBA, and grayscale images.This serves as our foundation for image manipulation.At the beginning, the only available functionality (besides loading and saving images) is the ability to set the color of a single pixel.

There are no built-in functions for drawing line segments or triangles — we will implement all of this manually.While I provide my own source code, written alongside my students, I do not recommend using it directly, as doing the work yourself is essential to understanding the concepts.The complete code is available ongithub, and you can find the initial source code I provide to my studentshere.Behold, here is the starting point:

#include"tgaimage.h"constexpr TGAColor white   = {255,255,255,255};// attention, BGRA orderconstexpr TGAColor green   = {0,255,0,255};constexpr TGAColor red     = {0,0,255,255};constexpr TGAColor blue    = {255,128,64,255};constexpr TGAColor yellow  = {0,200,255,255};intmain(int argc,char** argv) {constexprint width  =64;constexprint height =64;     TGAImageframebuffer(width, height, TGAImage::RGB);int ax =7, ay =3;int bx =12, by =37;int cx =62, cy =53;     framebuffer.set(ax, ay, white);    framebuffer.set(bx, by, white);    framebuffer.set(cx, cy, white);    framebuffer.write_tga_file("framebuffer.tga");return0;}

It produces the 64x64 imageframebuffer.tga, here I scaled it for better readability:

git clone https://github.com/ssloy/tinyrenderer.git&&cd tinyrenderer&&cmake -Bbuild&&cmake --build build -j&&build/tinyrenderer obj/diablo3_pose/diablo3_pose.obj obj/floor.obj

The rendered image is saved toframebuffer.tga.