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

<book lang="&language;">

<bookinfo>
<title
>Manuale di gioco per &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>

<othercredit role="translator"
><firstname
>Andrea</firstname
> <surname
>Celli</surname
><affiliation
><address
><email
> a.celli@caltanet.it</email
></address
></affiliation
><contrib
> Traduzione della documentazione</contrib
></othercredit
> 

</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
>2005-12-10</date>
<releaseinfo
>0.3.0</releaseinfo>

<abstract
><para
>&kblackbox; è uno straordinario gioco di logica, ispirato al gioco blackbox contenuto in <application
>emacs</application
>.</para
></abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>KBlackBox</keyword>
<keyword
>kdegames</keyword>
<keyword
>blackbox</keyword>
<keyword
>gioco</keyword>
</keywordset>

</bookinfo>

<chapter id="what-is-kblackbox">
<title
>Cos'è &kblackbox;?</title>

<para
>&kblackbox; è uno straordinario :-) gioco grafico di logica, ispirato al gioco blackbox di <application
>emacs</application
>. Gran parte di questo manuale è basato sul manuale originale di <application
>emacs</application
>. </para>

<para
>&kblackbox; è un gioco di cerca e trova, giocato su un reticolo di celle. Il tuo rivale (in questo caso il generatore di numeri casuali) ha nascosto delle sfere in queste celle. Sparando dei raggi attraverso la scatola e osservando dove emergono è possibile dedurre la posizione delle sfere nascoste. Meno raggi utilizzi per trovare le sfere, migliore (più basso) sarà il tuo punteggio.</para>

</chapter>

<chapter id="game-description">
<title
>Descrizione del gioco.</title>

<para
>Nella prima parte di questa sezione viene data una descrizione dell'ambiente di gioco. La seconda parte riguarda l'interfaccia utente e, dulcis in fundo, nella terza parte sono spiegate le effettive regole di gioco.</para>

<sect1 id="game-board-descritpion">
<title
>Descrizione dell'ambiente di gioco</title>

<para
>L'ambiente di gioco contiene i seguenti tipi di oggetti: </para>

<variablelist>
<varlistentry>
<term
><interface
>Scatola nera</interface
></term>
<listitem
><para
>La scatola nera. Al suo interno devi marcare le celle in cui pensi sia nascosta una sfera.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><interface
>Quadrati verdi</interface
></term>
<listitem
><para
>Questi sono dei laser che emettono dei raggi quando li attivi.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><interface
>Quadrati grigio chiaro</interface
></term>
<listitem
><para
>Niente d'importante, è solo un bordo :).</para
></listitem>
</varlistentry>

<varlistentry>
<term
><interface
>Sfere blu</interface
></term>
<listitem
><para
><quote
>Servivano proprio!</quote
> avrai pensato. Queste segnano le celle della scatola nera in cui tu sospetti ci sia una sfera.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><interface
>Sfere azzurre </interface
></term>
<listitem
><para
>Mostrano dove sono effettivamente le sfere.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><interface
>Sfere rosse</interface
></term>
<listitem
><para
>Le sfere che tu hai posizionato erroneamente vengono segnate in rosso.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><interface
>Celle marroni</interface
></term>
<listitem
><para
>Colore per marcare.</para
></listitem>
</varlistentry>
</variablelist>

<note
><para
>I nomi di colore sono usati solo per identificare i diversi tipi di campo in questo manuale. Essi potrebbero <emphasis
>non</emphasis
> avere alcuna relazione con i colori effettivi. Più semplicemente, la scatola nera è al centro, attorno ci sono i laser e più esternamente il bordo. Riassegna tu i colori come preferisci :-). </para
></note>

</sect1>

<sect1 id="user-interaction">
<title
>Interfaccia utente</title>

<para
>Il cursore può essere mosso in giro per la scatola nera con le abituali frecce o con il mouse. L'attivazione dei laser e il marcamento di una cella sono ottenuti con il &LMB; o premendo i tasti <keycap
>Ritorno a capo</keycap
> o <keycap
>Invio</keycap
>.</para>

<para
>Puoi anche marcare le celle dove tu pensi che non ci sia una sfera. Basta premere il &RMB;. Questo spesso aiuta a delimitare una zona in cui potrebbero stare le sfere. Per eliminare ogni contrassegno (blu o marrone) premi il tasto &LMB;. I segni marroni non possono sovrapporsi a quelli blu. Così non rischi di cancellare per errore un segno blu (sfera presunta) mentre armeggi con il &RMB;. </para>

<para
>Quando sei convinto di aver disposto correttamente tutte le sfere, premi il &MMB;. Ti verrà detto se hai indovinato e ti verrà assegnato un punteggio. Il tuo punteggio sarà il numero di lettere e cifre attorno al margine della scatola nera, più cinque per ogni sfera messa fuori posto. Se hai disposto erroneamente delle sfere, queste diventeranno rosse e le posizioni corrette saranno occupate da sfere azzurre.</para>

</sect1>

<sect1 id="game-rules">
<title
>Regole di gioco</title>

<para
>Devi trovare le sfere nascoste in una scatola nera. I mezzi a tua disposizione sono limitati: puoi solo attivare i laser che stanno attorno alla scatola. Ci sono tre possibili esiti per ogni raggio che invii all'interno della scatola: </para>

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

<varlistentry>
<term
>Deviazione</term
> 
<listitem
><para
>Il raggio viene deviato ed esce da qualche parte, diversa dal punto da cui lo hai lanciato. Sul piano di gioco le deviazioni sono indicate da una coppia di numeri uguali, uno dove il raggio è entrato e l'altro dove è uscito.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Riflessione</term>
<listitem
><para
>Il raggio viene riflesso ed emerge nello stesso punto da cui è stato inviato. Sul piano di gioco la riflessione è indicata con la lettera <guilabel
>R</guilabel
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Collisione</term>
<listitem
><para
>Il raggio colpisce in pieno una sfera e viene assorbito. Non esce più dalla scatola. Sul piano di gioco, le collisioni sono indicate con la lettera <guilabel
>H</guilabel
>.</para
></listitem>
</varlistentry>
</variablelist>

<para
>Le regole secondo cui le sfere riflettono i raggi sono semplici e si spiegano facilmente tramite esempi.</para>

<para
>Quando un raggio sfiora una sfera è deviato di 90°. I raggi possono essere deviati più di una volta. Nei diagrammi seguenti, i trattini rappresentano celle vuote e le lettere <guilabel
>O</guilabel
> delle sfere. I punti di ingresso e di uscita di ogni raggio sono denotati con un numero come descritto nel precedente paragrafo  <link linkend="detour"
>Deviazione</link
>. Nota che il punto di ingresso e di uscita sono interscambiabili. Gli <guilabel
>*</guilabel
> segnano il percorso seguito dal raggio.</para>

<para
>Osserva attentamente le posizioni relative delle sfere e le deviazioni di 90° che causano.</para>

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

<para
>Come già detto, abbiamo una riflessione quando un raggio esce dallo stesso punto dove era entrato. Questo può succedere in diversi casi: </para>

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

</screen>

<para
>Nel primo esempio, il raggio è deviato verso il basso dalla sfera superiore, poi a sinistra da quella inferiore e, alla fine, ripercorre la strada verso il suo punto di origine. Il secondo esempio è simile. Il terzo esempio è un po' anomalo, ma può essere compreso pensando che il raggio non ha mai la possibilità di entrare nella scatola. Altrimenti, si può pensare che il raggio sia immediatamente deviato verso il basso, uscendo subito dalla scatola.</para>

<para
>Una collisione avviene quando un raggio centra in pieno una sfera.</para>

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

</screen>

<para
>Non tralasciare di confrontare il secondo esempio di collisione con il primo di riflessione.</para>

</sect1>
</chapter>
<chapter id="gui-description">
<title
>Descrizione dell'ambiente grafico</title>

<sect1 id="game-menu">
<title
>Il menu <guimenu
>Partita</guimenu
></title>

<variablelist>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
> </shortcut
> <guimenu
>Partita</guimenu
> <guimenuitem
>Nuova</guimenuitem
></menuchoice
></term>
<listitem
><para
>Avvia una nuova partita (e abbandona quella eventualmente in corso).</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Partita</guimenu
> <guimenuitem
>Arrenditi</guimenuitem
></menuchoice
></term>
<listitem
><para
>Ti mostra le posizioni delle sfere.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Partita</guimenu
> <guimenuitem
>Fatto</guimenuitem
></menuchoice
></term>
<listitem
><para
>Controlla se tutte le sfere sono state collocate. Se sì, termina il gioco in corso, calcola il punteggio finale ed indica la vera disposizione delle sfere. Il tasto <mousebutton
>centrale</mousebutton
> del mouse ha la stessa funzione. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Partita</guimenu
> <guimenuitem
>Ridimensiona</guimenuitem
></menuchoice
></term>
<listitem
><para
>Ridimensiona la finestra principale per adattarla perfettamente al suo contenuto. E` utile quando modifichi per sbaglio la dimensione della finestra...</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
> </shortcut
> <guimenu
>Partita</guimenu
> <guimenuitem
>Esci</guimenuitem
></menuchoice
></term>
<listitem
><para
>Abbandona &kblackbox;.</para
></listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="settings-menu">
<title
>Il menu <guimenu
>Impostazioni</guimenu
></title>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Impostazioni</guimenu
><guimenuitem
>Mostra/nascondi la barra degli strumenti</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
>Mostra o nasconde la barra degli strumenti di &kblackbox;.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Impostazioni</guimenu
><guimenuitem
>Mostra/Nascondi la barra di stato</guimenuitem
> </menuchoice
></term>
<listitem>
<para
>Mostra o nasconde la barra di stato di &kblackbox;.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Impostazioni</guimenu
><guisubmenu
>Dimensione</guisubmenu
></menuchoice
></term>
<listitem
><para
>Imposta la dimensione del campo di gioco (scatola nera). Puoi scegliere tra <guimenuitem
>8 x 8</guimenuitem
>, <guimenuitem
>10 x 10</guimenuitem
> e <guimenuitem
>12 x 12</guimenuitem
>. È preimpostato come <guimenuitem
>8 x 8</guimenuitem
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Impostazioni</guimenu
><guisubmenu
>Sfere</guisubmenu
></menuchoice
></term>
<listitem
><para
>Definisce il numero di sfere nella scatola nera. Puoi scegliere tra <guimenuitem
>4</guimenuitem
> (predefinito), <guimenuitem
>6</guimenuitem
> o <guimenuitem
>8</guimenuitem
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Impostazioni</guimenu
><guimenuitem
>Esercitazione</guimenuitem
></menuchoice
></term>
<listitem
><para
>Inizia o termina un'esercitazione. Durante un'esercitazione, puoi vedere dove sono effettivamente le sfere. Tieni conto che il cambiamento avrà effetto solo dopo l'avvio di una nuova partita.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Impostazioni</guimenu
><guimenuitem
>Configura scorciatoie...</guimenuitem
></menuchoice
></term>
<listitem
><para
>Mostra l'abituale finestra di &kde; per configurare le scorciatoie, tramite la quale puoi modificare le scorciatoie utilizzate in &kblackbox;.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Impostazioni</guimenu
><guimenuitem
>Configura la barra degli strumenti...</guimenuitem
> </menuchoice
></term>
<listitem>
<para
>Attiva il solito modulo &kde; per la configurazione della barra degli strumenti per permetterti di personalizzare quella di &kblackbox;.</para>
</listitem>
</varlistentry>

</variablelist>

</sect1>

<sect1 id="help">
<title
>Il menu <guimenuitem
>Aiuto</guimenuitem
></title>
&help.menu.documentation; </sect1>

<sect1 id="toolbar">
<title
>La barra degli strumenti</title>

<screenshot>
<screeninfo
>barra degli strumenti di &kblackbox;</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="kblackboxtbar.png" format="PNG"/>
</imageobject>
</mediaobject>
</screenshot>

<para
>La barra degli strumenti di &kblackbox; offre un rapido accesso alle funzioni di &kblackbox; più usate. Da sinistra a destra le icone sono:</para>

<variablelist>

<varlistentry>
<term
><guiicon
>Nuova</guiicon
></term>
<listitem
><para
>Avvia una nuova partita</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guiicon
>Arrenditi</guiicon
></term>
<listitem
><para
>Ti mostra le posizioni delle sfere.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guiicon
>Fatto</guiicon
></term>
<listitem
><para
>Controlla se tutte le sfere sono state collocate. Se sì, termina il gioco in corso, calcola il punteggio finale ed indica la vera disposizione delle sfere. Il tasto <mousebutton
>centrale</mousebutton
> del mouse ha la stessa funzione. </para
></listitem>
</varlistentry>

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

<chapter id="credits-and-license">
<title
>Riconoscimenti e Licenza</title>

<para
>&kblackbox;</para>

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

<para
>Documentazione di &Robert.Cimrman;. Aggiornata e convertita in formato docbook per &kde;-2.0 da &Lauri.Watts; &Lauri.Watts.mail;</para>

<para
>Responsabile attuale: &Philip.Rodrigues; &Philip.Rodrigues.mail; </para>

<para
>Traduzione della documentazione e dell'interfaccia grafica: Andrea Celli <email
>a.celli@caltanet.it</email
></para
><para
>Traduzione dell'interfaccia grafica: Andrea Rizzi <email
>rizzi@kde.org</email
></para
> 
&underFDL; &underGPL; </chapter>


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

&install.intro.documentation;

<sect1 id="compilation">
<title
>Compilazione ed installazione</title>
&install.compile.documentation; </sect1>
</appendix>

</book>

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

