Technical reference
Prev
Next

Chapter 3. Technical reference

Éric Bischoff

Revision 0.05.01 (2006-05-05)

KTuberling offers a gentle and rewarding introduction to KDE customization and programming. The application can be extended. For example, without any coding, new playgrounds can be added by changing the graphics files. By adding appropriate sound files, translators can change the sounds to their native tongue!

If you extend or add to the game please consider sending your additions to the developer Éric Bischoff for inclusion in future releases.

For artists

The size and shape of the playground and the number of objects can be changed. New playgrounds can be added. Only two image files need to be created for each playground: a gameboard and a mask. A maximum of 8 playgrounds is allowed, out of which only 3 are currently used.

Six images are used in KTuberling: potato-game.png, potato-mask.png, penguin-game.png, penguin-mask.png, aquarium-game.png and aquarium-mask.png. The standard location for these files is the folder $TDEDIR/share/apps/ktuberling/pics/.

The first type of images, *-game.png holds the playground and the objects that the user selects. This is the graphic that the user sees when playing the game.

The second type of images, *-mask.png, contains only masks of the objects. The masks are used to delimit the borders of the objects and, in some cases, give the object some transparency (for example, the spectacles). It is mandatory to put the objects at the same position in the gameboard file as in the mask file.

In the same folder, a file named layout.xml. ($TDEDIR/share/apps/ktuberling/pics/layout.xml) tells which images to use and links them to menu entries. It also contains the position parameters of the playground and the objects in the gameboard and in the masks. It assigns the sounds to objects and places the objects in groups. It finally declares languages as sets of translated sounds. It follows standard XML syntax (see details below).

Still in the same folder, a file named layout.i18n ($TDEDIR/share/apps/ktuberling/pics/layout.xml) recapitulates the strings in layout.xml that can be translated:

  • The menu entries that allow to choose the playground and the language

  • The names of the categories of objects

One folder above, a file named ktuberlingui.rc ($TDEDIR/share/apps/ktuberling/ktuberlingui.rc) is a second XML file describing the menus of KTuberling. It should contain one <action> tag per playground and language. The symbolic name of the action in this file should be identical to the symbolic name of the action in layout.xml.

Prev
Next
Home


Would you like to comment or contribute an update to this page?
Send feedback to the TDE Development Team