<?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 % French "INCLUDE"
> <!-- change language only here -->
]>

<book lang="&language;">

<bookinfo>
<title
>Manuel du jeu &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>

&traducteurEricBischoff; &traducteurLudovicGrossard; 

</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
>2003-09-18</date>
<releaseinfo
>0.3.0</releaseinfo>

<abstract
><para
>&kblackbox; est un superbe jeu de logique en mode graphique, inspiré du blackbox d'<application
>emacs</application
>.</para
></abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>KBlackBox</keyword>
<keyword
>kdegames</keyword>
<keyword
>boîte noire</keyword>
<keyword
>jeu</keyword>
</keywordset>

</bookinfo>

<chapter id="what-is-kblackbox">
<title
>Qu'est-ce que &kblackbox; ?</title>

<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>

</chapter>

<chapter id="game-description">
<title
>Description du jeu</title>

<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>

<sect1 id="game-board-descritpion">
<title
>Description du plateau de jeu</title>

<para
>On trouve les types de cases suivants sur le plateau de jeu : </para>

<variablelist>
<varlistentry>
<term
><interface
>Cases noires</interface
></term>
<listitem
><para
>La boîte noire. Vous y marquez les positions où vous pensez que les billes se trouvent.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><interface
>Cases vertes</interface
></term>
<listitem
><para
>Il s'agit des lasers, qui envoient des rayons de lumière si on les déclenche.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><interface
>Cases gris clair</interface
></term>
<listitem
><para
>Aucun intérêt, c'est juste la bordure.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><interface
>Billes bleues</interface
></term>
<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>
</varlistentry>

<varlistentry>
<term
><interface
>Billes couleur cyan</interface
></term>
<listitem
><para
>Indiquent les positions correctes des billes.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><interface
>Billes rouges</interface
></term>
<listitem
><para
>Indiquent les positions mal estimées.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><interface
>Cases brunes</interface
></term>
<listitem
><para
>Couleur de marquage</para
></listitem>
</varlistentry>
</variablelist>

<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>

</sect1>

<sect1 id="user-interaction">
<title
>Actions du joueur</title>

<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>

</sect1>

<sect1 id="game-rules">
<title
>Règles du jeu</title>

<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>

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

<varlistentry>
<term
>Déviation</term
> 
<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>
</varlistentry>

<varlistentry>
<term
>Réflexion</term>
<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>
</varlistentry>

<varlistentry>
<term
>Collision</term>
<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>
</varlistentry>
</variablelist>

<para
>Les règles qui régissent le cheminement des rayons sont simples et s'expliquent plus aisément en montrant quelques exemples.</para>

<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
>Remarquez les positions de la bille et les déviations de quatre-vingt-dix degrés qu'elle cause.</para>

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

<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>

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

</screen>

<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>

<para
>Une collision se produit lorsqu'un rayon frappe une bille de plein fouet :</para>

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

</screen>

<para
>Prenez soin de comparer le second exemple de collision avec le premier exemple de réflexion.</para>

</sect1>
</chapter>
<chapter id="gui-description">
<title
>Description de l'interface graphique</title>

<sect1 id="game-menu">
<title
>Le menu <guimenu
>Jeu</guimenu
></title>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Jeu</guimenu
> <guimenuitem
>Nouveau</guimenuitem
></menuchoice
></term>
<listitem
><para
>Démarre un nouveau jeu (et abandonne le précédent, s'il y en a un).</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Jeu</guimenu
> <guimenuitem
>Abandonner</guimenuitem
></menuchoice
></term>
<listitem
><para
>Montre l'emplacement des billes.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Jeu</guimenu
> <guimenuitem
>Solution</guimenuitem
></menuchoice
></term>
<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>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Jeu</guimenu
> <guimenuitem
>Taille normale</guimenuitem
></menuchoice
></term>
<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>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Jeu</guimenu
> <guimenuitem
>Quitter</guimenuitem
></menuchoice
></term>
<listitem
><para
>Sort de &kblackbox;</para
></listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="settings-menu">
<title
>Le menu <guimenu
>Configuration</guimenu
></title>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Configuration</guimenu
> <guisubmenu
>Dimension</guisubmenu
></menuchoice
></term>
<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>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Configuration</guimenu
> <guisubmenu
>Billes</guisubmenu
></menuchoice
></term>
<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>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Configuration</guimenu
> <guimenuitem
>Tutoriel</guimenuitem
></menuchoice
></term>
<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>
</varlistentry>

<varlistentry>
<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>
</varlistentry>


</variablelist>

</sect1>

<sect1 id="help">
<title
>Le menu <guimenuitem
>Aide</guimenuitem
></title>
&help.menu.documentation; </sect1>

<sect1 id="toolbar">
<title
>La barre d'outils</title>

<screenshot>
<screeninfo
>Barre d'outils de &kblackbox;</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="kblackboxtbar.png" format="PNG"/>
</imageobject>
</mediaobject>
</screenshot>

<para
>La barre d'outils de &kblackbox; offre un accès rapide aux fonctions les plus utilisées. De gauche à droite, les icônes sont :</para>

<variablelist>
<varlistentry>
<term
><guiicon
>Quitter</guiicon
></term>
<listitem
><para
>Sort de &kblackbox;</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guiicon
>Nouveau</guiicon
></term>
<listitem
><para
>Démarre une nouvelle partie.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guiicon
>Abandonner</guiicon
></term>
<listitem
><para
>Montre l'emplacement des billes.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guiicon
>Arrête la partie</guiicon
></term>
<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>
</varlistentry>

<varlistentry>
<term
><guiicon
>Manuel de &kblackbox;</guiicon
></term>
<listitem>
<para
>Affiche ce document dans &centreAide;.</para>
</listitem>
</varlistentry>


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

<chapter id="credits-and-license">
<title
>Remerciements et licence</title>

<para
>&kblackbox;</para>

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

<para
>Documentation par Robert Cimrman. Mise à jour et convertie au format Docbook pour KDE 2.0 par &Lauri.Watts; &Lauri.Watts.mail;</para>

<para
>Mainteneur actuel : &Philip.Rodrigues; &Philip.Rodrigues.mail; </para>

<para
>Traduction française par &EricBischoff; et &LudovicGrossard;.</para
> 
&underFDL; &underGPL; </chapter>


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

&install.intro.documentation;

<sect1 id="compilation">
<title
>Compilation et installation</title>
&install.compile.documentation; </sect1>
</appendix>

</book>

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

