README.md

Software Renderer

This is a shader-based software renderer written from scratch. It is written in C89 with minimal dependencies, available for Windows, macOS, and Linux.

Features

Cross-platform (Windows, macOS, and Linux)
Minimal dependencies
Shader-based
Blinn–Phong reflection model
Physically based rendering (PBR)
Metalness workflow
Specular workflow
Image-based lighting (IBL)
Tangent space normal mapping
Shadow mapping
Cubemapped skybox
Skeletal animation
Orbit camera control
Back-face culling
Homogeneous clipping
Perspective-correct interpolation
Depth testing
Alpha testing
Alpha blending
Platform abstraction layer (window, event, and timer)
Math library (vector, matrix, and quaternion)
Mesh loading (obj, gltf)
Image loading (tga, hdr)

Download

Binaries for Windows, macOS, and Linux are available.

Build

To build the renderer from source, a C89 compiler and development files for your window system are required.

Windows

Install Visual Studio and run build_win32.bat.

macOS

Install Xcode and run build_macos.sh.

Linux

Install GCC and Xlib with the following commands and run build_linux.sh.

Ubuntu / Debian

sudo apt install gcc libx11-dev

Fedora / RHEL

sudo dnf install gcc libX11-devel

openSUSE / SUSE

sudo zypper install gcc libX11-devel

Usage

Launch

If the renderer is launched without arguments, one of the available scenes will be chosen randomly. To display a specific scene (see below), additional arguments should be supplied. The command line syntax is: