Compiterator v1.7

Controls

• space: Toggle RENDER/EDIT modes
  --EDIT--
• L alt HOLD + L mouse: Add node
• L mouse HOLD: Delete node
• up arrow: New layer
• down arrow: Delete top layer
• right arrow: Next layer
• left arrow: Previous layer
  --RENDER--
• Q: Toggle render (freeze)
• R: Clear render
• W: Move mouse-selector point up
• A: Move mouse-selector point left
• S: Move mouse-selector point down
• D: Move mouse-selector point right
• 1: Change to complex parameter mouse-selector mode
• 2: Change to colour origin mouse-selector mode
• 3: Change to iterated point mouse-selector mode
• 4: Change to iterated cluster mouse-selector mode
• 5: Change to probability mouse-selector mode
• 6: Change to latest node mouse-selector mode
• ~: Cycle mouse-selector mode
• E: Cycle iteration mode
• B: Cycle colour mode (clears window also)
• N: Cycle node exclusion
• M: Cycle layer exclusion
• H: Jumble node order
• K: Jumble layer order
• <: Decrease colour cycle depth
• >: Increase colour cycle depth
• shift: Toggle toggling of N and M to their broken functions in prior versions (read the instructions).
• enter: Save Image (Right click the canvas and save manually if this doesn't work)

Instructions

In edit mode (default state):

Place nodes in different layers to inform the kind of image that will be generated in render mode.
Use the up and down arrow keys to increase or decrease the total number of layers.
Use the right and left arrow keys to select the current layer that the new node will be part of.

Alt + Left Click to place a node at the cursor, an already existing node at the cursor will be overridden.
Hold left click to remove any nodes at the cursor, it will not remove a node if it is the last of its layer.
Layers that don't have any nodes are considered to have a node at the center of the screen.

Press spacebar to move to render mode.

In render mode:
You can save the image in render mode using the ENTER key.
NOTE: If your window resizes due to the downloads bar popping up it will clear the render mode but the image can still be saved.

To clear the screen press R or go to edit mode and then back to render.
Pressing Q toggles the rendering so that no changes occur, useful for pausing to inspect and for swapping modes for creative combinations.

Pressing E will cycle the different algorithms for the chaos game, it will not clear the screen.

1. linear interpolation algorithm.
2. constant distance algorithm.
3. linear interpolation algorithm with exponential sum output parameter
4. constant distance with exponential sum output parameter
5. exponential sum algorithm

Pressing ~ will cycle the different mouse-selector modes.
The mouse (or WASD keys) will set/move the point that controls the:

1. Complex parameter for the various algorithms.
2. Location of the origin for colouring.
3. Location of the iterated point, can be used to demonstrate the attractor properties.
4. Point at which the plot is drawn towards, also useful to demonstrate the attractors.
5. Game probabilities, with the probability of iterated point resetting as x and layer swapping as y respectively.
6. Most recently created node, mostly for making small adjustments in the exponential sum mode.

You can budge the point specified by the input settings that would otherwise be set by the mouse a small distance from its current position by pressing WASD in the way you would expect, W = up, A = left, S = down, D = right.
This can be used to observe how small changes in the current state effect the outcome without having to locate the old point with the mouse.

Pressing N and M cycle the exclusion algorithm for the nodes and layers, this does not clear the screen. Both default to 0.
At the value of 1, no longer can the previously chosen item be chosen again.
Beyond 1 it excludes the "nth" next item from being chosen.
Use H and K to jumble the node and layer order to explore all the permutations of the exclusion effects.
If you wish to use the old broken functionality of the node and layer exclusion modes, press SHIFT, then press N or M, then SHIFT again.
The node exclusion or the layer exclusion respectively will work as they did before the fix. (SHIFT toggles the N and M buttons into toggles of the fix independently for either mode)

You can cycle through different modes of the colours shown by pressing B. This will clear the screen.
The depth to which the colour algorithm refers to can be increased or decreased by using > and <.
This will increase the time it takes the render to fill but it can allow for a clearer exploration of the self-similarities and symmetries in the fractal structures produced.

Background Information

The chaos game involves choosing points in a probabilistic algorithm and iterating the movement by some other algorithm to the chosen point of a tracked point.
This often produces mathematical attractors, shapes which are approached regardless of the starting value of the iteration given enough iterations.

This program completes 500 iterations a frame.
At 50% (variable) probability each iteration there is a chance that a new layer is chosen at random, this could include the layer previously selected.
Each iteration in the chosen layer a single node is chosen at random, it also can include the node that was previously selected.

What layers and nodes can be selected in relevance to the previously selected layers and nodes can be changed.
The image is coloured based on previous iterations to highlight the fractal elements of the image such as the self-similarities and symmetries.

There are three algorithms for the iteration:

1. The iterated point moves on a linear interpolation to the chosen node with a complex parameter.
   The parameter, based on the screen position, is mapped from the whole plane into the unit disk.
2. The iterated point moves by a rotation of a constant complex vector towards the chosen node.
   The parameter, based on the screen position, is mapped in the reals by an exponential and in the imaginary by a branched logarithm.
3. The iterated point moves on a linear interpolation to the chosen node with a complex parameter of the output of the sum of a complex expoentiation function and the chosen node.
4. The iterated point moves by a rotation of a constant complex vector (the output of the sum of a complex exponentiation function and the chosen node) towards the chosen node.
5. The iterated point moves to the output of the iterated sum of a complex exponentiation function and the chosen node
   The parameter, based on twice the screen position, is used as the exponent.

For the last two algorithms to work the probability of the point being reset must be more than 0, adjustable via the fifth mouse-selector mode. Otherwise the point iterates away from the canvas in most cases and thus produces not much of an image.