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

Download history 316/week @ 2024-11-11 116/week @ 2024-11-18 113/week @ 2024-12-02

545 downloads per month

MIT license

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