https://github.com/spicycactuar/soft-trace

An interactive CPU Ray Tracing application
https://github.com/spicycactuar/soft-trace

computer-graphics cpp cpu-raytracing glm global-illumination opengl qt5

Last synced: 22 days ago
JSON representation

An interactive CPU Ray Tracing application

• Host: GitHub
• URL: https://github.com/spicycactuar/soft-trace
• Owner: SpicyCactuar
• Created: 2024-10-30T01:05:53.000Z (about 2 months ago)
• Default Branch: main
• Last Pushed: 2024-11-30T21:29:52.000Z (23 days ago)
• Last Synced: 2024-11-30T22:35:08.903Z (23 days ago)
• Topics: computer-graphics, cpp, cpu-raytracing, glm, global-illumination, opengl, qt5
• Language: C++
• Homepage:
• Size: 95.7 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Soft Trace

CPU Ray Tracing application exhibiting basic Global Illumination effects.

The application displays a Qt UI with two windows: the left window shows the scene rendered using OpenGL (immediate mode), while the right window displays the equivalent ray-traced scene.

![soft-trace](https://github.com/user-attachments/assets/2e5d981c-8d5d-4b2b-bdb8-c9f5149da0f7)

## Global Illumination effects supported

* Blinn-Phong shading - Affected by standard `.mtl` properties {`Ka`, `Kd`, `Ks`, `Ke`}

* Fresnel - Controlled by custom `.mtl` property `N_ior` (see [Typical values](https://en.wikipedia.org/wiki/Refractive_index#Typical_values))

* Reflections - Controlled by custom `.mtl` property `0 <= N_mirr <= 1`

* Refractions - Controlled by custom `.mtl` property `0 <= N_transp <= 1`

* Shadows - Single shadow ray test

* Area Lights - 20 shadow samples

* Interpolation - Render normal as `[r, g, b] = abs([n.x, n.y, n.z])`

* Orthographic - Renders scene using Orthographic or Perspective camera

## Project Structure

```plaintext

soft-trace/

├── src/                 # Source code

├── assets/              # Static assets (.obj and .mtl files)

├── soft-trace.pro       # QMake project

└── README.md            # Project README

```

## Build

```bash

qmake

make

```

## Run

```bash

bin/soft-trace <.obj> <.mtl>

```

Example:

```shell

bin/soft-trace assets/cornell_box.obj assets/cornell_box.mtl

```

The asset files must be well-formed for the application to work. See `Material.h` for custom .mtl properties used.

Example files are provided.

## Technologies

* **C++**: `>= C++17`

* **Qt**: `5.12.x`

* **OpenGL**: `>= 4.0`

* **OpenMP**: `>= 4.5`

* **GLM**: `1.0.1`

Newer versions of Qt might work correctly, if no breaking changes that affect the application were introduced.