Skip to content

Commit aee85c7

Browse files
committed
Final changelog update for v3.2.0
1 parent b64cfd8 commit aee85c7

File tree

1 file changed

+35
-0
lines changed

1 file changed

+35
-0
lines changed

Diff for: CHANGELOG.md

+35
Original file line numberDiff line numberDiff line change
@@ -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

Comments
 (0)