• Stars
    star
    133
  • Rank 264,083 (Top 6 %)
  • Language
    C
  • License
    MIT License
  • Created over 1 year ago
  • Updated 5 months ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Viewer of 3D models in ASCII without graphic libraries.

3d-ascii-viewer

Viewer of 3D models in ASCII, written in C.

Example usage capture.

Supported formats:

Compile an run the program

You need developer's libraries for ncurses (the libncurses-dev package on Debian).

Compile the program using the make command:

$ make

You can try it passing any of the models in the models folder as an argument:

$ ./3d-ascii-viewer models/fox.obj

For additional options pass the --help option.

$ ./3d-ascii-viewer --help

Color support

With the --color option, the program looks for the companion MTL files (referenced in the main OBJ file) for information about the materials used by the model.

Characters within faces that use a material will be displayed with the diffuse color of said material. Textures are not supported.

Example usage capture.

To use this option, the terminal must support color attributes and must be capable of redefining colors. Also, the number of colors is limited by the maximum number of color pairs supported by ncurses.

Models

ASCII luminescence idea by: a1k0n.net

Note: If you want to add a Public Domain (CC0) or MIT licenced model, you can send it as a Pull Request or open an Issue. Remember to add the proper credits in the list here.

Older version

There is also an older version, written in Haskell.