added xrick game

original xrick code by 'BigOrno' at:
http://www.bigorno.net/xrick/

Rockbox port, plus bugfixes at:
https://github.com/pierluigi-vicinanza/xrick

Further changes:

 * Additonal fixes from g#3026
 * Port to modern plugin API
 * Add Pluginlib keymap fallback
 * Support all >1bpp screens
 * Fix build warnings in miniz
 * Better error message when resources are missing

Change-Id: Id83928bc2539901b0221692f65cbca41389c58e7

5 files changed, 112 insertions, 0 deletions

diff --git a/manual/plugins/images/ss-xrick-220x176x16.png b/manual/plugins/images/ss-xrick-220x176x16.png
new file mode 100755
index 0000000000..5fb3a74a2f
--- /dev/null
+++ b/manual/plugins/images/ss-xrick-220x176x16.png
diff --git a/manual/plugins/images/ss-xrick-240x320x16.png b/manual/plugins/images/ss-xrick-240x320x16.png
new file mode 100755
index 0000000000..2d86387b15
--- /dev/null
+++ b/manual/plugins/images/ss-xrick-240x320x16.png
diff --git a/manual/plugins/images/ss-xrick-320x240x16.png b/manual/plugins/images/ss-xrick-320x240x16.png
new file mode 100755
index 0000000000..7739445c35
--- /dev/null
+++ b/manual/plugins/images/ss-xrick-320x240x16.png
diff --git a/manual/plugins/main.tex b/manual/plugins/main.tex
index c04299ca49..b2274f18af 100644
--- a/manual/plugins/main.tex
+++ b/manual/plugins/main.tex
@@ -111,8 +111,13 @@ text files%
 
 \input{plugins/xobox.tex}
 
+\opt{lcd_non-mono}{\input{plugins/xrick.tex}}
+
 \opt{lcd_color}{\input{plugins/xworld.tex}}
 
+
+
+
 \section{Demos}
 
 \input{plugins/bounce.tex}
diff --git a/manual/plugins/xrick.tex b/manual/plugins/xrick.tex
new file mode 100755
index 0000000000..3aac6e08c8
--- /dev/null
+++ b/manual/plugins/xrick.tex
@@ -0,0 +1,107 @@
+% $Id$ %
+\subsection{xrick}
+\screenshot{plugins/images/ss-xrick}{xrick}{img:xrick}
+xrick is a clone of the platform game
+\emph{'Rick Dangerous'}
+(\url{http://en.wikipedia.org/wiki/Rick_Dangerous}),
+originally written by 'BigOrno'
+(\url{http://www.bigorno.net/xrick/}),
+modified and ported to Rockbox by Pierluigi Vicinanza
+(\url{https://github.com/pierluigi-vicinanza/xrick}).
+
+Walk through the maps, avoid traps, kill the Bad Guys... and
+try to stay alive long enough to accomplish your mission!
+
+Rick can fire bullets, lay sticks of dynamite, walk, crawl,
+climb, and also poke walls or Bad Guys with his stick.
+Poking walls can trigger traps, open doors, etc. although
+sometimes a dynamite stick or a bullet is needed.
+Go figure.
+
+\subsubsection{Getting started}
+For the game to run you need \fname{.dat} game files located in
+\fname{/.rockbox/xrick} on your \dap.
+Create the directory and extract xrick \fname{data.zip} archive into it.
+The needed files can be found at
+\url{https://github.com/pierluigi-vicinanza/xrick/blob/master/game/data.zip}.
+
+\subsubsection{Controls}
+By holding down \emph{Fire} and pressing \emph{Left} or \emph{Right},
+you can poke a wall (or anything else) with your stick.
+By holding down \emph{Fire} and pressing \emph{Down}, you can lay a stick of dynamite.
+By holding down \emph{Fire} and pressing \emph{Up}, you can fire a bullet.
+
+Throughout the game, use these buttons to control Rick:
+
+\begin{btnmap}
+%
+    \opt{iriverh300}{\ButtonUp/\ButtonRec}
+    \opt{fuzeplus}{\ButtonUp}
+    \opt{ipodvideo}{\ButtonMenu}
+    \nopt{iriverh300,fuzeplus,ipodvideo}{\PluginUp}
+      \opt{HAVEREMOTEKEYMAP}{& }
+    & Jump or Climb Up\\
+%
+    \opt{fuzeplus}{\ButtonPlay & Jump Right or Climb Up and Right\\}
+%
+    \opt{fuzeplus}{\ButtonBack & Jump Left or Climb Up and Left\\}
+%
+    \opt{iriverh300}{\ButtonDown/\ButtonMode}
+    \opt{fuzeplus}{\ButtonDown}
+    \opt{ipodvideo}{\ButtonPlay}
+    \nopt{iriverh300,fuzeplus,ipodvideo}{\PluginDown}
+      \opt{HAVEREMOTEKEYMAP}{& }
+    & Crouch or Climb Down\\
+%
+    \opt{fuzeplus}{\ButtonBottomRight & Crouch and Move Right or Climb Down and Right\\}
+%
+    \opt{fuzeplus}{\ButtonBottomLeft & Crouch and Move Left or Climb Down and Left\\}
+%
+    \opt{iriverh300,fuzeplus,ipodvideo}{\ButtonLeft}
+    \nopt{iriverh300,fuzeplus,ipodvideo}{\PluginLeft}
+      \opt{HAVEREMOTEKEYMAP}{& }
+    & Move Left\\
+%
+    \opt{iriverh300,fuzeplus,ipodvideo}{\ButtonRight}
+    \nopt{iriverh300,fuzeplus,ipodvideo}{\PluginRight}
+      \opt{HAVEREMOTEKEYMAP}{& }
+    & Move Right\\
+%
+    \opt{iriverh300}{\ButtonOn}
+    \opt{fuzeplus}{\ButtonVolDown}
+    \opt{ipodvideo}{\ButtonSelect}
+    \nopt{iriverh300,fuzeplus,ipodvideo}{\PluginSelect}
+
+      \opt{HAVEREMOTEKEYMAP}{& }
+    & Fire\\
+%
+    \opt{iriverh300}{\ButtonSelect}
+    \opt{fuzeplus}{\ButtonVolUp}
+    \opt{ipodvideo}{\ButtonScrollBack}
+    \nopt{iriverh300,fuzeplus,ipodvideo}{\PluginCancel}
+      \opt{HAVEREMOTEKEYMAP}{& }
+    & Pause\\
+%
+    \opt{iriverh300}{\ButtonOff}
+    \opt{fuzeplus}{\ButtonPower}
+    \opt{ipodvideo}{\ButtonScrollFwd}
+    \nopt{iriverh300,fuzeplus,ipodvideo}{\PluginExit}
+    \opt{hold_button}{/\ButtonHold}
+      \opt{HAVEREMOTEKEYMAP}{& }
+    & Menu\\
+%
+\end{btnmap}
+
+\subsubsection{Menu}
+\begin{description}
+  \item[Resume Game. ] Resume the game
+  \item[Restart Game. ] Restart the game
+  \item[Cheat Settings. ] This menu has the following options:
+
+  \emph{Enable Unlimited Lives/Ammo Mode. } Toggle trainer mode (always six bullets, six sticks, six Rick).\\
+  \emph{Enable Never Die Mode. } Toggle 'never die' mode (nothing can kill Rick). Use with care.
+        Although it lets you walk through Bad Guys unharmed, it can produce strange results.\\
+  \emph{Enable Expose Mode. } Toggle 'expose' mode (see all entities).%\\
+
+  \item[Quit. ] Quit the game
+\end{description}