Manuale di KTuberling

# Manuale di KTuberling

Éric Bischoff `<e.bischoff@noos.fr>`

Paul E. Ahlquist, Jr. `<pea@ahlquist.org>`

Eugene Trounev `<eugene.trounev@gmail.com>`

Revisore: Lauri Watts
Traduzione della documentazione: Valter Mura
Traduzione della documentazione e dell'interfaccia grafica: Andrea Celli
Revisione KDE Gear 21.08 (2021-10-04)

Diritto d'autore © 1999, 2000, 2002, 2006 Éric Bischoff

Diritto d'autore © 2001 Paul E. Ahlquist, Jr.

Nota Legale

Potato Guy è un gioco pensato per i più piccoli.

Lista delle tabelle

4.1. Pulsanti della barra degli strumenti

Capitolo 1. Introduzione
Introduzione

# Capitolo 1. Introduzione

Tipo di gioco: divertimento

Numero massimo giocatori: Uno

Potato Guy è un semplice gioco di costruzioni adatto tanto ai bambini che agli adulti. L'idea del gioco è basata su un tradizionale metodo per costruire pupazzi. Una patata veniva decorata con vari ammennicoli per renderla simile a un bambolotto. Potato Guy va molto oltre come contenuti e offre una sorprendente varietà di temi.

Capitolo 2. Come si gioca
Come si gioca

# Capitolo 2. Come si gioca

Potato Guy è un gioco pensato per i bambini. Naturalmente, può essere giocato da adulti che sono rimasti giovani dentro.

Si tratta di un «modificatore di patate». Ciò significa che puoi trascinare occhi, bocche, baffi, altre parti del viso e ornamenti, per posizionarli su un uomo-patata. Analogamente, hai a disposizione altri ambienti in cui sistemare altre cose.

Non c'è un vincitore del gioco. L'unico obiettivo è quello di disegnare la faccia più divertente che ti riesce.

Potato Guy può anche «parlare». Dirà i nomi degli oggetti che prendi per sistemare. «Parlerà» in una lingua a tua scelta. Puoi anche utilizzarlo per imparare qualche parola in lingue straniere.

Capitolo 3. Regole e suggerimenti
Regole e suggerimenti

# Capitolo 3. Regole e suggerimenti

## Operazioni col mouse

La finestra principale è divisa in due zone:

- L'area con la «scena».

- Deposito degli «Oggetti», dove puoi scegliere gli oggetti da disporre sulla scena.

### Nota

L'aspetto effettivo dell'applicazione può cambiare a seconda della «scena» selezionata.

### Disporre un oggetto

Per prelevare un oggetto, sposta il puntatore del mouse nel deposito degli «oggetti» e fai clic su di esso. Poi portalo sulla «scena» e fissalo con un altro clic.

### Nota

La dimensione degli oggetti può variare mentre li trascini. Alcuni oggetti enormi sono stati ridotti di scala per farli entrare nel deposito degli «oggetti».

### Spostare un oggetto

Una volta sistemato sulla «scena», un oggetto, questo può ancora essere spostato. Basta selezionarlo con un clic e poi trascinarlo e riposizionarlo. Quando lo lasci, esso verrà posto in primo piano rispetto agli altri oggetti che lo nascondevano parzialmente. Questo trucco è utile per sistemare correttamente occhi e occhiali.

### Rimuovere un oggetto

Per rimuovere un oggetto che è stato collocato sulla «scena», basta ritrascinarlo dalla «scena» al deposito degli «oggetti».

Capitolo 4. Uno sguardo all'interfaccia
Uno sguardo all'interfaccia

# Capitolo 4. Uno sguardo all'interfaccia

## La barra degli strumenti

La barra degli strumenti contiene dei pulsanti che attivano le funzioni più comuni.

Tabella 4.1. Pulsanti della barra degli strumenti

Pulsante | Nome | Equivalente nel menu | Azione
--- | --- | --- | ---
| Nuovo | Gioco → Nuovo | Ripristina la «scena». Ossia pulisce completamente il disegno, in modo che si possa creare una nuova decorazione.
| Carica… | Gioco → Carica… | Apre un precedente file `.tuberling` presente nel sistema.
| Salva | Gioco → Salva | Salva la tua creazione nella tua cartella personale o in qualsiasi altra del sistema. `.tuberling` viene salvato su un piccolo file che contiene solo le posizioni degli oggetti.
| Stampa… | Gioco → Stampa… | Stampa il tuo disegno.
| Annulla | Modifica → Annulla | Annulla l'ultima operazione
| Rifai | Modifica → Rifai | Compie nuovamente l'ultima operazione annullata.

Le voci del menu
Le voci del menu

## Le voci del menu

### Il menu Gioco

Gioco → Nuovo (Ctrl+N)

  Ripulisce la «scena».

Gioco → Carica… (Ctrl+O)

  Apre un file `.tuberling` esistente, caricandolo dal sistema.

Gioco → Salva (Ctrl+S)

  Salva la tua creazione. L'uomo patata o il pinguino sono salvati in un piccolo file che riporta solo le posizioni degli oggetti.

Gioco → Salva come immagine…

  Crea un file grafico che contiene un'immagine del tuo uomo-patata.

Gioco → Stampa… (Ctrl+P)

  Stampa l'immagine del tuo uomo-patata.

Gioco → Esci (Ctrl+Q)

  Esce da Potato Guy.

### Il menu Modifica

Modifica → Annulla (Ctrl+Z)

  Annulla l'ultima collocazione di un «oggetto».

Modifica → Rifai (Ctrl+Shift+Z)

  Ripristina l'ultima collocazione di un «oggetto». Questa voce di menu è attiva solo se si è usata precedentemente l'opzione Annulla.

Modifica → Copia (Ctrl+C)

  Copia la «scena» negli appunti.

### Il menu Vista

Impostazioni → Modalità a tutto schermo (Ctrl+Shift+F)

  Passa dalla modalità a finestre a quella a schermo intero, e viceversa.

### Il menu Scena

Scena → Blocca le proporzioni

  Questa opzione conserva l'aspetto della scena quando ridimensioni la finestra di Potato Guy. Quando i rapporti tra le dimensioni della scena non coincidono con quelli della finestra, lo sfondo libero viene riempito con quello del tema.

Scena → `Nome della scena`

  Passa alla scena indicata.

Conterrà tutte le scene installate su questo sistema.

Al prossimo riavvio Potato Guy si ricorderà dell'ultima scena che hai scelto e inizierà da quella.

### Il menu Voce

Voce → Muto

  Spegne il sonoro.

Voce → `Nome della lingua`

  Attiva il sonoro nella lingua che hai scelto.

Al prossimo riavvio Potato Guy si ricorderà di questa impostazione.

### I menu Impostazioni e Aiuto

Inoltre Potato Guy ha le voci di menu Impostazioni e Aiuto comuni a tutto KDE. Per ulteriori informazioni leggere le sezioni relative Menu Impostazioni e Menu Aiuto dei Fondamentali di KDE.

Capitolo 5. Domande frequenti
Domande frequenti

# Capitolo 5. Domande frequenti

5.1. Vorrei cambiare l'aspetto del gioco. Posso?
5.2. Posso giocare con la tastiera?
5.3. Ho fatto un bellissimo disegno e voglio farlo vedere ai miei amici. Posso salvarlo in formato immagine?

5.1. | Vorrei cambiare l'aspetto del gioco. Posso?
| Certo che puoi. Segui le indicazioni dell'apposita sezione di "Uno sguardo all'interfaccia" per informazioni dettagliate.
5.2. | Posso giocare con la tastiera?
| No. Questo gioco non può essere giocato con la tastiera.
5.3. | Ho fatto un bellissimo disegno e voglio farlo vedere ai miei amici. Posso salvarlo in formato immagine?
| Sì. Per salvare la sessione corrente in formato immagine segui le indicazioni dell'apposita sezione di "Uno sguardo all'interfaccia".

Capitolo 6. Documentazione tecnica
Documentazione tecnica

# Capitolo 6. Documentazione tecnica

Éric Bischoff

Traduzione della documentazione tecnica: Andrea Celli
Revisione KDE Gear 21.08 (2021-10-04)

KTuberling fornisce un'introduzione agevole e gratificante alla programmazione e personalizzazione in KDE. Questa applicazione può essere estesa. Per esempio, si possono introdurre nuove scene cambiando i file grafici, senza bisogno di programmare. Aggiungendo gli appropriati file sonori, i traduttori possono mettere i commenti sonori nella propria lingua.

Se crei estensioni o aggiunte al gioco, considera l'idea di inviare i tuoi contributi allo sviluppatore Alex Fiestas affinché possa includerli nelle prossime versioni.

## Per i disegnatori

Per creare una nuova scena di KTuberling devi:

- Disegnare lo sfondo in formato SVG, per farlo dovrai:

  - Dare un nome al punto dove gli oggetti possono essere trascinati sullo «sfondo».

  - Dare un nome univoco a tutti gli oggetti trascinabili.

- Creare un file `.theme`. Che deve rispettare questo schema:

      <playground gameboard="TuoFileSVG" name="IlFileDesktop">
          <object name="NomeOggetto" sound="NomeSuono" scale="ValoreOpportuno" />
          ...
          ...
          ...
          </playground>

  - `TuoFileSVG` è il nome del file SVG che contiene il disegno.

  - `IlFileDesktop` è il nome del file del desktop che ha il nome del tema.

  - Per ogni oggetto ti serve una voce `<object>`. `NomeOggetto` è il nome univoco che hai usato nel file SVG, `NomeSuono` è la voce che si sente quando trascini l'oggetto. Vedi il file `sounds/soundthemes.HOWTO` presente nel codice sorgente per maggiori informazioni.

  - `scale` è opzionale e `ValoreOpportuno` è il fattore di scala che viene applicato all'oggetto quando viene trascinato fuori dal deposito. Se non è specificato, sarà 1.

- Per creare un file `.desktop` bisogna seguire questo schema:

      [KTuberlingTheme]
      Name=NomeTema

  - `NomeTema` è il nome che identifica il tema. Verrà mostrato nel menu Scena.

- Se vuoi aggiungere il tuo tema nel deposito di KTuberling, devi aggiungere i file `.svg`, `.theme` e `.desktop` alla sezione `FILES` del file `CMakeLists.txt` nella cartella `pics/`.

- Se vuoi installarlo per te stesso, copia i file `.svg`, `.theme` e `.desktop` all'interno della cartella `ktuberling/pics` in `qtpaths `--paths GenericDataLocation``

Per i traduttori
Per i traduttori

## Per i traduttori

Oltre all'abituale sistema dei file `.po` per tradurre messaggi e richieste del programma, occorrerà localizzare anche i file sonori.

Per creare un nuovo tema sonoro per KTuberling devi:

- Registrare i suoni su file con formato OGG Vorbis rc3.

- Creare un file ``Codice2LettereXTuaLingua``. soundtheme file, che deve avere questo schema:

      <language code="Codice2LettereXTuaLingua">
      <sound name="NomeSuono" file="PercorsoRelativo" />
      ...
      ...
      ...
      </language>

  - `Codice2LettereXTuaLingua` è il codice in due lettere che individua la tua lingua, ad esempio "it" per italiano.

  - Per ogni suono serve una riga `<sound>`. `NomeSuono` deve corrispondere al NomeSuono specificato nel tema della scena (vedi `pics/themes.HOWTO` dal codice sorgente). `PercorsoRelativo` deve essere il percorso relativo da seguire per trovare dove è installato il file con questo suono. Tipicamente sarà ``QualcosaDiUnivoco`/`NomeSuono`.`formato`` (ad esempio, `QualcosaDiUnivoco` potrebbe essere il codice di due lettere della tua lingua).

- Se vuoi aggiungere il tuo tema sonoro a KTuberling:

  - Aggiungi i file audio e i file `.soundtheme` nella cartella `data/kdegames/ktuberling` delle traduzioni della tua lingua.

  - Proprio in questa cartella dovrai creare un file `CMakeLists.txt` che indica come installare i file. La sua forma tipica è:

        FILE( GLOB oggfiles *.ogg )
        INSTALL( FILES ${oggfiles} DESTINATION ${KDE_INSTALL_DATADIR}/ktuberling/sounds/Codice2LettereXTuaLingua )
        INSTALL( FILES Codice2LettereXTuaLingua.soundtheme DESTINATION ${KDE_INSTALL_DATADIR}/ktuberling/sounds/ )

- Se vuoi installarlo per te stesso:

  - Copia il file ``Codice2LettereXTuaLingua`.soundtheme` nella cartella `ktuberling/sounds` in `qtpaths `--paths GenericDataLocation``

  - Copia i tuoi file audio nella cartella `ktuberling/sounds/`unPercorsoUnivoco`` in `qtpaths `--paths GenericDataLocation``

Le informazioni su come utilizzare i meccanismi di traduzione per KDE sono disponibili su The KDE Translation HOWTO.

Per i programmatori
Per i programmatori

## Per i programmatori

Non è molto difficile per un programmatore estendere KTuberling.

### Classi C++

`TopLevel`

  Gestione a alto livello della finestra e del programma base.

`PlayGround`

  Descrizione di uno dei livelli di gioco.

`ToDraw`

  Descrizione di uno degli «oggetti» grafici da disegnare.

`SoundFactory`

  Descrizione di una lingua e dei suoi suoni.

`Action`

  Una delle manipolazioni dell'utente sullo stack annulla/rifai.

Capitolo 7. Riconoscimenti e licenza
Riconoscimenti e licenza

# Capitolo 7. Riconoscimenti e licenza

KTuberling

- Alex Fiestas `(alex AT eyeos.org)` - attuale sviluppatore

- John Calhoun - Idea originale, disegni originali e suoni inglesi

- Éric Bischoff `(e.bischoff AT noos.fr)` - KDE Programmazione

- François-Xavier Duranceau `(duranceau AT free.fr)` - Prove, consigli e aiuto

- Peter Silva `(peter.silva AT videotron.ca)` - Revisione bozze documentazione

- Paul E. Ahlquist, Jr. `(pea AT ahlquist.org)` - Miglioramenti alla documentazione

Traduzione della documentazione e dell'interfaccia grafica Andrea Celli `(andrea.celli AT libero.it)`

Traduzione della documentazione Valter Mura `(valtermura AT gmail.com)`

Voce dell'edizione italiana Clara Tattoni `(clara.tattoni AT libero.it)`

Questa documentazione è concessa in licenza sotto i termini della GNU Free Documentation License.

Questo programma è concesso in licenza sotto i termini della GNU General Public License.