A simple ray tracer built as part of the 42 School curriculum. miniRT renders 3D scenes using basic ray tracing techniques, handling spheres, planes, cylinders, lights, and camera perspective.
This project is written in C and uses the minilibx graphics library provided by 42.
- Ray-object intersection (spheres, planes, cylinders)
- Phong lighting (ambient, diffuse, specular)
- Shadows
- Basic camera and viewport system
- BMP screenshot saving
- Real-time rendering window with MiniLibX
gccmake- MiniLibX (provided by 42)
Linux
git clone https://github.com/tasmanday/minirt.git
cd minirt
make./miniRT scenario_file.rtThere are a number od test scenarios in the eval_scenarios directory or you can make your own.
.rt files describe the scene to render. Here's a simple example:
A 0.2 255,255,255
C -50,0,20 0,0,1 70
L -40,0,30 0.6 255,255,255
sp 0,0,20 20 255,0,0
Identifiers
| Symbol | Meaning | Notes |
|---|---|---|
A |
Ambient light | Ratio and RGB color |
C |
Camera | Position, direction, FOV |
L |
Light | Position, brightness, RGB color |
sp |
Sphere | Position, diameter, RGB color |
pl |
Plane | Position, normal vector, RGB color |
cy |
Cylinder | Position, orientation, diameter, height, RGB color |
Each line starts with an identifier followed by parameters like position, color, brightness, etc.
- Ray Casting: For the four corners of each pixel, a ray is shot into the scene.
- Intersection Tests: The ray is checked against all scene objects.
- Shadows: Casts rays to light sources to check for obstructions.
- Lighting: Calculates color using the Phong model.
- Anti-aliasing: Corner ray colours are averaged for each pixel allowing anti-alliasing with only one extra column and one extra row of rays needing to be processed.
- Rendering: Pixels are colored and displayed using MiniLibX.
C
open, close, read, write, printf, malloc, free, perror, strerror, exit
All functions of the math library (-lm man man 3 math)
MinilibX