rust-sloth icon indicating copy to clipboard operation
rust-sloth copied to clipboard

A 3D software rasterizer... for the terminal!

sloth - A one-of-a-kind Rust 3D Renderer for the CLI

pikachu

A one-of-a-kind command line 3D software rasterizer made with termion, tobj, and nalgebra. Currently it supports OBJ file formats without textures. It also supports OBJ file formats with vertex colors.

Javascript Export Demonstration

Getting Started / Uses


Here's a few really simple commands for you to get started.

You can replace sloth <args> with cargo run --release -- <args> anywhere

Render pikachu

sloth models/Pikachu.obj

For multiple models:

sloth "models/suzy.obj models/suzy.obj"

You can also generate a static image:

sloth models/Pikachu.obj image -w <width_in_pixels> -h <height_in_pixels>

You can also generate a portable Javascript render like this:

sloth models/Pikachu.obj image -j <number_of_frames> -w <width_in_pixels> -h <height_in_pixels> > src-webify/data.js

Thank you, contributors!

Maxgy – Rustfmt lint donbright – STL model loading added, Rustfmt lint jonathandturner – Crossterm port