<para>&kblackbox; est un superbe :-) jeu de logique en mode graphique, inspiré du blackbox d'<application>emacs</application>. La majeure partie de cette documentation est basée sur l'aide originale de la version <application>emacs</application>. </para>
<para>&kblackbox; est un jeu consistant à localiser dans un quadrillage des objets cachés. Votre adversaire (ici, le générateur de nombres aléatoires) a caché plusieurs billes dans la boîte. En lançant des rayons dans la boîte et en regardant à quel endroit ils en ressortent, il est possible d'en déduire la position des billes cachées. Moins vous utilisez de rayons pour y parvenir et meilleur (plus petit) est votre score.</para>
<para>Dans la première partie de cette section, vous trouverez une description du plateau de jeu. La seconde partie se rapporte aux actions du joueur et, finalement, les règles formelles du jeu sont exposées dans la troisième partie.</para>
<listitem><para>Vous pensez sans doute <quote>Il fallait bien en mettre!</quote>. Elles indiquent les positions où vous suspectez qu'une bille se trouve dans la boîte noire.</para></listitem>
<note><para>Les noms de couleurs utilisés ici ne servent qu'à identifier les différents types d'objets dans les explications du présent texte. Il <emphasis>se pourrait qu'elles ne correspondent pas</emphasis> aux couleurs réellement affichées sur votre écran. Pour dire les choses plus simplement: la boîte noire est au centre, autour ce sont les lasers, et autour d'eux, c'est la bordure. Avec ces informations, vous pouvez ajuster les couleurs vous-même! </para></note>
<para>Le curseur peut être déplacé autour de la boîte au moyen des touches standards de déplacement du curseur ou de la souris. Le déclenchement des lasers ou le marquage des positions s'effectue au moyen du &BGS;, ou en appuyant sur les touches <keycap>Retour chariot</keycap> ou &Enter;.</para>
<para>Vous pouvez également marquer les emplacements où aucune bille ne peut se trouver. Appuyez simplement sur le &BDS;. Ceci vous aidera souvent à trouver un endroit où une bille peut se trouver. Pour effacer toutes les marques (bleues ou brunes), appuyez sur &BGS;. Les marques brunes ne peuvent pas effacer les bleues. Ainsi, vous ne risquez pas d'effacer les marques bleues (positions estimées) par accident lorsque vous utilisez le &BDS;. </para>
<para>Quand vous pensez avoir trouvé la configuration correcte des billes, appuyez sur le &BCS;. Vous saurez alors si vous avez trouvé ou pas, et vous connaîtrez votre score. Ce score est égal au nombre de lettres et de nombres situés autour de la boîte, plus cinq pour chaque bille incorrectement placée. Si vous avez mal placé une bille, elle sera indiquée en rouge et la position correcte sera indiquée en cyan.</para>
<para>Vous devez localiser les billes cachées dans la boîte noire. Vos moyens sont limités. Vous ne pouvez que déclencher les lasers situés autour de la boîte. Il y a trois possibilités lorsque vous envoyez un rayon dans la boîte: </para>
<listitem><para>Le rayon est dévié et émerge quelque part ailleurs. Sur le plateau de jeu, les déviations sont repérées par des paires de nombres - un à l'endroit où le rayon a été envoyé, et l'autre à l'endroit où il est ressorti.</para></listitem>
<listitem><para>Le rayon est réfléchi et émerge à l'endroit même où il a été émis. Sur le plateau de jeu, les réflexions sont repérées par la lettre <guilabel>R</guilabel>.</para></listitem>
<listitem><para>Le rayon frappe une bille de plein fouet et est absorbé. Il ne réémerge pas de la boîte. Sur le plateau de jeu, les collisions sont repérées par la lettre <guilabel>H</guilabel>.</para></listitem>
<para>Lorsqu'un rayon arrive au voisinage d'une bille, il est dévié de quatre-vingt-dix degrés. Les rayons peuvent être déviés plusieurs fois. Sur le diagramme ci-dessous, les tirets représentent des positions vides et la lettre <guilabel>O</guilabel> représente une bille. Les points d'entrée et de sortie de chaque rayon sont marqués par des nombres comme décrit au paragraphe <link linkend="detour">Déviation</link> ci-dessus. Notez que les points d'entrée et de sortie sont toujours interchangeables. Le signe <guilabel>*</guilabel> indique le chemin suivi par le rayon.</para>
<para>Comme mentionné précédemment, une réflexion se produit lorsqu'un rayon émerge à l'endroit même d'où il est parti. Ceci peut se produire pour différentes raisons: </para>
<para>Dans le premier exemple, le rayon est dévié vers le bas par la bille supérieure, puis immédiatement vers la gauche par celle du dessous, et, finalement, il revient jusqu'à son point de départ. Le second exemple est similaire. Le troisième exemple est un peu curieux, mais s'explique si on prend en considération que le rayon ne peut tout simplement pas entrer dans la boîte. On peut aussi considérer que le rayon a été dévié vers le bas et est immédiatement ressorti de la boîte.</para>
<listitem><para>Vérifie qu'une position a été estimée pour chaque bille. Si c'est le cas, termine le jeu, calcule le score et indique les véritables positions des billes. Le bouton <mousebutton>central</mousebutton> de la souris a une fonction identique. </para></listitem>
<listitem><para>Redimensionne la fenêtre principale, afin qu'elle s'adapte parfaitement à son contenu. C'est utile dans le cas où vous changez accidentellement la taille de la fenêtre...</para></listitem>
<listitem><para>Fixe la taille du plateau de jeu (boîte noire). Vous pouvez choisir parmi <guimenuitem>8 x 8</guimenuitem>, <guimenuitem>10 x 10</guimenuitem> et <guimenuitem>12 x 12</guimenuitem>. La valeur par défaut est <guimenuitem>8 x 8</guimenuitem></para></listitem>
<listitem><para>Fixe le nombre de billes dans la boîte noire. Vous avez le choix entre <guimenuitem>4</guimenuitem> (la valeur par défaut), <guimenuitem>6</guimenuitem> et <guimenuitem>8</guimenuitem>.</para>
<listitem><para>Active ou désactive le mode tutoriel, dans lequel vous pouvez voir la position réelle des billes. Notez que vous devez démarrer une nouvelle partie pour que les changements soient appliqués.</para></listitem>
<term><menuchoice><guimenu>Configuration</guimenu> <guimenuitem>Configurer les raccourcis clavier...</guimenuitem></menuchoice></term>
<listitem><para>Affiche une boîte de dialogue standard de &kde;, dans la quelle vous pouvez changer les raccourcis-clavier utilisés par &kblackbox;.</para></listitem>
<listitem><para>Vérifie qu'une position a été estimée pour chaque bille. Si c'est le cas, termine le jeu, calcule le score et indique les véritables positions des billes. Le bouton <mousebutton>central</mousebutton> de la souris a une fonction identique. </para></listitem>
