manual/plugins/doom.tex

   1 % $Id$ %
   2 \subsection{Doom}
   3 \screenshot{plugins/images/ss-doom}{Doom}{}
   4 This is the famous Doom game.
   5
   6 \subsubsection{Getting started}
   7 For the game to run you need \fname{.wad} game files located in
   8 \fname{/.rockbox/doom/} on your player. Create the directory and save the
   9 following files there:
  10 \begin{description}
  11 \item[rockdoom.wad.] The Rockbox \fname{.wad}, based on \fname{prboom.wad}
  12 from prboom-2.2.6
  13 \item[Your wad files.] Copy all Doom wads you wish to play into that directory.
  14 \end{description}
  15 The needed files can be found at
  16 \wikilink{PluginDoom}
  17
  18 To play addon wads create the \fname{addons} directory within the doom directory.
  19 Place \fname{wad} files in this directory. Currently doom only supports
  20 a maximum number of 10 addons.
  21
  22 A free alternative for Doom 2 is FreeDoom (\url{http://freedoom.sourceforge.net}).
  23 This can be used in place of \fname{doom2.wad}, or it may be used as an addon in
  24 Doom, by placing it in the \fname{addons} directory.
  25
  26 \subsubsection{Menus}
  27 \begin{description}
  28   \item[Rockdoom Menu. ] The Rockdoom menu is shown when Doom is first launched.
  29 This is the only time it can be accessed (before starting the game).  To re-adjust
  30 Rockdoom options, you will need to quit your current game and restart the plugin.
  31   \item[Main Menu. ]
  32   The Doom plugin has a main menu, which is brought up before a game is started. It
  33   has the following entries:
  34
  35   \emph{Game. } Select which (official) wad to launch\\
  36   \emph{Addon. } Select which unofficial addon wad to launch (From
  37   \fname{/.rockbox/doom/addons} directory)\\
  38   \emph{Demos. } Select which demo file to play on game start\\
  39   \emph{Options. } Configure low-level Doom options\\
  40   \emph{Play Game. } Launch the wad/addon/Demo chosen%\\
  41
  42   \item[Options Menu. ]This menu has the following options:
  43
  44   \emph{Sound. } Enable or Disable sound in Doom\\
  45   \emph{Set Keys. }  Change the game key configuration\\
  46   \emph{Time Demo. } Run a timed demo, to test game speed on a player (Only runs on Doom Shareware)\\
  47   \emph{Player Bobbing. } Enable or Disable player up/Down movement\\
  48   \emph{Translucency. } Enable or Disable sprite translucency (Fireballs, Plasma...)\\
  49   \emph{Fake Contrast.} Enable or Disable modified game lighting\\
  50   \emph{Always Run.} Make the player always run\\
  51   \emph{Headsup Display.} Show the player status when in fullscreen\\
  52   \emph{Statusbar Always Red.} Disable colour response statusbar%\\
  53
  54   \item[InGame Main Menu. ]This menu can only be accessed from within a running game, and is displayed by
  55     \opt{IRIVER_H100_PAD,IRIVER_H300_PAD}{pressing \ButtonOff}%
  56     \opt{IPOD_3G_PAD,IPOD_4G_PAD}{flipping your \ButtonHold{} switch a couple of times}%
  57     \opt{IAUDIO_X5_PAD,IRIVER_H10_PAD,SANSA_E200_PAD, SANSA_C200_PAD%
  58          ,GIGABEAT_PAD,GIGABEAT_S_PAD,COWON_D2_PAD}{pressing \ButtonPower}%
  59     \opt{SANSA_FUZE_PAD}{pressing \ButtonHome}
  60     \opt{PBELL_VIBE500_PAD}{pressing \ButtonRec}
  61
  62   \emph{New Game. } Start a new game\\
  63   \emph{Options. } In game options\\
  64   \emph{Load Game. } Load a saved game\\
  65   \emph{Save Game. } Save the current game\\
  66   \emph{Quit. } Quit the game%\\
  67
  68   \item[InGame Options Menu. ]This menu has the folloing options:
  69
  70   \emph{End Game. } Ends the current game\\
  71   \emph{Messages. }  Enable or Disable in game messages\\
  72   \emph{Screen Size. } Shrink or Enlarge the displayed portion of the game\\
  73   \emph{Gamma. } Change the brightness (Gamma) of the game\\
  74   \emph{Sound Volume. } Change the sound, music and system volume%\\
  75   \note{In game music is not currently supported}
  76
  77 \end{description}
  78
  79 \subsubsection{Keys}
  80 \begin{table}
  81 \begin{btnmap}{}{}
  82   \opt{IRIVER_H100_PAD,IRIVER_H300_PAD,IAUDIO_X5_PAD,SANSA_E200_PAD,SANSA_FUZE_PAD,SANSA_C200_PAD%
  83       ,GIGABEAT_PAD,GIGABEAT_S_PAD,MROBE100_PAD}{\ButtonUp}
  84   \opt{IPOD_3G_PAD,IPOD_4G_PAD}{\ButtonMenu}
  85   \opt{IRIVER_H10_PAD}{\ButtonScrollUp}
  86   \opt{COWON_D2_PAD}{\TouchTopMiddle}
  87   \opt{PBELL_VIBE500_PAD}{\ButtonOK}
  88        \opt{HAVEREMOTEKEYMAP}{& }
  89     & Move Forward \\
  90 %
  91   \nopt{IPOD_3G_PAD,IPOD_4G_PAD,COWON_D2_PAD}{
  92     \opt{IRIVER_H100_PAD,IRIVER_H300_PAD,IAUDIO_X5_PAD,SANSA_E200_PAD,SANSA_FUZE_PAD,SANSA_C200_PAD%
  93         ,GIGABEAT_PAD,GIGABEAT_S_PAD,MROBE100_PAD}{\ButtonDown}
  94     \opt{IRIVER_H10_PAD}{\ButtonScrollDown}
  95     \opt{COWON_D2_PAD}{\TouchBottomMiddle}
  96     \opt{PBELL_VIBE500_PAD}{\ButtonCancel}
  97        \opt{HAVEREMOTEKEYMAP}{& }
  98       & Down\\
  99   }
 100 %
 101   \opt{IRIVER_H100_PAD,IRIVER_H300_PAD,IAUDIO_X5_PAD,SANSA_E200_PAD%
 102       ,SANSA_FUZE_PAD,SANSA_C200_PAD,GIGABEAT_PAD,GIGABEAT_S_PAD,MROBE100_PAD%
 103       ,IPOD_3G_PAD,IPOD_4G_PAD,IRIVER_H10_PAD}{\ButtonLeft}
 104   \opt{COWON_D2_PAD}{\TouchMidLeft}
 105   \opt{PBELL_VIBE500_PAD}{\ButtonPrev}
 106       \opt{HAVEREMOTEKEYMAP}{& }
 107     & Turn Left \\
 108 %
 109   \opt{IRIVER_H100_PAD,IRIVER_H300_PAD,IAUDIO_X5_PAD,SANSA_E200_PAD%
 110       ,SANSA_FUZE_PAD,SANSA_C200_PAD,GIGABEAT_PAD,GIGABEAT_S_PAD,MROBE100_PAD%
 111       ,IPOD_3G_PAD,IPOD_4G_PAD,IRIVER_H10_PAD}{\ButtonRight}
 112   \opt{COWON_D2_PAD}{\TouchMidRight}
 113   \opt{PBELL_VIBE500_PAD}{\ButtonNext}
 114       \opt{HAVEREMOTEKEYMAP}{& }
 115     & Turn Right \\
 116 %
 117   \opt{IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonRec}
 118   \opt{IPOD_3G_PAD,IPOD_4G_PAD,GIGABEAT_S_PAD}{\ButtonPlay}
 119   \opt{IAUDIO_X5_PAD,SANSA_E200_PAD,SANSA_FUZE_PAD,SANSA_C200_PAD}{\ButtonSelect}
 120   \opt{IRIVER_H10_PAD}{\ButtonRew}
 121   \opt{GIGABEAT_PAD}{\ButtonA}
 122   \opt{MROBE100_PAD}{\ButtonDisplay}
 123   \opt{COWON_D2_PAD}{\TouchBottomRight}
 124   \opt{PBELL_VIBE500_PAD}{\ButtonMenu}
 125        \opt{HAVEREMOTEKEYMAP}{& }
 126     & Shoot \\
 127 %
 128   \opt{IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonMode}
 129   \opt{IPOD_3G_PAD,IPOD_4G_PAD}{\ButtonMenu}
 130   \opt{IAUDIO_X5_PAD,IRIVER_H10_PAD}{\ButtonPlay}
 131   \opt{SANSA_E200_PAD,SANSA_C200_PAD}{\ButtonRec}
 132   \opt{SANSA_FUZE_PAD}{\ButtonPower}
 133   \opt{GIGABEAT_PAD,GIGABEAT_S_PAD,MROBE100_PAD}{\ButtonMenu}
 134   \opt{PBELL_VIBE500_PAD}{\ButtonOK}
 135        \opt{HAVEREMOTEKEYMAP}{& }
 136     & Open \\
 137 %
 138   \opt{IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonOff}
 139   \opt{IPOD_3G_PAD,IPOD_4G_PAD}{\ButtonHold{} switch}
 140   \opt{IAUDIO_X5_PAD,IRIVER_H10_PAD,SANSA_E200_PAD,SANSA_C200_PAD,GIGABEAT_PAD%
 141       ,GIGABEAT_S_PAD,MROBE100_PAD}{\ButtonPower}
 142   \opt{SANSA_FUZE_PAD}{\ButtonHome}
 143   \opt{COWON_D2_PAD}{\TouchTopLeft}
 144   \opt{PBELL_VIBE500_PAD}{\ButtonRec}
 145        \opt{HAVEREMOTEKEYMAP}{& }
 146     & InGame Menu \\
 147 %
 148   \opt{IRIVER_H100_PAD,IRIVER_H300_PAD,IPOD_3G_PAD,IPOD_4G_PAD,IAUDIO_X5_PAD%
 149       ,GIGABEAT_PAD,GIGABEAT_S_PAD,SANSA_E200_PAD,SANSA_FUZE_PAD,SANSA_C200_PAD%
 150       ,MROBE100_PAD}{\ButtonSelect}
 151   \opt{IRIVER_H10_PAD}{\ButtonRew}
 152   \opt{COWON_D2_PAD}{\TouchCenter}
 153   \opt{PBELL_VIBE500_PAD}{\ButtonPower}
 154        \opt{HAVEREMOTEKEYMAP}{& }
 155     & Enter \\
 156 %
 157   \opt{IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonOn}
 158   \opt{IPOD_3G_PAD,IPOD_4G_PAD}{\ButtonSelect}
 159   \opt{IAUDIO_X5_PAD}{\ButtonRec}
 160   \opt{IRIVER_H10_PAD}{\ButtonFF}
 161   \opt{SANSA_E200_PAD,SANSA_FUZE_PAD}{\ButtonScrollFwd}
 162   \opt{SANSA_C200_PAD}{\ButtonVolUp}
 163   \opt{GIGABEAT_PAD,GIGABEAT_S_PAD}{\ButtonVolDown}
 164   \opt{COWON_D2_PAD}{\TouchBottomLeft}
 165   \opt{PBELL_VIBE500_PAD}{\ButtonPlay}
 166        \opt{HAVEREMOTEKEYMAP}{& }
 167     & Change Weapon \\
 168 %
 169 \end{btnmap}
 170 \end{table}
 171
 172 \subsubsection{Playing the game}
 173 After installation of the \fname{wad} files is complete you can start the
 174 game.
 175 \fixme{more description is needed}