Capitolo 2. Creare un tema di KsirK

Ogni tipo di sprite (bandiera, fanteria, cavalleria, cannone, cannone che fa fuoco e cannone che esplode) è definito da un gruppo. Solo alcuni sprite hanno una voce per la larghezza. Questa voce viene usata per il posizionamento relativo durante le animazioni: i cannoni, che facciano fuoco o che esplodano, non dovrebbero «spostarsi» attorno alla bandiera dello stato durante il combattimento.

Per ogni stato elencato nel gruppo onu, la voce countries ha il suo gruppo, la cui etichetta è il nome dello stato. La tabella sotto elenca le voci di questi gruppi.

Per ogni nazionalità elencata nel gruppo onu, la voce nationalities ha il suo gruppo, la cui etichetta è il nome della nazionalità. La tabella sotto elenca le voci di questi gruppi.

Per ogni continente elencato nel gruppo onu, la voce continents ha il suo gruppo, la cui etichetta è il nome del continente. La tabella sotto elenca le voci di questi gruppi.

Per ogni obiettivo elencato nel gruppo onu, la voce goals ha il suo gruppo, la cui etichetta è il nome dell'obiettivo. La tabella sotto elenca le voci di questi gruppi.

Questo file SVG contiene la mappa e tutti gli sprite del gioco. Ogni elemento ha un nome, in modo che il programma possa selezionare e rendere separatamente ciascuno di essi.

Nel tema predefinito, gli sprite sono bandiere, fanteria, cavalleria e cannone. La fanteria rappresenta un'armata, la cavalleria cinque e il cannone dieci. I cannoni sono usati anche per visualizzare le armate in combattimento: è per questo che ci sono tre tipi di sprite per i cannoni: cannone normale fermo o in movimento, cannone che fa fuoco e cannone che esplode.

Ogni immagine degli sprite è la concatenazione di varie viste dell'oggetto, e per ogni vista i suoi fotogrammi. Le viste sono organizzate verticalmente e i fotogrammi orizzontalmente. Dividendo l'altezza dell'immagine per il numero di viste e la larghezza per il numero di fotogrammi si calcola dove tagliare l'immagine in fotogrammi individuali. Questi dati si trovano nel file onu.desktop.

Un esempio di immagine sprite: cannon.png

Per gli sprite delle armate, ci sono tre viste diverse, dall'alto in basso:

Per le bandiere, c'è solo una vista. Tutti gli sfondi degli sprite dovrebbero essere trasparenti.

Un esempio di un'immagine sprite di una bandiera: italy.png.

Tabella 2.7. Gli elementi del magazzino

Nome dell'elemento	Immagine campione	Significato
map		Mappa del mondo del tema. Gli stati possono avere forme arbitrarie, ma dovrebbero essere raggruppati in continenti riconoscibili a occhio, per posizione o per colore.
italy		La bandiera della nazione italiana. C'è una voce simile per ogni nazione.
infantry		Icona che rappresenta un'armata.
cavalry		Icona che rappresenta cinque armate.
cannon		Icona che rappresenta dieci armate.
firing		Icona che rappresenta dieci armate durante un combattimento.
exploding		Icona che rappresenta le armate sconfitte.
alaska		La forma dello stato dell'Alaska; si usa per evidenziarlo. C'è una forma simile per ogni stato. Il suo colore non viene usato, quindi, si è liberi di sceglierne uno qualsiasi.
reddices		I dadi rossi usati per mostrare i risultati delle battaglie.
bluedices		I dadi blu usati per mostrare i risultati delle battaglie.
mark1		Questo marcatore viene aggiunto agli sprite in combattimento per indicare il numero di armate che rappresentano, in questo caso 1. Ci sono anche degli elementi mark2 e mark3.

Anche questo è un file png che rappresenta il mondo del tema, ma con colori in codice che permettono di identificare ogni stato. Gli stati devono avere almeno le stesse forme degli stati corrispondenti in map.png, in modo che gli utenti possano fare clic ovunque in uno stato visibile e selezionare quello giusto. Stati come le isolette dell'Indonesia nella mappa predefinita possono essere più grandi dell'equivalente nel file map.png per facilitarne la selezione.

Il componente blu (nel modello RGB) di uno stato lo identifica: l'indice 0 è lo stato 0 nel file onu.xml, l'indice 1 è lo stato 1, ecc.. Il bianco (0xFFFFFF in RGB) indica l'assenza di uno stato, come per i mari o le terre di nessuno.

I nomi dei file sono fissati nel codice, quindi non vanno modificati. La tabella sotto indica tutti i pulsanti che si dovrebbero fornire.

Tabella 2.8. I pulsanti dell'interfaccia

Immagine	Nome del file	Significato
	newNetGame.png	Cerca di entrare in una partita in rete.
	recycling.png	Dopo che tutti i giocatori hanno disposto le loro armate, è possibile modificarne la distribuzione (cosiddetto riciclo). Questo pulsante chiede di eseguire questa redistribuzione.
	recyclingFinished.png	Sceglie di non ridistribuire. Tutte le finestre dei client devono avere questo pulsante premuto per concludere la redistribuzione.
	nextPlayer.png	Conclude il turno del giocatore attuale e passa al prossimo giocatore, o al prossimo turno se il giocatore attuale era l'ultimo.
	attackOne.png	Sceglie di cominciare un attacco con un'armata.
	attackTwo.png	Sceglie di cominciare un attacco con due armate.
	attackThree.png	Sceglie di cominciare un attacco con tre armate.
	defendOne.png	Sceglie di difendere uno stato attaccato con un'armata.
	defendTwo.png	Sceglie di difendere uno stato attaccato con due armate.
	moveArmies.png	Sceglie di cominciare lo spostamento di armate tra stati (ultima azione del turno).