README

Ray Tracing in One Weekend Book Series
====================================================================================================

| ![RT in One Weekend][cover1] | ![RT The Next Week][cover2] | ![RT The Rest of Your Life][cover3] |
|:----------------------------:|:---------------------------:|:-----------------------------------:|
|   [In One Weekend][book1]    |   [The Next Week][book2]    |   [The Rest of Your Life][book3]    |


Getting the Books
------------------
The _Ray Tracing in One Weekend_ series of books are now available to the public for free directly
from the web.

 Version 4.0.1

  - [Ray Tracing in One Weekend][web1]
  - [Ray Tracing: The Next Week][web2]
  - [Ray Tracing: The Rest of Your Life][web3]

These books have been formatted for both screen and print. For more information about printing your
own copies, or on getting PDFs of the books, see [PRINTING.md][] for more information.


Contributing
-------------
If you'd like to contribute a PR _please read our [contribution guidelines][CONTRIBUTING]
first_.


Project Status
---------------
If you'd like to check out the latest updates and watch our progress, we're on the dev-patch,
dev-minor, and dev-major branches. You can also browse our issues and milestones to see what
we're planning.

If you're interested in contributing, email us! You can find our contact info at the head of each
book. Or just start [a new discussion][discussions] or [issue][issues].


GitHub Discussions
------------------
Do you have general questions about raytracing code, issues with your own implmentation, or general
raytracing ideas you'd like to share? Check out our [GitHub discussions][discussions] forum!


Directory Structure
-------------------
The organization of this repository is meant to be simple and self-evident at a glance:

  - books/ --
    This folder contains the three raytracing books (in HTML), and some supporting material.

  - images/ --
    Contains all of the images and figures of the books. Can also be used to compare your
    results.

  - style/ --
    Contains the css for the books and the site.

  - src/ --
    Contains the source.

  - src// --
    Contains the final source code for each book.


Source Code
-----------
 Intent
This repository is not meant to act as its own tutorial. The source is provided so you can compare
your work when progressing through the book. We strongly recommend reading and following along with
the book to understand the source. Ideally, you'll be developing your own implementation as you go,
in order to deeply understand how a raytracer works.

 Downloading The Source Code
The [GitHub home][] for this project contains all source and documentation associated with the _Ray
Tracing in One Weekend_ book series. To clone or download the source code, see the green "Clone or
download" button in the upper right of the project home page.

 Programming Language
This book is written in C++, and uses some modern features of C++11. The language an