|
1 #summary Structure of the theme.cfg file |
|
2 |
|
3 == Theme.cfg == |
|
4 This file gives the engine the values associated with a certain theme, to complement the graphics. |
|
5 It is structured with a key followed by a number of values. Example: |
|
6 <code>sky = 120, 40, 80</code> |
|
7 |
|
8 There is also keys that replace existing keys under certain conditions, all keys preceding with "sd-" are used during sudden death and all keys with "rq-" are used when quality is reduced. These keys must be placed after the regular keys and they are all optional. |
|
9 |
|
10 Following is the list of all current keys and their values, it is important to have the right number of values. Most keys may only be used once. |
|
11 |
|
12 The values red, green, blue and opacity are in the range of one byte and can be specified in both decimal or hexadecimal form. The range are 0 - 255 or 0 - $FF. |
|
13 |
|
14 === sky === |
|
15 The colour of the sky. |
|
16 |
|
17 Values: red, green, blue |
|
18 |
|
19 Values: red, green, blue |
|
20 |
|
21 === border === |
|
22 The colour of the outline of explosions. |
|
23 |
|
24 Values: red, green, blue |
|
25 |
|
26 === water-top === |
|
27 The colour of the topmost part of the water (under the water.png). |
|
28 This makes a gradient together with water-bottom. |
|
29 |
|
30 Values: red, green, blue |
|
31 |
|
32 === water-bottom === |
|
33 The colour of the lowest part of the water. |
|
34 This makes a gradient together with water-top. |
|
35 |
|
36 Values: red, green, blue |
|
37 |
|
38 === water-opacity === |
|
39 Opacity of the water, how visible gears in the water are. |
|
40 |
|
41 Values: opacity |
|
42 |
|
43 === music === |
|
44 Name of the track to be played in the theme, e.g. Nature.ogg |
|
45 |
|
46 Values: name |
|
47 |
|
48 === clouds === |
|
49 The number of clouds to create. |
|
50 |
|
51 Values: number |
|
52 |
|
53 === object === |
|
54 There may be several object keys in the file, each one representing one land object. |
|
55 |
|
56 unfinished, values are the file name and then the old values |
|
57 |
|
58 === spray === |
|
59 There may be several spray keys in the file, each one representing one spray object. |
|
60 The name is the name of the .png (without the extension) of the graphics file, and the number is the number of instances of this spray that may be added. |
|
61 |
|
62 Values: name, number |
|
63 |
|
64 === flakes === |
|
65 Values for the flakes of this theme. First the number of flakes, then number of frames and ticks per frame. Lastly the speed and fall speed of the flakes. |
|
66 If left out there are no flakes. |
|
67 |
|
68 Values: number, frames, frame ticks, speed, fall speed |
|
69 |
|
70 === sd-water-top === |
|
71 Sudden death version of water-top. Has a default value. |
|
72 |
|
73 === sd-water-bottom === |
|
74 Sudden death version of water-bottom. Has a default value. |
|
75 |
|
76 === sd-water-opacity === |
|
77 Sudden death version of water-opacity. As default same as water-opacity. |
|
78 |
|
79 === sd-clouds === |
|
80 Sudden death version of clouds. As default same as clouds. |
|
81 |
|
82 === sd-flakes === |
|
83 Sudden death version of flakes. Has a default value. |
|
84 |
|
85 === rq-sky === |
|
86 Reduced quality version of sky. If present used instead of sky on low quality. |