CIS565-Fall-2017 · AgentLee · Oct 12, 2017 · Oct 12, 2017 · Oct 13, 2017 · Oct 13, 2017
diff --git a/README.md b/README.md
@@ -1,20 +1,92 @@
 CUDA Rasterizer
 ===============
 
-[CLICK ME FOR INSTRUCTION OF THIS PROJECT](./INSTRUCTION.md)
-
 **University of Pennsylvania, CIS 565: GPU Programming and Architecture, Project 4**
 
-* (TODO) YOUR NAME HERE
-* Tested on: (TODO) Windows 22, i7-2222 @ 2.22GHz 22GB, GTX 222 222MB (Moore 2222 Lab)
+* Jonathan Lee
+* Tested on: Tested on: Windows 7, i7-7700 @ 4.2GHz 16GB, GTX 1070 (Personal Machine)
+
+# Overview
+
+In this project, I was able to implement a basic graphics pipeline in CUDA including the *Vertex Shading*, *Primitive Assembly*, *Rasterization*, and *Fragment Shading* stages.
+
+![](renders/milktruck.PNG)
+
+## Features
+* UV Texture Mapping with Bilinear Filtering and Perspective Correct Coordinates
+* Line and Point Rasterization
+* Naive Backface Culling 
+
+## Flags
+* `DRAWLINES`
+* `DRAWPOINTS`
+* `TEXTURE`
+* `BILINEAR`
+* `PERPSECTIVE_CORRECT`
+* `MUTEX`
+
+# Results
+
+## Rasterization Types
+### Duck
+Textured  |  Triangles    |   Lines     | Points
+:-------------------------:|:-------------------------:|:-------------------------:|:-------------------------:
+![](renders/duck_tri.PNG) | ![](renders/duck_diff.PNG) | ![](renders/duck_line.PNG) | ![](renders/duck_point.PNG) | 
+
+### Cesium Milk Truck
+Textured  |  Triangles    |   Lines     | Points
+:-------------------------:|:-------------------------:|:-------------------------:|:-------------------------:
+![](renders/milktruck_diff_texture.png) | ![](renders/milktruck_diff.png) | ![](renders/milktruck_line.png) | ![](renders/milktruck_point.png) | 
+
+## Texturing
+### Perspective Correctness
+
+Perspective correctness accounts for the vertex positions in 3D space rather than interpolating in screen space. This is where most of the overhead comes from in the rasterization step.
+
+Without Perspective Correct Coordinates  | With Perspective Correct Coordinates
+:-------------------------:|:-------------------------:
+![](renders/noperspective2.png) | ![](renders/perspective2.png) 
+
 
-### (TODO: Your README)
 
-*DO NOT* leave the README to the last minute! It is a crucial part of the
-project, and we will not be able to grade you without a good README.
+### Flickering
 
+Having a lock for dealing with each specific pixel is fairly important. This prevents the flickering seen in the left gif. This is caused when two threads are working on the same pixel. 
+
+Without Locking  | With Locking
+:-------------------------:|:-------------------------:
+![](renders/(no)mutex.gif) | ![](renders/mutex.gif) 
+
+# Analysis
+
+Below is the data from rendering the Cesium Milk Truck model. Overall, the rasterization step takes the most time to process. This makes sense since all of the main computation occurs at this step. 
+
+#### Cesium Milk Truck
+
+Having the mutex lock causes a slight overhead across the texture methods which is well worth the overhead. 
+
+![](images/milktruck_pipeline.png)
+
+![](images/pipeline.PNG)
+
+![](images/rasterization_types.png)
+
+![](images/rastertype.PNG)
+
+![](images/line_point.png)
+
+Clearly, there is a huge dropoff between rasterizing triangles and lines and points. There are no calculations needed to rasterize points. To rasterize lines, `_rasterizeLine()` gets called three times to account for the three lines that make up the triangle: P1-P2, P2-P3, P3-P1. Using the slope, we can find the position along the line as we move from point to point.
 
 ### Credits
 
 * [tinygltfloader](https://github.com/syoyo/tinygltfloader) by [@soyoyo](https://github.com/syoyo)
 * [glTF Sample Models](https://github.com/KhronosGroup/glTF/blob/master/sampleModels/README.md)
+
+### References
+* https://www.scratchapixel.com/lessons/3d-basic-rendering/rasterization-practical-implementation/perspective-correct-interpolation-vertex-attributes
+*  https://www.opengl.org/discussion_boards/showthread.php/170651-Is-it-possible-to-get-the-pixel-color
+* https://stackoverflow.com/questions/35005603/get-color-of-the-texture-at-uv-coordinate
+* https://en.wikipedia.org/wiki/Bilinear_filtering
+* http://groups.csail.mit.edu/graphics/classes/6.837/F02/lectures/6.837-7_Line.pdf
+* https://en.wikipedia.org/wiki/Back-face_culling
+
diff --git a/images/chart.png b/images/chart.png
diff --git a/images/line_point.png b/images/line_point.png
diff --git a/images/milktruck_pipeline.png b/images/milktruck_pipeline.png
diff --git a/images/pipeline.PNG b/images/pipeline.PNG
diff --git a/images/rasterization_types.png b/images/rasterization_types.png
diff --git a/images/rastertype.PNG b/images/rastertype.PNG
diff --git a/renders/(no)mutex.gif b/renders/(no)mutex.gif
diff --git a/renders/cow.PNG b/renders/cow.PNG
diff --git a/renders/duck.PNG b/renders/duck.PNG
diff --git a/renders/duck_diff.PNG b/renders/duck_diff.PNG
diff --git a/renders/duck_line.PNG b/renders/duck_line.PNG
diff --git a/renders/duck_point.PNG b/renders/duck_point.PNG
diff --git a/renders/duck_tri.PNG b/renders/duck_tri.PNG
diff --git a/renders/fail1.PNG b/renders/fail1.PNG
diff --git a/renders/frontfaceculling.PNG b/renders/frontfaceculling.PNG
diff --git a/renders/lines.PNG b/renders/lines.PNG
diff --git a/renders/milk.PNG b/renders/milk.PNG
diff --git a/renders/milk2.PNG b/renders/milk2.PNG
diff --git a/renders/milktruck.PNG b/renders/milktruck.PNG
diff --git a/renders/milktruck_diff.png b/renders/milktruck_diff.png
diff --git a/renders/milktruck_diff_texture.png b/renders/milktruck_diff_texture.png
diff --git a/renders/milktruck_diffuse.PNG b/renders/milktruck_diffuse.PNG
diff --git a/renders/milktruck_line.png b/renders/milktruck_line.png
diff --git a/renders/milktruck_lines.PNG b/renders/milktruck_lines.PNG
diff --git a/renders/milktruck_point.png b/renders/milktruck_point.png
diff --git a/renders/milktruck_points.PNG b/renders/milktruck_points.PNG
diff --git a/renders/milktruck_texture.PNG b/renders/milktruck_texture.PNG
diff --git a/renders/mutex.gif b/renders/mutex.gif
diff --git a/renders/nobilinear.gif b/renders/nobilinear.gif
diff --git a/renders/noperspective.PNG b/renders/noperspective.PNG
diff --git a/renders/noperspective2.png b/renders/noperspective2.png
diff --git a/renders/perspective.PNG b/renders/perspective.PNG
diff --git a/renders/perspective2.png b/renders/perspective2.png
diff --git a/renders/uvindex.PNG b/renders/uvindex.PNG