Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/therustmonk/lustre-rs
Toy RT Renderer
https://github.com/therustmonk/lustre-rs
Last synced: 2 days ago
JSON representation
Toy RT Renderer
- Host: GitHub
- URL: https://github.com/therustmonk/lustre-rs
- Owner: therustmonk
- License: mit
- Created: 2023-01-31T22:57:10.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2023-01-31T01:29:26.000Z (almost 2 years ago)
- Last Synced: 2025-01-02T21:12:36.768Z (6 days ago)
- Homepage:
- Size: 41.1 MB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# lustre-rs: Toy RT Renderer
[](https://github.com/nbarrios1337/lustre-rs/actions/workflows/rust.yml)
Learning Rust via [Peter Shirley's Ray Tracing in One Weekend](https://raytracing.github.io/) Book series and other sources.
## Usage
1. If you don't have Rust installed, take a look at [Rust's Getting Started page](https://www.rust-lang.org/learn/get-started).
2. Clone this repository:
```shell
git clone [email protected]:nbarrios1337/lustre-rs.git
```
3. Build `lustre` by running:
```shell
cargo build --release
```
4. Run `lustre` by specifying a scene to render:
```shell
./target/release/lustre -s cover-photo
```
See `lustre --help` for more options.
## Progress
- [x] Implementing Book 1: [Ray Tracing in One Weekend](https://raytracing.github.io/books/RayTracingInOneWeekend.html) - 100%
- [x] Documenting Book 1 implementation - 100%
- [x] Implementing Book 2: [Ray Tracing: The Next Week](https://raytracing.github.io/books/RayTracingTheNextWeek.html) - 100%
- [x] Documenting Book 2 implementation - 100%
- [ ] Implementing Book 3: [Ray Tracing: The Rest of Your Life](https://raytracing.github.io/books/RayTracingTheRestOfYourLife.html)
- [ ] Documenting Book 3 implementation
- [ ] Look into other ways to expand this renderer. Possibilties:
- Integration with shaders
- Integration with graphics APIs
- Rendering in realtime
- ...
## Additional Sources
- [Peter Shirley's "In One Weekend" Blog](https://in1weekend.blogspot.com/), serving as addendums to his aforementioned book series.
- [Pharr's, Jakob's, and Humphrey's "Physically Based Rendering: From Theory to Implementation"](https://pbr-book.org/): incorporated some of the acceleration structure ideas for the Tree module.
- [Tavian Barnes' blog posts on branchless ray-bbox intersections](https://tavianator.com/2022/ray_box_boundary.html): Used the branchless implementation in the bounding box module. Made those hit checks a lot faster.
- [Inigo Quilez's article on bilinear interpolation](https://iquilezles.org/articles/ibilinear/): Used the shadertoy examples in the Quad module, which is a generic quadrilaterial primitive.
## Examples
Below are some resulting images from lustre:
The Cornell Box, rendered at 2k x 2k with 10k samples per pixel:
A modified (in the dark with lights!) version of the RT in One Weekend cover photo, rendered at 4k with 5k samples per pixel:
A slightly altered version of the final scene from [Book 2 of RT in One Weekend](https://raytracing.github.io/books/RayTracingTheNextWeek.html), rendered at 4k with 10k samples per pixel (this took ~27 hours to render!):
