From c90c389a8a8d9d8661e9772ec4144c5cf2039f23 Mon Sep 17 00:00:00 2001 From: toma Date: Wed, 25 Nov 2009 17:56:58 +0000 Subject: Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. BUG:215923 git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdegames@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da --- doc/ktuberling/index.docbook | 811 +++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 811 insertions(+) create mode 100644 doc/ktuberling/index.docbook (limited to 'doc/ktuberling/index.docbook') diff --git a/doc/ktuberling/index.docbook b/doc/ktuberling/index.docbook new file mode 100644 index 00000000..33b87804 --- /dev/null +++ b/doc/ktuberling/index.docbook @@ -0,0 +1,811 @@ + + + + + + +]> + + + +The &ktuberling; Handbook + + + +Éric +Bischoff + +
&Eric.Bischoff.mail;
+ + + +Paul +E. +Ahlquist +Jr. + +
&Paul.E.Ahlquist.Jr.mail;
+ + + + +Lauri +Watts +Reviewer + + + + + + +2006-05-05 +0.05.01 + + +1999200020022006 +Éric Bischoff + + + +2001 +&Paul.E.Ahlquist.Jr; + + +&FDLNotice; + + + +&ktuberling; is a game intended for small children. + + + + +KDE +KTuberling +game +children +tuberling +potato +penguin +aquarium + + + + +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 <guimenu>Game</guimenu> 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 <guimenu>Edit</guimenu> 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 <guimenu>Playground</guimenu> 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 <guimenu>Speech</guimenu> 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 <guimenu>Settings</guimenu> 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 <guimenu>Help</guimenu> 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 <application>ktuberling</application> + +&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; + + + + + -- cgit v1.2.1