skyrookieyu / tinyrenderer_python-1

A fork of ssloy/tinyrenderer in python

Python port of ssloy/tinyrenderer in Python3

To install just download the code. Make sure to have python3 running and the following libs are installed:

pip install pillow

What is special about this fork?

For the general idea please visit https://github.com/ssloy/tinyrenderer

This fork is intended to be a starting point of teaching programming in python3 to everyone as I consider the content to be tough but motivational for beginners. With this in mind I tried to follow ssloys tutorial closely and chose some guidelines:

1. Simplicity over perfection
2. Readability over performance

To accomplish these goals I included a special linear algebra module geom.py instead of using numpy. Numpy is undoubtly more universal and elaborated but harder to read for beginners. The geom.py module contains some basic vector and matrix classes and supports indexing via '.x', '.y' and '.z' notation based on namedtuples.

After finishing the fork I am going to be working on course material and structured lessons to roll out this exciting course of 3D animation and programming sometime in the future. To motivate students even more I plan providing some short Blender tutorials on how to prepare custom models for this renderer.

Here are some examples generated by the renderer

Rendered image with shadows, ambient occlusion and specular lighting (current optimum)

Rendered wire mesh

Rendered randomly colored filled mesh triangles