---
slug: 2024/11/playing-with-fire-transforms
title: "Playing with fire: Transforms and variations"
date: 2024-11-15 13:00:00
authors: [bspeice]
tags: []
---

Now that we have a basic chaos game in place, it's time to spice things up. Variations create the
shapes and patterns that fractal flames are known for.

<!-- truncate -->

:::info
This post uses [reference parameters](../params.flame) to demonstrate the fractal flame algorithm.
If you're interested in tweaking the parameters, or generating your own art, [Apophysis](https://sourceforge.net/projects/apophysis/)
can load that file to play around with!
:::

## Variations

:::note
This post covers section 3 for the Fractal Flame Algorithm paper
:::

import CodeBlock from '@theme/CodeBlock'

We previously introduced transforms as the "functions" of an "iterated function system," and showed how
playing the chaos game leads to an image of Sierpinski's Gasket. Even though we used simple functions,
the image it generates is exciting. But it's still not nearly as exciting as the images the Fractal Flame
algorithm is known for.

This leads us to the first big innovation of the Fractal Flame algorithm: adding non-linear functions
after the affine transform. These functions are called "variations":

$$
F_i(x, y) = V_j(a_i \cdot x + b_i \cdot y + c_i, d_i \cdot x + e_i \cdot y + f_i)
$$

import variationSource from '!!raw-loader!../src/variation'

<CodeBlock language="typescript">{variationSource}</CodeBlock>

Just like transforms, variations ($V_j$) are functions that take in $(x, y)$ coordinates
and give back new $(x, y)$ coordinates.
However, the sky is the limit for what happens between input and output.
The Fractal Flame paper lists 49 different variation functions,
and the official `flam3` implementation supports [98 different variations](https://github.com/scottdraves/flam3/blob/7fb50c82e90e051f00efcc3123d0e06de26594b2/variations.c).

To draw our reference image, we'll focus on four variations:

### Linear (variation 0)

This variation is dead simple: just return the $x$ and $y$ coordinates as-is.

$$
V_0(x,y) = (x,y)
$$

import linearSrc from '!!raw-loader!../src/linear'

<CodeBlock language={'typescript'}>{linearSrc}</CodeBlock>

:::tip
In a way, we've already been using this variation! The transforms that define Sierpinski's Gasket
apply the affine coefficients to the input point, and use that as the output point.
:::

### Julia (variation 13)

This variation is a good example of the non-linear functions we can use. It uses both trigonometry
and probability to produce interesting shapes:

$$
\begin{align*}
r &= \sqrt{x^2 + y^2} \\
\theta &= \text{arctan}(x / y) \\
\Omega &= \left\{
\begin{array}{lr}
0 \hspace{0.4cm} \text{w.p. } 0.5 \\
\pi \hspace{0.4cm} \text{w.p. } 0.5 \\
\end{array}
\right\} \\

V_{13}(x, y) &= \sqrt{r} \cdot (\text{cos} ( \theta / 2 + \Omega ), \text{sin} ( \theta / 2 + \Omega ))
\end{align*}
$$

import juliaSrc from '!!raw-loader!../src/julia'

<CodeBlock language={'typescript'}>{juliaSrc}</CodeBlock>

### Popcorn (variation 17)

Some variations rely on knowing the transform's affine coefficients; they're called "dependent variations."
For the popcorn variation, we use $c$ and $f$:

$$
V_{17}(x,y) = (x + c \cdot \text{sin}(\text{tan }3y), y + f \cdot \text{sin}(\text{tan }3x))
$$

import popcornSrc from '!!raw-loader!../src/popcorn'

<CodeBlock language={'typescript'}>{popcornSrc}</CodeBlock>

### PDJ (variation 24)

Some variations have extra parameters; they're called "parametric variations."
For the PDJ variation, there are four extra parameters we can choose:

$$
p_1 = \text{pdj.a} \hspace{0.2cm} p_2 = \text{pdj.b} \hspace{0.2cm} p_3 = \text{pdj.c} \hspace{0.2cm} p_4 = \text{pdj.d} \\
V_{24} = (\text{sin}(p_1 \cdot y) - \text{cos}(p_2 \cdot x), \text{sin}(p_3 \cdot x) - \text{cos}(p_4 \cdot y))
$$

import pdjSrc from '!!raw-loader!../src/pdj'

<CodeBlock language={'typescript'}>{pdjSrc}</CodeBlock>

## Blending

Now, one variation is fun, but we can also combine variations in a process called "blending."
Each variation receives the same $x$ and $y$ inputs, and we add together each variation's $x$ and $y$ outputs.
We'll also give each variation a weight ($v_{ij}$) that changes how much it contributes to the result:

$$
F_i(x,y) = \sum_{j} v_{ij} V_j(a_i \cdot x + b_i \cdot y + c_i, \hspace{0.2cm} d_i \cdot x + e_i \cdot y + f_i)
$$

The formula looks intimidating, but it's not hard to implement:

import blendSource from "!!raw-loader!../src/blend";

<CodeBlock language={'typescript'}>{blendSource}</CodeBlock>

With that in place, we have enough to render a first fractal flame. We'll use the same
chaos game as before, but our new transforms and variations produce a dramatically different image:

:::tip
Try using the variation weight sliders to figure out which parts of the image each transform controls.
:::

import {SquareCanvas} from "../src/Canvas";
import FlameBlend from "./FlameBlend";

<SquareCanvas name={"flame_blend"}><FlameBlend/></SquareCanvas>

## Post transforms

Next, we'll introduce a second affine transform, applied _after_ variation blending. This is called a "post transform."

We'll use some new variables, but the post transform function should look familiar:

$$
\begin{align*}
P_i(x, y) &= (\alpha_i x + \beta_i y + \gamma_i, \delta_i x + \epsilon_i y + \zeta_i) \\
F_i(x, y) &= P_i\left(\sum_{j} v_{ij} V_j(x, y)\right)
\end{align*}
$$

import postSource from '!!raw-loader!./post'

<CodeBlock language="typescript">{postSource}</CodeBlock>

The image below uses the same transforms/variations as the previous fractal flame,
but allows modifying the post-transform coefficients:

<details>
    <summary>If you want to test your understanding...</summary>

    - What post-transform coefficients will give us the previous image?
    - What post-transform coefficients will give us a _mirrored_ image?
</details>

import FlamePost from "./FlamePost";

<SquareCanvas name={"flame_post"}><FlamePost/></SquareCanvas>

## Final transforms

Our last step is to introduce a "final transform" ($F_{final}$) that is applied
regardless of which transform the chaos game selects. It works just like a normal transform
(composition of affine transform, variation blend, and post transform),
but it doesn't change the chaos game state.

With that in place, our chaos game algorithm changes slightly:

$$
\begin{align*}
&(x, y) = \text{random point in the bi-unit square} \\
&\text{iterate } \{ \\
&\hspace{1cm} i = \text{random integer from 0 to } n - 1 \\
&\hspace{1cm} (x,y) = F_i(x,y) \\
&\hspace{1cm} (x_f,y_f) = F_{final}(x,y) \\
&\hspace{1cm} \text{plot}(x_f,y_f) \text{ if iterations} > 20 \\
\}
\end{align*}
$$

import chaosGameFinalSource from "!!raw-loader!./chaosGameFinal"

<CodeBlock language="typescript">{chaosGameFinalSource}</CodeBlock>

import FlameFinal from "./FlameFinal";

<SquareCanvas name={"flame_final"}><FlameFinal/></SquareCanvas>

## Summary

Variations are the fractal flame algorithm's first major innovation.
By blending variation functions, and post/final transforms, we generate unique images.

However, the images themselves are grainy and unappealing. In the next post, we'll clean up
the image quality and add some color.