https://github.com/andrewgazelka/cpp-raytracer

👁 A ray-tracer for UMN 5607
https://github.com/andrewgazelka/cpp-raytracer

cpp17 raytracing spheres triangles

Last synced: about 2 months ago
JSON representation

👁 A ray-tracer for UMN 5607

• Host: GitHub
• URL: https://github.com/andrewgazelka/cpp-raytracer
• Owner: andrewgazelka
• Created: 2021-03-12T22:53:58.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2021-03-30T16:10:27.000Z (about 5 years ago)
• Last Synced: 2025-10-25T10:33:55.534Z (8 months ago)
• Topics: cpp17, raytracing, spheres, triangles
• Language: C
• Homepage:
• Size: 3.37 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# Project 3 Computer Graphics

## Compilation

This project has only been tested on MacOS. It is not guaranteed to work

on other platforms.

- Install `googletest` (`brew install googletest` on MacOS)

- Install `boost`

- Go to project root directory `mkdir build`

- `cd build`

- `cmake ..`

- `make`

## Running

`./project3 {input_file}`

# Features 3B

- Everything in 3A

## Transmissive

Below is a modified version of `outdoor.txt`,

which swaps the materials for each sphere. 

The sphere on the left is reflective and the

sphere on the right is transmissive with an

ior of 1.5

![Transimissive 1](.github/outdoor-mod.png)

The same image with a 1.1 transmission on the right sphere is  

![Transimissive 2](.github/outdoor-mod2.png)

with a 1.01 transmission

![Transimissive 3](.github/outdoor-mod3.png)

and finally with 1.00 transmission

![Transimissive 4](.github/outdoor-mod4.png)

## Reflections

Here is the `outdoor.txt` file with only reflections and no

transmissive term

![Reflection 4](.github/outdoor-refl.png)

Here is `sphere2.txt` unmodified for reference

![Spheres 2](.github/spheres2-main.png)

## Recursion to a bounded depth

Here is spheres 2 with recursion to a bounded depth of 2 

(which was the default)

![Spheres 2](.github/spheres2-main.png)

The same with a bounded depth of 1 is

![Spheres 2 b](.github/spheres2-b1.png)

We can see that the red sphere on the right of the yellow sphere is more illuminated

with a bounded depth of 2 than 1.

and with a bounded depth of 0 is

![Spheres 2 c](.github/spheres2-c.png)

There are no reflections as the depth is limited so no can occur.

## Triangles

Here is `outdoor.txt` with only one triangle

![Tri](.github/outdoor-tri.png)

## Planes

Here is `outdoor.txt` but with a triangle replaced with a plane

![Tri](.github/outdoor-plane.png)

Here it `outdoor.txt` but with one vertex in the plane shifted up a bit.

![Tri](.github/outdoor-plane2.png)

## Boxes

A modified version of `outdoor.txt` with a box

![Box](.github/outdoor-box.png)

# Features 3A

## Sample Scene 1

We start with 50 samples per pixel on the file [spheres1.txt](.github/spheres1.txt)



![Sample Scene 1](.github/spheres1.png)



## Scene Setup

### Camera Placement



[The viewpoint is adjusted slightly](.github/spheres1-vp.txt)

```text

camera_pos: -6 3 -2

```

![Sample Scene 1](.github/spheres1-vp.png)



### Film Resolution (and Aspect Ratio)



![Sample Scene 2](.github/spheres1-res.png)



### Background Colors



![Sample Scene 4](.github/spheres1-bg.png)



### PNG Output

- This should be clear

## Primitive

### Spheres

- This should be clear

## Lighting

### Ambient Lights

- This should be apparent by the default image

### Point light sources

- This should be apparent by the default image

### Multiple light sources



![Sample Scene 4](.github/spheres2-main.png)



### Shadows

- This should be apparent by the default image

## Sampling 

- I added a custom command `samples: {#}` to determine the number of samples

- The first sample is always at the center of the pixels

- The rest are randomly distributed between the pixel boundary

- This makes 1 sample equivalent to basic sampling and `n > 1` samples equivalent to

jittered sampling

  

### Basic Sampling

- results in jagged edges



![Sample Scene 5](.github/spheres-samples1.png)



### Sampling with `n=100`

- smoother result like box-filtering.



![Sample Scene 6](.github/spheres-samples100.png)



## Materials

### Color & Specularity

- This should be apparent by the default image

# Implementation

The code is implemented in C++. Some interesting features

## General

- I really like immutable data, so I made a macro `#define let const auto`

- There are no switch statements for strings in C++. This is an issue for parsing commands.

To get around this I made an unordered map of string to enum and then used the switch

  statement on the enum.

- I use modern C++ 17 features such as destructuring and default nested struct values

## Ray Tracing

- Most of the logic occurs in `Scene` class

- Collision uses the quadratic formula

- Collision which occurs with a `t-value` less than 0.001 is ignored (to prevent shadow acne)

- For each sample loops over all lights and sees if can reach it (to do this needs to iterate over all spheres)

- Shades with appropriate formulas

## Sampling

- See the `Features/Sampling` section

# Challenges

- The switch statements described in the previous 

# Issues

- So far, I do not see any issues in my code (apart from missing features)

- If there is an issue, feel free to create a GitHub issue.