Warning, /games/ktuberling/doc/index.docbook is written in an unsupported language. File is not indexed.

0001 <?xml version="1.0" ?>
0002 <!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd" [
0003   <!ENTITY i18n-ktuberling "Potato Guy">
0004 
0005   <!ENTITY technical.reference SYSTEM "technical-reference.docbook">
0006   <!ENTITY % addindex "IGNORE">
0007   <!ENTITY % English "INCLUDE" > <!-- change language only here -->
0008 ]>
0009 
0010 <book id="ktuberling" lang="&language;">
0011 <bookinfo>
0012 <title>The &ktuberling; Handbook</title>
0013 <authorgroup>
0014 
0015 <author>
0016 <firstname>√Čric</firstname><surname>Bischoff</surname>
0017 <affiliation><address>&Eric.Bischoff.mail;</address></affiliation>
0018 </author>
0019 
0020 <author>
0021 <firstname>Paul</firstname><othername>E.</othername><surname>Ahlquist</surname><lineage>Jr.</lineage>
0022 <affiliation><address>&Paul.E.Ahlquist.Jr.mail;</address></affiliation>
0023 </author>
0024 
0025 <author>
0026 <firstname>Eugene</firstname><surname>Trounev</surname>
0027 <affiliation><address><email>eugene.trounev@gmail.com</email></address></affiliation>
0028 </author>
0029 
0030 <othercredit role="reviewer">
0031 <firstname>Lauri</firstname>
0032 <surname>Watts</surname>
0033 <contrib>Reviewer</contrib>
0034 </othercredit>
0035 
0036 <!-- TRANS:ROLES_OF_TRANSLATORS -->
0037 
0038 </authorgroup>
0039 
0040 <date>2021-10-04</date>
0041 <releaseinfo>KDE Gear 21.08</releaseinfo>
0042 
0043 <copyright>
0044 <year>1999</year><year>2000</year><year>2002</year><year>2006</year>
0045 <holder>&Eric.Bischoff;</holder>
0046 </copyright>
0047 
0048 <copyright>
0049 <year>2001</year>
0050 <holder>&Paul.E.Ahlquist.Jr;</holder>
0051 </copyright>
0052 
0053 <legalnotice>&FDLNotice;</legalnotice>
0054 
0055 <abstract>
0056 <para>
0057 &i18n-ktuberling; is a game intended for small children.
0058 </para>
0059 </abstract>
0060 
0061 <keywordset>
0062 <keyword>KDE</keyword>
0063 <keyword>KTuberling</keyword>
0064 <keyword>game</keyword>
0065 <keyword>toy</keyword>
0066 <keyword>constructor</keyword>
0067 <keyword>doll</keyword>
0068 <keyword>decorating</keyword>
0069 <keyword>children</keyword>
0070 <keyword>tuberling</keyword>
0071 <keyword>potato</keyword>
0072 <keyword>train station</keyword>
0073 <keyword>one player</keyword>
0074 </keywordset>
0075 </bookinfo>
0076 
0077 <chapter id="introduction">
0078 <title>Introduction</title>
0079 <para>Gametype: Toy</para>
0080 <para>Number of possible players: One</para>
0081 
0082 <screenshot>
0083 <mediaobject>
0084 <imageobject>
0085 <imagedata fileref="ktuberling-pizzeria.png" format="PNG"/>
0086 </imageobject>
0087 <textobject>
0088 <phrase>Pizzeria Playground</phrase>
0089 </textobject>
0090 </mediaobject>
0091 </screenshot>
0092 
0093 <para>
0094 &i18n-ktuberling; is 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. &i18n-ktuberling; however, goes much further in terms of content and adds a surprising variety of different themes.
0095 </para>
0096 </chapter>
0097 
0098 <chapter id="howto">
0099 <title>How to Play</title>
0100 
0101 <para>
0102 &i18n-ktuberling; is a game intended for small children. Of course, it may be
0103 suitable for adults who have remained young at heart.
0104 </para>
0105 
0106 <para>
0107 It is a <quote>potato editor</quote>. That means that you can drag and drop
0108 eyes, mouths, mustache, and other parts of face and goodies onto a potato-like
0109 guy. Similarly, you have other playgrounds with different themes.
0110 </para>
0111 
0112 <para>
0113 There is no winner for the game. The only purpose is to make the funniest faces
0114 you can.
0115 </para>
0116 
0117 <para>
0118 &i18n-ktuberling; can also <quote>speak</quote>. It will spell out the name of
0119 the objects you drag and drop. It will <quote>speak</quote> in a language
0120 that you can choose. You can even use it to learn a bit of vocabulary
0121 in foreign languages.
0122 </para>
0123 </chapter>
0124 
0125 <chapter id="rules_and_tips">
0126 <title>Rules and Tips</title>
0127 
0128 <sect1 id="mouse-operation">
0129 <title>Mouse Operation</title>
0130 
0131 <para>
0132 There are two areas in the main window:
0133 </para>
0134 
0135 <itemizedlist>
0136 <listitem><para><quote>Playground</quote> area.
0137 </para></listitem>
0138 <listitem><para>
0139 <quote>Objects</quote> area, where you select objects to
0140 place on your playground.
0141 </para></listitem>
0142 </itemizedlist>
0143 <note><para>An actual look of the application screen may change depending on a <quote>playground</quote> selected.</para></note>
0144 <screenshot>
0145 <screeninfo>Main Window of &i18n-ktuberling;</screeninfo>
0146 <mediaobject>
0147 <imageobject>
0148 <imagedata format="PNG" fileref="gameboard.png"/>
0149 </imageobject>
0150 <textobject><phrase>Main Window</phrase></textobject>
0151 </mediaobject>
0152 </screenshot>
0153 
0154 <sect2 id="place-object">
0155 <title>Placing an Object</title>
0156 
0157 <para>
0158 To drag an object, move the mouse pointer to the <quote>objects</quote>
0159 area and click on it. Then move it to the <quote>playground</quote> area
0160 and click again.
0161 <note><para>Size of the objects may change while dragging. Some of the oversized objects have been scaled down to feet into the <quote>objects</quote> area.</para></note>
0162 </para>
0163 </sect2>
0164 
0165 <sect2 id="move-object">
0166 <title>Moving an Object</title>
0167 <para>
0168 Once dropped in the <quote>playground</quote> area, an object can be moved.
0169 Just click on the object to select it, move it to the new place and click again
0170 to drop it. When you drop it, it goes on top of other objects that were partially hiding it.
0171 This trick is useful for getting the glasses and eyes placed correctly.
0172 </para>
0173 </sect2>
0174 
0175 <sect2 id="remove-object">
0176 <title>Removing an Object</title>
0177 <para>
0178 To remove an object that has been dropped in the <quote>playground</quote>
0179 area, drag it back from the <quote>playground</quote> area to the
0180 <quote>objects</quote> area.
0181 </para>
0182 </sect2>
0183 </sect1>
0184 </chapter>
0185 
0186 <chapter id="interface">
0187 <title>Interface Overview </title>
0188 <sect1 id="the-tool-bar">
0189 <title>The Tool Bar</title>
0190 
0191 <para>
0192 The toolbar provides buttons for the commonly used functions.
0193 </para>
0194 
0195 <table>
0196 <title>Toolbar Buttons</title>
0197 <tgroup cols="4">
0198 
0199   <thead>
0200     <row>
0201       <entry>Button&nbsp;</entry>
0202       <entry>Name&nbsp;</entry>
0203       <entry>Menu Equivalent&nbsp;</entry>
0204       <entry>Action</entry>
0205     </row>
0206   </thead>
0207 <tbody>
0208   <row>
0209     <entry>
0210       <inlinemediaobject>
0211         <imageobject><imagedata format="PNG" fileref="document-new.png"/></imageobject>
0212         <textobject><phrase>New Game Button</phrase></textobject>
0213       </inlinemediaobject>
0214     </entry>
0215     <entry><guiicon>New</guiicon></entry>
0216     <entry><link linkend="game-new"><menuchoice>
0217     <guimenu>Game</guimenu> <guimenuitem>New</guimenuitem></menuchoice></link></entry>
0218     <entry>Resets the <quote>playground</quote> area. This cleans all parts of the
0219     playground so a new decoration may be created.</entry>
0220   </row>
0221 
0222   <row>
0223     <entry>
0224       <inlinemediaobject>
0225         <imageobject><imagedata format="PNG" fileref="document-open.png"/></imageobject>
0226         <textobject><phrase>Load Button</phrase></textobject>
0227       </inlinemediaobject>
0228     </entry>
0229     <entry><guiicon>Load...</guiicon></entry>
0230     <entry><link linkend="game-load"><menuchoice>
0231     <guimenu>Game</guimenu> <guimenuitem>Load...</guimenuitem></menuchoice></link></entry>
0232     <entry>Opens an existing <literal role="extension">.tuberling</literal> file from the disk.</entry>
0233   </row>
0234 
0235   <row>
0236     <entry>
0237       <inlinemediaobject>
0238         <imageobject><imagedata format="PNG" fileref="document-save.png"/></imageobject>
0239         <textobject><phrase>Save Button</phrase></textobject>
0240       </inlinemediaobject>
0241     </entry>
0242     <entry><guiicon>Save</guiicon></entry>
0243     <entry><link linkend="game-save"><menuchoice>
0244     <guimenu>Game</guimenu> <guimenuitem>Save</guimenuitem></menuchoice></link></entry>
0245     <entry>Saves your creation to your home folder, or to some other folder
0246     on your disk. The <literal role="extension">.tuberling</literal>
0247     is saved to a small file where only the position of objects are saved.</entry>
0248   </row>
0249 
0250   <row>
0251     <entry>
0252       <inlinemediaobject>
0253         <imageobject><imagedata format="PNG" fileref="document-print.png"/></imageobject>
0254         <textobject><phrase>Print Button</phrase></textobject>
0255       </inlinemediaobject>
0256     </entry>
0257     <entry><guiicon>Print...</guiicon></entry>
0258     <entry><link linkend="game-print"><menuchoice>
0259     <guimenu>Game</guimenu> <guimenuitem>Print...</guimenuitem></menuchoice></link></entry>
0260     <entry>Prints your picture.</entry>
0261   </row>
0262 
0263   <row>
0264     <entry>
0265       <inlinemediaobject>
0266         <imageobject><imagedata format="PNG" fileref="edit-undo.png"/></imageobject>
0267         <textobject><phrase>Undo Button</phrase></textobject>
0268       </inlinemediaobject>
0269     </entry>
0270     <entry><guiicon>Undo</guiicon></entry>
0271     <entry><link linkend="edit-undo"><menuchoice>
0272     <guimenu>Edit</guimenu> <guimenuitem>Undo</guimenuitem></menuchoice></link></entry>
0273     <entry>Undoes last operation.</entry>
0274   </row>
0275 
0276   <row>
0277     <entry>
0278       <inlinemediaobject>
0279         <imageobject><imagedata format="PNG" fileref="edit-redo.png"/></imageobject>
0280         <textobject><phrase>Redo Button</phrase></textobject>
0281       </inlinemediaobject>
0282     </entry>
0283     <entry><guiicon>Redo</guiicon></entry>
0284     <entry><link linkend="edit-redo"><menuchoice>
0285     <guimenu>Edit</guimenu> <guimenuitem>Redo</guimenuitem></menuchoice></link></entry>
0286     <entry>Re-does last operation.</entry>
0287   </row>
0288 
0289 </tbody>
0290 </tgroup>
0291 </table>
0292 </sect1>
0293 
0294 <sect1 id="the-menu-items">
0295 <title>The Menu Items</title>
0296 
0297 <sect2>
0298 <title>The Game Menu</title>
0299 
0300 <variablelist>
0301 
0302   <varlistentry id="game-new">
0303     <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo> </shortcut>
0304     <guimenu>Game</guimenu>
0305     <guimenuitem>New</guimenuitem></menuchoice></term>
0306     <listitem><para><action>Clears</action> the <quote>playground</quote> area.</para></listitem>
0307   </varlistentry>
0308 
0309   <varlistentry id="game-load">
0310     <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo> </shortcut>
0311     <guimenu>Game</guimenu>
0312     <guimenuitem>Load...</guimenuitem></menuchoice></term>
0313     <listitem><para><action>Opens an existing <literal role="extension">.tuberling</literal> file</action>
0314     from your disk.</para></listitem>
0315   </varlistentry>
0316 
0317   <varlistentry id="game-save">
0318     <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo> </shortcut>
0319     <guimenu>Game</guimenu>
0320     <guimenuitem>Save</guimenuitem></menuchoice></term>
0321     <listitem><para><action>Saves</action> your creation. The tuberling is saved
0322     to a small file where only the position of objects are saved.</para></listitem>
0323   </varlistentry>
0324 
0325   <varlistentry id="game-save-as-picture">
0326     <term><menuchoice><guimenu>Game</guimenu>
0327     <guimenuitem>Save as Picture...</guimenuitem></menuchoice></term>
0328     <listitem><para><action>Creates a graphics file</action> containing a picture
0329     of your tuberling.</para></listitem>
0330   </varlistentry>
0331 
0332   <varlistentry id="game-print">
0333     <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo> </shortcut>
0334     <guimenu>Game</guimenu>
0335     <guimenuitem>Print...</guimenuitem></menuchoice></term>
0336     <listitem><para><action>Prints</action> your tuberling picture.</para></listitem>
0337   </varlistentry>
0338 
0339   <varlistentry>
0340     <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo> </shortcut>
0341     <guimenu>Game</guimenu>
0342     <guimenuitem>Quit</guimenuitem></menuchoice></term>
0343     <listitem><para><action>Quit</action> &i18n-ktuberling;.</para></listitem>
0344   </varlistentry>
0345 
0346 </variablelist>
0347 </sect2>
0348 
0349 <sect2>
0350 <title>The Edit Menu</title>
0351 
0352 <variablelist>
0353 
0354   <varlistentry id="edit-undo">
0355     <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>Z</keycap></keycombo> </shortcut>
0356     <guimenu>Edit</guimenu>
0357     <guimenuitem>Undo</guimenuitem></menuchoice></term>
0358     <listitem><para><action>Undo</action> the last <quote>object</quote>
0359     placement.</para></listitem>
0360   </varlistentry>
0361 
0362   <varlistentry id="edit-redo">
0363     <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;&Shift;<keycap>Z</keycap></keycombo> </shortcut>
0364     <guimenu>Edit</guimenu>
0365     <guimenuitem>Redo</guimenuitem></menuchoice></term>
0366     <listitem><para><action>Re-does</action> the last <quote>object</quote>
0367     placement.  This menu option is active only if you have previously used
0368     <guilabel>Undo</guilabel>.</para></listitem>
0369   </varlistentry>
0370 
0371   <varlistentry>
0372     <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo> </shortcut>
0373     <guimenu>Edit</guimenu>
0374     <guimenuitem>Copy</guimenuitem></menuchoice></term>
0375     <listitem><para><action>Copy</action> the <quote>playground</quote> area to the
0376     clipboard.</para></listitem>
0377   </varlistentry>
0378 
0379 </variablelist>
0380 </sect2>
0381 
0382 <sect2>
0383 <title>The View Menu</title>
0384 
0385 <variablelist>
0386 
0387   <varlistentry>
0388     <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;&Shift;<keycap>F</keycap></keycombo> </shortcut>
0389     <guimenu>View</guimenu>
0390     <guimenuitem>Full Screen Mode</guimenuitem></menuchoice></term>
0391     <listitem><para>Toggles the graphic interface to full screen mode.</para></listitem>
0392   </varlistentry>
0393 
0394 </variablelist>
0395 </sect2>
0396 
0397 <sect2>
0398 <title>The Playground Menu</title>
0399 
0400 <variablelist>
0401 
0402   <varlistentry>
0403     <term><menuchoice><guimenu>Playground</guimenu>
0404     <guimenuitem>Lock Aspect Ratio</guimenuitem></menuchoice></term>
0405     <listitem><para>This option preserves the playground aspect ratio when resizing
0406     the &i18n-ktuberling; window. When the playground aspect ratio does not match the one
0407     of the window the background is filled with the one specified in the theme.</para></listitem>
0408   </varlistentry>
0409 
0410   <varlistentry id="theme_change">
0411     <term><menuchoice>
0412     <guimenu>Playground</guimenu>
0413     <guimenuitem><replaceable>Playground Name</replaceable></guimenuitem></menuchoice></term>
0414     <listitem><para><action>Switches to the playground</action>.</para></listitem>
0415   </varlistentry>
0416 
0417 </variablelist>
0418 
0419 <para>
0420 It will contain the playgrounds installed in your system.
0421 </para>
0422 <para>
0423 &i18n-ktuberling; remembers the last chosen playground the next time it starts up.
0424 </para>
0425 </sect2>
0426 
0427 <sect2>
0428 <title>The Speech Menu</title>
0429 
0430 <variablelist>
0431 
0432   <varlistentry>
0433     <term><menuchoice><guimenu>Speech</guimenu>
0434     <guimenuitem>No Sound</guimenuitem></menuchoice></term>
0435     <listitem><para><action>Toggles sound off</action>.</para></listitem>
0436   </varlistentry>
0437 
0438   <varlistentry>
0439     <term><menuchoice><guimenu>Speech</guimenu>
0440     <guimenuitem><replaceable>Language Name</replaceable></guimenuitem></menuchoice></term>
0441     <listitem><para><action>Toggles sound on and speaks the selected language</action>.</para></listitem>
0442   </varlistentry>
0443 
0444 </variablelist>
0445 
0446 <para>
0447 &i18n-ktuberling; remembers of this option the next time it starts up.
0448 </para>
0449 </sect2>
0450 
0451 <sect2 id="settings">
0452 <title>The Settings and Help Menus</title>
0453 
0454 <para>
0455 Additionally &i18n-ktuberling; has the common &kde; <guimenu>Settings</guimenu> and <guimenu>Help</guimenu>
0456 menu items, for more information read the sections about the
0457 <ulink url="help:/fundamentals/menus.html#menus-settings">Settings Menu</ulink> and
0458 <ulink url="help:/fundamentals/menus.html#menus-help">Help Menu</ulink>
0459 of the &kde; Fundamentals.
0460 </para>
0461 
0462 </sect2>
0463 </sect1>
0464 </chapter>
0465 
0466 <chapter id="faq">
0467 <title>Frequently Asked Questions</title>
0468 
0469 <qandaset>
0470 <qandaentry>
0471  <question><para>I want to change the way this game looks. Can I? </para></question>
0472  <answer><para>Yes you can. Refer to <link linkend="theme_change">this</link> section of 'Interface Overview' for details.</para></answer>
0473 </qandaentry>
0474 <qandaentry>
0475  <question><para>Can I use the keyboard to play this game? </para></question>
0476  <answer><para>No. This game cannot be played using keyboard.</para></answer>
0477 </qandaentry>
0478 <qandaentry>
0479  <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>
0480   <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>
0481 </qandaentry>
0482 </qandaset>
0483 </chapter>
0484 
0485 &technical.reference;
0486 
0487 <chapter id="credits_license">
0488 <title>Credits and License</title>
0489 
0490 <para>&ktuberling;</para>
0491 
0492 <itemizedlist>
0493 <listitem>
0494 <para>Alex Fiestas <email>alex@eyeos.org</email> - current Maintainer</para>
0495 </listitem>
0496 
0497 <listitem>
0498 <para>John Calhoun - Original idea, original pictures and English
0499 sounds</para>
0500 </listitem>
0501 
0502 <listitem>
0503 <para>&Eric.Bischoff; &Eric.Bischoff.mail; - &kde;
0504 Programming</para>
0505 </listitem>
0506 
0507 <listitem>
0508 <para>Fran&ccedil;ois-Xavier Duranceau <email>duranceau@free.fr</email> - Tests,
0509 advice and help</para>
0510 </listitem>
0511 
0512 <listitem>
0513 <para>Peter Silva <email>peter.silva@videotron.ca</email> - Proofreading of
0514 the documentation</para>
0515 </listitem>
0516 
0517 <listitem>
0518 <para>&Paul.E.Ahlquist.Jr; &Paul.E.Ahlquist.Jr.mail; - Bettering of
0519 documentation</para>
0520 </listitem>
0521 </itemizedlist>
0522 
0523 <!-- TRANS:CREDIT_FOR_TRANSLATORS -->
0524 
0525 &underFDL;
0526 &underGPL;
0527 
0528 </chapter>
0529 
0530 </book>