Nyaaori/rockbox
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

Rework the chip8 button table, rotate button names to make it fit; some general style adjustments.

Browse source 
git-svn-id: svn://svn.rockbox.org/rockbox/trunk@11939 a1c6a512-1295-4272-9138-f99709370657
This commit is contained in:
Dominik Riebeling 2007-01-07 17:23:57 +00:00
parent 6ea22829c9
commit 141e55d846
1 changed files with 94 additions and 30 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

124
manual/plugins/chip8emulator.tex
View file

@ -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: