RayTracer

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #claude-code #codex #cli #developer-tools #react #windows

★ 183 Open GitHub ↗

Ray tracer with phong lighting, reflections, refractions, normal mapping, procedural textures, super sampling, and depth of field.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Ray Tracer!

This is a simple ray tracer developed as a final project for CSC 471 Introduction to Graphics at Cal Poly and later extended in CSC 570.
It currently supports phong lighting, shadows, reflections, refractions, procedural textures, super sampling, and depth of field.
The only objects supported are spheres.

## Basic Ray Tracing
The basic ray tracing model is as follows.
A camera is placed in the world and rays are cast from the camera's position to points on an imaginary image plane.
A ray is used to determine what light would be going towards the camera at that point and direction.
In our case each ray represents a pixel in the output image and the resulting color of the ray determines the color output for the pixel.

## Intersections
Each ray performs an intersection test with all objects in the scene to determine the closest intersection.
The closest intersection is used to determine the resulting color.

[<img src="https://raw.github.com/marczych/RayTracer/master/samples/timeline/intersection_thumb.jpeg" />](https://raw.github.com/marczych/RayTracer/master/samples/timeline/intersection.jpeg)

## Lighting
In addition to objects, lights are positioned in the world to shade the objects.

### Diffuse
Diffuse lighting is determined by computing the intensity of the light at a point on the sphere.
If the angle is close to the normal at that point then the intensity will be increased.
The intensity determines how much of the object's color to contribute.

[<img src="https://raw.github.com/marczych/RayTracer/master/samples/timeline/diffuse_thumb.jpeg" />](https://raw.github.com/marczych/RayTracer/master/samples/timeline/diffuse.jpeg)

### Shadows
Shadows are incorporated into lighting.
To determine if a light source should contribute to the lighting at an intersection point a shadow ray is cast from the intersection point to the light source.
If there is an intersection before the light source then this point is in the shadow of that light source.

[<img src="https://raw.github.com/marczych/RayTracer/master/samples/timeline/shadows_thumb.jpeg" />](https://raw.github.com/marczych/RayTracer/master/samples/timeline/shadows.jpeg)

### Specular
Specular lighting is calculated by computing a reflection ray by reflecting the light vector about the normal at the intersection point.
The view ray is compared to the reflection ray to determine how much specular lighting to contribute.
The more parallel the vectors are the more specular lighting will be added.

[<img src="https://raw.github.com/marczych/RayTracer/master/samples/timeline/specular_thumb.jpeg" />](https://raw.github.com/marczych/RayTracer/master/samples/timeline/specular.jpeg)

## Reflections
Reflections are performed by casting rays originating from the intersection point directed along the reflection vector.
A portion of the reflected ray's color will be contributed to the original intersection point based on how reflective the surface is.
Fortunately this is fairly easy given the a recursive approach for casting rays.
There is an arbitrary limit on how many reflections a ray can perform before stopping to improve performance and eliminate potential infinite loops.

[<img src="https://raw.github.com/marczych/RayTracer/master/samples/timeline/reflections_thumb.jpeg" />](https://raw.github.com/marczych/RayTracer/master/samples/timeline/reflections.jpeg)

## Refractions
Refractions occur when rays intersect refractive spheres.
The light at the intersection point is determined by blending the reflected and refracted light at that point.
A reflective ray is cast in the same way as described in the previous section.
The refractive ray is calculated by bending the original ray based on the angle of incidence and the indices of refraction of the two materials.
The amount of reflective and refractive light at the point is determined by the Fresnel equation.

[<img src="https://raw.github.com/marczych/RayTracer/master/samples/refraction_2_1_thumb.jpg" />](https://raw.github.com/marczych/RayTracer/master/samples/refraction_2_1.jpg)

## Procedural Textures and Normal Mapping
Procedural textures are a simple way to texture geometry without generating any texture files by hand.
They can be used to simulate lots of different materials such as wood, marble, granite, metal, stone, etc.
Procedural textures are typically generated using a noise function such as Perlin noise which produces coherent noise.
Given some coordinates in space the noise function will return a number between -1 and 1.
Noise functions can be used to generate procedural textures by sampling several versions of the function at different resolutions.
The resulting value is used to blend multiple colors together to get the final color.

Perlin noise can also be used to perform normal mapping in which the normals at an intersection point are modified from their original values.
This affects lighting computations so the geometry appears to be deformed from its original state.

[<img src="https://raw.github.com/marczych/RayTracer/master/samples/allMaterials_2_1_thumb.jpg" />](https://raw.github.com/marczych/RayTracer/master/samples/allMaterials_2_1.jpg)

## Super Sampling (Anti-aliasing)
Aliasing is an artifact of images that have sharp, jagged edges.
Super sampling is an anti-aliasing technique to smooth out jagged edges.
My super sampling algorithm works by casting more initial rays and averaging neighboring samples together.
For example, 2x super sampling involves calculating 4 sub points for each pixel.
The following images have 1, 2, and 3 time super sampling, respectively.

[<img src="https://raw.github.com/marczych/RayTracer/master/samples/timeline/superSamplingx1_thumb.jpeg" />](https://raw.github.com/marczych/RayTracer/master/samples/timeline/superSamplingx1.jpeg)
[<img src="https://raw.github.com/marczych/RayTracer/master/samples/timeline/superSamplingx2_thumb.jpeg" />](https://raw.github.com/marczych/RayTracer/master/samples/timeline/superSamplingx2.jpeg)
[<img src="https://raw.github.com/marczych/RayTracer/master/samples/timeline/superSamplingx3_thumb.jpeg" />](https://raw.github.com/marczych/RayTracer/master/samples/timeline/superSamplingx3.jpeg)

## Depth of Field
Depth of field is simulated by defining a sharp plane where all objects will be in focus.
The idea is that the camera doesn't detect light at a single precise point.
The final image is composed of light coming from slightly different directions because of the size of the camera.
Any ray passing through the same point on the sharp plane will contribute to the same pixel on the image.
Slightly randomizing the originating point from the camera makes objects not on the focus plane to be out of focus.
Casting many randomized rays and averaging their results creates a blurred effect.
If few rays are cast then the resulting image will be grainy and noisy.
The images below were rendered by casting hundreds of rays per pixel to reduce this effect.

[<img src="https://raw.github.com/marczych/RayTracer/master/samples/line_4_300_thumb.jpeg" />](https://raw.github.com/marczych/RayTracer/master/samples/line_4_300.jpeg)
[<img src="https://raw.github.com/marczych/RayTracer/master/samples/lineFar_4_300_thumb.jpeg" />](https://raw.github.com/marczych/RayTracer/master/samples/lineFar_4_300.jpeg)

## Final Renders
__Note:__ Images rendered on a 4-core machine using OpenMP.

[<img src="https://raw.github.com/marczych/RayTracer/master/samples/ballsInAPit_2_60_thumb.jpg" />](https://raw.github.com/marczych/RayTracer/master/samples/ballsInAPit_2_60.jpg)

1,665,574,078 rays in 1121m33.392s (2x super sampling and 60 rays per pixel for depth of field)

[<img src="https://raw.github.com/marczych/RayTracer/master/samples/texturesInYoFace_3_1_thumb.jpg" />](https://raw.github.com/marczych/RayTracer/master/samples/texturesInYoFace_3_1.jpg)

66,818,420 rays in 8m14.464s (3x super sampling)

[<img src="https://raw.github.com/marczych/RayTracer/master/samples/tumbledStones_3_1_thumb.jpg" />](https://raw.github.com/marczych/RayTracer/master/samples/tumbledStones_3_1.jpg)

104,733,878 rays in 11m58.162s (3x super sampling)

[<img src="https://raw.github.com/marczych/RayTracer/master/samples/ballsOnAPlaneClose_3_1_thumb.jpeg" />](https://raw.github.com/marczych/RayTracer/master/samples/ballsOnAPlaneClose_3_1.jpeg)
[<img src="https://raw.github.com/marczych/RayTracer/master/samples/ballsOnAPlane_2_50_thumb.jpeg" />](https://raw.github.com/marczych/RayTracer/master/samples/ballsOnAPlane_2_50.jpeg)
[<img src="https://raw.github.com/marczych/RayTracer/master/samples/triangleSpheres_4_300_thumb.jpeg" />](https://raw.github.com/marczych/RayTracer/master/samples/triangleSpheres_4_300.jpeg)

RayTracer

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README