ThemeCfg.wiki
changeset 1313 fa362f7bacbd
parent 1312 73191c174bf5
child 1314 fa3ef0be3f4e
equal deleted inserted replaced
1312:73191c174bf5 1313:fa362f7bacbd
     1 #summary Structure of the theme.cfg file
     1 #summary Structure of the theme.cfg file
     2 
     2 
     3 = `theme.cfg` =
     3 = `theme.cfg` =
       
     4 <wiki:toc max_depth="3" />
       
     5 
     4 == Syntax ==
     6 == Syntax ==
     5 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].
     7 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].
     6 It is structured with a list of keys, each separated by line breaks. Each key is followed by an equals sign followed a value. The value depends on the key.
     8 It is structured with a list of keys, each separated by line breaks. Each key is followed by an equals sign followed a value. The value depends on the key.
     7 
     9 
     8 Example:
    10 Example:
    17 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`.
    19 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`.
    18 
    20 
    19 Any line can be made into a comment line by having a semicolon (“`;`”) at the beginning. Comments are ignored by Hedgewars.
    21 Any line can be made into a comment line by having a semicolon (“`;`”) at the beginning. Comments are ignored by Hedgewars.
    20 
    22 
    21 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.
    23 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.
    22 
       
    23 <wiki:toc max_depth="3" />
       
    24 
    24 
    25 == Keys ==
    25 == Keys ==
    26 === General configuration ===
    26 === General configuration ===
    27 ==== `hidden` (0.9.24) ====
    27 ==== `hidden` (0.9.24) ====
    28 If this key is present in `theme.cfg` (the value does not matter), the theme will be hidden from the theme selection menu. Background themes *must* be hidden.
    28 If this key is present in `theme.cfg` (the value does not matter), the theme will be hidden from the theme selection menu. Background themes *must* be hidden.