Skip to content

MARKDOWN SOURCE

Raw
# Project instructions: ray-tracer

Build a compact Rust ray-tracing/rendering showcase using wgpu, with a clear rendering pipeline and PNG output. Keep the core math and scene logic testable and make the GPU adapter/device failure mode understandable.

## Rules for this project

- This project is independent: keep all source, tests, assets, and configuration inside `projects/ray-tracer`. Do not import or copy code from another showcase.
- Use Rust `1.98.1`, pinned in this directory's `mise.toml`.
- Manage toolchains and external build tools with `mise.toml`. Pin every Rust crate to an exact version (`=x.y.z`) in `Cargo.toml`, commit `Cargo.lock`, and use locked Cargo commands. Mise does not replace Cargo's crate manifest/lockfile.
- Provide `mise run install` and `mise run run` tasks. Add a check task and run Clippy with `all` and `pedantic` enabled; fix warnings rather than suppressing them broadly.
- Do not assume globally installed helper binaries or shell out to another renderer. Pin all required tools through mise and write PNG output from the application.
- Include deterministic tests for geometry/sampling, a small example scene, and a README with rendering and GPU requirements. If practical, support a documented software/fallback adapter.

Project instructions: ray-tracer

Build a compact Rust ray-tracing/rendering showcase using wgpu, with a clear rendering pipeline and PNG output. Keep the core math and scene logic testable and make the GPU adapter/device failure mode understandable.

Rules for this project

  • This project is independent: keep all source, tests, assets, and configuration inside projects/ray-tracer. Do not import or copy code from another showcase.
  • Use Rust 1.98.1, pinned in this directory's mise.toml.
  • Manage toolchains and external build tools with mise.toml. Pin every Rust crate to an exact version (=x.y.z) in Cargo.toml, commit Cargo.lock, and use locked Cargo commands. Mise does not replace Cargo's crate manifest/lockfile.
  • Provide mise run install and mise run run tasks. Add a check task and run Clippy with all and pedantic enabled; fix warnings rather than suppressing them broadly.
  • Do not assume globally installed helper binaries or shell out to another renderer. Pin all required tools through mise and write PNG output from the application.
  • Include deterministic tests for geometry/sampling, a small example scene, and a README with rendering and GPU requirements. If practical, support a documented software/fallback adapter.