Configuration files
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 ( ) , 1 ( )
- 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 =
- 1 =
- 2 =
- Initial value: 0
- diagram =
-
Select a diagram for
- 0 =
- 1 =
- 2 =
- 3 =
- 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 = | floating point | -0.7 | |
startvalue1 = | floating point | 1.4 | |
startvalue2 = | floating point | 1.4 | |
low = | floating point | -2 | |
high = | floating point | 2 | |
escapevalue = | floating point or 'auto' | auto | |
iterstep = | Integer (positive value) | 1 | |
iterated = | Integer (positive value) | 1 |
Tag: [real_orbits_x]
Variable | Name | Type | Default |
---|---|---|---|
c = | floating point | -1.41 | |
xlow = | floating point | -2.5 | |
xhigh = | floating point | 2.5 | |
ylow = | floating point | -2 | |
yhigh = | floating point | 2 | |
escapevalue = | floating point or 'auto' | auto | |
itermax = | Integer (positive value) | 250 | |
iterskip = | Integer (positive value) | 0 |
Tag: [real_orbits_c]
Variable | Name | Type | Default |
---|---|---|---|
x = | floating point | -0.7 | |
xlow = | floating point | -2.5 | |
xhigh = | floating point | 0.5 | |
ylow = | floating point | -2 | |
yhigh = | floating point | 2 | |
escapevalue = | floating point or 'auto' | auto | |
itermax = | Integer (positive value) | 250 | |
iterskip = | 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 =
- 1 =
- 2 =
- 3 =
- Initial value: 0
- shape =
-
Select a shape to start with for
- 0 =
- 1 =
- 2 =
- 3 =
- Initial value: 0
and
:
- coloring =
-
Select a coloring method for
- 0 =
- 1 =
- 2 =
- Initial value: 0
and
:
- zdiagram =
-
Select a diagram for
- 0 =
- 1 =
- 2 =
- 3 =
- Initial value: 1
:
- cdiagram =
-
Select a diagram for
- 0 =
- 1 =
- 2 =
- 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 = | floating point | 0 | |
c_imag = | floating point | 0 | |
min_real_values = | floating point | -3 | |
max_real_values = | floating point | 3 | |
min_imag_values = | floating point | -2.1875 | |
max_imag_values = | floating point | 2.1875 | |
escapevalue = | floating point or 'auto' | auto | |
itersteps = | Integer (positive value) | 1 | |
iterskip = | Integer (positive value) | 0 |
Tag: [real_orbits_z]
Variable | Name | Type | Default |
---|---|---|---|
c_real = | floating point | -1 | |
c_imag = | floating point | 0 | |
min_real_values = | floating point | -2 | |
max_real_values = | floating point | 2 | |
min_imag_values = | floating point | -1.4375 | |
max_imag_values = | floating point | 1.4375 | |
escapevalue = | floating point or 'auto' | auto | |
itermax = | Integer (positive value) | 250 | |
iterskip = | 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 = | floating point | 0 | |
z_imag = | floating point | 0 | |
min_real_values = | floating point | -2 | |
max_real_values = | floating point | 2 | |
min_imag_values = | floating point | -1.4375 | |
max_imag_values = | floating point | 1.4375 | |
escapevalue = | floating point or 'auto' | auto | |
itermax = | Integer (positive value) | 250 | |
iterskip = | 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:
- Possible values: 0 (off) , 1 (on)
- Initial value: 1
and
for complex experiments with diagram
.
- 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