diff options
Diffstat (limited to 'manual')
-rw-r--r-- | manual/plugins/chip8emulator.tex | 49 | ||||
-rw-r--r-- | manual/plugins/main.tex | 5 |
2 files changed, 40 insertions, 14 deletions
diff --git a/manual/plugins/chip8emulator.tex b/manual/plugins/chip8emulator.tex index 1c8575b687..dee286d06c 100644 --- a/manual/plugins/chip8emulator.tex +++ b/manual/plugins/chip8emulator.tex | |||
@@ -1,28 +1,53 @@ | |||
1 | \subsection{\label{ref:Chip8emulator}Chip{}-8 Emulator} | 1 | \subsection{\label{ref:Chip8emulator}Chip{}-8 Emulator} |
2 | The Chip{}-8 Emulator allows you to play many old chip8 games found on | 2 | Chip8 is a kind of assembly language for a long-gone architecture. |
3 | the Net. It modifies Rockbox, so file extensions .ch8 will be | 3 | This plugin runs games written using the chip8 instructions. |
4 | recognised as chip8 games. Just press PLAY on a .ch8 file to start a | 4 | Just press PLAY on a .ch8 file to start a game. |
5 | game. | ||
6 | 5 | ||
7 | 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 |
8 | couple of KB) which were made popular by the HP48 | 7 | couple of KB) which were made popular by the HP48 |
9 | calculator's emulator for them. The original Chip8 had | 8 | calculator's emulator for them. The original Chip8 had |
10 | 64x32 pixel graphics, and the new superchip emulator supports 128x64 | 9 | 64x32 pixel graphics, and the new superchip emulator supports 128x64 |
11 | graphics, which almost fits on the Recorder's display. | 10 | graphics. |
12 | The only problem is they are based on a 4x4 keyboard, but since most | 11 | |
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 | Some places where can you can find .ch8 files: | 15 | To do this, one may put a ".c8k" file with the same name as the |
16 | original program which contains new key mappings (for BLINKY.ch8, one | ||
17 | writes a BLINKY.c8k file). | ||
18 | That c8k file contains 16 characters | ||
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 | ||
21 | Rockbox key). For example, a file containing the single line:\\\\ | ||
22 | \textbf{0122458469ABCDEF}\\\\ | ||
23 | would correspond to the following non-default mappings:\\\\ | ||
24 | 3-\textgreater 2\hspace{1cm} 6-\textgreater 8\hspace{1cm} 7-\textgreater 4\hspace{1cm} 8-\textgreater 6\\\\ | ||
25 | Default keymappings: | ||
26 | \begin{table}[ht!] | ||
27 | \begin{center} | ||
28 | \begin{footnotesize} | ||
29 | \begin{tabular}{@{}*{16}{@{\hspace{1mm}}c@{\hspace{1mm}}|}@{\hspace{1mm}}c@{}}\toprule | ||
30 | \textbf{Chip8 key} & 0 & 1 & 2 & 3 & 4 & 5 & 6 & 7 & 8 & 9 & A & B & C & D & E & F\\ | ||
31 | \textbf{Key} & | ||
32 | \opt{recorder,recorderv2fm}{& F1 & UP & F3 & LEFT & PLAY & RIGHT & F2 & DOWN & ON & & & & & &} | ||
33 | \opt{ondio}{& & UP & & LEFT & MODE & RIGHT & & DOWN & & & & & & &} | ||
34 | \opt{h1xx}{& & UP & & LEFT & SELECT & RIGHT & & DOWN & & & & & & &} | ||
35 | \opt{h300}{& & UP & & LEFT & NAVI & RIGHT & & DOWN & & & & & & &} | ||
36 | \opt{ipodcolor,ipodnano}{& & Scroll back & & LEFT & PLAY & RIGHT & & Scroll forward& & & & & & &} | ||
37 | \\\bottomrule | ||
38 | \end{tabular} | ||
39 | \end{footnotesize} | ||
40 | \end{center} | ||
41 | \end{table} | ||
16 | 42 | ||
43 | Some places where can you can find .ch8 files: | ||
17 | \begin{itemize} | 44 | \begin{itemize} |
18 | \item The original chip8 patch had several attached: | 45 | \item The PluginChip8 page on www.rockbox.org has several attached: |
19 | \url{http://sourceforge.net/tracker/index.php?func=detail&aid=628509&group_id=44306&atid=439120} | 46 | \url{http://www.rockbox.org/twiki/bin/view/Main/PluginChip8} |
20 | \item Check out the HP48 chip games section: | 47 | \item Check out the HP48 chip games section: |
21 | \url{http://www.hpcalc.org/hp48/games/chip/} | 48 | \url{http://www.hpcalc.org/hp48/games/chip/} |
22 | \item Check out the PC emulator by the guy who wrote the HP48 emulator: | 49 | \item PC emulator by the guy who wrote the HP48 emulator: |
23 | \url{http://www.pdc.kth.se/~lfo/chip8/CHIP8.htm} | 50 | \url{http://www.pdc.kth.se/~lfo/chip8/CHIP8.htm} |
24 | \item Links to other chip8 emulators: | 51 | \item Links to other chip8 emulators: |
25 | \url{http://www.zophar.net/chip8.html} | 52 | \url{http://www.zophar.net/chip8.html} |
26 | \end{itemize} | 53 | \end{itemize} |
27 | |||
28 | |||
diff --git a/manual/plugins/main.tex b/manual/plugins/main.tex index 6eb57c0cd3..be5c92879c 100644 --- a/manual/plugins/main.tex +++ b/manual/plugins/main.tex | |||
@@ -16,7 +16,8 @@ loaded, run and then exited, which returns control to Rockbox. Music | |||
16 | will carry on playing whilst plugins are being run. | 16 | will carry on playing whilst plugins are being run. |
17 | 17 | ||
18 | \section{Games} | 18 | \section{Games} |
19 | See also the Chip{}-8 emulator on page \pageref{ref:Chip8emulator}. | 19 | \opt{recorder,recorderv2fm,ondio,h1xx,h300,ipodcolor,ipodnano} |
20 | {See also the Chip{}-8 emulator on page \pageref{ref:Chip8emulator}.} | ||
20 | 21 | ||
21 | \opt{recorder,recorderv2fm,ondio,h1xx,h300,ipodcolor,ipodnano}{\input{plugins/bejeweled.tex}} | 22 | \opt{recorder,recorderv2fm,ondio,h1xx,h300,ipodcolor,ipodnano}{\input{plugins/bejeweled.tex}} |
22 | 23 | ||
@@ -71,7 +72,7 @@ They cannot be run directly but are started by ``playing'' | |||
71 | the associated file. Viewers are stored in the | 72 | the associated file. Viewers are stored in the |
72 | \textbf{/.rockbox/viewers/ }directory. | 73 | \textbf{/.rockbox/viewers/ }directory. |
73 | 74 | ||
74 | \opt{recorder,recorderv2fm,ondio}{\input{plugins/chip8emulator.tex}} | 75 | \opt{recorder,recorderv2fm,ondio,h1xx,h300,ipodcolor,ipodnano}{\input{plugins/chip8emulator.tex}} |
75 | 76 | ||
76 | \opt{recorder,recorderv2fm,ondio,h1xx,h300}{\input{plugins/jpegviewer.tex}} | 77 | \opt{recorder,recorderv2fm,ondio,h1xx,h300}{\input{plugins/jpegviewer.tex}} |
77 | 78 | ||