Raytracer

Your CPU goes brrrrr!

Description

This repository contains the source code for the Raytracer project at Epitech, a 3D rendering software that simulates the path of light to generate realistic images. It utilizes advanced rendering techniques such as ray tracing, material modeling, shadows, reflections, and refractions to produce high-quality renders.

Table of Contents

• Description
• Usage
• Features
  • Mandatory Features
  • Should Features
  • Could Features
• Scene File Format
  • Camera Parameters
  • Primitives Parameters
  • Lights Parameters
  • Materials Parameters
• Tools
• Development Team

Usage

./raytracer <SCENE_FILE>

SCENE_FILE: scene configuration

Mandatory Features

• Primitives:
  • Sphere
  • Plane
• Transformations:
  • Translation
• Light:
  • Directional light
  • Ambient light
• Material:
  • Flat color
• Scene configuration:
  • Add primitives to scene
  • Set up lighting
  • Set up camera
• Interface:
  • No GUI, output to a PPM file

Should Features

Once the previous features are working properly, you should add the following ones:

• Primitives:
  • Cylinder
  • Cone
• Transformation:
  • Rotation
• Light:
  • Drop shadows

Could Features

• Primitives:
  • Limited cylinder
  • Limited cone
  • Torus
  • Tanglecube
  • Triangles
  • .OBJ file
  • Fractals
  • Möbius strip
• Transformations:
  • Scale
  • Shear
  • Transformation matrix
  • Scene graph
• Light:
  • Multiple directional lights
  • Multiple point lights
  • Colored light
  • Phong reflection model
  • Ambient occlusion
• Material:
  • Transparency
  • Refraction
  • Reflection
  • Texturing from file
  • Texturing from procedural generation of chessboard
  • Texturing from procedural generation of Perlin noise
  • Normal mapping
• Scene configuration:
  • Import a scene in a scene
  • Set up antialiasing through supersampling
  • Set up antialiasing through adaptative supersampling
• Optimizations:
  • Space partitionning
  • Multithreading
  • Clustering (3)
• Interface:
  • Display the image during and after generation
  • Exit during or after generation
  • Scene preview using a basic and fast renderer
  • Automatic reload of the scene at file change

Scene File Format

Scene file is a simple text file containing the configuration of the scene. It is divided into four sections: camera, primitives, lights, and materials.

In each section, you can define multiple elements. For example, you can define multiple spheres in the primitives section.

Some parameters are mandatory, while others are optional. The mandatory parameters are required for the program to work correctly. The optional parameters are used to customize the scene further.

Camera Parameters

• fieldOfView: Field of view of the camera
• resolution_width: Width of the image
• resolution_height: Height of the image
• position_x: X position of the camera
• position_y: Y position of the camera
• position_z: Z position of the camera
• rotation_x: X rotation of the camera
• rotation_y: Y rotation of the camera
• rotation_z: Z rotation of the camera Exemple:

camera :
{
    cameras = (
        { fieldOfView = 72.0; resolution_width = 1920; resolution_height = 1080; position_x = 0; position_y = -100; position_z = 20; rotation_x = 0; rotation_y = 0; rotation_z = 0; }
    );
};

Primitives Parameters

Depending on the type of primitive, the parameters will change. Here some examples:

• Sphere:
  • x: X position of the sphere
  • y: Y position of the sphere
  • z: Z position of the sphere
  • r: Radius of the sphere
  • color_r: Red color of the sphere
  • color_g: Green color of the sphere
  • color_b: Blue color of the sphere
• Plane:
  • axis: Axis of the plane (X, Y, Z)
  • position: Position of the plane
  • color_r: Red color of the plane
  • color_g: Green color of the plane
  • color_b: Blue color of the plane

Exemple:

primitives :
{
    spheres = (
        { x = 60; y = 5; z = 40; r = 25; color_r = 255; color_g = 64; color_b = 64; },
        { x = -40; y = 20; z = -10; r = 35; color_r = 64; color_g = 255; color_b = 64; }
    );

    planes = (
        { axis = "Z"; position = -20; color_r = 64; color_g = 64; color_b = 255; }
    );
};

Lights Parameters

• ambient: Ambient light intensity
• diffuse: Diffuse light intensity
• point_x: X position of the point light
• point_y: Y position of the point light
• point_z: Z position of the point light

Exemple:

lights :
{
    lights = (
        { ambient = 0.4; diffuse = 0.6; point_x = 400; point_y = 100; point_z = 500; }
    );
    directional = () ;
};

Materials Parameters

• name: Name of the material
• ambient: Ambient light intensity of the material
• diffuse: Diffuse light intensity of the material
• specular: Specular light intensity of the material
• shininess: Shininess of the material
• reflection: Reflection intensity of the material
• refraction: Refraction intensity of the material
• transparency: Transparency intensity of the material Exemple:

materials :
{
    materials = (
        { name = "default"; ambient = 0.1; diffuse = 0.9; specular = 0.9; shininess = 100; },
        { name = "mirror"; ambient = 0.1; diffuse = 0.1; specular = 0.9; shininess = 100; reflection = 0.9; }
    );
};

Tools

• Language: C++
• Libraries: libconfig++
• Build: CMake
• Version Control: Git
• Continuous Integration: GitHub Actions

Development Team

• Sebastien BERTIL-SOUCHET (@Sebabacou)
• Ewen EMERAUD (@ewen1507)
• Alexis BOITEL (@DiaboloAB)
• Jules DANET (@fry56)