clementlrd/ray-tracer

Ray-Tracer

The Ray-tracer is a project for ENSTA Course IN204 developped by Clément Laroudie and Antoine Domingues. It will continue to be improved even after the final presentation.

Project description

Our Rendering Engine is able to render a scene composed of various 3D objects that can have a range of materials and colours.

The project exports the image to a .ppm file initially, for simplicity.

Requirement

• The ray-tracer generates images in ppm format. If you do not have applications that can read this file format, you can use an online viewer/converter. We have chosen to use the application for linux ImageMagick (also available for Windows) for its simplicity of use.
• The project has been built with CMake.

Create project

You can simply use the make command to build the project and run the ray-tracer with the default configuration. Other Makefile commands are available for simplicity:

• all: Build the project, run the programme and convert image to png.
• init: Clean folders and build the project
• start: Starts the program with the default settings
• build: Initialise cmake and build the project

You can convert the programme result in a format supported by ImageMagick with the following command : make png (Exemple pour le format png)

If you want to start the project manually, type the following command :

build/ray-tracer apps/config.json

Configuration

Rendering can be configured from Json files :

• A config.json file for the rendering parameters.
• A scene.json file that represents the scene.

Only the config.json file may be passed to the program as a parameter.

Details of the parameters are detailled here.

Development

We use the clang-format formatter.

Editor must be configured to work with cmake. (with >CMake: Configure for VSCode with the CMake tools extension).

Project has been configured to be developped using clangd or intellisense linter.

ray-tracer's Issues

Support for filters

• antialiasing
• gamma

[Makefile] Windows support

[README] Document json configuration

• configs
• scene

Background

• Daylight
• Night
• Dark

[Filters] Support custom kernels

Gamma filter

make gamma filter for all values

Fake shadows

[Objects] Add mode for easy positioning

Add json parameter "mode: "
make the calculation in constructor

• corner

  • plane
  • cuboid

• center

  • plane
  • cuboid

• Disallow corner mode for sphere

Camera

change screesize to int

[Json] Object Generator

• Object range generator
  Generate object from json macro. (min, max, type, step ?)
  need an extra loop when generating the scene.
• random value generator (in a range)

Multithreading

Mettre en place du multithreading pour le lancé de rayons pour le rendre plus rapide / efficace.

Change random distribution to speed up

[Json] Config support for objects

• cuboid
• objects
• metal

Wrong sphere intersection

Fix cuboid rendering

Le rendu du cuboid fait des faces noires lorsqu'il est rendu avec un angle incident.

[Speed Up] Try improving multithread by using only one for loop

• Use k = i * width + j in order to have only one for loop.
• Use k' = (i * width + j) * spp to parallelize antialiasing

[Objects] Add cylinder

• Cylinder is defined by a surface with boudaries and a direction
  • An update in surface abstract class may be required

Args

Permettre l'ajout d'arguments au programme, notamment pour les arguments de debug et les noms de fichiers

[Filters] Create filter for kernels

• create a more generic filter class Kernel (Gaussian filter is just a Kernel filter with a gaussian kernel)
• support more kernels
• #29

Camera

• orientable : utiliser un vecteur normal
• pivoter l'écran pas uniquement autour de la verticale
• Utiliser la distance focale !
• focus blur ?

Bug scanline display

Le multithreading a introduit un bug d'affichage graphique. Il peut être bien de revoir au passage la manière dont on note la progression

[Material] Fix Dielectric

[surface/object] Add triangle, circle

[Makefile] Fix bugs

• Fix make png when cleaning render folder before
  When cleaning render folder before generating image, the $(IMG) variable seems to keep the value with no images.ppm

• Fixer les prérequis qui se rechargent alors qu'ils existent déjà

[Makefile] Windows support

Ecriture dans un fichier

Faire en sorte que l'écriture dans les fichiers se fasse directement.
Nécessite #2

Implémenter Métal (matériau)

Implémenter la texture métallique

Support for Config

• camera
• filters (needed for #8 )
• render details