# Le manuel de &kenolaba;

Josef
Weidendorfer
Philip
Rodrigues

    phil.rod@ntlworld.com

Lauri
Watts

    lauri@kde.org

Relecteur
Gérard
Delafond

    g.delafond@medsyn.fr

Traducteur
2001-12-27
1.06.00a
2001
Philip Rodrigues
&FDLNotice;

&kenolaba; est un jeu de stratégie simple spour deux joueurs qui se joue sur un plateau.

KDE
jeu
kenolaba
linux

## Introduction

&kenolaba; est un simple jeu de stratégie qui se joue à deux sur un plateau. Chaque joueur a une couleur : soit rouge, soit jaune. Chaque joueur commence avec 14 boules. Le but du jeu est de déplacer ses boules de manière à pousser six boules de l'adversaire hors du plateau.

Le programme original a été développé pour DOS et XLib pure en 1993. Le portage sous &kde; a nécessité des modifications majeures.

Si vous connaissez le jeu sur plateau appelé Abalone, vous aimerez ce programme. En fait, ce programme s'inspire de ce jeu. Abalone est une marque déposée de Abalone SA, France.

## Règles du jeu

Les rouges jouent toujours en premier.

Deux types de déplacements sont autorisés :

Normal

  Vous pouvez déplacer une, deux ou trois pièces alignées dans l'une des six directions. Les déplacements latéraux sont également autorisés.

  Cliquez avec le bouton gauche de la souris sur la première pièce que vous voulez bouger. La pièce est alors mise en sur-brillance. Maintenant, glissez la souris jusqu'à la position désirée. Si le mouvement est possible, le pointeur de la souris se transforme en flèche dans cette direction et toutes les boules à déplacer sont mises en sur-brillance. Pour confirmer le déplacement, relâchez le bouton de la souris..

  Les mouvements de front de plusieurs boules sont gérés de manière différente. Pour deux boules adjacentes, cliquez entre les deux boules et faites glisser ; pour trois boules, cliquez sur celle du milieu avec le bouton central de la souris. Si un mouvement de front est autorisé pour ces boules, elles seront mises en sur brillance. Sinon, seule celle du milieu le sera, et il s'agira d'un mouvement normal.

Pousser

  Vous ne pouvez pousser au plus que deux boules adverses et ceci seulement si le nombre de boules que vous déplacez est supérieur à celui de votre adversaire. Ce qui veut dire qu'avec trois boules, vous ne pouvez en pousser qu'une ou deux et avec deux, une seule.

  Un cas spécial est celui où vous poussez une boule de votre adversaire hors du plateau. Si vous le faites six fois, vous avez gagné.

Si vous avez de la difficulté à comprendre le jeu, laissez l'ordinateur jouer tout seul. Pour cela, après avoir lancé &kenolaba;, choisissez Configuration L'ordinateur joue avec Les deux et commencez une nouvelle partie.

## Jeu en réseau

### Généralités sur le jeu en réseau

&kenolaba; gère le jeu en réseau. Cela permet à deux personnes de jouer l'une contre l'autre sur deux ordinateurs différents, ou à une personne d'observer le jeu d'un autre programme &kenolaba;. Pour utiliser les possibilités de jeu en réseau de &kenolaba;, vous devez le passer en mode réseau en sélectionnant Jeu Partie en réseau.

Tous les programmes &kenolaba; qui sont en mode réseau échangent des informations sur les déplacements des boules.

Pour fournir des informations sur les positions, les programmes &kenolaba; doivent se connaître. S'ils fonctionnent sur la même machine, il n'y a besoin de rien (sauf de choisir le mode réseau). S'ils fonctionnent sur des ordinateurs différents, vous devez préciser la machine de votre adversaire sur une ligne de commande avec l'option `-h` de cette manière :

    %kenolaba -hun_nom_d_hote

Pour ceux qui veulent des détails, &kenolaba; en mode réseau écoute une socket TCP pour connaître les changements de positions. On peut spécifier un port de communication avec l'option de ligne de commande `-p`. C'est nécessaire si vous voulez jouer deux jeux &kenolaba; différents en réseau.

#### Exemples

- Chris sur machine1 et Mary sur machine2 veulent jouer l'un contre l'autre : Mary démarre simplement &kenolaba;, règle le menu Configuration L'ordinateur joue avec sur Aucun et passe en mode réseau. Chris démarre &kenolaba; avec

      %kenolaba -h machine2

  et fait comme Mary. Maintenant, l'un des deux peut commencer en bougeant les rouges. Chaque fois que les positions des boules changent dans l'un des deux programmes, ces changements sont automatiquement reportés dans l'autre programme.

- John veut regarder un jeu. Il fait pareil que Chris, mais ne bouge pas les boules lui-même.

- Il existe deux modes réseau différents pour &kenolaba; sur les machines m1 et m2. Pour distinguer les parties, choisissons le port 12345 pour l'une. Sur m1, on démarre comme d'habitude avec :

      %kenolaba

  pour le premier et (inhabituel)

      %kenolaba -p 12345

  pour le deuxième. Sur m2 nous démarrons

      %kenolaba
      -h m1

  et le deuxième avec :

      %kenolaba -h m1:12345

  (Les deux points séparent l'hôte et le port comme dans une &URL;).

## Options avancées

### Mode modification

Vous pouvez modifier le plateau actuel en choisissant Édition Modifier pour passer &kenolaba; en mode modification. Vous pouvez ajouter des pièces rouges ou jaunes ou en supprimer. La barre d'état vous indique le nombre de pièces rouges et jaunes, le numéro du coup, le prochain joueur, et si la position est valable. Un point d'exclamation signifie NON, et un signe coché veut dire OUI.

Si la position est non valable et que vous retournez en mode Jeu, vous ne pouvez pas jouer ! Seules des positions valables peuvent être utilisées comme positions de départ pour une partie.

Précédent et Suivant changent seulement le numéro du mouvement mais ne changent aucune pièce.

#### Utilisation

En cliquant avec le bouton gauche ou droit de la souris sur une case vide ou jaune, vous passez en mode Ajout de boule rouge ; en cliquant avec le bouton central sur une case vide ou rouge, vous passez en mode Ajout de boule jaune. Enfin, en cliquant avec le bouton gauche ou droit sur une boule rouge ou avec le bouton central sur une pièce jaune, vous passez en mode Suppression de boule. En tenant le bouton enfoncé et en balayant aux alentours, vous agirez sur chaque case que vous survolez. Vous finissez la modification en relâchant le bouton.

Pour quitter le mode de modification et revenir en mode jeu, décochez simplement Modifier du menu Édition.

##### Utilisation du Presse-papiers

Le plateau en cours de &kenolaba; peut être copié dans le presse-papiers en utilisant la commande Copier du menu Édition, et collée en utilisant Coller. Vous pouvez ainsi copier l'état du plateau d'un programme &kenolaba; vers un autre en sélectionnant Copier dans un programme et Coller dans l'autre, mais pour ce faire il vaut mieux utiliser le mode réseau (voir ci-dessus). Une autre utilisation est d'enregistrer les positions dans un fichier texte (en utilisant Copier et votre éditeur favori) et de récupérer ces positions plus tard en les sélectionnant dans l'éditeur et en les collant dans &kenolaba;.

### Niveau

L'ordinateur peut jouer à quatre niveaux différents, nommés :

- Facile

- Normal

- Difficile

- Défi

Plus le réglage est difficile, plus l'ordinateur cherche longtemps le meilleur mouvement. Vous pouvez interrompre sa recherche en enfonçant la touche S.

### Espion

Espion peut être activé ou désactivé à partir du menu Configuration, option Espion. Si c'est votre tour, vous pouvez voir dans la barre d'état l'estimation de l'ordinateur quant au déplacement que vous voulez faire. Si c'est au tour de l'ordinateur, vous pouvez voir (dans la barre d'état et avec les pièces en sur-brillance) le mouvement qu'il pense actuellement être le meilleur. Bien sûr, ceci change durant sa recherche.

### Choix de la couleur jouée par l'ordinateur

Vous pouvez choisir que l'ordinateur joue avec les Rouges, les Jaunes, ou les deux. Choisissez avant de commencer une partie. Bien sûr, pendant le jeu, vous pouvez changer de coté également. Choisissez Aucun pour jouer contre quelqu'un d'autre. C'est très utile en mode réseau.

## Configuration avancée

&kenolaba; offre des options de configuration avancées pour les intrépides, en vous permettant de changer l'ensemble du système de comptage des points si vous le souhaitez. Pour accéder à ces options avancées, choisissez Configuration Configurer KEnolaba. Lorsque vous changez les réglages, le score obtenu pour la position actuelle avec ces réglages est affiché en bas de la boîte de dialogue, en face de Score pour la position actuelle.

### L'onglet Mouvements

Le nombre de points ajoutés à chaque coup peut être modifié ici, en fonction du type de coup et du nombre de boules impliquées. Les coups joués peuvent se classer dans trois catégories différentes :

Normal

  Un coup normal est un coup lors duquel vous déplacez une ou plusieurs de vos boules, mais lors duquel vous ne poussez aucune des boules de votre adversaire.

Pousser

  Lors d'un coup de type pousser, vous poussez une ou plusieurs boules appartenant à votre adversaire, mais elles restent sur le plateau.

Pousser à l'extérieur

  Lors d'un coup de type pousser à l'extérieur, vous poussez une ou plusieurs des boules appartenant à votre adversaire hors du plateau.

### L'onglet Position

Le nombre de points ajoutés au score total pour une position de plateau dépend du cercle du plateau sur lequel les boules sont. Pour chaque cercle, du centre vers l'extérieur, un nombre de points moyen peut être défini, avec une intervalle en plus ou en moins. Le score attribué à une position donnée varie aléatoirement à l'intérieur de cet intervalle. Ce mécanisme permet d'empêcher les parties jouées uniquement par l'ordinateur de partir dans une boucle infinie.

### L'onglet Alignement

À chaque fois qu'un certain nombre de boules sont alignées, le nombre de points défini ici points est ajouté au score score, &pex; X O O O ajoute les points correspondants à un alignement de trois pièces, ainsi que deux fois les points correspondants à un alignement de deux pièces.

### L'onglet Nombre de boules

Ajoute le nombre de points définis ici en fonction de la différence dans le nombre de boules de chaque adversaire, de 1 boule de plus à 5 boules de plus. S'il y a une différence de six boules, la partie est finie.

## Référence des menus

La manière de déplacer les boules est expliquée à la section Règles du jeu. Les boutons de la barre d'outils ont la même signification que les items du menu Jeu ou Édition.

### Le menu Jeu

&Ctrl;N Jeu Nouveau

  Commence une nouvelle partie, même si une partie est déjà en cours.

S Jeu Arrêter la réflexion

  Quand l'ordinateur réfléchit, sa recherche est interrompue et il joue le meilleur coup qu'il a trouvé à cet instant.

Page Haut Jeu Précédent

  Revient à votre précédent déplacement. Deux ( ! ) coups sont annulés : le mouvement de l'adversaire et votre dernier mouvement. C'est donc à nouveau à vous de jouer. Cent mouvements sont mémorisés ; n'hésitez donc pas à revenir en arrière jusqu'au début du jeu (plus rapide avec la touche F2). Le mode Modifier (voir le menu Édition Modifier ci-dessous), décrémente le numéro de cette position.

Page-bas Jeu Suivant

  Utile seulement en mode Modifier : augmente le numéro de la position.

H Jeu Conseil

  Une aide pour le mouvement suivant est donnée. Possible seulement dans le cas où vous jouez en mode normal ou supérieur, le numéro de la position est supérieur à 2, et votre mouvement n'a pas été annulé.

N Jeu Partie en réseau

  Si ceci est activé, l'application est en mode réseau.

&Ctrl;Q Jeu Quitter

  Quitte &kenolaba;.

### Le menu Édition

&Ctrl;C Édition Copier

  Copie une représentation du plateau de &kenolaba; dans le presse-papiers.

&Ctrl;V Édition Coller

  Interprète le contenu du presse-papiers comme le codage ASCII du plateau de jeu de &kenolaba;. Une représentation du plateau valable peut être obtenue en faisant Copier.

&Ctrl;Inser Édition Modifier

  Bascule &kenolaba; en mode modification.

&Ctrl;S Édition Mémorieser la position

  Vous pouvez enregistrer la position actuelle et la retrouver plus tard avec Édition Restaurer la position.

&Ctrl;O Édition Restaurer la position

  Restaure la position enregistrée dans le fichier de configuration de &kenolaba; par Édition Mémoriser la position.

### Le menu Configuration

&Ctrl;M Configuration Afficher la barre de menus

  Montre ou cache la barre de menus de &kenolaba;.

Configuration Afficher la barre d'outils

  Montre ou cache la barre d'outils de &kenolaba;.

Configuration Afficher la barre d'état

  Montre ou cache la barre d'état de &kenolaba; en bas de l'écran.

Configuration Enregistrer la configuration

  Enregistre les valeurs actuelles des options comme valeurs par défaut de &kenolaba;.

Configuration Raccourcis clavier...

  Ouvre une boîte de dialogue standard de &kde; qui vous permet de personnaliser les raccourcis-clavier de &kenolaba;.

Configuration Barre d'outils...

  Ouvre une boîte de dialogue standard de &kde; vous permettant de personnaliser la barre d'outils de &kenolaba;.

Configuration Niveau

  Choisissez le niveau auquel joue l'ordinateur. Ce peut être :

  - Facile

  - Normal

  - Difficile

  - Défi

Configuration L'ordinateur joue avec

  Vous pouvez choisir que l'ordinateur joue avec :

  - Les rouges

  - Les jaunes

  - Les deux

  - Aucun

Configuration Déplacements lents

  Un mouvement de l'ordinateur est généralement montré (si cette option est cochée) en faisant clignoter et en rehaussant la couleur des pièces utilisées. Dé-sélectionnez cette option si vous ne voulez pas attendre cette animation. Seule la sur-brillance se fera.

Configuration Boules élégantes

  Si vous sélectionnez cette option, le rendu des boules est fait par un traceur de rayon lumineux quand c'est nécessaire, &pex; quand on redimensionne la fenêtre.

Configuration Espion

  Si vous cochez cette option, vous activez le mode Espion.

### Le menu Aide

&help.menu.documentation;

## Options de ligne de commande

    kenolaba

    -p
    MyPortNumber

    -h
    host:port

Avec `-p`, vous spécifiez le numéro de port que doit écouter le socket TCP quand vous êtes en mode réseau

Avec `-h`, vous précisez un processus &kenolaba; distant (avec éventuellement un numéro de port, si vous n'utilisez pas celui par défaut sur la machine distante) pour communiquer en mode réseau. Vous pouvez spécifier plusieurs processus distants.

## Remerciements et Licences

&kenolaba;

Programme copyright 1997-2000 Josef Weidendorfer weidendo@informatik.tu-muenchen.de

Documentation originale par Robert Williams rwilliams@kde.org et Josef Weidendorfer

Documentation mise à jour pour &kde; 2.0 par Philip Rodrigues phil.rod@ntlworld.com

Traduction française par Gérard Delafond g.delafond@medsyn.fr

&underFDL; &underGPL;

## Installation

### Comment obtenir &kenolaba;

&install.intro.documentation;

### Compilation et installation

&install.compile.documentation;