Introduction:

Configuration files are intended to make the use of Funiter easier and to configure the program better. Besides, not all options are available through the menu system. This has two reasons: it prevents the language files from changing every time functionality is added, secondly you might want to 'hide' some advanced options for didactical reasons.

One of the advantages of configuration files is that Funiter starts in 'direct mode', which means that the program jumps directly to the selected graph and diagram, skipping all menu's (except for the summary).

In this chapter I will try to explain each setting in-depth.

General:

First, a few remarks regarding the syntax of configuration files:

• Separate sections are identified with a name in brackets, i.e. [main]
• Identifiers (such as auto_config_update) and their value(s) are separated by an equal sign ('=').
• Lines preceeded by a '#' are interpreted as comments (until the end of the line).

For more information you can take a look at the Allegro documentation, section 3: "Configuration routines".

Backup files:

Funiter creates a backup of the existing configuration file before writing the new file. In case you want to use the backup file, it is highly recommended you rename it to something that doesn't have the extention '.bak', otherwise no backup file will be created.

Main:

[main]

Configuration file control:

auto_config_update =

If set, configuration files are saved automatically when you quit Funiter.

• Possible values: 0 (off) , 1 (on)
• Initial value: 0

auto_par_convert =

If set, this function will save a parameter file that you load in the file-menu to the selected configuration file.

• Possible values: 0 (off) , 1 (on)
• Initial value: 1

language_file =

This option specifies a language file, i.e. dutch.mnu.

Functiontype:

functiontype =

Set the functiontype.

• Possible values: 0 (From R to R) , 1 (From C to C)
• Initial value: 1

Functiontype: From R to R:

[real]

Function selection:

function =

Sets the function:

• 0 = x -> x² + c
• 1 = x -> frac(cx)
• 2 = c * cos(x)
• 3 = cx(1 - x)
• 4 = -cx³ + (c + 1) x²
• 5 = c(1 - |2x - 1|)
• 6 = user defined, specified with 'userfunction'
• Initial value: 0

userfunction =

This contains the user defined function.

• Initial value: x*x+c
• See Functions for more details.

fn<0..6> =

This specifies a seperate config file by assigning a filename to fn0, fn1, fn2, ..., fn6

• Initial value: config/fn00.cfg

Graphs and Diagrams:

graph =

Select a graph:

• 0 = step-by-step iteration
• 1 = orbitdiagram for variable x
• 2 = orbitdiagram for variable c
• Initial value: 0

diagram =

Select a diagram for step-by-step iteration:

• 0 = webdiagram
• 1 = iteration values
• 2 = stepdiagram
• 3 = combination web- and stepdiagram.
• Initial value: 0

Function parameters:

These are the parameters that you will find in the "parameter menu". They are devided into three categories:

• [real_step]
• [real_orbits_x]
• [real_orbits_c]

In the following tables you can see the variables with the corresponding name in the parameter-menu, the type, and default value.

Tag: [real_step]

Variable	Name	Type	Default
c =	Value for parameter c	floating point	-0.7
startvalue1 =	1st starting value for iteration	floating point	1.4
startvalue2 =	2nd starting value for iteration	floating point	1.4
low =	Estimated lowest value	floating point	-2
high =	Estimated highest value	floating point	2
escapevalue =	Escape value	floating point or 'auto'	auto
iterstep =	Number of steps/iteration	Integer (positive value)	1
iterated =	Function N times iterated	Integer (positive value)	1

Tag: [real_orbits_x]

Variable	Name	Type	Default
c =	Value for parameter c	floating point	-1.41
xlow =	Lowest value for x	floating point	-2.5
xhigh =	Highest value for x	floating point	2.5
ylow =	Y-coordinate (lowest)	floating point	-2
yhigh =	Y-coordinate (highest)	floating point	2
escapevalue =	Escape value	floating point or 'auto'	auto
itermax =	Total number of iterations	Integer (positive value)	250
iterskip =	Number of skipped iterationsteps	Integer (positive value)	0

Tag: [real_orbits_c]

Variable	Name	Type	Default
x =	1st starting value for iteration	floating point	-0.7
xlow =	Lowest value for c	floating point	-2.5
xhigh =	Highest value for c	floating point	0.5
ylow =	Y-coordinate (lowest)	floating point	-2
yhigh =	Y-coordinate (highest)	floating point	2
escapevalue =	Escape value	floating point or 'auto'	auto
itermax =	Total number of iterations	Integer (positive value)	250
iterskip =	Number of skipped iterationsteps	Integer (positive value)	0

You can change all these parameters in either the function specific file or in the main file.

Functiontype: From C to C:

[complex]

Function selection:

function =

Sets the function:

• 0 = z -> z ^ 2 + c
• 1 = z -> z ^ 3 + c
• 2 = z -> z ^ 4 + c
• 3 = user defined, specified with 'userfunction'
• Initial value: 0

userfunction =

This contains the user defined function.

• Initial value: z*z+c
• See Functions for more details.

Graphs and Diagrams:

graph =

Select a graph:

• 0 = step-by-step iteration
• 1 = step-by-step inverse iteration
• 2 = orbitdiagram for variable z
• 3 = orbitdiagram for variable c
• Initial value: 0

shape =

Select a shape to start with for step-by-step iteration and step-by-step inverse iteration:

• 0 = point
• 1 = line
• 2 = rectangle
• 3 = circle
• Initial value: 0

coloring =

Select a coloring method for step-by-step iteration and step-by-step inverse iteration:

• 0 = color depends on startingpoint
• 1 = color depends on iter. steps
• 2 = all iterationsteps same color
• Initial value: 0

zdiagram =

Select a diagram for orbitdiagram for variable z:

• 0 = filled-in
• 1 = escape time
• 2 = boudary trace
• 3 = inverse iteration method
• Initial value: 1

cdiagram =

Select a diagram for orbitdiagram for variable c:

• 0 = filled-in
• 1 = escape time
• 2 = boundary trace
• Initial value: 1

Function parameters:

These are the parameters that you will find in the "parameter menu". They are devided into four categories:

• [complex_step]
• [complex_stepinv]
• [complex_orbits_z]
• [complex_orbits_c]

In the following tables you can see the variables with the corresponding name in the parameter-menu, the type, and default value.

Tag: [complex_step] , [complex_stepinv]

Variable	Name	Type	Default
c_real =	Real part of c	floating point	0
c_imag =	Imaginary part of c	floating point	0
min_real_values =	Min. for real part of values	floating point	-3
max_real_values =	Max. for real part of values	floating point	3
min_imag_values =	Min. for imaginary part of values	floating point	-2.1875
max_imag_values =	Max. for imaginary part of values	floating point	2.1875
escapevalue =	Escape value	floating point or 'auto'	auto
itersteps =	Number of steps/iteration	Integer (positive value)	1
iterskip =	Number of skipped iterationsteps	Integer (positive value)	0

Tag: [real_orbits_z]

Variable	Name	Type	Default
c_real =	Real part of c	floating point	-1
c_imag =	Imaginary part of c	floating point	0
min_real_values =	Min. for real part of values	floating point	-2
max_real_values =	Max. for real part of values	floating point	2
min_imag_values =	Min. for imaginary part of values	floating point	-1.4375
max_imag_values =	Max. for imaginary part of values	floating point	1.4375
escapevalue =	Escape value	floating point or 'auto'	auto
itermax =	Total number of iterations	Integer (positive value)	250
iterskip =	Number of skipped iterationsteps	Integer (positive value)	0
symmetry =	n/a	Possible values: 'mirror_x', 'mirror_y' and 'mirror_imag0'	mirror_x mirror_y mirror_imag0

Tag: [real_orbits_c]

Variable	Name	Type	Default
z_real =	Real part of z	floating point	0
z_imag =	Imaginary part of z	floating point	0
min_real_values =	Min. for real part of values	floating point	-2
max_real_values =	Max. for real part of values	floating point	2
min_imag_values =	Min. for imaginary part of values	floating point	-1.4375
max_imag_values =	Max. for imaginary part of values	floating point	1.4375
escapevalue =	Escape value	floating point or 'auto'	auto
itermax =	Total number of iterations	Integer (positive value)	250
iterskip =	Number of skipped iterationsteps	Integer (positive value)	0
symmetry =	n/a	Possible values: 'mirror_x', 'mirror_y' and 'mirror_imag0'	mirror_x mirror_imag0

You can change all these parameters in either the function specific file or in the main file.

Settings:

[settings]

general settings:

gen_statusbar =

If set, the statusbar at the bottom of the screen is visible.

• Possible values: 0 (off) , 1 (on)
• Initial value: 1

gen_parconnect =

If set, parameter transfers to other graphs/diagrams will be enabled. Only the parameters c and the coordinates are transfered.

• Possible values: 0 (off) , 1 (on)
• Initial value: 1

dbg_symmetry_area_coloring =

If set, mirrored area's will be colored. This setting is primarily intended for debugging purposes, and only works if some form of symmetry is set.

• Possible values: 0 (off) , 1 (on)
• Initial value: 0

Coordinates:

coo_visible =

Switch coordinate system 'on' or 'off'.

• Possible values: 0 (off) , 1 (on)
• Initial value: 1

coo_grid =

Switch the grid 'on' or 'off'.

• Possible values: 0 (off) , 1 (on)
• Initial value: 0

coo_calibration =

Switch the calibration (text) 'on' or 'off'.

• Possible values: 0 (off) , 1 (on)
• Initial value: 1

Step-by-step iteration:

step_coords =

Switch printing the value at each iteration point 'on' or 'off'.

• Possible values: 0 (off) , 1 (on)
• Initial value: 1

step_textsize =

Set the size for the text. This is related to the previous option.

• Possible values: 0 (off) , 1 (on)
• Initial value: 4

step_lines =

Switch Connecting lines between iteration points 'on' or 'off'. This option only applies to: "Step-by-step iteration" and "Step-by-step inverse iteration" for complex experiments with diagram Points.

• Possible values: 0 (off) , 1 (on)
• Initial value: 1

step_linewidth =

Set the line width for the connecting lines. This is related to the previous option.

• Possible values: 0 (off) , 1 (on)
• Initial value: 2

Colors:

col_grid =

Color of the grid.

• Possible values: 0 - 255
• Initial value: 15

col_function =

Color of the function.

• Possible values: 0 - 255
• Initial value: 4

col_xyline =

x=y line.

• Possible values: 0 - 255
• Initial value: 7

col_startvalue1 =

1st starting value.

• Possible values: 0 - 255
• Initial value: 6

col_startvalue2 =

2nd starting value.

• Possible values: 0 - 255
• Initial value: 5

mapfile =

Path to a Fractint .map file. Funiter will read this file, and replace the color values in [palette] by the values from the .map file.

• Initial value: empty

Palette:

[palette]

This section contains a list with colors in the RGB format. If you set a mapfile, the values from this file will be copied to the configuration-file and overwrite existing entries in the section [palette]. If the section doesn't exist yet, it will be created and filled with the values for Funiter's standard palette.

col<000..255> =

Color palette: each entry represents a color in RRR GGG BBB format.

• Possible values: R: 0 - 255 , G: 0 - 255 , B: 0 - 255
• Initial value: the standard funiter palette