Raytracing

A 3D raytracing engine written in C++. Engine supports rasterization, shadows and reflections.

TODO

• Add spotlight light sources
• Add support for textures
• Add reflections
• Add skydome
• Parallelize rendering
• Add shadows
• Add supersampling
• Fix a bug with random lines being shown
• Fix shadow bugs

Showcase

Utah teapot with skydome

Scene with reflections

Depth buffer

Dependencies

• SDL2

Compiling

Before you start compiling, make sure you have SDL2 library installed.

• If you want to compile with g++ compiler on Linux, everything is already in compile.sh file.

List of all the files and folders

• .gitignore - A gitignore file
• compile.sh - A Linux shell script that compiles the whole project
• main.cpp - The file with main function, that then includes classes and functions from raytracing.cpp file
• README.md - readme file
• libraries/ [folder] - a folder in which are all the necessary libraries (except for SDL2). Within this folder there are other folders, with the name of the library used. In each of those folders are then all the necessary .h and .cpp files.
  • lodepng/ [folder] - a folder with all the files necessary to save frames to png images. It was not written by me but you can find it on Github https://github.com/lvandeve/lodepng
  • raytracing/ [folder] - the folder, in which all the raytracing stuff is. Everything in this folder is my work
    • raytracing.cpp - The file with most of the code necessary
    • raytracing.h - raytracing.cpp header file
• tools/ [folder] - a folder with different tools (like .obj to .scene converter)

How to create your own scene

A scene is a simple file in which there is information about all the triangles in the scene.

A scene file can handle three different instructions

• tr - render a triangle. An example of such instruction would be tr 0 0 100 100 0 100 50 50 150 1 0 0. After the instruction, there are 12 float numbers, that tell the parser: x, y, z coordinates of all three sides of triangle and r g b values for the color of triangle (values should be between 0 and 1). There is also optional argument reflectiveness, which should be between 0 and 1 as well.
• ttr - acts similarly to just tr, but instead of rgb colors, there has to be a link to a png texture. After that, there should be 6 more floating point numbers, that represent the triangle on the texture itself, from where colors should be sampled. Example: ttr -200 200 0 200 200 0 0 0 200 textures/obama.png 0 0 1750 0 875 1500. Reflectiveness argument is also optional.
• lo - load another scene. An example would be lo 200 0 0 scenes/pyramid.scene. This tells the parser, to load scene scenes/pyramid.scene and move it 200 units in x direction and 0 units in y and z directions. The three numbers can be float numbers as well.
• ls - Add a light source. The following three floats tell its position, and the fourth float tells its brightness. Example: ls 300 500 20 1
• sky - Add a skydome. The only argument is the path to the file
• # - Indicates a comment. Any line that does not have a valid command in the beginning will be ignored, but I recommend you still use # as comments.