# Manuale di &kenolaba;

## Introduzione

&kenolaba; è un semplice gioco di strategia che si gioca in due. Ogni giocatore ha delle bilie rosse o gialle. Si parte da una disposizione in cui ogni giocatore ha 14 bilie e si continua a giocare finché uno dei giocatori non ha spinto 6 bilie dell'avversario fuori dal tavoliere.

Il programma originale fu sviluppato nel 1993 per DOS in puro Xlib. E` stato riscritto quasi completamente per &kde; .

Se conosci il gioco da tavolo chiamato Abalone, ti piacerà questo programma. In effetti, il programma è stato ispirato da quel gioco. Abalone è un marchio registrato della Abalone SA, Francia.

## Regole del gioco

Il rosso muove sempre per primo.

Sono permessi due tipi di mossa:

Normale

- Puoi muovere di una posizione, in una delle 6 direzioni, una, due o tre delle tue bilie, purché allineate. Sono permessi anche spostamenti laterali.

  Premi con il &LMB; sulla prima bilia che vuoi muovere (ndt: quella che spingerà le altre). La bilia verrà evidenziata. Ora trascina il mouse nella direzione voluta. Se la mossa è valida, il cursore diventerà una freccia puntata in quel verso e tutte le bilie da muovere saranno evidenziate. Se questo è il movimento voluto, rilascia il tasto del mouse.

  Gli spostamenti laterali si ottengono in un altro modo. Per spostare due bilie adiacenti, fai clic tra di esse e trascinale. Per tre bilie, premi il &MMB; sulla bilia di mezzo. Se quelle bilie possono essere spostate lateralmente, cambieranno tutte colore. Altrimenti verrà evidenziata solo la bilia centrale e farai una mossa normale.

Spinte

- Puoi spingere al più due bilie dell'avversario poste di fronte alle tue, purché il numero delle tue bilie in azione sia superiore a quello delle bilie avversarie da spingere. Questo significa che tre bilie tue possono spingere una o due bilie avversarie, mentre due bilie ne spostano una sola.

  Le spinte importanti sono quelle che spingono una bilia avversaria fuori dal tavoliere. Se riesci a spingere fuori dal tavoliere sei bilie avversarie, hai vinto la partita.

Se ancora non hai capito del tutto come funziona &kenolaba;, non preoccuparti. Osserva una partita in cui il computer gioca contro se stesso. Dopo aver lanciato &kenolaba;, scegli Impostazioni Il computer gioca come Entrambi e avvia una nuova partita.

## Partite in rete

### Generalità sulle partite in rete

&kenolaba; può essere giocato in rete. Ciò permette a due persone di giocare l'una contro l'altra da due diversi computer, o ad una persona di osservare una partita in corso su un altro computer. Per a &kenolaba; in rete bisogna impostarlo in modalità network, scegliendo Partita Partita in rete.

Tutte le istanze di &kenolaba; che sono attive e sono impostate in modalità network, trasmettono da l'una all'altra gli spostamenti delle bilie.

Per trasmettersi le nuove posizioni i programmi &kenolaba; devono comunicare tra di loro. Se stanno girando sulla stessa macchina non serve nulla (tranne che passare in modalità rete). Se girano su computer diversi, dovrai specificare l'altra macchina con una riga di comando, usando l'opzione `-h` in questo modo:

    %kenolaba -h Un_nome_di_macchina

Per i più esperti: &kenolaba;, quando è in modalità rete, ascolta su un socket TCP in attesa che gli altri programma &kenolaba; inviino comandi di spostamento. Si può specificare il numero della porta con l'opzione `-p` nella riga di comando. Questo è necessario solo se vuoi giocare due diverse partite di &kenolaba; in rete.

#### Esempi

- Chris su `macchina1` e Mary su `macchina2` vogliono giocare l'uno contro l'altra: Mary semplicemente avvia &kenolaba;, imposta Nessuno in Impostazioni Il computer gioca come e passa in modalità Network. Chris avvia &kenolaba; con

      %kenolaba -h macchina2

  e poi agisce come Mary. Ora, uno dei due può avviare la partita e muovere il rosso. Appena la disposizione delle bilie è modificata in un programma, automaticamente cambia anche nell'altro.

- John vuole osservare la partita: deve fare le stesse operazioni di Chris, ma non dovrà fare nessuna mossa.

- Si possono giocare due diverse partite in rete tra due macchine `m1` e `m2`. Per mantenerle distinte sceglieremo la porta 12345 per una delle due. Su `m1` partiremo come al solito:

      %kenolaba

  per avviare la prima partita, e (in modo meno usuale):

      %kenolaba -p 12345

  per la seconda. Su `m2` avvieremo la prima partita con:

      %kenolaba -h m1

  e la seconda con:

      %kenolaba -h  m1:12345

  (I due-punti separano l'host dalla porta come in un &URL;).

## Opzioni avanzate

### Modalità di modifica

Si può modificare la disposizione sul tavoliere scegliendo Modifica Modifica per porre &kenolaba; in modalità modifica. Si potranno aggiungere bilie rosse o gialle, o rimuoverne. La barra di stato mostrerà il numero di bilie rosse e gialle, il numero della mossa, il giocatore a cui tocca la prossima mossa, e se la disposizione è valida. Un punto esclamativo indica che non è valida, una V che lo è.

Se la disposizione è inammissibile e si torna alla normale modalità di gioco, non si potrà giocare! Si possono usare solo disposizioni ammissibili come punto di partenza per una partita.

Mosse Torna indietro e Mosse Avanti si limitano a ridurre ed aumentare il numero progressivo della mossa, ma non spostano nessuna bilia.

#### Utilizzo

Premendo il tasto sinistro o destro del mouse su una posizione vuota od occupata da una bilia gialla ti poni in modalità Aggiungi bilie rosse. Premendo il tasto centrale su una posizione vuota od occupata da una bilia gialla ti poni in modalità Aggiungi bilie gialle. Infine, premendo il tasto sinistro o destro del mouse su una bilia rossa, o quello centrale su una gialla, ti poni in modalità Rimuovi bilie. Ogni bilia su cui il mouse passerà con il tasto premuto sarà distrutta.

Per uscire dalla modalità Modifica e tornare in modalità Gioco, basta disattivare Modifica nel menu Modifica.

##### Utilizzo del clipboard

L'attuale tavoliere di &kenolaba; può essere copiato nel clipboard usando il comando Copia nel menu Modifica, e poi recuperato usando Incolla. In questo modo puoi copiare la disposizione di una partita di &kenolaba; in un'altra. Basta premere Copia in un programma e Incolla nell'altro. Però è meglio farlo in modalità Network (vedi sopra). Un altro utilizzo è quello di salvare la disposizione in un file di testo (usando Copia e un editor a tua scelta) per recuperarla in seguito selezionandola nell'editor e incollandola in &kenolaba;.

### Abilità del computer

Il computer può giocare a quattro differenti livelli di abilità:

- Facile

- Normale

- Difficile

- Sfida

Più alto è il livello impostato, più tempo il computer impiegherà per calcolare una mossa. Tu puoi interrompere questo calcolo premendo il tasto S.

### Spiare

Lo spionaggio può essere attivato o disattivato tramite l'opzione Spia del menu Impostazioni. Se è il tuo turno, puoi vedere nella barra di stato la valutazione che il computer dà della mossa che vuoi fare. Se tocca al computer, puoi vedere (barra di stato e bilie evidenziate) la valutazione della mossa che esso considera al momento la migliore. Ovviamente questa cambierà durante il suo calcolo della mossa da compiere.

### Scelta del colore per il computer

Puoi far giocare il computer come rosso o giallo o in entrambi i ruoli. Scegli una di queste opzioni prima di avviare una partita. Naturalmente puoi farlo anche a partita in corso, se vuoi scambiare le parti. Per giocare contro un'altra persona scegli Nessuno. Questo è molto utile in modalità network.

## Opzioni avanzate

&kenolaba; offre delle opzioni di configurazione avanzate per le gare.Ti permette, se lo vuoi, di modificare completamente il modo di calcolare il punteggio. Per accedere a queste opzioni avanzate, seleziona Impostazioni Configura Kenolaba....Non appena cambi le impostazioni, il punteggio calcolato col tuo nuovo metodo viene mostrato in fondo alla finestra, dopo la scritta Valutazione della posizione attuale.

### La scheda Mosse

Qui può essere modificato il numero di punti aggiunti per ogni tipo di mossa, al variare del tipo di mossa e di quanti pezzi vengono coinvolti. Le mosse sono divise in tre categorie:

Normale

- Una mossa normale è quando tu sposti una o più delle tue bilie, ma non spingi nessuna di quelle avversarie.

Spinta

- Una "spinta" è quando fai una mossa con cui sposti una o più delle bilie avversarie, ma queste restano sul tavoliere.

Espulsione

- Una "espulsione" è quando fai una mossa con cui sposti una o più bilie avversarie buttandole fuori dal tavoliere.

### La scheda Posizione

Il numero di punti aggiunti alla valutazione globale per la disposizione sul tavoliere sono legati alla distanza delle bilie dal centro. Per ogni anello concentrico, a partire dal centro, viene accreditato un punteggio che può essere variato all'interno di un intervallo. Ossia, il punteggio per una particolare posizione sarà un numero casuale, preso all'interno di un certo intervallo. Questo serve ad evitare che le partite tra computer finiscano in stallo.

### La scheda Allineamento

Ogni volta che delle bilie risultano allineate, viene assegnato un prefissato numero di punti alla valutazione. ⪚ X O O O aggiunge una volta il punteggio previsto per "tre allineate" e due volte quello per "due allineate".

### La scheda Conteggio

Aggiunge un dato punteggio in base alla differenza tra il numero di bilie rimasto ai due contendenti. Si parte da 1 bilia in più fino a 5 bilie in più. Se c'è una differenza di 6 bilie, la partita è terminata.

## Utilizzo dei menu

Le mosse sono state spiegate in Regole del gioco. I pulsanti nella barra degli strumenti hanno la stessa funzionalità delle corrispondenti voci nei menu Partita o Modifica.

### Il menu Partita

&Ctrl;N Partita Nuova

- Avvia una nuova partita anche se ce ne è una in corso.

N Partita Partita in rete

- Se questa opzione è impostata, il programma sarà in modalità Network.

&Ctrl;Q Partita Esci

- Esce da &kenolaba;.

### Il menu Modifica

&Ctrl;C Modifica Copia

- Copia una rappresentazione del tavoliere di &kenolaba; sul clipboard

&Ctrl;V Modifica Incolla

- Interpreta il contenuto del clipboard di X, considerandolo una rappresentazione ASCII di una disposizione dei pezzi di &kenolaba;, e lo copia sul tavoliere. Una valida rappresentazione ASCII può essere generata con Copia.

&Ctrl;Ins Modifica Modifica

- Fa passare &kenolaba; in modalità modifica.

&Ctrl;S Modifica Salva disposizione

- Salva la disposizione attuale per poterla recuperare in futuro con Modifica Ripristina disposizione .

&Ctrl;O Modifica Ripristina disposizione

- Ripristina la disposizione delle bilie memorizzata nel file di configurazione di &kenolaba; tramite Modifica Salva disposizione .

### Il menu Mosse

H Mosse Suggerimento

- Viene fornito un suggerimento per la tua prossima mossa. È disponibile solo se stai giocando a livello normale o superiore, sei almeno alla seconda mossa e non ne hai appena annullata una.

S Mosse Ferma calcolo mossa

- Quando il computer sta pensando, viene interrotta una ricerca più approfondita ed esso gioca la migliore mossa che ha trovato fino a quel momento.

PgSu Mosse Torna indietro

- Annulla la tua mossa precedente. In realtà vengono cancellate due (!) mosse: la tua e quella dell'avversario. Così tocca di nuovo a te. Vengono memorizzate 100 mosse; quindi non esitare a tornare indietro fino all'inizio del gioco (è più veloce se usi il tasto F2). Quando sei in modalità modifica (vedi Modifica Modifica più avanti), viene scalato il numero che indica la mossa.

PgGiù Mosse Avanti

- Utile solo in modalità modifica: incrementa il numero che individua questa disposizione.

### Il menu Impostazioni

&Ctrl; M Impostazioni Mostra la barra dei menu

- Mostra o nasconde la barra dei menu di &kenolaba;.

Impostazioni Mostra la barra degli strumenti

- Mostra o nasconde la barra degli strumenti di &kenolaba;.

Impostazioni Mostra la barra di stato

- Mostra o nasconde la barra di stato di &kenolaba; alla base della finestra.

Impostazioni Salva impostazioni

- Salva le impostazioni attuali, rendendole predefinite per &kenolaba;.

Impostazioni Scegli il tipo di gioco

- Imposta il livello a cui giocherà il computer. Può essere scelto tra:

  - Facile

  - Normale

  - Difficile

  - Sfida

Impostazioni Il computer gioca come

- Sceglie il colore per il computer. Può essere scelto tra:

  - Rosso

  - Giallo

  - Entrambi

  - Nessuno

Impostazioni Muovi piano

- Con questa opzione attivata, le mosse del computer saranno mostrate facendo lampeggiare ed evidenziando le bilie da muovere. Se non vuoi attendere a causa di questa animazione, disattiva questa opzione. Sarà mostrato solo un rapido lampeggio.

Impostazioni Resa grafica bilie

- Se questa opzione è abilitata, le bilie saranno disegnate in tempo reale tramite un semplice ray tracer, quando necessario (⪚ quando si ridimensiona la finestra).

Impostazioni Spia

- Se attivato, permette di spiare le mosse del computer.

Impostazioni Configura scorciatoie...

- Carica, l'abituale interfaccia di &kde; per configurare le associazioni tra tasti e azioni. Così potrai personalizzare quelle da usare in &kenolaba;.

Impostazioni Configura la barra degli strumenti...

- Carica, l'abituale interfaccia di &kde; che configura la barra degli strumenti, per personalizzare quella di &kenolaba;.

Impostazioni Configura Kenolaba...

- Carica la finestra di dialogo per modificare le impostazioni di &kenolaba;. Vedi advanced-config.

### Il menu Aiuto

&help.menu.documentation;

## Opzioni da riga di comando

    kenolaba  -p NumeroMiaPorta   -h host:port

Con `-p` viene specificato il numero della porta su cui sarà in ascolto il socket TCP quando si è in modalità network.

Con `-h` viene specificato un processo &kenolaba; remoto (con un numero di porta opzionale, se non si usa la porta standard sulla macchina remota) con cui comunicare quando si è in modalità network. Si può specificare più di un processo remoto.

## Riconoscimenti e licenze

&kenolaba;

Copyright 1997-2000 sul programma: &Josef.Weidendorfer; &Josef.Weidendorfer.mail;

Documentazione originale: Robert Williams rwilliams@kde.org e Josef Weidendorfer

Documentazione mantenuta da &Philip.Rodrigues; &Philip.Rodrigues.mail;.

Traduzione della documentazione e dell'interfaccia grafica: Andrea Celli a.celli@caltanet.it

&underFDL; &underGPL;

## Installazione

### Come procurarsi &kenolaba;

&install.intro.documentation;

### Compilazione e Installazione

&install.compile.documentation;