<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
 <!ENTITY kappname "&kblackbox;">
 <!ENTITY package "kdegames">
 <!ENTITY % addindex "IGNORE">
 <!ENTITY % German "INCLUDE"
> <!-- change language only here -->
]>

<book lang="&language;">

<bookinfo>
<title
>Das Handbuch zu &kblackbox;</title>
    
<authorgroup>
<author
>&Robert.Cimrman; &Robert.Cimrman.mail; </author>

<author
>&Philip.Rodrigues; &Philip.Rodrigues.mail; </author>

<othercredit role="developer"
>&Robert.Cimrman; &Robert.Cimrman.mail; </othercredit>

<othercredit role="reviewer"
>&Lauri.Watts; &Lauri.Watts.mail; </othercredit>

<othercredit role="translator"
><firstname
>Maren</firstname
><surname
>Pakura</surname
><affiliation
><address
><email
>maren@kde.org</email
></address
></affiliation
><contrib
>Deutsche Übersetzung</contrib
></othercredit
> 

</authorgroup>

<copyright>
<year
>1998</year
><year
>2000</year>
<holder
>&Robert.Cimrman;</holder>
</copyright>

<copyright>
<year
>2001-2003</year>
<holder
>&Philip.Rodrigues;</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

<date
>2005-12-10</date>
<releaseinfo
>0.3.0</releaseinfo>

<abstract
><para
>&kblackbox; ist ein Logik-Spiel für &kde;, angeregt durch das <application
>emacs</application
>-Spiel Blackbox.</para
></abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>KBlackBox</keyword>
<keyword
>kdegames</keyword>
<keyword
>Blackbox</keyword>
<keyword
>Spiel</keyword>
</keywordset>

</bookinfo>

<chapter id="what-is-kblackbox">
<title
>Was ist &kblackbox;?</title>

<para
>&kblackbox; ist ein Logik-Spiel, angeregt durch das <application
>emacs</application
>-Spiel Blackbox. Ein Großteil des Handbuchs basiert auf der ursprünglichen <application
>emacs</application
>-Hilfe. </para>

<para
>&kblackbox; ist ein Versteckspiel, das auf einem Gitter von Schachteln gespielt wird. Der Gegner (in diesem Fall der Zufallsgenerator) hat Kugeln in diesen Schachteln versteckt. Um die Kugeln zu entdecken, schießen Sie Lichtstrahlen in die Schachteln und beobachten den Verlauf der Strahlen. Je weniger Lichtstrahlen Sie dafür benötigen, um so besser (geringer) ist Ihre Punktzahl.</para>

</chapter>

<chapter id="game-description">
<title
>Spielanleitung</title>

<para
>Im ersten Abschnitt wird das Spielfeld beschrieben. Der zweite Abschnitt handelt von der Benutzung des Spielfeldes und im letzten Abschnitt werden die Spielregeln erklärt.</para>

<sect1 id="game-board-descritpion">
<title
>Spielfeldbeschreibung</title>

<para
>Es gibt die folgenden Quadrate auf dem Spielfeld: </para>

<variablelist>
<varlistentry>
<term
><interface
>Schwarze Quadrate</interface
></term>
<listitem
><para
>Die Blackbox. Sie müssen die Quadrate markieren, in denen Sie Kugeln vermuten.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><interface
>Grüne Quadrate</interface
></term>
<listitem
><para
>Die Laser. Sie schießen mit Licht, wenn sie angeschaltet werden.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><interface
>Hellgraue Quadrate</interface
></term>
<listitem
><para
>Das ist nichts Wichtiges, nur eine Begrenzung :-).</para
></listitem>
</varlistentry>

<varlistentry>
<term
><interface
>Blaue Kugeln</interface
></term>
<listitem
><para
><quote
>Da liegt eine!</quote
> - denken Sie. Diese Marke zeigt an, wo Sie eine Kugel in der Blackbox vermuten.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><interface
>Türkise Kugeln</interface
></term>
<listitem
><para
>Zeigt wo die Kugeln wirklich liegen.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><interface
>Rote Kugeln</interface
></term>
<listitem
><para
>Kugeln, die an falscher Stelle platziert worden sind, werden rot.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><interface
>Braune Quadrate</interface
></term>
<listitem
><para
>Markierungsfarbe</para
></listitem>
</varlistentry>
</variablelist>

<note
><para
>Die verwendeten Farben dienen nur der Identifizierung der verschiedenen Typen des Spielfeldes in diesem Text. Sie haben <emphasis
>vielleicht nichts</emphasis
> mit der wirklichen Farbe im Spielfeld gemeinsam. Einfacher gesagt: Die Blackbox ist in der Mitte, rundherum liegen die Laser und darum der Rand. Wählen Sie die Farben, wie Sie möchten. </para
></note>

</sect1>

<sect1 id="user-interaction">
<title
>Benutzung des Spielfeldes</title>

<para
>Der Cursor kann in der Box mit den Pfeiltasten oder der Maus bewegt werden. Die Laser können mit der &LMBn; oder der &Enter;-Taste eingeschaltet werden; ebenso können die Kugeln markiert werden.</para>

<para
>Sie können auch die Felder markieren, in denen sie keine Kugel vermuten. Drücken Sie einfach die &RMB;. Das hilft Ihnen oft ein Gebiet zu finden, in dem eine Kugel möglicherweise liegt. Um beliebige Markierungen (braune oder blaue) zu löschen, drücken Sie die &LMB;. Braune Markierungen können keine blauen überschreiben. Auf diese Weise können keine blauen Markierungen (vermutete Kugeln) versehentlich gelöscht werden, wenn Sie mit der &RMBn; spielen. </para>

<para
>Wenn Sie glauben, dass die Anordnung der Kugeln, die Sie gesetzt haben, korrekt ist, drücken Sie die &MMB;. Sie werden informiert, ob Sie Recht hatten oder nicht und Sie erhalten Ihre erreichte Punktzahl. Die Punktzahl setzt sich aus den Buchstaben und Nummern zusammen, die um die Blackbox herum stehen. Zusätzlich werden fünf Punkte für jede richtig gesetzte Kugel addiert. Haben Sie Kugeln falsch gesetzt, werden sie rot und ihre richtige Position wird durch türkise Kugeln angezeigt.</para>

</sect1>

<sect1 id="game-rules">
<title
>Spielregeln</title>

<para
>Sie müssen alle, in der Blackbox versteckten Kugeln finden. Ihre Mittel sind begrenzt - Sie können nur die Laser um die Box herum abfeuern. Es gibt drei mögliche Ergebnisse für jeden Lichtstrahl, den Sie in die Blackbox schicken: </para>

<anchor id="detour"/>
<variablelist>

<varlistentry>
<term
>Ablenkung</term
> 
<listitem
><para
>Der Lichtstrahl wird abgelenkt und tritt an einer anderen Stelle aus, als er reingeschickt wurde. Die Ablenkung wird auf dem Spielfeld durch zusammengehörige Zahlenpaare angezeigt - eine am Eintrittspunkt des Lichtstrahls, die andere am Austrittspunkt.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Reflexion</term>
<listitem
><para
>Der Lichtstrahl wird gespiegelt und tritt an der gleichen Stelle aus an der er eingetreten ist. Im Spielfeld werden Reflexionen durch den Buchstaben <guilabel
>R</guilabel
> gekennzeichnet.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Treffer</term>
<listitem
><para
>Der Lichtstrahl trifft die Kugel direkt und wird absorbiert. Er tritt nicht aus der Blackbox aus. Auf dem Spielfeld wird ein Treffer durch den Buchstaben <guilabel
>H</guilabel
> gekennzeichnet.</para
></listitem>
</varlistentry>
</variablelist>

<para
>Die Regeln für die Ableitung der Lichtstrahlen an den Kugeln lässt sich am besten am Beispiel erklären.</para>

<para
>Wenn ein Lichtstrahl eine Kugel erreicht, wird er um 90 Grad abgelenkt. Lichtstrahlen können beliebig oft abgelenkt werden. Im folgenden Diagramm stellen die Trennstriche leere Felder dar, der Buchstabe <guilabel
>O</guilabel
> steht für eine Kugel. Der Ein- und Austrittspunkt eines jeden Lichtstrahls ist durch Nummern gekennzeichnet, wie unter <link linkend="detour"
>Ablenkung</link
> beschrieben. Beachten Sie, dass Ein- und Austrittspunkt eines Lichtstrahls immer austauschbar sind. <guilabel
>*</guilabel
> zeigt den Weg an, den der Lichtstrahl geht.</para>

<para
>Beachten Sie die relative Position der Kugel und die 90 Grad Ablenkung, die sie verursacht.</para>

<screen
>    1
  - * - - - - - -         - - - - - - - -         - - - - - - - -
  - * - - - - - -         - - - - - - - -         - - - - - - - -
1 * * - - - - - -         - - - - - - - -         - O - - - - O -
  - - O - - - - -         - - O - - - - -         - - * * * * - -
  - - - - - - - -         - - - * * * * * 2     3 * * * - - * - -
  - - - - - - - -         - - - * - - - -         - - - O - * - -
  - - - - - - - -         - - - * - - - -         - - - - * * - -
  - - - - - - - -         - - - * - - - -         - - - - * - O -
                                2                         3
</screen>

<para
>Wie bereits erwähnt, tritt eine Reflexion genau dann auf, wenn der Lichtstrahl dort austritt, wo er eingetreten ist. Das kann auf verschiedene Weise geschehen: </para>

<screen
>- - - - - - - -         - - - - - - - -          - - - - - - - -
  - - - - O - - -         - - O - O - - -          - - - - - - - -
R * * * * - - - -         - - - * - - - -          O - - - - - - -
  - - - - O - - -         - - - * - - - -        R - - - - - - - -
  - - - - - - - -         - - - * - - - -          - - - - - - - -
  - - - - - - - -         - - - * - - - -          - - - - - - - -
  - - - - - - - -       R * * * * - - - -          - - - - - - - -
  - - - - - - - -         - - - - O - - -          - - - - - - - -

</screen>

<para
>Im ersten Beispiel wurde der Lichtstrahl von der oberen Kugel nach unten abgelenkt, dann nach links durch die untere Kugel und nimmt so den ursprünglichen Weg wieder auf. Das zweite Beispiel ist ähnlich. Das dritte Beispiel ist ein wenig ungewöhnlich, aber es kann verstanden werden, wenn sie erkennen, dass der Lichtstrahl nie die Gelegenheit hat in die Blackbox zu gelangen. Anderenfalls könnte der Lichtstrahl auch in die Blackbox eintreten und sofort wieder austreten, da er nach unten abgelenkt wurde.</para>

<para
>Ein Treffer erscheint, wenn ein Lichtstrahl direkt auf eine Kugel trifft.</para>

<screen
>- - - - - - - -         - - - - - - - -          - - - - - - - -
  - - - - - - - -         - - - - - - - -          - - - - O - - -
  - - - - - - - -         - - - - O - - -        H * * * * - - - -
  - - - - - - - -       H * * * * O - - -          - - - * - - - -
  - - - - - - - -         - - - - O - - -          - - - O - - - -
H * * * O - - - -         - - - - - - - -          - - - - - - - -
  - - - - - - - -         - - - - - - - -          - - - - - - - -
  - - - - - - - -         - - - - - - - -          - - - - - - - -

</screen>

<para
>Vergleichen Sie das zweite Beispiel des Treffers mit dem ersten Beispiel der Reflexion.</para>

</sect1>
</chapter>
<chapter id="gui-description">
<title
>Beschreibung des Spielfeldes</title>

<sect1 id="game-menu">
<title
>Das Menü <guimenu
>Spiel</guimenu
></title>

<variablelist>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
> </shortcut
> <guimenu
>Spiel</guimenu
> <guimenuitem
>Neu</guimenuitem
></menuchoice
></term>
<listitem
><para
>Startet ein neues Spiel (und verlässt das aktuelle, wenn vorhanden).</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Spiel</guimenu
> <guimenuitem
>Aufgeben</guimenuitem
></menuchoice
></term>
<listitem
><para
>Zeigt die Positionen der Kugeln.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Spiel</guimenu
> <guimenuitem
>Fertig</guimenuitem
></menuchoice
></term>
<listitem
><para
>Überprüft, ob alle Kugeln gesetzt wurden. Ist das der Fall, wird das aktuelle Spiel beendet, die endgültige Punktzahl berechnet und die wirklichen Positionen der Kugeln angezeigt. Die &MMB; hat die gleiche Funktion. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Spiel</guimenu
> <guimenuitem
>Größe zurücksetzen</guimenuitem
></menuchoice
></term>
<listitem
><para
>Setzt die Fenstergröße so zurück, dass das Fenster den Inhalt perfekt enthält. Das ist hilfreich, wenn Sie versehentlich die Größe des Fensters verändert haben.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
> </shortcut
> <guimenu
>Spiel</guimenu
> <guimenuitem
>Beenden</guimenuitem
></menuchoice
></term>
<listitem
><para
>Beendet &kblackbox;.</para
></listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="settings-menu">
<title
>Das Menü <guimenu
>Einstellungen</guimenu
></title>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Einstellungen</guimenu
> <guimenuitem
>Werkzeugleiste anzeigen/ausblenden</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
>Blendet die Werkzeugleiste ein bzw. aus.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Einstellungen</guimenu
> <guimenuitem
>Statusleiste anzeigen/ausblenden</guimenuitem
> </menuchoice
></term>
<listitem>
<para
>Blendet die Statusleiste ein bzw. aus.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Einstellungen</guimenu
> <guisubmenu
>Größe</guisubmenu
></menuchoice
></term>
<listitem
><para
>Legt die Größe des Spielfeldes (der Blackbox) fest. Sie können zwischen <guimenuitem
>8 x 8</guimenuitem
>, <guimenuitem
>10 x 10</guimenuitem
> und <guimenuitem
>12 x 12</guimenuitem
> wählen. Die Voreinstellung ist <guimenuitem
>8 x 8</guimenuitem
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Einstellungen</guimenu
> <guisubmenu
>Kugeln</guisubmenu
></menuchoice
></term>
<listitem
><para
>Legt die Anzahl der Kugeln in der Blackbox fest. Sie können zwischen <guimenuitem
>4</guimenuitem
> (Voreinstellung), <guimenuitem
>6</guimenuitem
> oder<guimenuitem
>8</guimenuitem
> wählen.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Einstellungen</guimenu
> <guimenuitem
>Einführung</guimenuitem
></menuchoice
></term>
<listitem
><para
>Schaltet den Einführungsmodus ein bzw. aus. Im Einführungsmodus können Sie sehen, wo die Kugeln gegenwärtig sind. Beachten Sie, dass Sie ein neues Spiel starten müssen, damit diese Änderung wirksam wird.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Einstellungen</guimenu
> <guimenuitem
>Kurzbefehle festlegen ...</guimenuitem
></menuchoice
></term>
<listitem
><para
>Öffnet den &kde;-Standarddialog zur Änderung der Tastenkürzel von &kblackbox;.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Einstellungen</guimenu
> <guimenuitem
>Werkzeugleisten einrichten ...</guimenuitem
> </menuchoice
></term>
<listitem>
<para
>Öffnet den &kde;-Standarddialog zur Einrichtung der Werkzeugleisten für &kblackbox;.</para>
</listitem>
</varlistentry>

</variablelist>

</sect1>

<sect1 id="help">
<title
>Das Menü <guimenuitem
>Hilfe</guimenuitem
></title>
&help.menu.documentation; </sect1>

<sect1 id="toolbar">
<title
>Die Werkzeugleiste</title>

<screenshot>
<screeninfo
>Die Werkzeugleiste von &kblackbox;</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="kblackboxtbar.png" format="PNG"/>
</imageobject>
</mediaobject>
</screenshot>

<para
>Die Werkzeugleiste von &kblackbox; ermöglicht schnellen Zugriff auf häufig gebrauchte Funktionen. Die Symbole von links nach rechts:</para>

<variablelist>

<varlistentry>
<term
><guiicon
>Neu</guiicon
></term>
<listitem
><para
>Startet ein neues Spiel.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guiicon
>Aufgeben</guiicon
></term>
<listitem
><para
>Zeigt die Positionen der Kugeln.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guiicon
>Fertig</guiicon
></term>
<listitem
><para
>Überprüft, ob alle Kugeln gesetzt wurden. Ist das der Fall, wird das aktuelle Spiel beendet, die endgültige Punktzahl berechnet und die wirklichen Positionen der Kugeln angezeigt. Die &MMB; hat die gleiche Funktion. </para
></listitem>
</varlistentry>

</variablelist>
</sect1>
</chapter>

<chapter id="credits-and-license">
<title
>Danksagungen und Lizenz</title>

<para
>&kblackbox;</para>

<para
>Programm Copyright 1998-2000 &Robert.Cimrman; &Robert.Cimrman.mail;</para>

<para
>Diese Dokumentation wurde von &Robert.Cimrman; geschrieben. &Lauri.Watts; &Lauri.Watts.mail; hat sie aktualisiert und für &kde; 2.0 in Docbock konvertiert.</para>

<para
>Aktueller Betreuer &Philip.Rodrigues; &Philip.Rodrigues.mail; </para>

<para
>Deutsche Übersetzung von Maren Pakura<email
>maren@kde.org</email
></para
> 
&underFDL; &underGPL; </chapter>


<appendix id="installation">
<title
>Installation</title>

&install.intro.documentation;

<sect1 id="compilation">
<title
>Kompilierung und Installation</title>
&install.compile.documentation; </sect1>
</appendix>

</book>

<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
End:
-->

