A CLI app which uses Triangula to generate triangulated images. For a simpler interface consider using the GUI.

Running the algorithm saves a .json file every specified number of repetitions. This file contains data with the best set of the points from the algorithm. This file can then be rendered to a PNG or SVG.

Run the algorithm using the command:

triangula run -img <path/to/your/image> -out <path/to/save/file>

For almost all cases, only changing the number of points and the shape type and leaving all other options with their default values will generate an optimal result.

To change the shape type use the flag:

-shape [triangles|polygons]

For a list of available options, run:

triangula run -help

There are 2 image formats which the .json file can be rendered to: SVG and PNG. PNG is currently the only format that supports effects.

To change the shape type use the flag:

-shape [triangles|polygons]

Renders the .json file to a SVG.

Usage:

triangula render -in path/to/json -out path/to/save/svg

Options:

triangula render -help

Renders a .json file generated by the algorithm to a PNG. There are also multiple effects that can be applied to the output.

Usage:

triangula render -in path/to/json -out path/to/save/svg -img <path/to/your/image>

To add an effect, add the flag:

-effect [none|gradient|split]

Options:

triangula render -i . -o . -img . png -help