Next: , Previous: Map options.xml, Up: Reference


4.10 Map style.xml

4.10.1 background-color-alternate-bg

— Command-line option: --background-color-alternate-bg=<value>
— Environment variable: LW6_BACKGROUND_COLOR_ALTERNATE_BG
— XML key: background-color-alternate-bg

Defines a color which will be used together with background-color-alternate-fg to draw things (animations, sprites, text, whatever) in the background. It should be different enough from background-color-alternate-fg so that one can really distinguish these colors. Will be automatically guessed from the map texture if background-color-auto is set. Can be #RGB, #RGBA, #RRGGBB or #RRGGBBAA.

4.10.2 background-color-alternate-fg

— Command-line option: --background-color-alternate-fg=<value>
— Environment variable: LW6_BACKGROUND_COLOR_ALTERNATE_FG
— XML key: background-color-alternate-fg

Defines a color which will be used to draw things (animations, sprites, text, whatever) in the background. It should be different enough from background-color-alternate-bg so that one can really distinguish these colors. Think of this as the sprite, the text, the whatever-needs-to-be-seen-uses-this color. Will be automatically guessed from the map texture if background-color-auto is set. Can be #RGB, #RGBA, #RRGGBB or #RRGGBBAA.

4.10.3 background-color-auto

— Command-line option: --background-color-auto=<value>
— Environment variable: LW6_BACKGROUND_COLOR_AUTO
— XML key: background-color-auto

Defines wether background colors should be set automatically from texture colors. If set to true, then the program will try to pick up colors automatically from the texture, and will override the values of the background-color-base-bg, background-color-base-fg, background-color-alternate-bg and background-color-alternate-fg parameters. How these colors are picked up can't be garanteed, so if the map does not have strong contrast or if there can be any form of ambiguity, it's safe to set this to false and define one's own colors.

4.10.4 background-color-base-bg

— Command-line option: --background-color-base-bg=<value>
— Environment variable: LW6_BACKGROUND_COLOR_BASE_BG
— XML key: background-color-base-bg

Defines the main background color. This is, for instance, the color which will be used to clear the screen before drawing thing. Will be automatically guessed from the map texture if background-color-auto is set. Can be #RGB, #RGBA, #RRGGBB or #RRGGBBAA.

4.10.5 background-color-base-fg

— Command-line option: --background-color-base-fg=<value>
— Environment variable: LW6_BACKGROUND_COLOR_BASE_FG
— XML key: background-color-base-fg

Defines a color which will be used together with background-color-base-bg to compose the background. It can be wise to have a minimum contrast between this color and background-color-base-bg, but it is not mandatory, especially if other colors are manually redefined. Will be automatically guessed from the map texture if background-color-auto is set. Can be #RGB, #RGBA, #RRGGBB or #RRGGBBAA.

4.10.6 background-density

— Command-line option: --background-density=<value>
— Environment variable: LW6_BACKGROUND_DENSITY
— XML key: background-density

Density of the background animation, that is, for instance, if the background animation is about displaying bubbles, using a high value will display many bubbles. A value of 1.0 corresponds to the default setting.

4.10.7 background-speed

— Command-line option: --background-speed=<value>
— Environment variable: LW6_BACKGROUND_SPEED
— XML key: background-speed

Speed of the background animation, that is, for instance, if the background animation is about displaying bubbles, using a high value will cause bubbles to move very fast. A value of 1.0 corresponds to the default setting.

4.10.8 background-style

— Command-line option: --background-style=<value>
— Environment variable: LW6_BACKGROUND_STYLE
— XML key: background-style

The background defines, of course, what is displayed at the background, but it also conditions the colors used for other items, such as the menus for instance. Possible values include 'bubbles', 'air', 'fire', 'earth' and 'void'.

4.10.9 colorize-background

— Command-line option: --colorize-background=<value>
— Environment variable: LW6_COLORIZE_BACKGROUND
— XML key: colorize-background

If set, then all background drawings including textures will use the bakground colors. This means, for instance, that if background colors are set automatically by background-color-auto from the map texture, then the background will adopt the same range of colors than the map itself. In short, the background will mimic the map.

4.10.10 fighter-scale

— Command-line option: --fighter-scale=<value>
— Environment variable: LW6_FIGHTER_SCALE
— XML key: fighter-scale

Defines how wide (in pixels) fighters must be. This parameter is very important and will largely condition the number of fighters on the map. It is used when loading the map. If it is, for instance, set to 1, there will be exactly a fighter per pixel on the screen. That is, if you play 640x480 on an empty map, the maximum fighters you could have is about 300000. The idea is that by changing the resolution, you also define the density of the map. In pratice, this is done in the hope that someone with a slow computer will pick up a low resolution and therefore play small levels. Conversely, someone with a brand new computer with powerfull CPU & GPU will use great resolutions and be happy with many fighters on the map. Still, changing the resolution after loading the map will not affet the number of fighters. Same for network games, the first player, who loads the map, defines its properties according to its own settings.

4.10.11 hud-color-auto

— Command-line option: --hud-color-auto=<value>
— Environment variable: LW6_HUD_COLOR_AUTO
— XML key: hud-color-auto

Defines wether hud colors will be set automatically from background colors. This is a time saver to keep map designers from requiring to redefined every single color in the game. You only need to set background-color-base-bg, background-color-base-fg, background-color-alternate-bg and background-color-alternate-fg. Then hud_color_frame_bg, hud_color_frame_fg, hud_color_text_bg and hud_color_text_fg will be automatically set.

4.10.12 hud-color-frame-bg

— Command-line option: --hud-color-frame-bg=<value>
— Environment variable: LW6_HUD_COLOR_FRAME_BG
— XML key: hud-color-frame-bg

Defines the background color for the hud frame. Ignored if hud-color-auto is set. Can be #RGB, #RGBA, #RRGGBB or #RRGGBBAA.

4.10.13 hud-color-frame-fg

— Command-line option: --hud-color-frame-fg=<value>
— Environment variable: LW6_HUD_COLOR_FRAME_FG
— XML key: hud-color-frame-fg

Defines the foreground color for the hud frame. Ignored if hud-color-auto is set. Can be #RGB, #RGBA, #RRGGBB or #RRGGBBAA.

4.10.14 hud-color-text-bg

— Command-line option: --hud-color-text-bg=<value>
— Environment variable: LW6_HUD_COLOR_TEXT_BG
— XML key: hud-color-text-bg

Defines the background color for hud text. Ignored if hud-color-auto is set. Can be #RGB, #RGBA, #RRGGBB or #RRGGBBAA.

4.10.15 hud-color-text-fg

— Command-line option: --hud-color-text-fg=<value>
— Environment variable: LW6_HUD_COLOR_TEXT_FG
— XML key: hud-color-text-fg

Defines the foreground color for hud text. Ignored if hud-color-auto is set. Can be #RGB, #RGBA, #RRGGBB or #RRGGBBAA.

4.10.16 hud-style

— Command-line option: --hud-style=<value>
— Environment variable: LW6_HUD_STYLE
— XML key: hud-style

The hud is where informations about the game are displayed. This means, who is winning, are other status-like informations. Possible values include 'floating' and 'tactical'.

4.10.17 keep-ratio

— Command-line option: --keep-ratio=<value>
— Environment variable: LW6_KEEP_RATIO
— XML key: keep-ratio

Defines wether the map should keep its ratio, or if it should be stretched to fill the shape of your screen.

4.10.18 menu-color-auto

— Command-line option: --menu-color-auto=<value>
— Environment variable: LW6_MENU_COLOR_AUTO
— XML key: menu-color-auto

Defines wether menu colors will be set automatically from background colors. This is a time saver to keep map designers from requiring to redefined every single color in the game. You only need to set background-color-base-bg, background-color-base-fg, background-color-alternate-bg and background-color-alternate-fg. Then menu_color_default_bg, menu_color_default_fg, menu_color_selected_bg, menu_color_selected_fg, menu_color_disabled_bg and menu_color_disabled_fg will be automatically set.

4.10.19 menu-color-default-bg

— Command-line option: --menu-color-default-bg=<value>
— Environment variable: LW6_MENU_COLOR_DEFAULT_BG
— XML key: menu-color-default-bg

Defines the default background color for menus. Ignored if menu-color-auto is set. Can be #RGB, #RGBA, #RRGGBB or #RRGGBBAA.

4.10.20 menu-color-default-fg

— Command-line option: --menu-color-default-fg=<value>
— Environment variable: LW6_MENU_COLOR_DEFAULT_FG
— XML key: menu-color-default-fg

Defines the default foreground color for menus. In fact, this is the main color for menu text, the color used to draw letters in menus. Ignored if menu-color-auto is set. Can be #RGB, #RGBA, #RRGGBB or #RRGGBBAA.

4.10.21 menu-color-disabled-bg

— Command-line option: --menu-color-disabled-bg=<value>
— Environment variable: LW6_MENU_COLOR_DISABLED_BG
— XML key: menu-color-disabled-bg

Defines the background color for a disabled menu item. Ignored if menu-color-auto is set. Can be #RGB, #RGBA, #RRGGBB or #RRGGBBAA.

4.10.22 menu-color-disabled-fg

— Command-line option: --menu-color-disabled-fg=<value>
— Environment variable: LW6_MENU_COLOR_DISABLED_FG
— XML key: menu-color-disabled-fg

Defines the foreground color for a disabled menu item. Ignored if menu-color-auto is set. Can be #RGB, #RGBA, #RRGGBB or #RRGGBBAA.

4.10.23 menu-color-selected-bg

— Command-line option: --menu-color-selected-bg=<value>
— Environment variable: LW6_MENU_COLOR_SELECTED_BG
— XML key: menu-color-selected-bg

Defines the background color for a selected menu item. Ignored if menu-color-auto is set. Can be #RGB, #RGBA, #RRGGBB or #RRGGBBAA.

4.10.24 menu-color-selected-fg

— Command-line option: --menu-color-selected-fg=<value>
— Environment variable: LW6_MENU_COLOR_SELECTED_FG
— XML key: menu-color-selected-fg

Defines the foreground color for a selected menu item. Ignored if menu-color-auto is set. Can be #RGB, #RGBA, #RRGGBB or #RRGGBBAA.

4.10.25 menu-style

— Command-line option: --menu-style=<value>
— Environment variable: LW6_MENU_STYLE
— XML key: menu-style

The menu style is simply the name of the engine used to power the menu system. The only possible value, for now, is 'cylinder'.

4.10.26 system-color-auto

— Command-line option: --system-color-auto=<value>
— Environment variable: LW6_SYSTEM_COLOR_AUTO
— XML key: system-color-auto

Defines wether system colors will be set automatically from background colors. This is a time saver to keep map designers from requiring to redefined every single color in the game. You only need to set background-color-base-bg, background-color-base-fg, background-color-alternate-bg and background-color-alternate-fg. Then system_color_bg and system_color_fg will be automatically set.

4.10.27 system-color-bg

— Command-line option: --system-color-bg=<value>
— Environment variable: LW6_SYSTEM_COLOR_BG
— XML key: system-color-bg

Defines the system background color, used when displaying system info, such as the number of frames per second. Can be #RGB, #RGBA, #RRGGBB or #RRGGBBAA.

4.10.28 system-color-fg

— Command-line option: --system-color-fg=<value>
— Environment variable: LW6_SYSTEM_COLOR_FG
— XML key: system-color-fg

Defines the system foreground color, used when displaying system info, such as the number of frames per second. This will typically be text color. Can be #RGB, #RGBA, #RRGGBB or #RRGGBBAA.

4.10.29 team-color-blue

— Command-line option: --team-color-blue=<value>
— Environment variable: LW6_TEAM_COLOR_BLUE
— XML key: team-color-blue

Defines the color for the blue team. Syntax is HTML-like, #RGB or #RRGGBB.

4.10.30 team-color-cyan

— Command-line option: --team-color-cyan=<value>
— Environment variable: LW6_TEAM_COLOR_CYAN
— XML key: team-color-cyan

Defines the color for the cyan team. Syntax is HTML-like, #RGB or #RRGGBB.

4.10.31 team-color-green

— Command-line option: --team-color-green=<value>
— Environment variable: LW6_TEAM_COLOR_GREEN
— XML key: team-color-green

Defines the color for the green team. Syntax is HTML-like, #RGB or #RRGGBB.

4.10.32 team-color-lightblue

— Command-line option: --team-color-lightblue=<value>
— Environment variable: LW6_TEAM_COLOR_LIGHTBLUE
— XML key: team-color-lightblue

Defines the color for the light blue team. Syntax is HTML-like, #RGB or #RRGGBB.

4.10.33 team-color-magenta

— Command-line option: --team-color-magenta=<value>
— Environment variable: LW6_TEAM_COLOR_MAGENTA
— XML key: team-color-magenta

Defines the color for the magenta team. Syntax is HTML-like, #RGB or #RRGGBB.

4.10.34 team-color-orange

— Command-line option: --team-color-orange=<value>
— Environment variable: LW6_TEAM_COLOR_ORANGE
— XML key: team-color-orange

Defines the color for the orange team. Syntax is HTML-like, #RGB or #RRGGBB.

4.10.35 team-color-pink

— Command-line option: --team-color-pink=<value>
— Environment variable: LW6_TEAM_COLOR_PINK
— XML key: team-color-pink

Defines the color for the pink team. Syntax is HTML-like, #RGB or #RRGGBB.

4.10.36 team-color-purple

— Command-line option: --team-color-purple=<value>
— Environment variable: LW6_TEAM_COLOR_PURPLE
— XML key: team-color-purple

Defines the color for the purple team. Syntax is HTML-like, #RGB or #RRGGBB.

4.10.37 team-color-red

— Command-line option: --team-color-red=<value>
— Environment variable: LW6_TEAM_COLOR_RED
— XML key: team-color-red

Defines the color for the red team. Syntax is HTML-like, #RGB or #RRGGBB.

4.10.38 team-color-yellow

— Command-line option: --team-color-yellow=<value>
— Environment variable: LW6_TEAM_COLOR_YELLOW
— XML key: team-color-yellow

Defines the color for the yellow team. Syntax is HTML-like, #RGB or #RRGGBB.

4.10.39 use-texture

— Command-line option: --use-texture=<value>
— Environment variable: LW6_USE_TEXTURE
— XML key: use-texture

Defines wether the map texture should be used. Of course if there's no map texture, the texture... won't be used. But if there is one, this parameter will force the game to ignore it and play with solid colors. This probably won't look as nice as the textured map in most cases, but some players might find it more readable and confortable to play when throwing eye candy away.

4.10.40 view-color-auto

— Command-line option: --view-color-auto=<value>
— Environment variable: LW6_VIEW_COLOR_AUTO
— XML key: view-color-auto

Defines wether view colors will be set automatically from background colors. This is a time saver to keep map designers from requiring to redefined every single color in the game. You only need to set background-color-base-bg, background-color-base-fg, background-color-alternate-bg and background-color-alternate-fg. Then view_color_cursor_bg, view_color_cursor_fg, view_color_map_bg and view_color_map_fg will be automatically set.

4.10.41 view-color-cursor-bg

— Command-line option: --view-color-cursor-bg=<value>
— Environment variable: LW6_VIEW_COLOR_CURSOR_BG
— XML key: view-color-cursor-bg

Defines the background cursor color. Will typically be used to draw the shape of the cursor. Ignored if view-color-auto is set. Can be #RGB, #RGBA, #RRGGBB or #RRGGBBAA.

4.10.42 view-color-cursor-fg

— Command-line option: --view-color-cursor-fg=<value>
— Environment variable: LW6_VIEW_COLOR_CURSOR_FG
— XML key: view-color-cursor-fg

Defines the foreground cursor color. Will typically be used to draw text in the cursor. Ignored if view-color-auto is set. Can be #RGB, #RGBA, #RRGGBB or #RRGGBBAA.

4.10.43 view-color-map-bg

— Command-line option: --view-color-map-bg=<value>
— Environment variable: LW6_VIEW_COLOR_MAP_BG
— XML key: view-color-map-bg

Defines the background map color. If there's no map texture defined or if use-texture is false, this is the color of the places where armies will go. Ignored if view-color-auto is set. Can be #RGB, #RGBA, #RRGGBB or #RRGGBBAA.

4.10.44 view-color-map-fg

— Command-line option: --view-color-map-fg=<value>
— Environment variable: LW6_VIEW_COLOR_MAP_FG
— XML key: view-color-map-fg

Defines the foreground map color. If there's no map texture defined or if use-texture is false, this is the color of walls, what armies can't go through. Ignored if view-color-auto is set. Can be #RGB, #RGBA, #RRGGBB or #RRGGBBAA.

4.10.45 view-style

— Command-line option: --view-style=<value>
— Environment variable: LW6_VIEW_STYLE
— XML key: view-style

The view style conditions which renderer is used for the map, the area where fighters are displayed. This is not the graphics backend. Indeed, the graphics backend defines which technical tool one uses (which library) one runs, wether this parameter says what kind of rendering one wants.

4.10.46 zoom

— Command-line option: --zoom=<value>
— Environment variable: LW6_ZOOM
— XML key: zoom

Defines the map zoom. If lower than 1.0, map will occupy only a fraction of the screen, if greater than 1.0, some areas will be outside the screen, and the player will need to scroll through it.