rtx

A ray tracing sandbox written in Rust, compiled to SPIR-V shaders using rust-gpu. The ray tracing logic runs entirely on the GPU as a compute shader.

Crates

• host - The host application that sets up the GPU, manages buffers, and displays the rendered image.
• shader - The GPU shader entry point compiled to SPIR-V via rust-gpu.
• shared - Types shared between host and shader (e.g., push constants).
• rtx-prim - Primitive types: Array, List, Ray, HitRecord, Interval, etc.
• rtx-obj - Scene objects that can be hit by rays (e.g., Sphere).
• rtx-mat - Materials (Lambertian, Metal, Dielectric) and the material dispatch table.
• rtx-tex - Textures (solid colors, checkerboard) and the texture table.
• rtx-util - Utilities including the camera and random number generation.

Commands

live - Interactive rendering

Open a window and render a scene in real-time with interactive camera controls.

cargo run --release -- live --scene cornell_box_fs

Available scenes: cornell_box_fs, quads_fs, metal_test_fs, dielectric_test_fs, two_spheres_fs, three_spheres_fs, many_spheres_fs

Controls:

• WASD - Move horizontally (forward/back/strafe)
• Space/C - Move up/down
• Mouse - Look around
• Q/Escape - Quit

test - Render all scenes

Render all scenes to a 4x4 grid image saved to renders/render.png.

cargo run --release -- test

bench - Performance benchmarking

Run benchmarks with an animated camera path. Results are saved to bench/results/<git-sha>/<timestamp>-<name>.jsonl.

Run a specific benchmark:

cargo run --release -- bench two_spheres

Run all benchmarks in the bench/configs/ directory:

cargo run --release -- bench

Benchmark definitions are TOML files in bench/configs/. See docs/tasks/benchmarking.md for details on the format and output.

Testing

cargo test