Crate barnsley 

barnsley

barnsley is a library and executeable for exploring iterated function systems. It’s based and inspired by pyifs written by James Tauber for Python.

Running the executable

Simply install using cargo install barnsley. Run barnsley in a terminal to get a CLI. Each command is documented there.

Defining an iterated function system

An iterated function is defined by a vector of transforms. You add them one at a time.

use barnsley::{ifs::IFS, transform::AffineTransform, image::Image};
let mut ifs = IFS::new();
ifs.add_transform(AffineTransform::random().into());
 
let width: usize = 100;
let height: usize = 100;
let num_points: usize = 100;
let num_iterations: usize = 10;
let mut image = Image::new(width, height);
ifs.evaluate(&mut image, num_points, num_iterations);

Defining iterated function systems in files

There are two kinds of files that are used to define a IFS:

1. templates: These are toml files specify which transforms you want to run but not their parameters. Each time you run one you will get a different result. They’re good for generating many different images.
2. configs: These are json files that fully specify the transforms and their parameters. You can use them to regenerate an image at a higher resolution, change the color scheme, or explore how changing parameters impacts the IFS.

Modules

animation

a struct and associated methods for animations

config

core definition for an IFS run that can be serialized to a file

ifs

iterated function system

image

two-dimensional image representation

template

representation of an non-parameterized, random IFS

transform

functions used in the IFS

util

useful support functionality