diff options
Diffstat (limited to 'manual/plugins/chip8emulator.tex')
-rw-r--r-- | manual/plugins/chip8emulator.tex | 39 |
1 files changed, 24 insertions, 15 deletions
diff --git a/manual/plugins/chip8emulator.tex b/manual/plugins/chip8emulator.tex index b7071c3cd4..0f71c6d31e 100644 --- a/manual/plugins/chip8emulator.tex +++ b/manual/plugins/chip8emulator.tex | |||
@@ -1,7 +1,7 @@ | |||
1 | \subsection{\label{ref:Chip8emulator}Chip{}-8 Emulator} | 1 | \subsection{\label{ref:Chip8emulator}Chip{}-8 Emulator} |
2 | Chip8 is a kind of assembly language for a long-gone architecture. | 2 | Chip8 is a kind of assembly language for a long-gone architecture. |
3 | This plugin runs games written using the chip8 instructions. | 3 | This plugin runs games written using the chip8 instructions. |
4 | Just press PLAY on a .ch8 file to start a game. | 4 | To start a game open a \fname{.ch8} file in the \setting{File Browser} |
5 | 5 | ||
6 | There are lots of tiny Chip8 games (usually only about 256 bytes to a | 6 | There are lots of tiny Chip8 games (usually only about 256 bytes to a |
7 | couple of KB) which were made popular by the HP48 | 7 | couple of KB) which were made popular by the HP48 |
@@ -12,35 +12,44 @@ graphics. | |||
12 | The only problem is that they are based on a 4x4 keyboard, but since most | 12 | The only problem is that they are based on a 4x4 keyboard, but since most |
13 | games do not use all of the buttons, this can easily be worked around. | 13 | games do not use all of the buttons, this can easily be worked around. |
14 | 14 | ||
15 | To do this, one may put a ``.c8k'' file with the same name as the | 15 | To do this, one may put a \fname{``.c8k''} file with the same name as the |
16 | original program which contains new key mappings (for BLINKY.ch8, one | 16 | original program which contains new key mappings (for \fname{BLINKY.ch8}, one |
17 | writes a BLINKY.c8k file). | 17 | writes a \fname{BLINKY.c8k} file). That \fname{.c8k} file contains 16 |
18 | That c8k file contains 16 characters | 18 | characters describing the mapping from the Chip8 keyboard to the default key |
19 | describing the mapping from the Chip8 keyboard to the default key | ||
20 | mapping (that way, several Chip8 keys can be pressed using only one | 19 | mapping (that way, several Chip8 keys can be pressed using only one |
21 | Rockbox key). For example, a file containing the single line:\\\\ | 20 | Rockbox key). For example, a file containing the single line:\\\\ |
22 | \textbf{0122458469ABCDEF}\\\\ | 21 | \textbf{0122458469ABCDEF}\\\\ |
23 | would correspond to the following non-default mappings:\\\\ | 22 | would correspond to the following non-default mappings:\\\\ |
24 | 3 $\rightarrow$ 2\hspace{1cm} 6 $\rightarrow$ 8\hspace{1cm} 7 $\rightarrow$ 4\hspace{1cm} 8 $\rightarrow$ 6\\\\ | 23 | 3 $\rightarrow$ 2\hspace{1cm} 6 $\rightarrow$ 8\hspace{1cm} 7 $\rightarrow$ |
24 | 4\hspace{1cm} 8 $\rightarrow$ 6\\\\ | ||
25 | Default keymappings: | 25 | Default keymappings: |
26 | \begin{table} | 26 | \begin{table} |
27 | \begin{center} | 27 | \begin{center} |
28 | \begin{footnotesize} | 28 | \begin{footnotesize} |
29 | \begin{tabular}{@{}*{16}{@{\hspace{1mm}}c@{\hspace{1mm}}|}@{\hspace{1mm}}c@{}}\toprule | 29 | \begin{tabular}{@{}*{17}{@{\hspace{1mm}}c@{\hspace{1mm}}|}@{\hspace{1mm}} |
30 | \textbf{Chip8 key} & 0 & 1 & 2 & 3 & 4 & 5 & 6 & 7 & 8 & 9 & A & B & C & D & E & F\\ | 30 | c@{}}\toprule |
31 | \textbf{Chip8 key} & Off & 0 & 1 & 2 & 3 & 4 & 5 & 6 & 7 & 8 & 9 & A & B | ||
32 | & C & D & E & F\\ | ||
31 | \textbf{Key} & | 33 | \textbf{Key} & |
32 | \opt{recorder,recorderv2fm}{& F1 & UP & F3 & LEFT & PLAY & RIGHT & F2 & DOWN & ON & & & & & &} | 34 | \opt{RECORDER_PAD}{\ButtonOff & & \ButtonFOne & \ButtonUp & |
33 | \opt{ondio}{& & UP & & LEFT & MODE & RIGHT & & DOWN & & & & & & &} | 35 | \ButtonFThree & \ButtonLeft & \ButtonPlay & \ButtonRight & |
34 | \opt{h1xx}{& & UP & & LEFT & SELECT & RIGHT & & DOWN & & & & & & &} | 36 | \ButtonFTwo & \ButtonDown & \ButtonOn & & & & & &} |
35 | \opt{h300}{& & UP & & LEFT & NAVI & RIGHT & & DOWN & & & & & & &} | 37 | \opt{ONDIO_PAD}{\ButtonOff & & & \ButtonUp & & \ButtonLeft & \ButtonMenu |
36 | \opt{ipodcolor,ipodnano}{& & Scroll back & & LEFT & PLAY & RIGHT & & Scroll forward& & & & & & &} | 38 | & \ButtonRight & & \ButtonDown & & & & & & &} |
39 | \opt{IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonOff & & \ButtonUp & & | ||
40 | \ButtonLeft & \ButtonSelect & \ButtonRight & & \ButtonDown & & & & | ||
41 | & & &} | ||
42 | \opt{IPOD_4G_PAD}{\ButtonMenu & & & \ButtonScrollBack & & \ButtonLeft & | ||
43 | \ButtonPlay & \ButtonRight & & \ButtonScrollFwd & & & & & & &} | ||
44 | \opt{IAUDIO_X5_PAD}{\ButtonPower & & & \ButtonUp & & \ButtonLeft & | ||
45 | \ButtonSelect & \ButtonRight & & \ButtonDown & & & & & & &} | ||
37 | \\\bottomrule | 46 | \\\bottomrule |
38 | \end{tabular} | 47 | \end{tabular} |
39 | \end{footnotesize} | 48 | \end{footnotesize} |
40 | \end{center} | 49 | \end{center} |
41 | \end{table} | 50 | \end{table} |
42 | 51 | ||
43 | Some places where can you can find .ch8 files: | 52 | Some places where can you can find \fname{.ch8} files: |
44 | \begin{itemize} | 53 | \begin{itemize} |
45 | \item The PluginChip8 page on www.rockbox.org has several attached: | 54 | \item The PluginChip8 page on www.rockbox.org has several attached: |
46 | \url{http://www.rockbox.org/twiki/bin/view/Main/PluginChip8} | 55 | \url{http://www.rockbox.org/twiki/bin/view/Main/PluginChip8} |