<?xml version="1.0" ?> <!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY kappname "&ktuberling;"> <!ENTITY package "kdegames"> <!ENTITY technical.reference SYSTEM "technical-reference.docbook"> <!ENTITY % addindex "IGNORE"> <!ENTITY % English "INCLUDE" > <!-- change language only here --> ]> <book lang="&language;"> <bookinfo> <title>The &ktuberling; Handbook</title> <authorgroup> <author> <firstname>Éric</firstname><surname>Bischoff</surname> <affiliation><address>&Eric.Bischoff.mail;</address></affiliation> </author> <author> <firstname>Paul</firstname><othername>E.</othername><surname>Ahlquist</surname><lineage>Jr.</lineage> <affiliation><address>&Paul.E.Ahlquist.Jr.mail;</address></affiliation> </author> <author> <firstname>Eugene</firstname><surname>Trounev</surname> <affiliation><address><email>eugene.trounev@gmail.com</email></address></affiliation> </author> <othercredit role="reviewer"> <firstname>Lauri</firstname> <surname>Watts</surname> <contrib>Reviewer</contrib> </othercredit> <!-- TRANS:ROLES_OF_TRANSLATORS --> </authorgroup> <date>2007-11-14</date> <releaseinfo>0.5.1</releaseinfo> <copyright> <year>1999</year><year>2000</year><year>2002</year><year>2006</year> <holder>&Eric.Bischoff;</holder> </copyright> <copyright> <year>2001</year> <holder>&Paul.E.Ahlquist.Jr;</holder> </copyright> <legalnotice>&FDLNotice;</legalnotice> <abstract> <para> &ktuberling; is a game intended for small children. </para> </abstract> <keywordset> <keyword>KDE</keyword> <keyword>KTuberling</keyword> <keyword>game</keyword> <keyword>toy</keyword> <keyword>constructor</keyword> <keyword>doll</keyword> <keyword>decorating</keyword> <keyword>children</keyword> <keyword>tuberling</keyword> <keyword>potato</keyword> <keyword>train station</keyword> <keyword>one player</keyword> </keywordset> </bookinfo> <chapter id="introduction"> <title>Introduction</title> <para>Gametype: Toy</para> <para>Number of possible players: One</para> <para> &ktuberling; a simple constructor game suitable for children and adults alike. The idea of the game is based around a once popular doll making concept. A potato was decorated with various small artifacts to make it look more like a tiny person. &ktuberling; however, goes much further in terms of content and adds a surprising variety of different themes. </para> </chapter> <chapter id="howto"> <title>How to Play</title> <para> <!--<inlinemediaobject><imageobject> <imagedata fileref="ktuberling.png" format="PNG"/></imageobject> </inlinemediaobject>--> &ktuberling; is a game intended for small children. Of course, it may be suitable for adults who have remained young at heart. </para> <para> It is a <quote>potato editor</quote>. 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 other playgrounds with different themes. </para> <para> There is no winner for the game. The only purpose is to make the funniest faces you can. </para> <para> There is a museum (like a <quote>Madame Tusseau</quote> 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, <ulink url="mailto:ebischoff@nerim.net">&Eric.Bischoff;</ulink>, who will include them in the museum if he gets some spare time. </para> <para> &ktuberling; can also <quote>speak</quote>. It will spell out the name of the objects you drag and drop. It will <quote>speak</quote> in a language that you can choose. You can even use it to learn a bit of vocabulary in foreign languages. </para> </chapter> <chapter id="rules_and_tips"> <title>Rules and Tips</title> <sect1 id="mouse-operation"> <title>Mouse Operation</title> <para> There are two areas in the main window: </para> <itemizedlist> <listitem><para><quote>Playground</quote> area. </para></listitem> <listitem><para> <quote>Objects</quote> area, where you select objects to place on your playground. </para></listitem> </itemizedlist> <note><title>Note:</title><para>An actual look of the application screen may change depending on a 'playground' selected.</para></note> <screenshot> <screeninfo>Main Window of &ktuberling;</screeninfo> <mediaobject> <imageobject> <imagedata format="PNG" fileref="gameboard.png"/> </imageobject> <imageobject> <imagedata format="EPS" fileref="gameboard.eps"/> </imageobject> <textobject><phrase>Main Window</phrase></textobject> </mediaobject> </screenshot> <sect2 id="place-object"> <title>Placing an Object</title> <para> To drag an object, move the mouse pointer to the <quote>objects</quote> area and Click on it. Then move it to the <quote>playground</quote> area and click again. <note><title>Note:</title><para>Size of the objects may change while dragging. Some of the oversized objects have been scaled down to feet into the “objects” area.</para></note> </para> </sect2> <sect2 id="move-object"> <title>Moving an Object</title> <para> Once dropped in the <quote>playground</quote> area, an object can be moved. Just click on the object to select it, move it to the new place and click again to drop it. When you drop 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. </para> </sect2> <sect2 id="remove-object"> <title>Removing an Object</title> <para> To remove an object that has been dropped in the <quote>playground</quote> area, drag it back from the <quote>playground</quote> area to the <quote>objects</quote> area. </para> </sect2> </sect1> </chapter> <chapter id="interface"> <title>Interface Overview </title> <sect1 id="the-tool-bar"> <title>The Tool Bar</title> <mediaobject> <imageobject> <imagedata format="PNG" fileref="toolbar.png"/> </imageobject> <imageobject> <imagedata format="EPS" fileref="toolbar.eps"/> </imageobject> <textobject><phrase>Toolbar</phrase></textobject> </mediaobject> <para> The toolbar provides buttons for the commonly used functions. </para> <table> <title>Toolbar Buttons</title> <tgroup cols="4"> <thead> <row> <entry>Button</entry> <entry>Name</entry> <entry>Menu Equivalent</entry> <entry>Action</entry> </row> </thead> <tbody> <row> <entry> <inlinemediaobject> <imageobject> <imagedata format="PNG" fileref="button-new.png"/> </imageobject> <imageobject> <imagedata format="EPS" fileref="button.new.eps"/> </imageobject> <textobject><phrase>New Game Button</phrase></textobject> </inlinemediaobject> </entry> <entry> <guiicon>New</guiicon></entry> <entry> <link linkend="game-new"><menuchoice> <guimenu>Game</guimenu> <guimenuitem>New</guimenuitem></menuchoice> </link> </entry> <entry> Resets the <quote>playground</quote> area. This cleans all parts of the playground so a new decoration may be created. </entry> </row> <row> <entry> <inlinemediaobject> <imageobject> <imagedata format="PNG" fileref="button-open.png"/> </imageobject> <imageobject> <imagedata format="EPS" fileref="button.open.eps"/> </imageobject> <textobject><phrase>Load Button</phrase></textobject> </inlinemediaobject> </entry> <entry><guiicon>Load</guiicon></entry> <entry> <link linkend="game-load"><menuchoice> <guimenu>Game</guimenu> <guimenuitem>Load...</guimenuitem></menuchoice> </link> </entry> <entry> Opens an existing tuberling file from the museum or from other folders. </entry> </row> <row> <entry> <inlinemediaobject> <imageobject> <imagedata format="PNG" fileref="button-save.png"/> </imageobject> <imageobject> <imagedata format="EPS" fileref="button.save.eps"/> </imageobject> <textobject><phrase>Save Button</phrase></textobject> </inlinemediaobject> </entry> <entry><guiicon>Save</guiicon></entry> <entry> <link linkend="game-save"><menuchoice> <guimenu>Game</guimenu> <guimenuitem>Save</guimenuitem></menuchoice> </link> </entry> <entry> 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. </entry> </row> <row> <entry> <inlinemediaobject> <imageobject> <imagedata format="PNG" fileref="button-print.png"/> </imageobject> <imageobject> <imagedata format="EPS" fileref="button.print.eps"/> </imageobject> <textobject><phrase>Print Button</phrase></textobject> </inlinemediaobject> </entry> <entry> <guiicon>Print</guiicon> </entry> <entry> <link linkend="game-print"><menuchoice> <guimenu>Game</guimenu> <guimenuitem>Print...</guimenuitem></menuchoice> </link> </entry> <entry> Prints your picture. </entry> </row> <row> <entry> <inlinemediaobject> <imageobject> <imagedata format="PNG" fileref="button-undo.png"/> </imageobject> <imageobject> <imagedata format="EPS" fileref="button.undo.eps"/> </imageobject> <textobject><phrase>Undo Button</phrase></textobject> </inlinemediaobject> </entry> <entry> <guiicon>Undo</guiicon> </entry> <entry> <link linkend="edit-undo"><menuchoice> <guimenu>Edit</guimenu> <guimenuitem>Undo</guimenuitem></menuchoice> </link> </entry> <entry>Undoes last operation.</entry> </row> <row> <entry> <inlinemediaobject> <imageobject> <imagedata format="PNG" fileref="button-redo.png"/> </imageobject> <imageobject> <imagedata format="EPS" fileref="button.redo.eps"/> </imageobject> <textobject><phrase>Redo Button</phrase></textobject> </inlinemediaobject> </entry> <entry> <guiicon>Redo</guiicon> </entry> <entry> <link linkend="edit-redo"><menuchoice> <guimenu>Edit</guimenu> <guimenuitem>Redo</guimenuitem></menuchoice> </link> </entry> <entry> Re-does last operation.</entry> </row> <!-- Currently there is no HELP button on the toolbar <row> <entry> <inlinemediaobject> <imageobject> <imagedata format="PNG" fileref="button-help.png"/> </imageobject> <imageobject> <imagedata format="EPS" fileref="button.help.eps"/> </imageobject> <textobject><phrase>Help Button</phrase></textobject> </inlinemediaobject> </entry> <entry> Help </entry> <entry>Displays this handbook.</entry> </row> --> </tbody> </tgroup> </table> </sect1> <sect1 id="the-menu-items"> <title>The Menu Items</title> <sect2> <title>The <guimenu>Game</guimenu> Menu</title> <mediaobject> <imageobject> <imagedata format="PNG" fileref="menu-game.png"/> </imageobject> <imageobject> <imagedata format="EPS" fileref="menu.game.eps"/> </imageobject> <textobject><phrase><guimenu>Game</guimenu> Menu</phrase></textobject> </mediaobject> <variablelist> <varlistentry id="game-new"> <term><menuchoice> <shortcut> <keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo> </shortcut> <guimenu>Game</guimenu> <guimenuitem>New</guimenuitem> </menuchoice></term> <listitem><para><action>Clears</action> the <quote>playground</quote> area </para></listitem> </varlistentry> <varlistentry id="game-load"> <term><menuchoice> <shortcut> <keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo> </shortcut> <guimenu>Game</guimenu> <guimenuitem>Load...</guimenuitem> </menuchoice></term> <listitem><para><action>Opens an existing tuberling file</action> from the museum or from somewhere else if you wish.</para></listitem> </varlistentry> <varlistentry id="game-save"> <term><menuchoice> <shortcut> <keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo> </shortcut> <guimenu>Game</guimenu> <guimenuitem>Save</guimenuitem> </menuchoice></term> <listitem><para><action>Saves</action> your creation. The tuberling is saved to a small file where only the position of objects are saved. </para></listitem> </varlistentry> <varlistentry id="game-save-as-picture"> <term><menuchoice> <guimenu>Game</guimenu> <guimenuitem>Save as Picture...</guimenuitem> </menuchoice></term> <listitem><para><action>Creates a graphics file</action> containing a picture of your tuberling. </para></listitem> </varlistentry> <varlistentry id="game-print"> <term><menuchoice> <shortcut> <keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo> </shortcut> <guimenu>Game</guimenu> <guimenuitem>Print...</guimenuitem> </menuchoice></term> <listitem><para><action>Prints</action> your tuberling picture. </para></listitem> </varlistentry> <varlistentry> <term><menuchoice> <shortcut> <keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo> </shortcut> <guimenu>Game</guimenu> <guimenuitem>Quit</guimenuitem> </menuchoice></term> <listitem><para><action>Quit</action> &ktuberling;. </para></listitem> </varlistentry> </variablelist> </sect2> <sect2> <title>The <guimenu>Edit</guimenu> Menu</title> <mediaobject> <imageobject> <imagedata format="PNG" fileref="menu-edit.png"/> </imageobject> <imageobject> <imagedata format="EPS" fileref="menu.edit.eps"/> </imageobject> <textobject><phrase>Edit Menu</phrase></textobject> </mediaobject> <variablelist> <varlistentry id="edit-undo"> <term><menuchoice> <shortcut> <keycombo action="simul">&Ctrl;<keycap>Z</keycap></keycombo> </shortcut> <guimenu>Edit</guimenu> <guimenuitem>Undo</guimenuitem> </menuchoice></term> <listitem><para><action>Undo</action> the last <quote>object</quote> placement. </para></listitem> </varlistentry> <varlistentry id="edit-redo"> <term><menuchoice> <shortcut> <keycombo action="simul">&Ctrl;&Shift; <keycap>Z</keycap></keycombo> </shortcut> <guimenu>Edit</guimenu> <guimenuitem>Redo</guimenuitem> </menuchoice></term> <listitem><para><action>Re-does</action> the last <quote>object</quote> placement. This menu option is active only if you have previously used <guilabel>Undo</guilabel>. </para></listitem> </varlistentry> <varlistentry> <term><menuchoice> <shortcut> <keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo> </shortcut> <guimenu>Edit</guimenu> <guimenuitem>Copy</guimenuitem> </menuchoice></term> <listitem><para><action>Copy</action> the <quote>playground</quote> area to the clipboard.</para></listitem> </varlistentry> </variablelist> </sect2> <sect2> <title>The <guimenu>Playground</guimenu> Menu</title> <variablelist> <varlistentry id="theme_change"> <term><menuchoice> <guimenu>Playground</guimenu> <guimenuitem>Playground Name</guimenuitem> </menuchoice></term> <listitem><para><action>Switches to the playground</action>. </para></listitem> </varlistentry> </variablelist> <para> It will contain the playgrounds installed in your system. </para> <para> &ktuberling; remembers the last chosen playground the next time it starts up. </para> </sect2> <sect2> <title>The <guimenu>Speech</guimenu> Menu</title> <!--<para> Please note that you need to have <command>&phonon;</command> installed and properly configured to be able to hear sounds. </para>--> <variablelist> <varlistentry> <term><menuchoice> <guimenu>Speech</guimenu> <guimenuitem>No Sound</guimenuitem> </menuchoice></term> <listitem><para><action>Toggles sound off</action>.</para></listitem> </varlistentry> <varlistentry> <term><menuchoice> <guimenu>Speech</guimenu> <guimenuitem>Language Name</guimenuitem> </menuchoice></term> <listitem><para><action>Toggles sound on and speaks the selected language</action>. </para></listitem> </varlistentry> </variablelist> <para> &ktuberling; remembers of this option the next time it starts up. </para> </sect2> <sect2 id="settings"> <title>The <guimenu>Settings</guimenu> Menu</title> <mediaobject> <imageobject> <imagedata format="PNG" fileref="menu-settings.png"/> </imageobject> <textobject><phrase>Settings Menu</phrase></textobject> </mediaobject> <variablelist> <varlistentry> <term><menuchoice> <guimenu>Settings</guimenu> <guimenuitem>Show Toolbar</guimenuitem> </menuchoice></term> <listitem><para><action>Toggle the Toolbar display</action> on and off. </para></listitem> </varlistentry> <varlistentry> <term><menuchoice> <shortcut> <keycombo action="simul">&Ctrl;&Shift;<keycap>F</keycap></keycombo> </shortcut> <guimenu>Settings</guimenu> <guimenuitem>Full Screen Mode</guimenuitem> </menuchoice></term> <listitem><para><action>Toggles the Full Screen mode</action> on and off. </para></listitem> </varlistentry> <varlistentry> <term><menuchoice> <guimenu>Settings</guimenu> <guimenuitem>Configure Shortcuts...</guimenuitem> </menuchoice></term> <listitem><para>Opens a standard &kde; shortcut configuration dialog, where you can change the keyboard shortcuts used by &ktuberling;. </para></listitem> </varlistentry> <varlistentry> <term><menuchoice> <guimenu>Settings</guimenu> <guimenuitem>Configure Toolbars...</guimenuitem> </menuchoice></term> <listitem><para>Display the standard &kde; toolbar configuration dialog.</para></listitem> </varlistentry> </variablelist> </sect2> <sect2> <title>The <guimenu>Help</guimenu> Menu</title> <mediaobject> <imageobject> <imagedata format="PNG" fileref="menu-help.png"/> </imageobject> <imageobject> <imagedata format="EPS" fileref="menu.help.eps"/> </imageobject> <textobject><phrase>Help Menu</phrase></textobject> </mediaobject> &help.menu.documentation; </sect2> </sect1> </chapter> <chapter id="faq"> <title>Frequently Asked Questions</title> <qandaset> <qandaentry> <question><para>I want to change the way this game looks. Can I? </para></question> <answer><para>Yes you can. Refer to <link linkend="theme_change">this</link> section of 'Interface Overview' for details.</para></answer> </qandaentry> <qandaentry> <question><para>Can I use the keyboard to play this game? </para></question> <answer><para>No. This game cannot be played using keyboard.</para></answer> </qandaentry> <qandaentry> <question><para>I have made a great picture and I want to share it with my friends. Can I save it as an image?</para></question> <answer><para>Yes. To save the current session as an image refer to <link linkend="game-save-as-picture">this</link> section of 'Interface Overview' for details.</para></answer> </qandaentry> </qandaset> </chapter> &technical.reference; <chapter id="credits_license"> <title>Credits and License</title> <para>&ktuberling;</para> <itemizedlist> <listitem> <para>John Calhoun - Original idea, original pictures and English sounds</para> </listitem> <listitem> <para>&Eric.Bischoff; &Eric.Bischoff.mail; - &kde; Programming</para> </listitem> <listitem> <para>François-Xavier Duranceau <email>duranceau@free.fr</email> - Tests, advice and help</para> </listitem> <listitem> <para>Peter Silva <email>peter.silva@videotron.ca</email> - Proofreading of the documentation</para> </listitem> <listitem> <para>Paul Ahlquist &Paul.E.Ahlquist.Jr.mail; - Bettering of documentation</para> </listitem> </itemizedlist> <!-- TRANS:CREDIT_FOR_TRANSLATORS --> &underFDL; &underGPL; </chapter> </book>