9 releases
0.2.3 | Feb 4, 2024 |
---|---|
0.2.2 | Jan 13, 2024 |
0.2.1 | Oct 27, 2023 |
0.2.0 | Aug 19, 2023 |
0.1.4 | Aug 12, 2023 |
#243 in Images
36 downloads per month
43KB
865 lines
barnsley: Iterated Function Systems in Rust
Make your own images like this! Look at at all the variety in the examples.
Make your own!
You can use https://barnsley.dev to generate your own IFS and animations right in the browser.
This website is built in the barnsley_gui repo.
How to run crate
Install
Rust is required to run this code. Installation of Rust is easy though.
Once you have rust, install Barnsley with cargo install barnsley
.
Then, you can run from a template or a config.
From a template
A template toml file specifies the image properties, the evaluation properties, and which transforms to run.
Since you have not specified the parameters of the transforms, they're generated randomly.
This is an example template.
You can use the construct
command in the program to generate a specific instance of parameters and then evaluate it
to create an image.
- Install with
cargo install barnsley
- Using Rust, run
barnsley construct example_template.toml > test.json
- Look at your picture in the test.png file and the configuration in test.json
From a config
A config json file specifies the image properties, the evaluation properties, and the specific parameters of transforms. It can be used to recreate an image at a later date.
- Install with
cargo install barnsley
. - Using Rust, run
barnsley construct examples/example7.json
- Look at the example7.png file to see the result. Note how it matches the one in the examples directory!
Implemented transforms
- LinearTransform
- AffineTransform
- MoebiusTransform
- InverseJuliaTransform
Try different combinations of them to generate new images.
Origins
This code is based on pyifs written by James Tauber for Python.
The crate name is in honor of Michael Barnsley, a leading researcher of iterated function systems.
Dependencies
~10MB
~168K SLoC