Don't use the same completion_event for both directions. This could cause problems...
[kugel-rb.git] / manual / plugins / doom.tex
blob687e140cfa76c466b53d870eb9cf98c28ac9aab2
1 % $Id$ %
2 \subsection{Doom}
3 \screenshot{plugins/images/ss-doom}{Doom}{}
4 This is the famous Doom game.
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}
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.
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.
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:
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%\\
42 \item[Options Menu. ]This menu has the following options:
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 color response statusbar%\\
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}{pressing \ButtonPower}%
59 \opt{SANSA_FUZE_PAD}{pressing \ButtonHome}
61 \emph{New Game. } Start a new game\\
62 \emph{Options. } In game options\\
63 \emph{Load Game. } Load a saved game\\
64 \emph{Save Game. } Save the current game\\
65 \emph{Quit. } Quit the game%\\
67 \item[InGame Options Menu. ]This menu has the folloing options:
69 \emph{End Game. } Ends the current game\\
70 \emph{Messages. } Enable or Disable in game messages\\
71 \emph{Screen Size. } Shrink or Enlarge the displayed portion of the game\\
72 \emph{Gamma. } Change the brightness (Gamma) of the game\\
73 \emph{Sound Volume. } Change the sound, music and system volume%\\
74 \note{In game music is not currently supported}
76 \end{description}
78 \subsubsection{Keys}
79 \begin{table}
80 \begin{btnmap}{}{}
81 \opt{IRIVER_H100_PAD,IRIVER_H300_PAD,IAUDIO_X5_PAD,SANSA_E200_PAD,SANSA_FUZE_PAD,SANSA_C200_PAD%
82 ,GIGABEAT_PAD,GIGABEAT_S_PAD,MROBE100_PAD}{\ButtonUp}
83 \opt{IPOD_3G_PAD,IPOD_4G_PAD}{\ButtonMenu}
84 \opt{IRIVER_H10_PAD}{\ButtonScrollUp}
85 \opt{HAVEREMOTEKEYMAP}{& }
86 & Move Forward \\
88 \nopt{IPOD_3G_PAD,IPOD_4G_PAD}{
89 \opt{IRIVER_H100_PAD,IRIVER_H300_PAD,IAUDIO_X5_PAD,SANSA_E200_PAD,SANSA_FUZE_PAD,SANSA_C200_PAD%
90 ,GIGABEAT_PAD,GIGABEAT_S_PAD,MROBE100_PAD}{\ButtonDown}
91 \opt{IRIVER_H10_PAD}{\ButtonScrollDown}
92 \opt{HAVEREMOTEKEYMAP}{& }
93 & Down\\
96 \ButtonLeft
97 \opt{HAVEREMOTEKEYMAP}{& }
98 & Turn Left \\
100 \ButtonRight
101 \opt{HAVEREMOTEKEYMAP}{& }
102 & Turn Right \\
104 \opt{IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonRec}
105 \opt{IPOD_3G_PAD,IPOD_4G_PAD,GIGABEAT_S_PAD}{\ButtonPlay}
106 \opt{IAUDIO_X5_PAD,SANSA_E200_PAD,SANSA_FUZE_PAD,SANSA_C200_PAD}{\ButtonSelect}
107 \opt{IRIVER_H10_PAD}{\ButtonRew}
108 \opt{GIGABEAT_PAD}{\ButtonA}
109 \opt{MROBE100_PAD}{\ButtonDisplay}
110 \opt{HAVEREMOTEKEYMAP}{& }
111 & Shoot \\
113 \opt{IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonMode}
114 \opt{IPOD_3G_PAD,IPOD_4G_PAD}{\ButtonMenu}
115 \opt{IAUDIO_X5_PAD,IRIVER_H10_PAD}{\ButtonPlay}
116 \opt{SANSA_E200_PAD,SANSA_C200_PAD}{\ButtonRec}
117 \opt{SANSA_FUZE_PAD}{\ButtonPower}
118 \opt{GIGABEAT_PAD,GIGABEAT_S_PAD,MROBE100_PAD}{\ButtonMenu}
119 \opt{HAVEREMOTEKEYMAP}{& }
120 & Open \\
122 \opt{IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonOff}
123 \opt{IPOD_3G_PAD,IPOD_4G_PAD}{\ButtonHold{} switch}
124 \opt{IAUDIO_X5_PAD,IRIVER_H10_PAD,SANSA_E200_PAD,SANSA_C200_PAD,GIGABEAT_PAD%
125 ,GIGABEAT_S_PAD,MROBE100_PAD}{\ButtonPower}
126 \opt{SANSA_FUZE_PAD}{\ButtonHome}
127 \opt{HAVEREMOTEKEYMAP}{& }
128 & InGame Menu \\
130 \opt{IRIVER_H100_PAD,IRIVER_H300_PAD,IPOD_3G_PAD,IPOD_4G_PAD,IAUDIO_X5_PAD%
131 ,GIGABEAT_PAD,GIGABEAT_S_PAD,SANSA_E200_PAD,SANSA_FUZE_PAD,SANSA_C200_PAD%
132 ,MROBE100_PAD}{\ButtonSelect}
133 \opt{IRIVER_H10_PAD}{\ButtonRew}
134 \opt{HAVEREMOTEKEYMAP}{& }
135 & Enter \\
137 \opt{IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonOn}
138 \opt{IPOD_3G_PAD,IPOD_4G_PAD}{\ButtonSelect}
139 \opt{IAUDIO_X5_PAD}{\ButtonRec}
140 \opt{IRIVER_H10_PAD}{\ButtonFF}
141 \opt{SANSA_E200_PAD,SANSA_FUZE_PAD}{\ButtonScrollFwd}
142 \opt{SANSA_C200_PAD}{\ButtonVolUp}
143 \opt{GIGABEAT_PAD,GIGABEAT_S_PAD}{\ButtonVolDown}
144 \opt{HAVEREMOTEKEYMAP}{& }
145 & Change Weapon \\
147 \end{btnmap}
148 \end{table}
150 \subsubsection{Playing the game}
151 After installation of the \fname{wad} files is complete you can start the
152 game.
153 \fixme{more description is needed}