<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook V3.1-Based Variant V1.0//EN">
<book lang="fr">
<bookinfo>
<title>Le manuel du jeu KBlackBox</title>
<authorgroup>
<author>
<surname></surname>
</author>
</authorgroup>
<date>version 0.2.3, 10. Février 1998 </date>
<releaseinfo><!-- information about this particular version --></releaseinfo>
<revhistory>
<revision>
<revnumber></revnumber>
<date></date>
</revision>
</revhistory>
<abstract>
<para>Ce document contient le guide d'installation et une brève description
du jeu KblackBox.</para>
<para>Le manuel de KAsteroids</para><!-- Merge this with the previous paragraph; it comes from <META NAME="description" CONTENT="..."> --></abstract>
<keywordset>
<keyword>KDE</keyword>
<keyword>KAsteroids</keyword>
<keyword>asteroïdes</keyword>
</keywordset>
</bookinfo>

<chapter id="QuestcequeKBlackBox">
<title>Qu'est-ce que KBlackBox?</title>

<para>KblackBox est un superbe :-) jeu de logique en mode graphique, inspiré du
blackbox de emacs. Il est distribué sous licence GPL. La majeure partie de
cette documentation est basée sur l'aide originale de la version emacs.</para>

<para>KblackBox est un jeu consistant à localiser, dans une boîte
quadrillée, des objets cachés. Votre adversaire (ici, le générateur de
nombres aléatoires) a caché plusieurs balles 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 balles
cachées. Moins vous utilisez de rayons pour y parvenir et meilleur
(plus petit) est votre score.</para>
</chapter>

<chapter id="Installation">
<title>Installation</title>

<para>KblackBox est une application KDE. C'est pourquoi il nécessite que KDE
soit installé sur votre ordinateur - au moins les paquetages
kdesupport, kdelibs et kdebase. La procédure d'installation est très
simple :</para>

<para><programlisting>       cd somewhere
       gunzip kblackbox-x.y.z.tgz
       tar -xvf kblackbox-x.y.z.tar
       cd kblackbox-x.y.z
       # La ligne suivante  est destinée à générer le script de configuration.
       # Elle sera probablement enlevée lorsque Kblackblox sera partie
       # intégrante de kdegames.
       make -f Makefile.dist
       #
       ./configure
       make
       make install</programlisting>
</para>

<para>Vous aurez problablement besoin d'être superutilisateur (root) pour procéder
à l'installation.</para>
</chapter>

<chapter id="Descriptiondelinterfacegraphique">
<title>Description de l'interface graphique</title>

<para><itemizedlist>
<listitem>
<para><emphasis remap="bf">Menus</emphasis>
<itemizedlist>
<listitem>
<para><emphasis remap="bf">Fichier</emphasis>
<itemizedlist>
<listitem>
<para><emphasis remap="bf">Quitter</emphasis> - Bien, ceci est difficile à expliquer. Passons à autre chose.</para>
</listitem>
</itemizedlist>
</para>
</listitem>
<listitem>
<para><emphasis remap="bf">Jeu</emphasis>
<itemizedlist>
<listitem>
<para><emphasis remap="bf">Nouvelle partie</emphasis> - Démarre un nouveau jeu (et abandonne le précédent, s'il y en a un). </para>
</listitem>
<listitem>
<para><emphasis remap="bf">Abandonner</emphasis> - Montre l'emplacement des balles.</para>
</listitem>
<listitem>
<para><emphasis remap="bf">Solution</emphasis> - Vérifie qu'une position a été estimée pour
chaque balle. Si c'est le cas, termine le jeu, calcule le score et
indique les véritables positions des balles. Le bouton du milieu
de la souris a la même fonction.</para>
</listitem>
<listitem>
<para><emphasis remap="bf">Taille normale</emphasis> - Redimensionne la fenêtre principale,
afin qu'elle s'adapte parfaitement à son contenu. Ceci serait utile
dans dans cas où vous changeriez accidentellement la taille de la
fenêtre...</para>
</listitem>
</itemizedlist>
</para>
</listitem>
<listitem>
<para><emphasis remap="bf">Options</emphasis>
<itemizedlist>
<listitem>
<para><emphasis remap="bf">Dimensions</emphasis> - Fixe la taille du plateau de jeu (black box). </para>
</listitem>
<listitem>
<para><emphasis remap="bf">Balles</emphasis> - Fixe le nombre de balles dans la boîte.</para>
</listitem>
<listitem>
<para><emphasis remap="bf">Tutoriel</emphasis> - (Dés)active le mode tutoriel (dans lequel
vous pouvez voir la position réelle des balles.</para>
</listitem>
</itemizedlist>
</para>
</listitem>
<listitem>
<para><emphasis remap="bf">Help</emphasis>
<itemizedlist>
<listitem>
<para><emphasis remap="bf">Aide</emphasis> - Affiche cette aide.</para>
</listitem>
<listitem>
<para><emphasis remap="bf">A propos de Kblackbox</emphasis> - Affiche la fenêtre d'information "A propos".</para>
</listitem>
<listitem>
<para><emphasis remap="bf">A propos de Qt</emphasis> - Affiche la fenêtre d'information concernant la bibliothèque Qt.</para>
</listitem>
</itemizedlist>
</para>
</listitem>
</itemizedlist>
</para>
</listitem>
<listitem>
<para><emphasis remap="bf">Barre d'outils:</emphasis> La barre d'outils offre quelques-unes des fonctions les plus utiles du menu, plus précisément, et dans l'ordre des outils :
<itemizedlist>
<listitem>
<para><emphasis remap="bf">Quitter</emphasis></para>
</listitem>
<listitem>
<para><emphasis remap="bf">Nouvelle partie</emphasis></para>
</listitem>
<listitem>
<para><emphasis remap="bf">Abandonner</emphasis></para>
</listitem>
<listitem>
<para><emphasis remap="bf">Fini</emphasis></para>
</listitem>
<listitem>
<para><emphasis remap="bf">Mode d'emploi</emphasis></para>
</listitem>
</itemizedlist>
</para>
</listitem>
<listitem>
<para><emphasis remap="bf">Barre d'état:</emphasis> Elle vous donne différentes informations utiles.</para>
</listitem>
</itemizedlist>
</para>
</chapter>

<chapter id="Descriptiondujeu">
<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 du jeu sont exposées dans
la troisième partie.</para>

<sect1 id="description-du-plateau-de-jeu">
<title>Description du plateau de jeu</title>

<para>On trouve les différentes couleurs sur le plateau de jeu :</para>

<para><itemizedlist>
<listitem>
<para><emphasis remap="bf">&quot;gris&quot;</emphasis> - La boîte. Ici, vous marquez les positions où vous pensez que les balles se trouvent.</para>
</listitem>
<listitem>
<para><emphasis remap="bf">&quot;vert&quot;</emphasis> - Voici les lasers, qui envoient des rayons si on les déclenche.</para>
</listitem>
<listitem>
<para><emphasis remap="bf">&quot;blanc&quot;</emphasis> - Aucun intérêt, c'est juste la bordure.</para>
</listitem>
<listitem>
<para><emphasis remap="bf">&quot;bleu&quot;</emphasis> - &quot;Il fallait bien en mettre !&quot;. </para>
</listitem>
<listitem>
<para><emphasis remap="bf">&quot;cyan&quot;</emphasis> - Indique les positions correctes des balles.</para>
</listitem>
<listitem>
<para><emphasis remap="bf">&quot;rouge&quot;</emphasis> - Indique les positions mal estimées. </para>
</listitem>
<listitem>
<para><emphasis remap="bf">&quot;marron&quot;</emphasis> - Couleur de marquage des estimations.</para>
</listitem>
</itemizedlist>
</para>

<para><emphasis remap="bf">NOTE:</emphasis> Les couleurs définies ici sont celles utilisées dans les
explications du présent texte.  Il se pourrait qu'elles ne
<emphasis>correspondent pas</emphasis> aux couleurs affichées sur votre écran. Pour
dire les choses plus simplement: la boîte 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>
</sect1>

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

<para>Le curseur (un cercle) peut être déplacé autour de la boîte aux moyen
des touches standard de déplacement du curseur. Le déclenchement des
lasers ou le marquage des positions s'effectue au moyen du bouton
gauche de la souris, ou en pressant les touches &quot;Return&quot; or
&quot;Entrée&quot;. Vous pouvez également marquer les emplacements où
aucune balle ne peut se trouver. Pressez simplement le bouton de
droite sur la souris. Ceci vous aidera souvent à trouver un endroit ou
une balle peut se trouver. Pour effacer toutes les marques (bleues ou
marron), pressez le bouton de gauche. Les marques marron 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 bouton de droite de la souris.</para>

<para>Quand vous pensez avoir trouvé la configuration correcte des balles,
pressez le bouton du milieu de la souris. 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 balle incorrectement placée. Si vous avez mal
placé une balle, elle sera indiquée en rouge et la position correcte
sera indiquée en cyan.</para>
</sect1>

<sect1 id="regle-du-jeu">
<title>Règle du jeu</title>

<para>Vous devez localiser les balles 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 possiblités lorsque vous envoyez un
rayon dans la boîte :</para>

<para><itemizedlist>
<listitem>
<para><emphasis remap="bf">Déviation</emphasis> - 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><emphasis remap="bf">Reflexion</emphasis> - 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 "R".
</para>
</listitem>
<listitem>
<para><emphasis remap="bf">Frappe (Hit)</emphasis> - Le rayon frappe une balle de plein fouet et
est absorbé. Il ne réémerge pas de la boîte. Sur le plateau de jeu,
les hits sont repérés par la lettre "H".
</para>
</listitem>
</itemizedlist>
</para>

<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 s'approche d'une balle, 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 "O" représente une balle. Les points
d'entrée et de sortie de chaque rayon sont marqués par des nombres
comme décrit ci-dessus. Notes que les points d'entrée et de sortie
sont toujours interchangeables. Le signe &quot;*&quot; indique les
cheminement du rayon.</para>

<para>Remarquez les positions de la balle et les déviations de
quatre-vingt-dix degrés qu'elle cause.</para>

<para><programlisting>
           1                                            
         - * - - - - - -         - - - - - - - -         - - - - - - - -       
         - * - - - - - -         - - - - - - - -         - - - - - - - -       
       1 * * - - - - - -         - - - - - - - -         - O - - - - O -       
         - - O - - - - -         - - O - - - - -         - - * * * * - -
         - - - - - - - -         - - - * * * * * 2     3 * * * - - * - -
         - - - - - - - -         - - - * - - - -         - - - O - * - -      
         - - - - - - - -         - - - * - - - -         - - - - * * - -       
         - - - - - - - -         - - - * - - - -         - - - - * - O -       
                                       2                         3</programlisting>
</para>

<para>Comme mentionné ci-dessus, 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><programlisting>         - - - - - - - -         - - - - - - - -          - - - - - - - -
         - - - - O - - -         - - O - O - - -          - - - - - - - -
       R * * * * - - - -         - - - * - - - -          O - - - - - - -
         - - - - O - - -         - - - * - - - -        R - - - - - - - -
         - - - - - - - -         - - - * - - - -          - - - - - - - -
         - - - - - - - -         - - - * - - - -          - - - - - - - -
         - - - - - - - -       R * * * * - - - -          - - - - - - - -
         - - - - - - - -         - - - - O - - -          - - - - - - - -</programlisting>
</para>

<para>Dans le premier exemple, le rayon est dévié vers le bas par la balle
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 frappe (hit) se produit lorsqu'un rayon frappe une balle de plein fouet :</para>

<para><programlisting>         - - - - - - - -         - - - - - - - -          - - - - - - - -
         - - - - - - - -         - - - - - - - -          - - - - O - - -
         - - - - - - - -         - - - - O - - -        H * * * * - - - -
         - - - - - - - -       H * * * * O - - -          - - - * - - - -
         - - - - - - - -         - - - - O - - -          - - - O - - - -
       H * * * O - - - -         - - - - - - - -          - - - - - - - -
         - - - - - - - -         - - - - - - - -          - - - - - - - -
         - - - - - - - -         - - - - - - - -          - - - - - - - -</programlisting>
</para>

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

<chapter id="Epilogue">
<title>Epilogue</title>

<sect1 id="auteur">
<title>Auteur</title>

<para> 
<literal remap="tt">Robert Cimrman, <ulink url="mailto:cimrman3@students.zcu.cz">cimrman3@students.zcu.cz</ulink></literal></para>

<para><literal remap="tt">Traduction française: Christophe Dioux
<ulink url="mailto:chdioux@club-internet.fr">chdioux@club-internet.fr</ulink> , le 27 septembre 1999.</literal></para>
</sect1>

<sect1 id="copyright">
<title>Copyright</title>

<para>KBblackBox est distribué sour licence GPL.</para>
</sect1>
</chapter>
</book>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
End:
-->