THEMES IN BOMBER
----------------

This file explains the format of the themes used by bomber.

For each theme in Bomber their is a "*.desktop" file in the area
kdegames/Bomber/themes in the KDE SVN source-code repository, or in the
area $HOME/.kde/share/apps/Bomber/themes, the user's local data area. If 
two *.desktop files have the same name, the one in the local area takes
precedence.

Files in the SVN area are released and installed with Bomber.  Files in
the local area can be used for development and testing of themes or for holding
downloaded and copied themes, whatever the method of transfer or copying.  One
of the theme files is called "default.desktop".  That theme is used whenever
the game runs for the first time for a particular user.  On subsequent
occasions the last-used theme is loaded.

Each *.desktop file must start with the "group" line, which says
[KGameTheme].  There must also be a line which gives the name of the theme
(e.g. Name=Foo Bar).  That line gets picked up and translated into various
languages.  Some other standard (but optional) lines are: 
Description=...,
FileName=...,
Author=..., 
AuthorEmail=...  and 
VersionFormat=...
A line can also be added to display a preview of the theme in the GUI, such as
Preview=foobar.png. This will display the foobar.png found next to the *.desktop
file in the GUI when selecting the theme.

SVG THEMES
----------

SVG themes are the standard for Bomber. All the in game objects in Bomber are 
themeable though the SVG themes. The *.desktop file must contain a FileName=xxxx 
line, that contains the filename   in witch the SVG graphics for the game 
objects are stored. The filenames must end in .svg or .svgz and the file must 
be in or relative to the same folder as the *.desktop file.

Example, theme-file "default.desktop":
[KGameTheme]
VersionFormat=1
Name=Default
Name[gl]=Predeterminado
Name[it]=Predefinito
Name[wa]=Prémetou
FileName=default_theme.svg
Author=John-Paul Stanford
[email protected]
Preview=default_preview.png

Note that Name and Description have been translated. 

SVG ELEMENTS
------------

The elements in the SVG file must have standard names, corresponding to their
role in the Bomber game.  Each element should be set in a rectangle space.  
The size of the element will change depending on the size of game window. The 
tiles are resized so that game area is 12 tiles wide and 20 tiles high.
The elements are:
	background		The game area background
	building_s_v	A tile used to make up the body of a building. (s = style
					of building (0...x), v=variant of the tile (0..x))
	bomb_n			A set of frames bomb's dropped from the plane 
	                (n = frame number (0...x))
	bomb_explode_n	The explosion when a bomb hits a building
	plane_n			A set of frames for the plane
	                (n = frame number (0...x))
	plane_explode_n	A set of frames for the explosion when a plane crashes into 
	                a building. (n = frame number (0...x))
	roof_s_v		A tile used for the roof of buildings. (s = style of 
	                building (0...x), v=variant of the tile (0..x))

The background element is not tiled like the others.  It will be displayed
behind the other elements and scaled fill the game area.  It could be stretched
further in either direction, at the user's whim, and will always fill the 
central widget.  The actual play-area will always be 12 x 20 tiles.

The tiles (bomb_n, plane_n,bomb_explode_n and plane_explode_n) all can be 
animated. The n in the objects id should be replaced with the number of the
frames. A frame set can have as many frames as the theme creator wishes, but
they should be numbered sequentially starting from 0. For example "bomb_0, bomb_1, bomb_2"
would greate a set of frames for the bomb with 3 frames. 

The building tiles (building_s_v and roof_s_v) do not have frames, but instead
thet have styles (s) and variant's (v). A building is made up from multiple tiles 
all having the same style. However the building can also have variant's of it's
tile to make each tile in a single building slight different.