cli3dviewer

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.