Update book 1 from Nate's progression + changes

hollasch · hollasch · commit ea3754ca2f33 · 2024-03-28T14:09:25.000-07:00
diff --git a/books/RayTracingInOneWeekend.html b/books/RayTracingInOneWeekend.html
@@ -66,6 +66,9 @@
 Graphics_ by Steve Marschner and Peter Shirley, or _Computer Graphics: Principles and Practice_
 by J.D. Foley and Andy Van Dam.
 
+See the [project README][readme] file for information about this project, the repository on GitHub,
+directory structure, building & running, and how to make or reference corrections and contributions.
+
 See [our Further Reading wiki page][wiki-further] for additional project related resources.
 
 These books have been formatted to print well directly from your browser. We also include PDFs of
@@ -191,6 +194,8 @@
     build/inOneWeekend > image.ppm
     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
+Complete building and running instructions can be found in the [project README][readme].
+
 Opening the output file (in `ToyViewer` on my Mac, but try it in your favorite image viewer and
 Google “ppm viewer” if your viewer doesn’t support it) shows this result:
 
@@ -2868,7 +2873,7 @@
     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     [Listing [lambertian-initial]: <kbd>[material.h]</kbd> The new lambertian material class]
 
-Note the third option that we could scatter with some fixed probability $p$ and have attenuation be
+Note the third option: we could scatter with some fixed probability $p$ and have attenuation be
 $\mathit{albedo}/p$. Your choice.
 
 If you read the code above carefully, you'll notice a small chance of mischief. If the random unit
@@ -4066,10 +4071,8 @@
         }
 
         ray get_ray(int i, int j) const {
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ C++ highlight
             // Construct a camera ray originating from the defocus disk and directed at a randomly
             // sampled point around the pixel location i, j.
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ C++
 
             auto offset = sample_square();
             auto pixel_sample = pixel00_loc
@@ -4126,7 +4129,7 @@
 
 
     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ C++ highlight
-        cam.defocus_angle = 10;
+        cam.defocus_angle = 10.0;
         cam.focus_dist    = 3.4;
     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ C++
 
@@ -4376,6 +4379,7 @@
 
 [discussions]:        https://github.com/RayTracing/raytracing.github.io/discussions/
 [gfx-codex]:          https://graphicscodex.com/
+[readme]:             ../README.md
 [releases]:           https://github.com/RayTracing/raytracing.github.io/releases/
 [repo]:               https://github.com/RayTracing/raytracing.github.io/
 [square-pixels]:      https://www.researchgate.net/publication/244986797
diff --git a/books/RayTracingTheNextWeek.html b/books/RayTracingTheNextWeek.html
@@ -31,6 +31,9 @@
 you want a weekend project. Order is not very important for the concepts presented in this book, and
 without BVH and Perlin texture you will still get a Cornell Box!
 
+See the [project README][readme] file for information about this project, the repository on GitHub,
+directory structure, building & running, and how to make or reference corrections and contributions.
+
 These books have been formatted to print well directly from your browser. We also include PDFs of
 each book [with each release][releases], in the "Assets" section.
 
@@ -4378,6 +4381,7 @@
 [Trevor David Black]: https://github.com/trevordblack
 
 [stb_image]:          https://github.com/nothings/stb
+[readme]:             ../README.md
 [releases]:           https://github.com/RayTracing/raytracing.github.io/releases/
 [wiki-further]:       https://github.com/RayTracing/raytracing.github.io/wiki/Further-Readings
 
diff --git a/books/RayTracingTheRestOfYourLife.html b/books/RayTracingTheRestOfYourLife.html
@@ -39,6 +39,9 @@
 
 I hope that you find the math as fascinating as I do.
 
+See the [project README][readme] file for information about this project, the repository on GitHub,
+directory structure, building & running, and how to make or reference corrections and contributions.
+
 As before, see [our Further Reading wiki page][wiki-further] for additional project related
 resources.
 
@@ -3872,6 +3875,7 @@
 [Steve Hollasch]:     https://github.com/hollasch
 [Trevor David Black]: https://github.com/trevordblack
 
+[readme]:             ../README.md
 [releases]:           https://github.com/RayTracing/raytracing.github.io/releases/
 [wiki-further]:       https://github.com/RayTracing/raytracing.github.io/wiki/Further-Readings
 
