What is Fable?
Fable is an animation engine that attempts to create a general-purpose rendering engine via Iterated Function Systems (IFSs).
The current Fable.jl API is still in active development, but for those wanting to learn about how to use it, there are several examples available to learn from. Though Fable.jl focuses on creating general-purpose animations with fractals, other rendering modes are either supported or planned to be implemented in the future. For now, the only available rendering modes are:
- Hutchinson operators: These are used to describe Iterated Function Systems and are the primary focus of Fable.jl
- Colors: This mode is somewhat trivial and will just create a layer of a specified color
- Shaders: This mode leverages the framework used to describe IFSs to color an image with some user-provided equation.
We would like to support rendering via raytracing, raymarching, and rasterization in the future for those who wish to use such features. If you would like to learn how to use any of the existing rendering modes, please look at the layering section of our documentation.
What are Iterated Function Systems?
We plan to put more information in the docs, but there is a great article already describing them in the Algorithm Archive. For now, please go there for more information.
General Fable.jl workflow
Fable.jl is generally structured around building a Fable Executable (fee). In the case you want to use the fractal rendering mode, this fee will be a function system, so for a Sierpinski Triangle, it would look like this:
\[\begin{aligned} f_1(P,A) &= \frac{P+A}{2} \\ f_2(P,B) &= \frac{P+B}{2} \\ f_3(P,C) &= \frac{P+C}{2}. \end{aligned}\]
Here, $P$ is some point location and $A$, $B$, and $C$ are all vertices of the triangle. For Fable.jl, each function is called a Fable User Method (fum or FableUserMethod). If the user wants to change the variables dynamically, they might create a Fable Input (fi or FableInput). Finally, each function should have some sort of color (or shader) associated with it. Combining two fums for both the position and color functions creates a Fable Operator (fo or FableOperator) So, how do you use Fable.jl?
Well...
fee, the Fable Executable is the thing you are buildingfi, the Fable Input(s) are the variables needed for your executablefo, the Fable Operator is the function you are using in your executable, complete with probability and color or shader informationfum, the Fable User Method is how users actually create colors and Fable Operators.
I am intending to write more docs here, but check out the examples for more information on specifically how to use these.