# Manuale di &kabalone;

Josef
Weidendorfer
Philip
Rodrigues

    phil.rod@ntlworld.com

Lauri
Watts

    lauri@kde.org

Revisore
Andrea
Celli

    a.celli@caltanet.it

Traduzione della documentazione e dell'interfaccia grafica
2001-05-29
1.06.00
2001
Philip Rodrigues
&FDLNotice;

&kabalone; �un semplice gioco di strategia che si gioca in due su un tavoliere speciale.

KDE
gioco
abalone
linux

## Introduzione

&kabalone; �un semplice gioco di strategia che si gioca in due su un tavoliere speciale. Ci sono delle biglie rosse o gialle a seconda del giocatore. Si parte da una disposizione in cui ogni giocatore ha14 biglie e si continua a giocare finch�uno dei giocatori non ha spinto 6 biglie dell'avversario fuori dal tavoliere.

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

L'idea del gioco non �mia. Si tratta di un vero gioco da tavola, commercializzato (credo) da una ditta tedesca specializzata in giochi.

## Regole del gioco

Il rosso muove sempre per primo.

Sono permessi due tipi di mossa:

Normale

  Puoi muovere uno, due o tre delle tue biglie, purch�allineate, in una delle 6 direzioni. Sono permessi anche spostamenti laterali.

  Premi col tasto sinistro del mouse sulla prima biglia che vuoi muovere (ndt: quella che spinger�le altre). La biglia 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 biglie 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 biglie adiacenti, fai clic tra di esse e trascinale. Per tre biglie, devi premere il tasto centrale del mouse sulla biglia di mezzo. Se lo spostamento laterale �possibile per quelle biglie, esse verranno evidenziate. Altrimenti cambier�colore solo la biglia centrale e tu potrai effettuare una mossa normale.

Spinte

  Puoi spingere al pi due biglie dell'avversario poste di fronte alle tue,purch�il numero delle tue biglie in movimento sia superiore a quello delle biglie avversarie da spingere. Questo significa che con tre biglie tue puoi spingere una o due biglie avversarie, mentre con due biglie una sola.

  Le spinte importanti sono quelle che spingono una biglia avversaria fuori dal tavoliere. Se sei riuscito a spingere fuori dal tavoliere sei biglie avversarie hai vinto la partita.

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

## Partite in rete

### Generalit�sulle partite in rete

&kabalone; supporta il gioco tramite un network. Ci permette a due persone di giocare l'una contro l'altra da due diversi computers, o ad una persona di osservare una partita in corso su un altro computer.Per usare le funzioni di rete in &kabalone; bisogna impostarlo, in modalit�network scegliendo Partita Partita in rete.

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

Per trasmettersi le nuove posizioni i programmi &kabalone; devono dialogare tra di loro. Se stanno girando sulla stessa macchina non serve nulla (tranne che passare in modalit�network). Se girano su computer diversi, dovrai specificare l'altra macchina dalla linea di comando, usando l'opzione `-h` in questo modo:

    %kabalone -h Un_nome_di_macchina

Per i pi esperti: &kabalone;, quando �in modalit�Network, ascolta su un socket TCP in attesa che l'altro programma Abalone invii comandi di spostamento . Si pu specificare il numero della porta con l'opzione `-p` nella linea di comando. Questo �necessario solo se vuoi giocare due diverse partite di Abalone in rete.

#### Esempi

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

      %kabalone -h macchina2

  e poi agisce come Mary. Ora, uno dei due pu avviare la partita e muovere il rosso. Appena la disposizione delle biglie �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 and m2. Per mantenerle distinte sceglieremo la porta 12345 per una delle due. Su m1 partiremo come al solito:

      %kabalone

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

      %kabalone -p 12345

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

      %kabalone -h m1

  e la seconda con:

      %kabalone -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 &kabalone; in modalit�modifica. Si potranno aggiungere biglie rosse o gialle, o rimuoverne. La barra di stato mostrer�il numero di biglie 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.

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

#### Utilizzo

Premendo il tasto sinistro or destro del mouse su una posizione vuota od occupata da una biglia gialla ti poni in modalit�Aggiungi biglie rosse; premendo il tasto centrale su una posizione vuota od occupata da una biglia gialla ti poni in modalit�Aggiungi biglie gialle. Infine, premendo il tasto sinistro o destro del mouse su una biglia rossa, o quello centrale su una gialla, ti poni in modalit�Distruggi biglie. Ogni biglia 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 &kabalone; 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 &kabalone; 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) e recuperala in seguito selezionandola nell'editor e incollandola in &kabalone;.

### 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 biglie evidenziate) la valutazione della mossa che esso considera al momento la migliore. Ovviamente questa cambier�durante il calcolo della mossa da farsi.

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

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

S Partita 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 Partita Torna indietro

  Annulla la tua mossa precedente. In realt�vengono cancellate due (!) mosse: la tua e quella dell'avversario. Cos�tocca ancora 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 Partita Avanti

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

S Partita Suggerimento

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

N Partita Partita in rete

  Se questa opzione �impostata, il programma sar�in modalit�Network.

&Ctrl;Q Partita Esci

  Esceda &kabalone;.

### Il menu Modifica

&Ctrl;C Modifica Copia

  Copia una rappresentazione del tavoliere di &kabalone; sul clipboard

&Ctrl;V Modifica Incolla

  Interpreta il contenuto del clipboard di X considerandolo una rappresentazione ASCII di una disposizione dei pezzi a &kabalone; e la copia sul tavoliere. Una valida rappresentazione ASCII pu essere generata con Copia.

CtrlIns Modifica Modifica

  Fa passare &kabalone; 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 biglie memorizzata nel file di configurazione di &kabalone; tramite Modifica Salva disposizione .

### Il menu Impostazioni

&Ctrl; M Impostazioni Mostra la barra dei menu

  Mostra o nasconde la barra dei menu di &kabalone;.

Impostazioni Mostra la barra degli strumenti

  Mostra o nasconde la barra degli strumenti di &kabalone;

Impostazioni Mostra la barra di stato

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

Impostazioni Salva le impostazioni

  Salva le impostazioni attuali, rendendole quelle predefinite per &kabalone;.

Impostazioni Configura le associazioni dei tasti...

  Carica, per personalizzare quelle da usare in &kabalone;, la classica finestra di &kde; per la configurazione delle associazioni tra tasti e azioni.

Impostazioni Configura la barra degli strumenti...

  Carica, per personalizzare quella di &kabalone;, la classica finestra di &kde; di configurazione della barra degli strumenti.

Impostazioni Livello

  Imposta il livello a cui giocher�il computer. Pu essere scelto tra:

  - Facile

  - Normale

  - Difficile

  - Sfida

Impostazioni Il Computer gioca come

  Scegli 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 biglie da muovere. Se non vuoi attendere a causa di questa animazione, disattiva questa opzione. Sar�mostrata solo una rapida evidenziazione.

Impostazioni Resa grafica biglie

  Se questa opzione �abilitata, le biglie saranno disegnate in tempo reale tramite un semplice ray tracer, quando necessario (&eg; quando si ridimensiona la finestra).

Impostazioni Spia

  Se attivato, permette di spiare le mosse del computer.

### Il menu Aiuto

F1 Aiuto Contenuti

  Avvia il sitema di guide &kde; a partire dalle pagine dedicate a &kabalone; (questo documento).

ShiftF1 Aiuto Che cos'�

  Trasforma il cursore del mouse in una freccia con un punto interrogativo. Facencdo clic con questa freccia su una voce di &kabalone;, si aprir�una finestra con una spiegazione (se disponibile per la particolare voce) delle funzionalit�d essa associate.

Aiuto Segnala un bug

  Riferisce agli autori di &kabalone; un bug o un miglioramento desiderato.

Aiuto Informazioni su KAbalone

  Mostra informazioni sulla versione e sugli autori.

Aiuto Informazioni su KDE

  Mostra la versione di &kde; ed altre informazioni basilari.

## Opzioni da linea di comando

    kabalone

    -p
    MyPortNumber

    -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 &kabalone; 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.

## Crediti & Licenze

&kabalone;

Copyright 1997-2000 sul programma: Josef Weidendorfer weidendo@informatik.tu-muenchen.de

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

Aggiornamento della documentazione per &kde; 2.0: Philip Rodrigues philip.rodrigues@libertysurf.co.uk

Traduzioni italiane curate dal Team di traduzione di KDE. Questo documento è stato tradotto da Andrea Celli a.celli@caltanet.it

&underFDL; &underGPL;

## Installazione

### Come procurarsi &kabalone;

&kabalone; fa parte del progetto &kde; (http://www.kde.org). &kabalone; si trova nel pacchetto kdegames a ftp://ftp.kde.org/pub/kde/, che �il principale sito &FTP; del progetto &kde;.

Tutte le librerie richieste possono essere reperite anche nel sito &FTP; di &kde;.

### Compilazione e Installazione

Per compilare ed installare &kabalone; sul tuo sistema, dovrai posizionarti nella directory di &kabalone; della tua copia dei kdegames ed immettere questi comandi:

    % ./configure
    % make
    % make install

Poich�&kabalone; utilizza autoconf e automake non dovrebbero sorgere problemi nel compilarlo. Se ne dovessero capitare, per favore riferiscili all'autore all'indirizzo weidendo@informatik.tu-muenchen.de