4 releases (breaking)
0.4.0 | Aug 8, 2022 |
---|---|
0.3.0 | Jul 13, 2022 |
0.2.0 | Jul 12, 2022 |
0.1.0 | Jul 12, 2022 |
#941 in Images
1MB
1.5K
SLoC
Trifit, a image compression / art program
Trifit takes input images like these
and give you beautefull triangle versions
and finally, it can create mindustry logic to display the images it creates --format mindustry
like so:
this can be used to get good looking logic images with VERY few processors (just make shure to use --image-size 176
or --image-size 80
)
note: schematics are not auto-generated, only code is. this will improve in the future
Usage
Trifit is a CLI program. to use, pass the path to the input image, and specify the size of the output image, the size of the starting triangle grid, the number of iterations, and the ammount to shift each vertex each step. for example:
trifit img/aroura_sky.jpg --image-size 900 --tri-size 15 --iterations 50 --shift 0.5
for more details about useage, run trifit --help
Output formats
you can also specify a file to write the result to, and its format with --format
. available formats are svg
, image
(type determined by file extension), and mindustry
when outputing to the mindustry
format, it will produce multiple files if it gets too long. it will draw to the display1
output.
Visualizations
as the program runs, it will open a window to display its progress (it also helps aleviate boredom while the program runs). if this is not desierable, use --no-visuals
to disable this.
Scoring methods
these affect what method is used to quantify how well a given triangle represents its part of an image, and can be specified with the --scoring
flag.
Installation
From Source
To build trifit from source, clone this repo and do cargo build
(or cargo build --release
). the binary will end up in ./target/debug|release/trifit
From crates.io
cargo install trifit
Contribution
Contrbuting is appreciated, feel free to open an issue or pull request. Note that any contribution submitted for inclusion in the project will be licensed according to the terms given in LICENSE
Dependencies
~28–40MB
~477K SLoC