@@ -3,6 +3,41 @@ Change Log -- Ray Tracing in One Weekend
33
44# v3.2.0 (2020-07-18)
55
6+ We're still chasing that elusive stable project state where we're mostly done with large changes,
7+ yet we keep finding more and more to tweak and improve. Besides the usual batch of corrections and
8+ small improvements, for this change we plodded through the complete code progression for both books
9+ one and two (_ In One Weekend_ and _ The Next Week_ ). This caught a _ lot_ of issues (to our dismay),
10+ and allowed us to generate a complete set of new render images for both books, to catch up with all
11+ of the changes we've been making. The end result is that readers should find a significantly better
12+ agreement between the book and their code as they progress, and their renders should also generally
13+ match.
14+
15+ Besides the new rendered images, we also much improved the image parameters, which were frequently
16+ missing from the previous version, leaving readers to guess at their values, or go to the code to
17+ try to figure out how we created some of the images. In general, our working renders are now 400
18+ pixels wide, usually 16:9 aspect ratio. We now use an explicit aspect ratio and deduce the image
19+ height and other camera values, so you can tweak your render size just by changing the image width
20+ (instead of updating a bunch of dependent parameters).
21+
22+ One interesting late change we made was adding explicit C++ ` override ` labels to subclass methods.
23+ We did this mostly to aid code readers, but were surprised to find that it actually caught a pretty
24+ significant bug hiding in our code (see entry in common changes below).
25+
26+ You'll also see a new citation section at the end of the books, to encourage uniform citations out
27+ in the world, making it easier for people to refer to and track these books.
28+
29+ As is typical, though we roughly follow [ semantic versioning] ( https://semver.org/ ) , we're
30+ considering this release a minor change instead of a major one. It's a common reflex, because people
31+ generally have a (misguided) aversion to bumping the major version a lot. We consider it minor
32+ because most of the changes are quite local, some classes get new constructors and any variances
33+ should be quite simple and easy to fix up. Still, one might consider this more properly a major
34+ version bump.
35+
36+ For our next larger-than-patch release, we're beginning a large revisit of book 3,
37+ _ Ray Tracing: The Rest of Your Life_ . There's a lot of work to do, and this will likely be a
38+ significant change and improvement. We're hoping that changes to books one and two will be small,
39+ but that's never worked out for us before. Ah, dreams.
40+
641### Common
742 - Bug: Found a bug in book 3 source ` isotropic::scatter() ` method. Commented out, using default
843 (as it was previously). (#669 )
0 commit comments