Expanded user guide

report-src/report.tex

@@ -513,26 +513,62 @@ \subsection{Federico Bagattoni}
 Tirando le somme percepisco che durante il corso si è affermata nella mia mente (e sono sicuro anche in quella di molti altri studenti) non la figura del "Corso di \textit{Programmazione (\textbf{progettazione e design}) ad oggetti}" quanto più il "Corso di \textit{Java}" ed è per questo che valuto (e rimpiango), solo alla fine, gli aspetti progettuali di questo corso che il corpo docente insegna con una notevole passione.
 \appendix
 \chapter{Guida utente}
-Il menu di gioco mostra all'utente due possibilità: iniziare una partita o intraprendere la guida. Incoraggiamo fortemente un principiante a seguire il secondo punto al fine di comprendere in prima persona il funzionamento del gioco.
+Il menu di gioco mostra all'utente due possibilità: iniziare una partita o intraprendere la guida. 
+\newline
+Incoraggiamo fortemente un principiante a seguire il secondo punto al fine di comprendere in prima persona il funzionamento del gioco.
+\newline
+Tuttavia è opportuno leggere ugualmente l'intera appendice in quanto la guida utente non contiene la spiegazione di meccaniche di gioco avanzate.
 \subsection{Match}
-All'inizio di un match si è generati nell'angolo in alto a sinistra di una mappa quadrata. L'obbiettivo del gioco è rimanere l'ultimo giocatore in vita eliminando gli altri giocatori attraverso l'esplosione di una bomba.   
+All'inizio di un match si è generati nell'angolo in alto a sinistra di una mappa quadrata. L'obbiettivo del gioco è rimanere l'ultimo giocatore in vita eliminando gli altri giocatori attraverso l'esplosione di una bomba. 
+\newline
 Premendo \keys{W}, \keys{A}, \keys{S}, \keys{D} il giocatore può muoversi.
 Tramite la barra spaziatrice \keys{space} è possibile piazzare una bomba.
-Ogni giocatore, all'inizio della partita, può piazzare una sola bomba mentre raccogliendo il relativo powerup \textit{allarga} il suo inventario.
+Ogni giocatore, all'inizio della partita, può piazzare una sola bomba mentre il giocatore può allargare questo spazio con l'uso di potenziamenti.
 \newline
-I powerup si presentano come dei cubi verdi con un immagine centrata al loro interno. Permettono di potenziare o depotenziare le statistiche del giocatore oppure forniscono una bomba \textit{one-time-use} come per esempio la line bomb, che premendo il tasto \keys{L} permette di piazzare tre bombe nella direzione in cui si sta guardando.
-Oppure la bomba remote che può essere detonata unicamente premendo il tasto \keys{P}.
+Detonare le bombe vicino alle casse permetterà di distruggerle fornendo spazio di movimento al giocatore e da la possibilità alla apparizione di un potenziamento (power up).
+\newline
+I powerup si presentano come dei cubi verdi con un immagine centrata al loro interno. Permettono di potenziare o depotenziare le statistiche del giocatore oppure forniscono una bomba \textit{one-time-use} come per esempio la line bomb
+oppure la bomba remote, spiegate nella sezione \ref{sec:puexpl}.
+I powerup danno il loro effetto sul giocatore nel momento che sono raccolti, per i powerup \textit{one time use} se ne viene raccolto un altro prima dell'utilizzo di uno precedente questo viene sovrascritto.
 \newline
 Un powerup da cui si deve stare in guardia è lo \texttt{Skull} (v. figura \ref{img:fig-skull}) che dona uno svantaggio casuale al player per un periodo limitato di tempo, tra cui: velocità estremamente alta o bassa, drop di bombe costante mentre il player cammina o nessuna bomba disponibile. 
 
 \begin{figure}[h]
-\centering{}
-\includegraphics{img/powerups/skull.png}
-\caption{Powerup Skull nel gioco}
-\label{img:fig-skull}
+    \centering{}
+    \includegraphics{img/powerups/skull.png}
+    \caption{Powerup Skull nel gioco}
+    \label{img:fig-skull}
 \end{figure}
 Dopo 2 minuti la mappa inizierà a \textbf{collassare} partendo dall'angolo in alto a sinistra e seguendo una forma a spirale, se si è colpiti da un muro si viene eliminati.
 
+\begin{figure}[h]
+    \centering{}
+    \includegraphics[width=0.7\textwidth]{img/map-collapse.PNG}
+    \caption{Collasso dell'arena a seguito dello scadere del tempo, il personaggio in basso a sinistra è stato appena colpito da un muro}
+\end{figure}
+
+\label{sec:puexpl}\subsubsection{Powerup con comportamento particolare}
+E' opportuno segnalare all'utente che i seguenti powerup hanno un comportamento particolare che potrebbe non essere compreso immediatamente:
+\begin{itemize}
+    \item{Remote bomb: la \textbf{prossima bomba piazzata} è remota e viene detonata esclusivamente premendo il tasto \keys{P}}
+    \begin{figure}[h]
+        \centering{}
+        \includegraphics{img/powerups/bomb_remote.png}
+        \caption{Remote bomb powerup}
+    \end{figure}
+    \item{Line bomb: premendo il tasto \keys{L} è possibile piazzare tutte le bombe che si ha nell'inventario (a meno di incontrare un muro) nella direzione in cui si sta guardando. E' comunque possibile piazzare una bomba normale premendo \keys{Space}}
+    \begin{figure}[h]
+        \centering{}
+        \includegraphics{img/powerups/line_bomb.png}
+        \caption{Line bomb powerup}
+    \end{figure}
+    \item{Piercing bomb: la fiamma generata dalla prossima bomba piazzata distruggerà tutti i muri che incontra fino a raggiungere il suo range massimo, distruggendo eventualmente tutti i powerup generati da questi muri}
+    \begin{figure}[h]
+        \centering{}
+        \includegraphics{img/powerups/bomb_pierce.png}
+        \caption{Piercing bomb}
+    \end{figure}
+\end{itemize}
 \chapter{Esercitazioni di laboratorio} 
 Nessuno studente ha consegnato i laboratori di programmazione ad oggetti. 
 \end{document}