From 141e55d846ff8356acb0dd6eb8bcf766dbc86a2b Mon Sep 17 00:00:00 2001 From: Dominik Riebeling Date: Sun, 7 Jan 2007 17:23:57 +0000 Subject: 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 --- manual/plugins/chip8emulator.tex | 124 +++++++++++++++++++++++++++++---------- 1 file 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: -- cgit v1.2.3