ThemeCfg.wiki
author Wuzzy
Sat, 10 Feb 2018 16:39:18 +0000
changeset 1188 fbcd3b2458b8
parent 1146 518cb4e4dc76
child 1193 4e4e0725777d
permissions -rw-r--r--
LuaAPI: details for SetVisualGearValues
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
83
b9fe713d7c27 Created wiki page through web user interface.
henrik.rostedt
parents:
diff changeset
     1
#summary Structure of the theme.cfg file
b9fe713d7c27 Created wiki page through web user interface.
henrik.rostedt
parents:
diff changeset
     2
746
d53a01a00832 Theme: Reduce header level by 1
Wuzzy
parents: 490
diff changeset
     3
= `theme.cfg` =
1019
0f9e43961b7e ThemeCfg: link back to Themes
Wuzzy
parents: 1011
diff changeset
     4
The file `theme.cfg` gives the engine the values associated with a certain theme, to complement the graphics. To understand themes in general, start at [Themes]. To learn more about the general file structure of themes, see [ThemeFiles].
816
08e347c81554 Theme: fixes
Wuzzy
parents: 815
diff changeset
     5
It is structured with a list of keys, each seperated by line breaks. Each key is followed by an equals sign followed a value. The value depends on the key.
815
69b8476b4bb2 Theme: Better example
Wuzzy
parents: 814
diff changeset
     6
69b8476b4bb2 Theme: Better example
Wuzzy
parents: 814
diff changeset
     7
Example:
69b8476b4bb2 Theme: Better example
Wuzzy
parents: 814
diff changeset
     8
<code>sky = 23, 8, 33
69b8476b4bb2 Theme: Better example
Wuzzy
parents: 814
diff changeset
     9
border = 7, 72, 102
69b8476b4bb2 Theme: Better example
Wuzzy
parents: 814
diff changeset
    10
music = Art.ogg</code>
83
b9fe713d7c27 Created wiki page through web user interface.
henrik.rostedt
parents:
diff changeset
    11
814
f0c338d954cb Theme: grammar fix
Wuzzy
parents: 813
diff changeset
    12
There are 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 the graphics quality is reduced.
83
b9fe713d7c27 Created wiki page through web user interface.
henrik.rostedt
parents:
diff changeset
    13
b9fe713d7c27 Created wiki page through web user interface.
henrik.rostedt
parents:
diff changeset
    14
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.
b9fe713d7c27 Created wiki page through web user interface.
henrik.rostedt
parents:
diff changeset
    15
1124
b37c99c55365 ThemeCfg: convert color numbers to hexadecimal form, consistently
Wuzzy
parents: 1123
diff changeset
    16
The values red, green, blue and opacity are in the range of one byte and can be specified in both decimal or hexadecimal form. A hexadecimal number must be prepended with a dollar sign. The range is `0` - `255` or `$00` - `$FF`.
83
b9fe713d7c27 Created wiki page through web user interface.
henrik.rostedt
parents:
diff changeset
    17
463
35d43dbb99ad Clarified comments
almikes@aol.com
parents: 462
diff changeset
    18
Any line can be made into a comment line by having a semicolon (“`;`”) at the beginning. Comments are ignored by Hedgewars.
319
e5542ee81444 Fixed the object entry, as well as some minor fixes.
Caironater@gmail.com
parents: 83
diff changeset
    19
806
366d41a07472 Theme: More about default values
Wuzzy
parents: 805
diff changeset
    20
Literally all lines in the `theme.cfg` file are optional, thus an empty file is valid. Everything has a default value. However, some default values are not really useful (e.g. the water or sky color) and you should therefore explicitly specify enough values.
366d41a07472 Theme: More about default values
Wuzzy
parents: 805
diff changeset
    21
746
d53a01a00832 Theme: Reduce header level by 1
Wuzzy
parents: 490
diff changeset
    22
== `sky` ==
83
b9fe713d7c27 Created wiki page through web user interface.
henrik.rostedt
parents:
diff changeset
    23
The colour of the sky.
b9fe713d7c27 Created wiki page through web user interface.
henrik.rostedt
parents:
diff changeset
    24
319
e5542ee81444 Fixed the object entry, as well as some minor fixes.
Caironater@gmail.com
parents: 83
diff changeset
    25
<code>Values: red, green, blue</code>
83
b9fe713d7c27 Created wiki page through web user interface.
henrik.rostedt
parents:
diff changeset
    26
1124
b37c99c55365 ThemeCfg: convert color numbers to hexadecimal form, consistently
Wuzzy
parents: 1123
diff changeset
    27
<code>Default: $00, $00, $00</code>
806
366d41a07472 Theme: More about default values
Wuzzy
parents: 805
diff changeset
    28
746
d53a01a00832 Theme: Reduce header level by 1
Wuzzy
parents: 490
diff changeset
    29
== `rq-sky` ==
462
4416c2ed13d8 Clarify rq-sky.
almikes@aol.com
parents: 451
diff changeset
    30
The sky color in reduced quality mode. If present, it is used instead of `sky` on low quality.
4416c2ed13d8 Clarify rq-sky.
almikes@aol.com
parents: 451
diff changeset
    31
4416c2ed13d8 Clarify rq-sky.
almikes@aol.com
parents: 451
diff changeset
    32
<code>Values: red, green, blue</code>
433
0661855ab04a Reorganize the page, improve typography, add sd-music.
almikes@aol.com
parents: 320
diff changeset
    33
746
d53a01a00832 Theme: Reduce header level by 1
Wuzzy
parents: 490
diff changeset
    34
== `border` ==
83
b9fe713d7c27 Created wiki page through web user interface.
henrik.rostedt
parents:
diff changeset
    35
The colour of the outline of explosions.
b9fe713d7c27 Created wiki page through web user interface.
henrik.rostedt
parents:
diff changeset
    36
319
e5542ee81444 Fixed the object entry, as well as some minor fixes.
Caironater@gmail.com
parents: 83
diff changeset
    37
<code>Values: red, green, blue</code>
83
b9fe713d7c27 Created wiki page through web user interface.
henrik.rostedt
parents:
diff changeset
    38
1124
b37c99c55365 ThemeCfg: convert color numbers to hexadecimal form, consistently
Wuzzy
parents: 1123
diff changeset
    39
<code>Default: $50, $50, $50</code>
806
366d41a07472 Theme: More about default values
Wuzzy
parents: 805
diff changeset
    40
746
d53a01a00832 Theme: Reduce header level by 1
Wuzzy
parents: 490
diff changeset
    41
== `water-top` ==
433
0661855ab04a Reorganize the page, improve typography, add sd-music.
almikes@aol.com
parents: 320
diff changeset
    42
The colour of the topmost part of the water (under the `BlueWater.png`) before Sudden Death.
1123
02863856f674 ThemeCfg: update default water color in 0.9.23
Wuzzy
parents: 1122
diff changeset
    43
This makes a gradient together with `water-bottom`. The default color is blue and matches the default `BlueColor.png`.
83
b9fe713d7c27 Created wiki page through web user interface.
henrik.rostedt
parents:
diff changeset
    44
319
e5542ee81444 Fixed the object entry, as well as some minor fixes.
Caironater@gmail.com
parents: 83
diff changeset
    45
<code>Values: red, green, blue</code>
83
b9fe713d7c27 Created wiki page through web user interface.
henrik.rostedt
parents:
diff changeset
    46
1123
02863856f674 ThemeCfg: update default water color in 0.9.23
Wuzzy
parents: 1122
diff changeset
    47
<code>Default: $54, $5C, $9D</code>
806
366d41a07472 Theme: More about default values
Wuzzy
parents: 805
diff changeset
    48
746
d53a01a00832 Theme: Reduce header level by 1
Wuzzy
parents: 490
diff changeset
    49
== `water-bottom` ==
433
0661855ab04a Reorganize the page, improve typography, add sd-music.
almikes@aol.com
parents: 320
diff changeset
    50
The colour of the lowest part of the water before Sudden Death.
1123
02863856f674 ThemeCfg: update default water color in 0.9.23
Wuzzy
parents: 1122
diff changeset
    51
This makes a gradient together with `water-top`. The default color is blue and matches the default `BlueColor.png`.
433
0661855ab04a Reorganize the page, improve typography, add sd-music.
almikes@aol.com
parents: 320
diff changeset
    52
0661855ab04a Reorganize the page, improve typography, add sd-music.
almikes@aol.com
parents: 320
diff changeset
    53
<code>Values: red, green, blue</code>
0661855ab04a Reorganize the page, improve typography, add sd-music.
almikes@aol.com
parents: 320
diff changeset
    54
1123
02863856f674 ThemeCfg: update default water color in 0.9.23
Wuzzy
parents: 1122
diff changeset
    55
<code>Default: $34, $3C, $7D</code>
806
366d41a07472 Theme: More about default values
Wuzzy
parents: 805
diff changeset
    56
746
d53a01a00832 Theme: Reduce header level by 1
Wuzzy
parents: 490
diff changeset
    57
== `sd-water-bottom` ==
433
0661855ab04a Reorganize the page, improve typography, add sd-music.
almikes@aol.com
parents: 320
diff changeset
    58
The colour of the lowest part of the water while in Sudden Death.
0661855ab04a Reorganize the page, improve typography, add sd-music.
almikes@aol.com
parents: 320
diff changeset
    59
This makes a gradient together with `sd-water-top`.
806
366d41a07472 Theme: More about default values
Wuzzy
parents: 805
diff changeset
    60
The default color neatly matches the default `SDWater.png`.
83
b9fe713d7c27 Created wiki page through web user interface.
henrik.rostedt
parents:
diff changeset
    61
319
e5542ee81444 Fixed the object entry, as well as some minor fixes.
Caironater@gmail.com
parents: 83
diff changeset
    62
<code>Values: red, green, blue</code>
83
b9fe713d7c27 Created wiki page through web user interface.
henrik.rostedt
parents:
diff changeset
    63
1124
b37c99c55365 ThemeCfg: convert color numbers to hexadecimal form, consistently
Wuzzy
parents: 1123
diff changeset
    64
<code>Default: $96, $70, $A9</code>
806
366d41a07472 Theme: More about default values
Wuzzy
parents: 805
diff changeset
    65
746
d53a01a00832 Theme: Reduce header level by 1
Wuzzy
parents: 490
diff changeset
    66
== `sd-water-top` ==
433
0661855ab04a Reorganize the page, improve typography, add sd-music.
almikes@aol.com
parents: 320
diff changeset
    67
The colour of the topmost part of the water (under the `SDWater.png`) while in Sudden Death.
0661855ab04a Reorganize the page, improve typography, add sd-music.
almikes@aol.com
parents: 320
diff changeset
    68
This makes a gradient together with `sd-water-bottom`.
806
366d41a07472 Theme: More about default values
Wuzzy
parents: 805
diff changeset
    69
The default color neatly matches the default `SDWater.png`.
433
0661855ab04a Reorganize the page, improve typography, add sd-music.
almikes@aol.com
parents: 320
diff changeset
    70
0661855ab04a Reorganize the page, improve typography, add sd-music.
almikes@aol.com
parents: 320
diff changeset
    71
<code>Values: red, green, blue</code>
0661855ab04a Reorganize the page, improve typography, add sd-music.
almikes@aol.com
parents: 320
diff changeset
    72
1124
b37c99c55365 ThemeCfg: convert color numbers to hexadecimal form, consistently
Wuzzy
parents: 1123
diff changeset
    73
<code>Default: $B9, $72, $C9</code>
806
366d41a07472 Theme: More about default values
Wuzzy
parents: 805
diff changeset
    74
746
d53a01a00832 Theme: Reduce header level by 1
Wuzzy
parents: 490
diff changeset
    75
== `water-opacity` ==
806
366d41a07472 Theme: More about default values
Wuzzy
parents: 805
diff changeset
    76
The water opacity before Sudden Death. Opacity of the water affects how visible gears in the water are. `0` makes it fully transparent, whereas `255` or `$FF` makes it fully opaque. If the water is fully opaque, the drowning animation is skipped when a hedgehog drowns.
366d41a07472 Theme: More about default values
Wuzzy
parents: 805
diff changeset
    77
366d41a07472 Theme: More about default values
Wuzzy
parents: 805
diff changeset
    78
In combination with the default `BlueWater.png`, the recommended value for this is `$80`, which also is the default.
83
b9fe713d7c27 Created wiki page through web user interface.
henrik.rostedt
parents:
diff changeset
    79
319
e5542ee81444 Fixed the object entry, as well as some minor fixes.
Caironater@gmail.com
parents: 83
diff changeset
    80
<code>Values: opacity</code>
83
b9fe713d7c27 Created wiki page through web user interface.
henrik.rostedt
parents:
diff changeset
    81
806
366d41a07472 Theme: More about default values
Wuzzy
parents: 805
diff changeset
    82
<code>Default: $80</code>
366d41a07472 Theme: More about default values
Wuzzy
parents: 805
diff changeset
    83
746
d53a01a00832 Theme: Reduce header level by 1
Wuzzy
parents: 490
diff changeset
    84
== `sd-water-opacity` ==
953
2237b516213b Theme: Add water-animation and sd-water-animation
Wuzzy
parents: 952
diff changeset
    85
The water opacity while in Sudden Death. Syntax and default value is equivalent to `water-opacity`.
2237b516213b Theme: Add water-animation and sd-water-animation
Wuzzy
parents: 952
diff changeset
    86
2237b516213b Theme: Add water-animation and sd-water-animation
Wuzzy
parents: 952
diff changeset
    87
== `water-animation` (0.9.23) ==
954
d1d33abc6377 Theme: Clarify water-aimation
Wuzzy
parents: 953
diff changeset
    88
Specified a custom water animation and flowing speed before Sudden Death. By default, the water just moves to the right and has no special animation.
953
2237b516213b Theme: Add water-animation and sd-water-animation
Wuzzy
parents: 952
diff changeset
    89
2237b516213b Theme: Add water-animation and sd-water-animation
Wuzzy
parents: 952
diff changeset
    90
<code>Values: frames, frame ticks, movement speed</code>
433
0661855ab04a Reorganize the page, improve typography, add sd-music.
almikes@aol.com
parents: 320
diff changeset
    91
954
d1d33abc6377 Theme: Clarify water-aimation
Wuzzy
parents: 953
diff changeset
    92
 * `frames`: Number of frames in `BlueWater.png`. The frames in this image should be stacked horizontally. The height of this image must be divisible by `frames`
955
9fb2a1738685 Theme: clarify anim once again
Wuzzy
parents: 954
diff changeset
    93
 * `frame ticks`: Duration of a single frame. Must be >0 if `frames`>1, otherwise it is ignored
954
d1d33abc6377 Theme: Clarify water-aimation
Wuzzy
parents: 953
diff changeset
    94
 * `movement speed`: How fast the water moves to the right. Higher values means faster movement. If negative, it moves to the left. Use 0 to stop movement
803
ef44649bd9df Theme: Explain values syntax everywhere
Wuzzy
parents: 801
diff changeset
    95
953
2237b516213b Theme: Add water-animation and sd-water-animation
Wuzzy
parents: 952
diff changeset
    96
<code>Default: 1, 0, 1</code>
2237b516213b Theme: Add water-animation and sd-water-animation
Wuzzy
parents: 952
diff changeset
    97
2237b516213b Theme: Add water-animation and sd-water-animation
Wuzzy
parents: 952
diff changeset
    98
== `sd-water-animation` (0.9.23) ==
2237b516213b Theme: Add water-animation and sd-water-animation
Wuzzy
parents: 952
diff changeset
    99
Sudden Death equivalent of `water-animation`, uses `SDWater.png`.
806
366d41a07472 Theme: More about default values
Wuzzy
parents: 805
diff changeset
   100
746
d53a01a00832 Theme: Reduce header level by 1
Wuzzy
parents: 490
diff changeset
   101
== `music` ==
812
1538e98a4d03 Theme: music defaults
Wuzzy
parents: 808
diff changeset
   102
Name of the music file to be played in the theme before Sudden Death, e.g. `Nature.ogg`. You find music tracks in `Data/Music` of the Hedgewars installation directory. The file name is case-sensitive!
83
b9fe713d7c27 Created wiki page through web user interface.
henrik.rostedt
parents:
diff changeset
   103
804
ed22ff58ac55 Theme: music/sd-music fix
Wuzzy
parents: 803
diff changeset
   104
<code>Values: filename</code>
83
b9fe713d7c27 Created wiki page through web user interface.
henrik.rostedt
parents:
diff changeset
   105
812
1538e98a4d03 Theme: music defaults
Wuzzy
parents: 808
diff changeset
   106
No music is played by default.
1538e98a4d03 Theme: music defaults
Wuzzy
parents: 808
diff changeset
   107
1141
9d37cc22ae9b ThemeCfg: remove .21 note
Wuzzy
parents: 1138
diff changeset
   108
== `sd-music` ==
812
1538e98a4d03 Theme: music defaults
Wuzzy
parents: 808
diff changeset
   109
Name of the music file to be played in the theme while in Sudden Death, e.g. `hell.ogg`. If `music` was not specified, the Sudden Death has no default music as well. You find music tracks in `Data/Music` of the Hedgewars installation directory. The file name is case-sensitive!
433
0661855ab04a Reorganize the page, improve typography, add sd-music.
almikes@aol.com
parents: 320
diff changeset
   110
804
ed22ff58ac55 Theme: music/sd-music fix
Wuzzy
parents: 803
diff changeset
   111
<code>Values: filename</code>
ed22ff58ac55 Theme: music/sd-music fix
Wuzzy
parents: 803
diff changeset
   112
812
1538e98a4d03 Theme: music defaults
Wuzzy
parents: 808
diff changeset
   113
Default: `sdmusic.ogg` (only if `music` was specified, no music otherwise)
1538e98a4d03 Theme: music defaults
Wuzzy
parents: 808
diff changeset
   114
746
d53a01a00832 Theme: Reduce header level by 1
Wuzzy
parents: 490
diff changeset
   115
== `clouds` ==
807
66e7208703e3 Theme: Default cleanup
Wuzzy
parents: 806
diff changeset
   116
The number of clouds to create, before Sudden Death. Uses `Clouds.png`.
83
b9fe713d7c27 Created wiki page through web user interface.
henrik.rostedt
parents:
diff changeset
   117
319
e5542ee81444 Fixed the object entry, as well as some minor fixes.
Caironater@gmail.com
parents: 83
diff changeset
   118
<code>Values: number</code>
83
b9fe713d7c27 Created wiki page through web user interface.
henrik.rostedt
parents:
diff changeset
   119
807
66e7208703e3 Theme: Default cleanup
Wuzzy
parents: 806
diff changeset
   120
<code>Default: 9</code>
66e7208703e3 Theme: Default cleanup
Wuzzy
parents: 806
diff changeset
   121
746
d53a01a00832 Theme: Reduce header level by 1
Wuzzy
parents: 490
diff changeset
   122
== `sd-clouds` ==
807
66e7208703e3 Theme: Default cleanup
Wuzzy
parents: 806
diff changeset
   123
Number of clouds while in Sudden Death, uses the file `SDClouds.png`. By default it is the same number as `clouds` or `9` if `clouds` was not specified as well.
433
0661855ab04a Reorganize the page, improve typography, add sd-music.
almikes@aol.com
parents: 320
diff changeset
   124
803
ef44649bd9df Theme: Explain values syntax everywhere
Wuzzy
parents: 801
diff changeset
   125
<code>Values: number</code>
ef44649bd9df Theme: Explain values syntax everywhere
Wuzzy
parents: 801
diff changeset
   126
807
66e7208703e3 Theme: Default cleanup
Wuzzy
parents: 806
diff changeset
   127
<code>Default: 9</code>
66e7208703e3 Theme: Default cleanup
Wuzzy
parents: 806
diff changeset
   128
746
d53a01a00832 Theme: Reduce header level by 1
Wuzzy
parents: 490
diff changeset
   129
== `flatten-clouds` ==
464
9a18697ec4ad Add flatten-clouds and flatten-flakes
almikes@aol.com
parents: 463
diff changeset
   130
Normally, the clouds vary in size and are drawn on different layers. But if this key is present (any value) in `theme.cfg`, all clouds have the same size and are on the same layer (background).
9a18697ec4ad Add flatten-clouds and flatten-flakes
almikes@aol.com
parents: 463
diff changeset
   131
746
d53a01a00832 Theme: Reduce header level by 1
Wuzzy
parents: 490
diff changeset
   132
== `flakes` ==
807
66e7208703e3 Theme: Default cleanup
Wuzzy
parents: 806
diff changeset
   133
Values for the flakes of this theme before Sudden Death. Uses `Flake.png`.
433
0661855ab04a Reorganize the page, improve typography, add sd-music.
almikes@aol.com
parents: 320
diff changeset
   134
806
366d41a07472 Theme: More about default values
Wuzzy
parents: 805
diff changeset
   135
 * `number`: Number of visible flakes.
433
0661855ab04a Reorganize the page, improve typography, add sd-music.
almikes@aol.com
parents: 320
diff changeset
   136
 * `frames`: Number of frames used in `Flake.png`
1122
e6d120deeae9 ThemeCfg: rising flakes
Wuzzy
parents: 1121
diff changeset
   137
 * `frame ticks`: Number of ticks a frame is shown, after that the next frame is shown (a tick currently equals 1 millisecond). A value of 0 indicates that each flake should keep displaying the exact frame that was selected randomly when the flake was created.
433
0661855ab04a Reorganize the page, improve typography, add sd-music.
almikes@aol.com
parents: 320
diff changeset
   138
 * `speed`: Rotation speed of flake
1122
e6d120deeae9 ThemeCfg: rising flakes
Wuzzy
parents: 1121
diff changeset
   139
 * `fall speed`: Falling speed of flake. This can also be negative for rising flakes
433
0661855ab04a Reorganize the page, improve typography, add sd-music.
almikes@aol.com
parents: 320
diff changeset
   140
0661855ab04a Reorganize the page, improve typography, add sd-music.
almikes@aol.com
parents: 320
diff changeset
   141
<code>Values: number, frames, frame ticks, speed, fall speed</code>
0661855ab04a Reorganize the page, improve typography, add sd-music.
almikes@aol.com
parents: 320
diff changeset
   142
807
66e7208703e3 Theme: Default cleanup
Wuzzy
parents: 806
diff changeset
   143
No flakes are used by default.
806
366d41a07472 Theme: More about default values
Wuzzy
parents: 805
diff changeset
   144
746
d53a01a00832 Theme: Reduce header level by 1
Wuzzy
parents: 490
diff changeset
   145
== `sd-flakes` ==
1145
006a65f86b5c ThemeCfg: Fix sd-flakes default
Wuzzy
parents: 1142
diff changeset
   146
Sudden Death version of `flakes`, the parameters are the same as in `flakes`. This uses `SDFlake.png`.
433
0661855ab04a Reorganize the page, improve typography, add sd-music.
almikes@aol.com
parents: 320
diff changeset
   147
803
ef44649bd9df Theme: Explain values syntax everywhere
Wuzzy
parents: 801
diff changeset
   148
<code>Values: number, frames, frame ticks, speed, fall speed</code>
ef44649bd9df Theme: Explain values syntax everywhere
Wuzzy
parents: 801
diff changeset
   149
1146
518cb4e4dc76 ThemeCfg: update sd-flakes text
Wuzzy
parents: 1145
diff changeset
   150
If `sd-flakes` is unspecified, skulls and bones are used as images and the following default values are used:
1145
006a65f86b5c ThemeCfg: Fix sd-flakes default
Wuzzy
parents: 1142
diff changeset
   151
806
366d41a07472 Theme: More about default values
Wuzzy
parents: 805
diff changeset
   152
<code>Default: X, 4, 0, 15, 250</code>
366d41a07472 Theme: More about default values
Wuzzy
parents: 805
diff changeset
   153
366d41a07472 Theme: More about default values
Wuzzy
parents: 805
diff changeset
   154
(The “X” means the default number of Sudden Death flakes is variable. It depends on the window size and the terrain width.)
366d41a07472 Theme: More about default values
Wuzzy
parents: 805
diff changeset
   155
1138
b32441125bb8 ThemeCfg: Add sd-tint
Wuzzy
parents: 1124
diff changeset
   156
== `sd-tint` ==
b32441125bb8 ThemeCfg: Add sd-tint
Wuzzy
parents: 1124
diff changeset
   157
Custom tinting of the background in Sudden Death.
b32441125bb8 ThemeCfg: Add sd-tint
Wuzzy
parents: 1124
diff changeset
   158
b32441125bb8 ThemeCfg: Add sd-tint
Wuzzy
parents: 1124
diff changeset
   159
<code>Values: red, green, blue, opacity</code>
b32441125bb8 ThemeCfg: Add sd-tint
Wuzzy
parents: 1124
diff changeset
   160
b32441125bb8 ThemeCfg: Add sd-tint
Wuzzy
parents: 1124
diff changeset
   161
<code>Default: $80, $80, $80, $FF</code>
b32441125bb8 ThemeCfg: Add sd-tint
Wuzzy
parents: 1124
diff changeset
   162
746
d53a01a00832 Theme: Reduce header level by 1
Wuzzy
parents: 490
diff changeset
   163
== `flatten-flakes` ==
464
9a18697ec4ad Add flatten-clouds and flatten-flakes
almikes@aol.com
parents: 463
diff changeset
   164
Normally, the flakes vary in size and are drawn on different layers, some of them even in front of the terrain. But if this key is present (any value) in `theme.cfg`, all flakes have the same size and are on the same layer: In front of the sky and horizont and behind the terrain.
9a18697ec4ad Add flatten-clouds and flatten-flakes
almikes@aol.com
parents: 463
diff changeset
   165
746
d53a01a00832 Theme: Reduce header level by 1
Wuzzy
parents: 490
diff changeset
   166
== `object` ==
319
e5542ee81444 Fixed the object entry, as well as some minor fixes.
Caironater@gmail.com
parents: 83
diff changeset
   167
There may be multiple object keys in the file, each one representing one land object.
83
b9fe713d7c27 Created wiki page through web user interface.
henrik.rostedt
parents:
diff changeset
   168
433
0661855ab04a Reorganize the page, improve typography, add sd-music.
almikes@aol.com
parents: 320
diff changeset
   169
 * `filename`: The object’s filename (without the “.png”). Case-sensitive.
1142
eba210749526 ThemeCfg: fix bracket
Wuzzy
parents: 1141
diff changeset
   170
 * `max`: The maximum number of this object that may be generated in a map (must by between 1 and 32)
1121
0a7925ca59e3 ThemeCfg: update buried rects
Wuzzy
parents: 1019
diff changeset
   171
 * `buriedrects_num`: (optional): Number of rectangles that must be buried in the terrain. If this value is ommitted, a value of 1 is assumed
0a7925ca59e3 ThemeCfg: update buried rects
Wuzzy
parents: 1019
diff changeset
   172
 * `buriedrects`: A rectangle that must be buried in the terrain (`left, top, width, height`). If all 4 values are 0, the object will be placed on top of the water
433
0661855ab04a Reorganize the page, improve typography, add sd-music.
almikes@aol.com
parents: 320
diff changeset
   173
 * `minvisible`: The minimum amount of rectangles that must be visible
990
606b2d0c5a09 Theme: Explain multiple buried rectangles in 0.9.23
Wuzzy
parents: 955
diff changeset
   174
 * `visiblerects`: List of the rectangles for being visible (`left, top, width, height`)
606b2d0c5a09 Theme: Explain multiple buried rectangles in 0.9.23
Wuzzy
parents: 955
diff changeset
   175
1121
0a7925ca59e3 ThemeCfg: update buried rects
Wuzzy
parents: 1019
diff changeset
   176
Syntax when you only need 1 buried rectangle:
319
e5542ee81444 Fixed the object entry, as well as some minor fixes.
Caironater@gmail.com
parents: 83
diff changeset
   177
e5542ee81444 Fixed the object entry, as well as some minor fixes.
Caironater@gmail.com
parents: 83
diff changeset
   178
<code>Values: filename, max, buriedrec, minvisible, visiblerec</code>
83
b9fe713d7c27 Created wiki page through web user interface.
henrik.rostedt
parents:
diff changeset
   179
1121
0a7925ca59e3 ThemeCfg: update buried rects
Wuzzy
parents: 1019
diff changeset
   180
Syntax when you want to use multiple buried rectangles:
990
606b2d0c5a09 Theme: Explain multiple buried rectangles in 0.9.23
Wuzzy
parents: 955
diff changeset
   181
606b2d0c5a09 Theme: Explain multiple buried rectangles in 0.9.23
Wuzzy
parents: 955
diff changeset
   182
<code>Values: filename, max, buriedrects_num, buriedrects, minvisible, visiblerects</code>
606b2d0c5a09 Theme: Explain multiple buried rectangles in 0.9.23
Wuzzy
parents: 955
diff changeset
   183
606b2d0c5a09 Theme: Explain multiple buried rectangles in 0.9.23
Wuzzy
parents: 955
diff changeset
   184
Here's an example where `visiblerects` and the `buriedrects` are visualized on an ancient picture:
808
a6c6a92dc83f Theme: fix image align
Wuzzy
parents: 807
diff changeset
   185
798
30c5f1ebd552 global replace of http with https for hedgewars.org wiki links
nemo
parents: 746
diff changeset
   186
https://hedgewars.org/images/avematantheme/hw-avematan.rects.png
448
e419fde32f07 Adding picture (blashphemy?)
sheepyluva@gmail.com
parents: 438
diff changeset
   187
990
606b2d0c5a09 Theme: Explain multiple buried rectangles in 0.9.23
Wuzzy
parents: 955
diff changeset
   188
The large rectangle shows a `visiblerects` and the small one shows a `buriedrects`.
808
a6c6a92dc83f Theme: fix image align
Wuzzy
parents: 807
diff changeset
   189
746
d53a01a00832 Theme: Reduce header level by 1
Wuzzy
parents: 490
diff changeset
   190
== `spray` ==
83
b9fe713d7c27 Created wiki page through web user interface.
henrik.rostedt
parents:
diff changeset
   191
There may be several spray keys in the file, each one representing one spray object.
472
52bd8ea08f4f Better explanation for the number of sprays.
almikes@aol.com
parents: 466
diff changeset
   192
The `name` is the case-sensitive name of the PNG file (without the file name suffix) of the graphics file, and `number` is the rough number of instances of this spray that may be added to the map. The number is the average number of sprays that are normally placed on a random medium-sized island. For larger and smaller landscapes, this number will be automatically scaled up or down. Please note that this number only specifies a rough goal, the actual number of created sprays may vary and you may have to play a bit with this number in order to find a good value.
83
b9fe713d7c27 Created wiki page through web user interface.
henrik.rostedt
parents:
diff changeset
   193
464
9a18697ec4ad Add flatten-clouds and flatten-flakes
almikes@aol.com
parents: 463
diff changeset
   194
<code>Values: name, number</code>
9a18697ec4ad Add flatten-clouds and flatten-flakes
almikes@aol.com
parents: 463
diff changeset
   195
746
d53a01a00832 Theme: Reduce header level by 1
Wuzzy
parents: 490
diff changeset
   196
== `ice` ==
803
ef44649bd9df Theme: Explain values syntax everywhere
Wuzzy
parents: 801
diff changeset
   197
If this key is present (any value), girders become slippery like ice. This also applies to placed girders. This significantly changes the gameplay of your theme, so use wisely. If this key is not present, the terrain is not slippery.
464
9a18697ec4ad Add flatten-clouds and flatten-flakes
almikes@aol.com
parents: 463
diff changeset
   198
746
d53a01a00832 Theme: Reduce header level by 1
Wuzzy
parents: 490
diff changeset
   199
== `snow` ==
813
f3d77338c4c2 Theme: remove redundant sentences
Wuzzy
parents: 812
diff changeset
   200
If this key is present (any value), the flakes which are normally purely decorational now behave like snowflakes. When they collide with terrain, they become a part of the landscape. This significantly changes the gameplay of your theme, so use wisely. If this key is not present, the flakes are purely decorational.