{"repo":"leonmavr/retrovoxel","free":true,"listed":false,"github":"https://github.com/leonmavr/retrovoxel","clone":"git clone https://github.com/leonmavr/retrovoxel.git","description":"📺👽 3D voxel graphics engine on the terminal in standard C without third parties","language":"C","stars":103,"topics":["ascii","c","graphics","raytracing","terminal","3d-graphics","linux","nix","terminal-graphics","ascii-graphics"],"license":"AGPL-3.0","category":"cli-tools","readme_excerpt":":black large square: retrocube :white large square: --- Render 3D meshes in ASCII on the command line. It runs on the standard C library. 1. This implementation In human language, the graphics are rendered more or less by the following algorithm: 2. Requirements Currenctly there is no Windows support. You only need gcc and make: 1. gcc 2. make 3. Development and installation 3.1 Development 3.1.1 Compiling the project The naming convention follows the one of stb. Source files are found in src and headers in include . When compiling the from project from a clean state, you need to specify where the mesh files (those that specify how shapes are rendereed) shall be stored. You can do this by setting the PREFIX variable to your directory of choice, e.g.: You can run the binary with (a list of command line arguments is provided in the next section): You can delete the binary and object files with: 3.1.2 Compiling the demos Several demos that showcase various usages of the libraries are found in the demos directory. These are compiled independently from their own file. To compile them you need to set the PREFIX once again: 3.2 General installation The Makefile includes an installation command. The binary will be installed at /usr/bin/cube as: Similarly, you can uninstall it from /usr/bin as: 3.3 Installation as Nix package On Nix (with flakes enabled) you don't need to install it and you can directly run it with: Credits for the Nix packaging @pmarreck and @Quantenzitrone. 4. Usage","default_branch":null,"files":null,"tree":[],"storefront":"/r/leonmavr","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/leonmavr/retrovoxel/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}