summaryrefslogtreecommitdiff
path: root/manual
diff options
context:
space:
mode:
authorDominik Riebeling <Dominik.Riebeling@gmail.com>2007-01-07 17:23:57 +0000
committerDominik Riebeling <Dominik.Riebeling@gmail.com>2007-01-07 17:23:57 +0000
commit141e55d846ff8356acb0dd6eb8bcf766dbc86a2b (patch)
tree04660c31575974a2086e015ad006b2ac30c6124d /manual
parent6ea22829c90de82cbed62f7a656506c4f8294149 (diff)
Rework the chip8 button table, rotate button names to make it fit; some general style adjustments.
git-svn-id: svn://svn.rockbox.org/rockbox/trunk@11939 a1c6a512-1295-4272-9138-f99709370657
Diffstat (limited to 'manual')
-rw-r--r--manual/plugins/chip8emulator.tex124
1 files changed, 94 insertions, 30 deletions
diff --git a/manual/plugins/chip8emulator.tex b/manual/plugins/chip8emulator.tex
index 867fbc5b57..7f927effaf 100644
--- a/manual/plugins/chip8emulator.tex
+++ b/manual/plugins/chip8emulator.tex
@@ -12,41 +12,105 @@ graphics.
The only problem is that they are based on a 4x4 keyboard, but since most
games do not use all of the buttons, this can easily be worked around.
-To do this, one may put a \fname{``.c8k''} file with the same name as the
+To do this, one may put a \fname{.c8k} file with the same name as the
original program which contains new key mappings (for \fname{BLINKY.ch8}, one
writes a \fname{BLINKY.c8k} file). That \fname{.c8k} file contains 16
characters describing the mapping from the Chip8 keyboard to the default key
mapping (that way, several Chip8 keys can be pressed using only one
-Rockbox key). For example, a file containing the single line:\\\\
-\textbf{0122458469ABCDEF}\\\\
-would correspond to the following non-default mappings:\\\\
-3 $\rightarrow$ 2\hspace{1cm} 6 $\rightarrow$ 8\hspace{1cm} 7 $\rightarrow$
-4\hspace{1cm} 8 $\rightarrow$ 6\\\\
-Default keymappings:
+Rockbox key). For example, a file containing the single line:
+\begin{code}
+ 0122458469ABCDEF
+\end{code}
+would correspond to the following non-default mappings:
+
+3 $\rightarrow$ 2, 6 $\rightarrow$ 8, 7 $\rightarrow$4, 8 $\rightarrow$ 6.
+
+The default keymappings are:
\begin{table}
- \begin{center}
- \begin{footnotesize}
- \begin{tabular}{@{}*{17}{@{\hspace{1mm}}c@{\hspace{1mm}}|}@{\hspace{1mm}}
- c@{}}\toprule
- \textbf{Chip8 key} & Off & 0 & 1 & 2 & 3 & 4 & 5 & 6 & 7 & 8 & 9 & A & B
- & C & D & E & F\\
- \textbf{Key} &
- \opt{RECORDER_PAD}{\ButtonOff & & \ButtonFOne & \ButtonUp &
- \ButtonFThree & \ButtonLeft & \ButtonPlay & \ButtonRight &
- \ButtonFTwo & \ButtonDown & \ButtonOn & & & & & &}
- \opt{ONDIO_PAD}{\ButtonOff & & & \ButtonUp & & \ButtonLeft & \ButtonMenu
- & \ButtonRight & & \ButtonDown & & & & & & &}
- \opt{IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonOff & & \ButtonUp & &
- \ButtonLeft & \ButtonSelect & \ButtonRight & & \ButtonDown & & & &
- & & &}
- \opt{IPOD_4G_PAD,IPOD_3G_PAD}{\ButtonMenu & & & \ButtonScrollBack & & \ButtonLeft &
- \ButtonPlay & \ButtonRight & & \ButtonScrollFwd & & & & & & &}
- \opt{IAUDIO_X5_PAD}{\ButtonPower & & & \ButtonUp & & \ButtonLeft &
- \ButtonSelect & \ButtonRight & & \ButtonDown & & & & & & &}
- \\\bottomrule
- \end{tabular}
- \end{footnotesize}
- \end{center}
+ \begin{center}
+ \begin{tabularx}{.9\textwidth}{c|ccccccccccccccccc}
+ \toprule
+ Chip8 & Off & 0 & 1 & 2 & 3 & 4 & 5 & 6 & 7 & 8 & 9
+ & A & B & C & D & E & F\\
+ \midrule
+ \begin{sideways}Key\end{sideways}
+ &
+ % key "off"
+ \begin{sideways}
+ \opt{RECORDER_PAD,ONDIO_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonOff}
+ \opt{IPOD_4G_PAD,IPOD_3G_PAD}{\ButtonMenu}
+ \opt{IAUDIO_X5_PAD}{\ButtonPower}
+ \end{sideways}
+ &
+ % Key "0"
+ &
+ % "Key "1"
+ \begin{sideways}
+ \opt{RECORDER_PAD}{\ButtonFOne}\opt{ONDIO_PAD}{\ButtonUp}
+ \end{sideways}
+ &
+ % Key "2"
+ \begin{sideways}
+ \opt{RECORDER_PAD,ONDIO_PAD}{\ButtonUp}
+ \opt{IPOD_4G_PAD,IPOD_3G_PAD}{\ButtonScrollBack}
+ \opt{IRIVER_H100_PAD,IRIVER_H300_PAD,IAUDIO_X5_PAD}{\ButtonUp}
+ \end{sideways}
+ &
+ % Key "3"
+ \begin{sideways}
+ \opt{RECORDER_PAD}{\ButtonFThree}
+ \end{sideways}
+ % Key "4"
+ \begin{sideways}
+ \opt{RECORDER_PAD,ONDIO_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonLeft}
+ \opt{IPOD_4G_PAD,IPOD_3G_PAD,IAUDIO_X5_PAD}{\ButtonLeft}
+ \end{sideways}
+ &
+ % Key "5"
+ \begin{sideways}
+ \opt{RECORDER_PAD}{\ButtonPlay}\opt{ONDIO_PAD}{\ButtonMenu}
+ \opt{IRIVER_H100_PAD,IRIVER_H300_PAD,IAUDIO_X5_PAD}{\ButtonSelect}
+ \opt{IPOD_4G_PAD,IPOD_3G_PAD}{\ButtonPlay}
+ \end{sideways}
+ &
+ % Key "6"
+ \begin{sideways}
+ \opt{RECORDER_PAD,ONDIO_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonRight}
+ \opt{IPOD_4G_PAD,IPOD_3G_PAD,IAUDIO_X5_PAD}{\ButtonRight}
+ \end{sideways}
+ &
+ % Key "7"
+ \begin{sideways}
+ \opt{RECORDER_PAD}{\ButtonFTwo}
+ \end{sideways}
+ &
+ % Key "8"
+ \begin{sideways}
+ \opt{RECORDER_PAD,ONDIO_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonDown}
+ \opt{IPOD_4G_PAD,IPOD_3G_PAD}{\ButtonScrollFwd}
+ \opt{IAUDIO_X5_PAD}{\ButtonDown}
+ \end{sideways}
+ &
+ % Key "9"
+ \begin{sideways}
+ \opt{RECORDER_PAD}{\ButtonOn}
+ \end{sideways}
+ &
+ % Key "A"
+ &
+ % Key "B"
+ &
+ % Key "C"
+ &
+ % Key "D"
+ &
+ % Key "E"
+ &
+ % Key "F"
+ &
+ \\\bottomrule
+ \end{tabularx}
+ \end{center}
\end{table}
Some places where can you can find \fname{.ch8} files: