Tangerine is a system for creating 3D models procedurally from a set of Signed Distance Function (SDF) primitive shapes and combining operators. Models are written in Lua, and may be either rendered directly or exported to a variety of common 3D model file formats.
Tangerine currently supports Windows and Linux:
-
Windows release builds can be downloaded from itch.io.
-
The Linux version must be built from source. Build instructions are at the end of this readme. Optionally, you can use Guix to automate the build process.
When you first run Tangerine, you will be greeted with a screen of static.
Open one of the models in the models directory to see a working example.
These are provided as a programming reference, and for regression testing.
There is also API reference documentation available.
-
Install Racket CS 8.5, and ensure that
racois in your system path variable. This requirement will be removed in the future. -
Install Visual Studio 2022 or newer with at least the C++ stuff.
-
Clone this project somewhere.
-
Open
windows/tangerine.sln, and then rebuild the projecttangerinein either the Debug or Release config. You should now be able to run Tangerine from visual studio for debugging or create your own release builds. -
(Optional) Run
package.batto package Tangerine up into a distributable form in the folderdistrib.
You can build the project directly, or you can use Guix to manage the build environment.
-
Install CMake, a C++17 toolchain (Clang and GCC both seem to work), and SDL2 by whatever means are appropriate for your distro. (If you encounter errors about linking to
tinfo, the problem may be related to Curses.) The other dependencies are provided by this repository. As several of the included dependencies contain modifications for this project, it is not advisable to replace them with packaged dependencies. I apologize for the convenience. -
Clone this project somewhere.
-
Run
./linux/build_majuscule.sh. -
If all goes well, the binary will show up in
./linux/build/Release/bin/tangerine: you can run it directly from the build directory. (If you want to move it somewhere else, beware that it must find some runtime data from a path relative to the executable:cmake --installhandles keeping them together.)
Of course, ./linux/build_majuscule.sh just runs cmake with some sensible options.
If you prefer, you can always run cmake directly.
If you install Guix (which may be as easy as sudo apt install guix), you don't have to worry about any of the other dependencies.
To run Tangerine, automatically building it if needed, try:
guix time-machine -C channels.scm -- \
shell --rebuild-cache -f guix.scm -- \
tangerineYou can create an isolated container and enter a shell for interactive building by running:
guix time-machine -C channels.scm -- \
shell --rebuild-cache -D -f guix.scm --container --emulate-fhsAdding -- ./linux/build_majuscule.sh to the end of that command will perform a build in the same way as the manual process described above.
Tangerine optionally integrates RmlUi, which in turn typically requires linking with FreeType. Per the FreeType project license, the use of FreeType must be acknowldeged somewhere in a project's documentation. The use of FreeType in Tangerine via an optional dependency is hereby acknowledged in Tangerine's documentation.