| author | Caironater@gmail.com |
| Tue, 04 Jun 2013 03:31:36 +0000 | |
| changeset 319 | e5542ee81444 |
| parent 83 | b9fe713d7c27 |
| child 320 | 91a3a47a1615 |
| permissions | -rw-r--r-- |
| 83 | 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 |
||
|
319
e5542ee81444
Fixed the object entry, as well as some minor fixes.
Caironater@gmail.com
parents:
83
diff
changeset
|
14 |
Comments may be added by prefixing a semicolon(;) to the comment. |
|
e5542ee81444
Fixed the object entry, as well as some minor fixes.
Caironater@gmail.com
parents:
83
diff
changeset
|
15 |
|
| 83 | 16 |
=== sky === |
17 |
The colour of the sky. |
|
18 |
||
|
319
e5542ee81444
Fixed the object entry, as well as some minor fixes.
Caironater@gmail.com
parents:
83
diff
changeset
|
19 |
<code>Values: red, green, blue</code> |
| 83 | 20 |
|
21 |
=== border === |
|
22 |
The colour of the outline of explosions. |
|
23 |
||
|
319
e5542ee81444
Fixed the object entry, as well as some minor fixes.
Caironater@gmail.com
parents:
83
diff
changeset
|
24 |
<code>Values: red, green, blue</code> |
| 83 | 25 |
|
26 |
=== water-top === |
|
|
319
e5542ee81444
Fixed the object entry, as well as some minor fixes.
Caironater@gmail.com
parents:
83
diff
changeset
|
27 |
The colour of the topmost part of the water (under the BlueWater.png). |
| 83 | 28 |
This makes a gradient together with water-bottom. |
29 |
||
|
319
e5542ee81444
Fixed the object entry, as well as some minor fixes.
Caironater@gmail.com
parents:
83
diff
changeset
|
30 |
<code>Values: red, green, blue</code> |
| 83 | 31 |
|
32 |
=== water-bottom === |
|
33 |
The colour of the lowest part of the water. |
|
34 |
This makes a gradient together with water-top. |
|
35 |
||
|
319
e5542ee81444
Fixed the object entry, as well as some minor fixes.
Caironater@gmail.com
parents:
83
diff
changeset
|
36 |
<code>Values: red, green, blue</code> |
| 83 | 37 |
|
38 |
=== water-opacity === |
|
|
319
e5542ee81444
Fixed the object entry, as well as some minor fixes.
Caironater@gmail.com
parents:
83
diff
changeset
|
39 |
Opacity of the water affects how visible gears in the water are. |
| 83 | 40 |
|
|
319
e5542ee81444
Fixed the object entry, as well as some minor fixes.
Caironater@gmail.com
parents:
83
diff
changeset
|
41 |
<code>Values: opacity</code> |
| 83 | 42 |
|
43 |
=== music === |
|
44 |
Name of the track to be played in the theme, e.g. Nature.ogg |
|
45 |
||
|
319
e5542ee81444
Fixed the object entry, as well as some minor fixes.
Caironater@gmail.com
parents:
83
diff
changeset
|
46 |
<code>Values: name</code> |
| 83 | 47 |
|
48 |
=== clouds === |
|
49 |
The number of clouds to create. |
|
50 |
||
|
319
e5542ee81444
Fixed the object entry, as well as some minor fixes.
Caironater@gmail.com
parents:
83
diff
changeset
|
51 |
<code>Values: number</code> |
| 83 | 52 |
|
53 |
=== object === |
|
|
319
e5542ee81444
Fixed the object entry, as well as some minor fixes.
Caironater@gmail.com
parents:
83
diff
changeset
|
54 |
There may be multiple object keys in the file, each one representing one land object. |
| 83 | 55 |
|
|
319
e5542ee81444
Fixed the object entry, as well as some minor fixes.
Caironater@gmail.com
parents:
83
diff
changeset
|
56 |
objects file name(without the .png), max number of this object that may be placed in a single map, rectangle that must be buried (left, top, width, height), minimum number of rectangles that must be visible, list of the rectangles for being visible(left, top, width, height) |
|
e5542ee81444
Fixed the object entry, as well as some minor fixes.
Caironater@gmail.com
parents:
83
diff
changeset
|
57 |
filename: The objects' filename (without the .png) |
|
e5542ee81444
Fixed the object entry, as well as some minor fixes.
Caironater@gmail.com
parents:
83
diff
changeset
|
58 |
max: The maximum number of this object that may be generated in a map |
|
e5542ee81444
Fixed the object entry, as well as some minor fixes.
Caironater@gmail.com
parents:
83
diff
changeset
|
59 |
buriedrec: A rectangle that must be buried in the terrain (left, top, width, height) |
|
e5542ee81444
Fixed the object entry, as well as some minor fixes.
Caironater@gmail.com
parents:
83
diff
changeset
|
60 |
minvisible: The minimum amount of rectangles that must be visible |
|
e5542ee81444
Fixed the object entry, as well as some minor fixes.
Caironater@gmail.com
parents:
83
diff
changeset
|
61 |
visiblerec: list of the rectangles for being visible(left, top, width, height) |
|
e5542ee81444
Fixed the object entry, as well as some minor fixes.
Caironater@gmail.com
parents:
83
diff
changeset
|
62 |
|
|
e5542ee81444
Fixed the object entry, as well as some minor fixes.
Caironater@gmail.com
parents:
83
diff
changeset
|
63 |
<code>Values: filename, max, buriedrec, minvisible, visiblerec</code> |
| 83 | 64 |
|
65 |
=== spray === |
|
66 |
There may be several spray keys in the file, each one representing one spray object. |
|
67 |
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. |
|
68 |
||
|
319
e5542ee81444
Fixed the object entry, as well as some minor fixes.
Caironater@gmail.com
parents:
83
diff
changeset
|
69 |
<code>Values: name, number</code> |
| 83 | 70 |
|
71 |
=== flakes === |
|
72 |
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. |
|
73 |
If left out there are no flakes. |
|
74 |
||
|
319
e5542ee81444
Fixed the object entry, as well as some minor fixes.
Caironater@gmail.com
parents:
83
diff
changeset
|
75 |
<code>Values: number, frames, frame ticks, speed, fall speed</code> |
| 83 | 76 |
|
77 |
=== sd-water-top === |
|
78 |
Sudden death version of water-top. Has a default value. |
|
79 |
||
80 |
=== sd-water-bottom === |
|
81 |
Sudden death version of water-bottom. Has a default value. |
|
82 |
||
83 |
=== sd-water-opacity === |
|
|
319
e5542ee81444
Fixed the object entry, as well as some minor fixes.
Caironater@gmail.com
parents:
83
diff
changeset
|
84 |
Sudden death version of water-opacity. Has default same as water-opacity. |
| 83 | 85 |
|
86 |
=== sd-clouds === |
|
|
319
e5542ee81444
Fixed the object entry, as well as some minor fixes.
Caironater@gmail.com
parents:
83
diff
changeset
|
87 |
Sudden death version of clouds. Has default same as clouds. |
| 83 | 88 |
|
89 |
=== sd-flakes === |
|
90 |
Sudden death version of flakes. Has a default value. |
|
91 |
||
92 |
=== rq-sky === |
|
93 |
Reduced quality version of sky. If present used instead of sky on low quality. |