5 releases
0.1.0 | Nov 17, 2024 |
---|---|
0.0.4 | Nov 12, 2024 |
0.0.3 | Nov 11, 2024 |
0.0.2 | Nov 11, 2024 |
0.0.1 | Nov 10, 2024 |
#19 in Visualization
545 downloads per month
38KB
707 lines
Terminal3d
Terminal3d (t3d
) is a tool for viewing 3d .obj
files, right in your terminal! 🦀
Ted the bear - Find this example under examples/ted.obj
Features
- Reads and renders
.obj
files to the terminal. - Render with both braille (
⡟
) and block (▛
) characters. - Choose between wireframe and vertices modes.
- Use mouse controls to view your model, just like any other 3d software.
Installation
Installing Terminal3d can be done via brew, crates.io, or from source.
From brew
To install Terminal3d with brew, install from this tap.
brew install liam-ilan/terminal3d/terminal3d
You will be able to invoke the binary as t3d
. Render a .obj
file with
t3d <filepath.obj>
From crates.io
Terminal3d is published as a crate on crates.io. If you have Cargo, you can install it with
cargo install terminal3d
You will be able to invoke the binary as t3d
. Render a .obj
file with
t3d <filepath.obj>
From Source
If you don't want to install a Rust crate, but do have Rust installed, you can build and run Terminal3d directly from source.
Clone this repository,
git clone https://github.com/liam-ilan/terminal3d.git
To render a .obj
file, navigate to the root of the repo directory, and run
cargo run --release <filepath.obj>
Demos
examples/teapot.obj rendered in block mode |
examples/cow.obj rendered in vertices mode |
UBC Formula Electric's Vehicle Controller, rendered in vertices mode from an export from Altium Designer. This board drives decisions related to inverters, drive algorithms, and LV power management. If you would like to support the team of aspiring engineers behind this board and the vehicle it drives, contact contact@ubcformulaelectric.com for more info. |
Usage
t3d: Visualize .obj files in the terminal!
Usage:
"t3d <filepath.obj>": Interactively view the provided .obj file.
"t3d --h", "t3d --help", "t3d -h", "t3d -help", "t3d": Help and info.
"t3d --v", "t3d --version", "t3d -v", "t3d -version": Get version info.
Controls:
Scroll down to zoom out, scroll up to zoom in.
Click and drag the mouse to rotate around the model.
Click and drag the mouse while holding [shift] to pan.
Press [b] to toggle block mode.
Press [p] to toggle vertices mode.
Obtained from t3d -h
Publishing
Notes for the maintainer on publishing Terminal3d can be found in PUBLISHING.md
.
Author
(c) Liam Ilan
Dependencies
~2–10MB
~125K SLoC