Skip to content

README.md

Latest commit

 

History

History
31 lines (24 loc) · 788 Bytes

README.md

File metadata and controls

31 lines (24 loc) · 788 Bytes

cli3dviewer

Example render

Minimal terminal 3D OBJ viewer with textured, shaded ASCII output.

Features

  • OBJ loading with optional UVs
  • Textured shading using 256-color terminal palette
  • Real-time rotation and zoom
  • Auto-resize to terminal window
  • Debug image dump to out.png

Usage

cargo run -- path/to/model.obj --scale 1.0

The viewer looks for a texture named shaded.png in the same directory as the OBJ file. If it is missing, the program will fail to load the texture.

Controls

  • Left / Right: rotate around Y axis
  • Up / Down: rotate around X axis
  • + / =: zoom in
  • - / _: zoom out
  • q / Esc: quit

Notes

  • Requires a terminal that supports 256 colors.
  • out.png is written on each redraw for debugging.