Release 4.0

Quaternion - Iteration Formulas

Iteration formulas are the most important formulas in ChaosPro: They define the fractal formula used to calculate the fractal, for example z^2+c or sin(z)+c. So this formula is responsible for the complexity of the fractal, i.e. the detail level and its shape.

Such an iteration formula may contain the following functions:

• void init_once(void): Called only once, i.e. when the fractal calculation starts: In this routine you can initialize variables and allocate arrays.
• void init(void): This init routine gets executed for each pixel before the actual fractal loop starts. Its purpose is to do some initializations for the formula. Please remember that variables do not have an initial value. They are uninitialized and contain random values at the beginning. So initialize them in this function or in init_once...
• void loop(void): This function defines the main iteration formula. For the classical mandelbrot set it would contain z=z^2+c. After the init function the main iteration loop starts: This function gets executed until the maximum number of iterations has been reached or the bailout function returns false.

• bool bailout(void): After each loop this function is executed in order to determine whether the value of the iteration has "bailed out". If this function returns false, the iteration stops. If it returns true, the iteration loop continues until the maximum number of iterations has been reached.
• void description(void): An iteration formula also may (must) contain a function named description.

The bailout function must return a boolean data type and must consist of a single expression of the form:

	
bool bailout(void)
{
   return(boolean-expression);
}

So you cannot make complex if-then-else statements with for-loops in the bailout function. If you do want to program more complex bailout expressions you can place the complex code at the end of the loop function and set a bool variable. In the bailout section you then simply return that bool variable.

The main reason for this limiting single-expression-function is speed: ChaosPro can simply evaluate the expression knowing that it returns the final result as a bool type. Otherwise there could be many branches in the execution path where the iteration bails out.

In order to tell ChaosPro that this formula is ment for fractal type Quaternion (and thus the proper predefined variables are defined), you need to specify the keyword QUATERNION in brackets after the formula identifier. This tells ChaosPro that pixel and z are quaternion variables (instead of complex variables) and that the other predefined variables for this fractal type are defined.

Hybrid(QUATERNION)
{
parameter real Bailout;
parameter quaternion c;

	void init(void)
	{
		z=pixel;
	}
	void loop(void)
	{
		z=z*z-c;
	}
	bool bailout(void)
	{
		return(|z| <= Bailout);
	}
	void description(void)
	{
		c.default=(0.3,-0.44,-0.57,0.3);
		Bailout.default=16;
		this.maxiter=7;
	}
}