# The &ktuberling; Handbook

## Introduction

&ktuberling; is a game intended for small children. Of course, it may be suitable for adults who have remained young at heart.

It is a potato editor. That means that you can drag and drop eyes, mouths, mustache, and other parts of face and goodies onto a potato-like guy. Similarly, you have a penguin and an aquarium on which you can drop other stuff.

There is no winner for the game. The only purpose is to make the funniest faces you can.

There is a museum (like a Madame Tusseau gallery) where you can find many funny examples of decorated potatoes, penguins and aquariums. Of course, you can send your own creations to the programmer, Éric Bischoff, who will include them in the museum if he gets some spare time.

&ktuberling; can also speak. It will spell out the name of the objects you drag and drop. It will speak in a language that you can chose. You can even use it to learn a bit of vocabulary in foreign languages. Currently, &ktuberling; can speak Danish, German, English, Spanish, French, Italian, Dutch, Portuguese, Romanian, Serbian, Slovak, Slovenian and Swedish.

## On Screen Fundamentals

### Mouse Operation

There are two areas in the main window:

- Playground area, on the left side.

- Objects area, on the right side, where you select objects to place on your playground.

Main Window of &ktuberling; Main Window

#### Placing an Object

To drag an object, move the mouse pointer to the objects area on the right. Click on the object you want to drag, but do not release the mouse button until you have moved the mouse pointer to the location in the playground area where you want to drop the object.

#### Moving an Object

Once dropped in the playground area, an object can be moved. Just click on the object to select it for further drag and drop. When you click on it, it goes on top of other objects that were partially hiding it. This trick is useful for getting the glasses and eyes placed correctly.

#### Removing an Object

To remove an object that has been dropped in the playground area, drag it back from the playground area to the objects area.

### The Tool Bar

Toolbar

The toolbar provides buttons for the commonly used functions.

### Toolbar Buttons

Button | Name | Menu Equivalent | Action
New Game Button | New | Game New | Resets the playground area. This cleans all parts off the playground so a new decoration may be created.
Load Button | Load | Game Load... | Opens an existing tuberling file from the museum or from other folders.
Save Button | Save | Game Save | Saves your creation to your home folder, or to some other folder like the museum if you wish. The tuberling is saved to a small file where only the position of objects are saved.
Print Button | Print | Game Print | Prints your picture (&PostScript; format).
Undo Button | Undo | Edit Undo | Undoes last operation.
Redo Button | Redo | Edit Redo | Re-does last operation.

### The Menu Items

Menu Bar

#### The Game Menu

File Menu

&Ctrl;N Game New

- Clears the playground area

&Ctrl;O Game Load...

- Opens an existing tuberling file from the museum or from somewhere else if you wish.

&Ctrl;S Game Save

- Saves your creation. The tuberling is saved to a small file where only the position of objects are saved.

Game Save as Picture...

- Creates a graphics file containing a picture of your tuberling. Available file formats are XPM, JPEG, PNG and BMP.

&Ctrl;P Game Print...

- Print your tuberling picture using &PostScript; format.

&Ctrl;Q Game Quit

- Quit &ktuberling;.

#### The Edit Menu

Edit Menu

&Ctrl;Z Edit Undo

- Undo the last object placement.

&Ctrl;Shift Z Edit Redo

- Re-does the last object placement. This menu option is active only if you have previously used Undo.

&Ctrl;C Edit Copy

- Copy the playground area to the clipboard.

#### The Playground Menu

Playground Menu

Playground Potato Guy

- Switches to potato playground. &ktuberling; remembers the last chosen playground the next time it starts up.

Playground Penguin

- Switches to penguin playground. &ktuberling; remembers the last chosen playground the next time it starts up.

Playground Aquarium

- Switches to aquarium playground. &ktuberling; remembers the last chosen playground the next time it starts up.

#### The Speech Menu

Speech Menu

Please note that you need to have kdemultimedia installed and `&artsd;` running to be able to hear sounds.

Speech No Sound

- Toggles sound off. &ktuberling; remembers of this option the next time it starts up.

Speech Danish

- Toggles sound on and speaks Danish. If Danish sounds are not installed then this option is grayed out. &ktuberling; remembers of this option the next time it starts up.

Speech German

- Toggles sound on and speaks German. If German sounds are not installed then this option is grayed out. &ktuberling; remembers of this option the next time it starts up.

Speech English

- Toggles sound on and speaks English. If English sounds are not installed then this option is grayed out. &ktuberling; remembers of this option the next time it starts up.

etc...

- Same for the other languages.

#### The Settings Menu

Settings Menu

Settings Show/Hide Toolbar

- Toggle the Toolbar display on and off.

Settings Configure Shortcuts...

- Opens a standard &kde; shortcut configuration dialog, where you can change the keyboard shortcuts used by &ktuberling;.

Settings Configure Toolbars...

- Display the standard &kde; toolbar configuration dialog.

#### The Help Menu

Help Menu &help.menu.documentation;
&technical.reference;

## Credits and License

&ktuberling;

- John Calhoun - Original idea, original pictures and English sounds

- Éric Bischoff &Eric.Bischoff.mail; - &kde; Programming

- François-Xavier Duranceau duranceau@free.fr - Tests, advice and help

- Agnieszka Czajkowska agnieszka@imagegalaxy.de - Penguin graphics

- Bas Willems next@euronet.nl - Graphics reworks and aquarium theme

- Roger Larsson roger.larsson@norran.net - Sounds tuning

- Dolores Almansa dolores.almansa@corazondemaria.org - Educative graphics for COR-EDUX initiative

- Peter Silva peter.silva@videotron.ca - Proofreading of the documentation

- Paul Ahlquist &Paul.E.Ahlquist.Jr.mail; - Bettering of documentation

This game is dedicated to my little daughter Sunniva Bischoff

Thanks to Apple Computer and to the &LinuxPPC; project for having made ports of &Linux; to the &Mac;. &ktuberling; would never have existed without that!

&underFDL; &underGPL;

## Installation

### How to obtain ktuberling

&install.intro.documentation;

### Requirements

In order to successfully compile &ktuberling;, you need &kde; 3.5. All required libraries as well as &ktuberling; itself can be found on &kde-ftp;.

To be able to hear the sounds, you need to have kdemultimedia installed.

### Compilation and Installation

&install.compile.documentation;