barnsley 0.1.0

iterated function system image generator
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47

# barnsley: Iterated Function Systems in Rust

Make your own images like this! Look at at all the variety in the [examples](examples/).

![example image](https://github.com/jmbhughes/barnsley/blob/main/examples/example4.png?raw=true)

This is based upon [pyifs](https://github.com/jtauber/pyifs) written by [James Tauber](https://github.com/jtauber) for Python. 

## How to run
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.](example_template.toml)
You can use the `construct` command in the program to generate a specific instance of parameters and then evaluate it
to create an image. 

1. Clone this repo
2. Using Rust, run `cargo run --release construct example_template.toml > test.json`
3. 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. 

1. Clone this repo
2. Using Rust, run `cargo run --release construct examples/example7.json`
3. 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. 

## Coming soon
- [x] the base package 
- [x] a configurable main function 
- [ ] more color schemes
- [ ] more transforms
- [ ] a mathematical guide
- [ ] classic fractals
- [ ] animation of the ifs executing