miniRT

42Paris School Project

About the Project

miniRT is a ray tracing program written in C using the MiniLibX library. It renders basic 3D scenes by simulating how light interacts with geometric objects. Created for 42Paris, this project builds on your knowledge of C programming, mathematical transformations, and real-time rendering techniques.

Features

• Parse and render scene descriptions from “.rt” files
• Supports basic geometric shapes: Plane, Sphere, Cylinder
• Ambient and diffuse lighting, plus hard shadows
• Rotations and translations of shapes, lights, and cameras
• Window event handling (close by pressing ESC or clicking the red cross)

Technical Details

• Language: C
• Libraries: MiniLibX, libft, math library (compile with -lm)
• Raytracing: Compute intersections, apply transformations, manage shadows, etc.

Getting Started

Prerequisites

• GCC or any C compiler
• GNU Make
• MiniLibX (included in the repo under Libs/)

Installation

1. Clone the repository:

   git clone https://github.com/Agrippa2023/miniRT.git
   cd miniRT

2. Build the project:

   make

Usage

Run the program by specifying a valid “.rt” scene file:

./miniRT path/to/scene.rt

Some sample scene files are located in the Scene_files/ directory. Each file describes a 3D scene with objects, lights, and camera settings. Simply pass a valid “.rt” file to miniRT at launch.

./miniRT Scene_files/img17.rt

Project Structure

• Srcs/: Source code (grouped by modules like Camera, Shapes, Ray, parser, etc.)
• Includes/: Header files
• Libs/: External libraries (libft, minilibx-linux)
• Scene_files: Sample scene files (*.rt)
• images/: Examples of 3D scenes generated with miniRT
• textures/: Additional texture assets
• Makefile/: Build script

Screenshots

Examples

Colored Lights

Textured Scenes

Acknowledgements

Developed at 42Paris. Special thanks to the 42 community for its resources and everyone who contributed helpful references.

License

Distributed under the MIT License. See LICENSE for more information.

Connect with Me