Skip to content

Latest commit

 

History

History
69 lines (56 loc) · 2.79 KB

README.md

File metadata and controls

69 lines (56 loc) · 2.79 KB
Raw

Tiny Renderer

A toy software renderer for learning Computer Graphics written in Rust.

Features

  • Homogeneous clipping
  • Back-face culling
  • Perspective correct interpolation
  • Depth testing
  • Phong shading
  • Orbital camera controls
  • Physicallly-Based-Rendering(Cook-Torrance)

Usage

Tiny renderer is available in Windows, Linux and MacOSX now.

Launch

You can run with cargo.

cargo run --release [shader] [path]
cargo run --release pbr [path] [spp]

shader is the name of fragment shader.

Available shaders:

  • z: Depth shader
  • color: Color shader.
  • texture: Texture mapping shader.
  • phong-color: Color shader with Phong shading.
  • phong-texture: Texture shader with Phong shading.

path is the the path without extension to .gltf/.obj/.mtl and texture image(.jpg/.png) file. It means they should be in same directory. PBR will try to load .gltf and others will try to load .obj.

For example, you can run just like:

cargo run --release color static/cube

It will run the renderer with static/cube.obj.

There are some simple models in static directory.

  • cube
  • cone
  • multi_models
  • earth
  • earth_good
  • spot
  • cornell-box

Don't forget --release flag because of its poor performance.

Controls

  • Rotate camera: W/S/A/D
  • Rotate light: I/K/J/L
  • Zoom camera: ↑/↓

Screenshots

screenshot command
cargo run --release texture static/earth
cargo run --release z static/cube
cargo run --release phong-texture static/spot
cargo run --release pbr static/cornell-box 512
cargo run --release pbr static/silver-mirror 512
cargo run --release pbr static/bunny 512

License

MIT