# Manuale di &palapeli;

## Introduzione

&palapeli; è un gioco di puzzle per giocatore singolo.

La finestra di &palapeli; è divisa in due aree, la raccolta e il tavoliere del puzzle. Il manuale descriverà queste due aree.

## Sfogliare la raccolta del puzzle

Quando avvii &palapeli; per la prima volta, la raccolta del tuo puzzle contiene alcuni puzzle predefiniti forniti con &palapeli;. Fai clic su uno di essi per iniziare subito a giocare. La partita si svolge nel tavoliere del puzzle; consulta la sezione dopo la seguente per imparare a usare il tavoliere.

Oltre che per la selezione di un puzzle, la raccolta di puzzle può essere utilizzata per le seguenti azioni:

- creare nuovi puzzle da immagini sul tuo disco

- importare puzzle creati da altri

- esportare puzzle per condividerli con gli amici e il mondo

- eliminare puzzle non più necessari

La sezione seguente mostra come eseguire queste operazioni con i pulsanti della barra degli strumenti.

### Panoramica della barra degli strumenti

Puoi selezionare i puzzle nell'elenco dei puzzle premendo insieme &Ctrl; e &LMB;. Se premi &LMB; o &RMB; senza &Ctrl; si apre il puzzlespecifico nel tavoliere.

Crea un nuovo puzzle

- Apre una finestra che permette di creare un puzzle da un'immagine sul disco. Vedi la sezione successiva per i dettagli.

Elimina

- Tutti i puzzle che hai selezionato nell'elenco saranno eliminati definitivamente dalla tua libreria.

  Questa azione non può essere annullata.

Importa da file

- Al ricevimento di un file puzzle &palapeli; (normalmente riconoscibile dall'estensione di file `*.puzzle`), puoi utilizzare questa azione per importarlo nella tua raccolta locale. I file puzzle possono essere anche eseguiti facendovi semplicemente sopra clic all'interno del tuo gestore di file preferito, ma dopo l'importazione; il puzzle apparirà nella tua raccolta locale e sarà possibile eliminare il file scaricato.

Esporta su file

- Questa azione esporterà i puzzle correntemente selezionati in file, per permetterti di regalarli ai tuoi amici, pubblicarli nel web o eseguire copie di sicurezza della tua raccolta.

## Creare nuovi puzzle

Come descritto nella sezione precedente, puoi creare nuovi puzzle facendo clic sul pulsante Crea un nuovo puzzle sulla raccolta dei puzzle.

Facendo clic su questo pulsante si apre la finestra per la creazione del puzzle, formata da tre pagine:

1. Nella prima pagina selezioni un file immagine presente sul disco, divisibile in pezzi. Assicurati di inserire i dati aggiuntivi corretti per l'immagine: devi indicare l'autore dell'immagine (per es., il fotografo o il disegnatore); rispetta il copyright dell'autore dell'immagine.

2. Nella seconda pagina, puoi selezionare il tipo di pezzi in cui l'immagine dovrà essere divisa. &palapeli; contiene una raccolta di tipi di ritagli preinstallati, ma potrebbero essere disponibili anche ritagli di terze parti.

3. Nella pagina finale della finestra può essere personalizzato il ritaglio selezionato, per es. scegliendo un numero di pezzi diverso oppure regolando i parametri della forma del pezzo. Il gruppo di opzioni disponibili dipende dal tipo di ritaglio selezionato.

Questo manuale continuerà la trattazione dei ritagli forniti con &palapeli;. Se hai scaricato un'estensione di ritaglio di terze parti, fai riferimento alla documentazione dell'estensione, in caso di problemi durante l'installazione o il suo uso nel sistema.

### &psc;

&psc; produce pezzi a incastro realistici con diversi modelli base:

Griglia rettangolare

- Contiene i famosi pezzi rettangolari.

Griglia Cairo

- Con i suoi pezzi pentagonali e gli angoli degli spigoli diseguali è molto difficile risolvere il puzzle dato che i pezzi incastrano assieme in modo non comune.

Griglia esagonale

- Produce pezzi esagonali disposti a nido d'ape.

Griglia Rotrex

- Grazie a una speciale composizione di pezzi triangolari, esagonali e rettangolari, i pezzi formano un modello che assomiglia tanti cerchi intersecanti.

Griglia irregolare

- Questa griglia è disponibile solo se hai installato qvoronoi dal pacchetto qhull. qvoronoi viene usato per calcolare forme irregolari dei pezzi partendo da punti stabiliti casualmente.

&psc; contiene vari parametri che controllano l'aspetto del bordo dei pezzi, specialmente riguardo i tasselli. Vengono fornite impostazioni predefinite per tutti questi parametri. È disponibile una preselezione aggiuntiva che riduce i parametri a una quantità minima. Sono in genere disponibili i parametri seguenti:

Conteggio appross. pezzi

Percentuale capovolgimento bordo

- La probabilità per ciascun tassello di essere capovolto. Un tassello è considerato capovolto se è rivolto nella direzione opposta, considerando una griglia regolare completa. Su una griglia rettangolare, ciò produce pezzi con tre o quattro tasselli rivolti all'interno piuttosto che all'esterno. Posizionando il cursore all'estrema sinistra si ottiene una griglia regolare totalmente normale. Nel mezzo, l'orientazione dei tasselli è casuale. Alla destra, la griglia è di nuovo totalmente regolare ma con una regola «alternata». Questo non significa l'inversione di tutti i tasselli: nella griglia regolare alternata, per esempio, ciascun pezzo ha quattro tasselli rivolti all'interno oppure quattro rivolti all'esterno. Questa impostazione non ha effetto sulla griglia irregolare.

Curvatura del bordo

- Determina quanto sono curvi i bordi, per es. quanto i bordi sono ammaccati o rigonfi. Sposta il cursore all'estrema sinistra per ottenere bordi lisci (ad eccezione dei tasselli).

Dimensione tassello

- Determina la dimensione del tassello per ciascun bordo. L'impostazione predefinita (posizione mediana del cursore) viene scelta per assomigliare a un puzzle vero. Il cursore determina la dimensione con un intervallo che va da 50% a 150%, misura in cui esso risulta esageratamente grande. Il programma tenta di evitare la collisione tra i tasselli. I bordi che collidono vengono ricreati più volte e ristretti pian piano. Vi sono casi, tuttavia, in cui non è possibile trovare una soluzione, soprattutto per i tasselli di dimensioni grandi.

Varietà della curvatura

- Determina quanto varia la curvatura (vedi sopra) tra i bordi. Sposta il cursore verso sinistra per rendere uguali le ammaccature e i rigonfiamenti. Verso destra, possono capitare bordi molto curvati e dritti.

Varietà posizione tassello

- Determina quanto varia la posizione del tassello sul bordo. All'estrema sinistra, i tasselli sono posti a metà bordo.

Varietà dei tasselli

- Determina le caratteristiche singolari dei tasselli. All'estrema sinistra, i tasselli sembrano tutti uguali. All'estrema destra, ciascun tassello sarà un pezzo artistico creato in modo speciale per te.

Irr.: Varietà della dimensione pezzo

- Solo per le griglie irregolari: determina come varia la dimensione del pezzo. Un'impostazione molto bassa significa quasi nessuna variazione; si erge una struttura simile a cristallite. Impostazioni più alte producono pezzi molto piccoli e molto grandi.

Memorizza immagine della griglia

- Salva un'immagine della griglia (bordi neri su sfondo bianco) in `~/goldberg-slicer-dump.png`. Se esiste un salvataggio precedente, esso viene sovrascritto.

### Ritagli precedenti (legacy)

Per ragioni storiche, &palapeli; include anche i tipi di ritagli "pezzi classici" e "pezzi rettangolari". Questi ritagli creano pezzi rettangolari semplici con o senza tasselli. Entrambi i ritagli permettono il conteggio dei pezzi e la regolazione delle proporzioni. Spostando il cursore della proporzione verso sinistra si produrranno pezzi alti, regolandolo verso destra, pezzi larghi. La selezione predefinita produce pezzi più o meno quadrati.

## Giocare sul tavoliere del puzzle

Il tavoliere del puzzle (dettaglio)

L'oggetto della partita è assemblare i pezzi dati in un'immagine.

I pezzi possono essere spostati liberamente facendo clic e trascinandoli col &LMB;. Puoi selezionare più pezzi assieme mantenendo premuto &Ctrl; e facendo clic sopra di essi, oppure trascinando un'area di selezione intorno a loro col &LMB;.

Quando posizioni un pezzo vicino ad uno contiguo, essi si agganceranno automaticamente (1). Dopo essersi agganciati assieme, i pezzi non possono essere più staccati. A differenza della realtà, non puoi combinare due pezzi che non siano realmente contigui.

La barra di avanzamento sotto il tavoliere del rompicapo indica i tuoi progressi (2). &palapeli; salverà automaticamente i tuoi progressi dopo ogni mossa, di modo che normalmente non dovrai occuparti del salvataggio.

Con la rotella del mouse, o con il regolatore in basso a destra (3), puoi cambiare il livello di ingrandimento della vista del tavoliere. Facendo clic e trascinando col &RMB; puoi spostare la vista del tavoliere.

Il movimento dei pezzi è limitato dall'area del tavoliere del rompicapo. Quest'area è rappresentata da una leggera ombra rettangolare sullo sfondo del tavoliere. Quando sposti i pezzi nel bordo (4) dell'area del tavoliere, l'area si espanderà automaticamente, offrendoti più spazio per muovere i tuoi pezzi. Vicino ai bordi ombreggiati, il cursore del mouse cambia in una doppia freccia, e indica che puoi regolare l'area del tavoliere facendovi sopra clic e trascinando col &LMB;.

Puoi bloccare l'area del tavoliere del puzzle tramite il piccolo pulsante (5) immediatamente a destra della barra di avanzamento. L'ombra (4) intorno al tavoliere diventerà scura, e i pezzi smetteranno di muoversi ai bordi dell'area del tavoliere. È possibile regolare manualmente la dimensione dell'area del tavoliere.

### Interazioni con il mouse

Come descritto nella sezione precedente, vi sono molti modi per interagire con il tavoliere di &palapeli; tramite il mouse. Puoi configurare liberamente le azioni da eseguire con i vari pulsanti (per ulteriori dettagli su questa configurazione, consulta la sezione Configurazione del gioco). L'elenco seguente riassume tutte le azioni del mouse possibili:

Cambia la dimensione dell'area del tavoliere trascinando i suoi bordi

- Per impostazione predefinita questa azione è assegnata al &LMB;.

Sposta i pezzi col trascinamento

- Quando fai clic e trascini un pezzo del puzzle, il pezzo viene spostato. Se selezioni più pezzi e fai clic su uno e lo trascini, tutti i pezzi vengono spostati. Per impostazione predefinita, questa azione è assegnata al &LMB;.

Sposta l'area di visualizzazione col trascinamento

- Per impostazione predefinita questa azione è assegnata al &RMB;.

Seleziona più pezzi alla volta

- Se fai clic su un'area libera del tavoliere, invece che su un pezzo, puoi trascinare un'area elastica. Se rilasci il mouse, tutti i pezzi all'interno dell'area elastica vengono selezionati, mentre i pezzi all'esterno vengono deselezionati. Per impostazione predefinita questa azione è assegnata al &LMB;.

Seleziona i pezzi col clic del mouse

- Se fai clic su un singolo pezzo, questo verrà selezionato. Se era già selezionato, allora verrà deselezionato. Per impostazione predefinita, questa azione è assegnata al &LMB; ed è disponibile solo quando mantieni premuto &Ctrl;.

Commuta il blocco dell'area del tavoliere

- Questa azione è uguale alla pressione del pulsante (5) sulla barra di stato. Per impostazione predefinita, questa azione non è assegnata ad alcun pulsante del mouse, ma puoi abilitarla nella finestra di configurazione.

Scorri orizzontalmente l'area di visualizzazione e Scorri verticalmente l'area di visualizzazione

- Per By default, this action is not assigned to the mouse wheel, but you can enable it from the configuration dialog.

Ingrandisci/riduci l'area di visualizzazione

- Questa azione è identica al movimento del cursore (3) nella barra di stato. Per impostazione predefinita, questa azione è assegnata alla rotella del mouse.

### Panoramica della barra degli strumenti

Riavvia il puzzle

- Tralascia i progressi salvati per questo puzzle.

## Panoramica dell'interfaccia

Le due aree di &palapeli;, la raccolta di puzzle e il tavoliere, sono incorporate come schede all'interno della barra del menu. Sono presenti anche menu con azioni standard, descritti sotto.

Impostazioni Mostra la barra di stato del tavoliere

- Mostra o nasconde la visualizzazione della barra di avanzamento e i pulsanti sotto il tavoliere. Questa azione non modificherà nulla nella raccolta di puzzle.

Impostazioni Configura &palapeli;...

- Apre una finestra di configurazione del gioco. Consulta la sezione Configurazione del gioco per ulteriori dettagli.

In aggiunta, &palapeli; contiene gli elementi di menu Impostazioni e Aiuto, comuni di &kde;, per ulteriori informazioni leggi le sezioni relative al menu Impostazioni e menu Aiuto dei Fondamentali di &kde;.

## Configurazione del gioco

Per aprire la finestra di configurazione, usa l'opzione nella barra del menu: Impostazioni Configura &palapeli;...

### Impostazioni generali

Sfondo

- Ti permette di scegliere un'altra trama di sfondo per il tavoliere. Se scegli un colore singolo anziché una trama, il pulsante dietro la casella di selezione può essere usato per definire questo singolo colore.

Aspetto del pezzo

- Controlla l'aspetto dei pezzi nel tavoliere del puzzle. Se &palapeli; funziona in modo lento, o se i puzzle ci mettono molto a caricare, puoi disattivare gli effetti grafici in questa categoria, in modo da aumentare la velocità generale.

Precisione aggancio

- Ti consente di scegliere quanto vicino uno all'altro i pezzi contigui debbano essere posizionati affinché si aggancino assieme. Se sposti il regolatore più verso destra, i pezzi si agganceranno anche se non sono molto vicino. Ciò rende il gioco un po' più semplice da gestire.

### Interazione del mouse

Questa pagina della finestra di dialogo della configurazione ti permette di assegnare le interazioni del mouse, descritte nella sezione Giocare sul tavoliere del puzzle, a pulsanti del mouse diversi. Le interazioni sono divise tra quelle che possono essere assegnate ai pulsanti del mouse (⪚ Sposta l'area di visualizzazione col trascinamento) e quelle che possono essere assegnate alla rotella del mouse (⪚ Scorri orizzontalmente l'area di visualizzazione).

#### Scheda pulsanti del mouse

Affianco al nome di ciascuna interazione è presente un pulsante con l'immagine di un mouse che mostra l'azione attualmente assegnata. Puoi configurare l'interazione facendo clic su quel pulsante col &LMB; e poi col pulsante del mouse cui vuoi assegnare l'interazione. Se mantieni premuti i tasti modificatori mentre fai clic per una seconda volta, il tavoliere permetterà l'interazione solo se questi tasti modificatori vengono mantenuti premuti.

Anziché fare clic, puoi anche premere Spazio per assegnare a questa interazione il pulsante speciale Nessun pulsante. Ciò viene permesso solo se i tasti modificatori vengono mantenuti premuti. Nessun pulsante significa che i tasti modificatori assumono il ruolo di pulsante del mouse: l'interazione inizia quando i tasti modificatori vengono premuti e di ferma quando uno di essi viene rilasciato.

#### Scheda rotella del mouse

Questa scheda funziona in modo simile alla precedente. Quando il pulsante alla destra richiede un'azione di immissione, anziché premere il pulsante devi girare la rotella del mouse. È consentito pure premere i tasti modificatori, con gli stessi effetti del caso precedente.

Se il tuo mouse possiede una rotella bidirezionale (come comunemente avviene nei touchpad dei notebook), ne puoi trarre vantaggi: il pulsante riconoscerà se hai girato la rotella orizzontalmente o verticalmente.

## Riconoscimenti e licenza

&palapeli; intende portare il tranquillo divertimento e la sfida dei puzzle nella tua scrivania.

L'idea è stata inizialmente sviluppata da Bernhard Schiffner, insieme con Stefan Majewsky, che è l'attuale sviluppatore principale di &palapeli;. Johannes Löhnert ha contribuito al &psc;.

Copyright della documentazione 2009, 2010 Johannes Löhnert, Stefan Majewsky.

Valter Mura valtermura@gmail.com

&underFDL; &underGPL;

## Installazione

&install.intro.documentation;

### Compilazione e installazione

&install.compile.documentation;
&documentation.index;