From cc4dc39dded647a5c3e62eae0c5577b69693b289 Mon Sep 17 00:00:00 2001 From: Martin Arver Date: Sat, 11 Mar 2006 07:52:11 +0000 Subject: Patch #4813 by Nils Wallménius. Fixes to the Chip-8 section of the manual MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit git-svn-id: svn://svn.rockbox.org/rockbox/trunk@8993 a1c6a512-1295-4272-9138-f99709370657 --- manual/plugins/chip8emulator.tex | 49 ++++++++++++++++++++++++++++++---------- manual/plugins/main.tex | 5 ++-- 2 files changed, 40 insertions(+), 14 deletions(-) (limited to 'manual/plugins') 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 @@ \subsection{\label{ref:Chip8emulator}Chip{}-8 Emulator} -The Chip{}-8 Emulator allows you to play many old chip8 games found on -the Net. It modifies Rockbox, so file extensions .ch8 will be -recognised as chip8 games. Just press PLAY on a .ch8 file to start a -game. +Chip8 is a kind of assembly language for a long-gone architecture. +This plugin runs games written using the chip8 instructions. +Just press PLAY on a .ch8 file to start a game. There are lots of tiny Chip8 games (usually only about 256 bytes to a couple of KB) which were made popular by the HP48 calculator's emulator for them. The original Chip8 had 64x32 pixel graphics, and the new superchip emulator supports 128x64 -graphics, which almost fits on the Recorder's display. -The only problem is they are based on a 4x4 keyboard, but since most +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. -Some places where can you can find .ch8 files: +To do this, one may put a ".c8k" file with the same name as the +original program which contains new key mappings (for BLINKY.ch8, one +writes a BLINKY.c8k file). +That 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-\textgreater 2\hspace{1cm} 6-\textgreater 8\hspace{1cm} 7-\textgreater 4\hspace{1cm} 8-\textgreater 6\\\\ +Default keymappings: +\begin{table}[ht!] + \begin{center} + \begin{footnotesize} + \begin{tabular}{@{}*{16}{@{\hspace{1mm}}c@{\hspace{1mm}}|}@{\hspace{1mm}}c@{}}\toprule + \textbf{Chip8 key} & 0 & 1 & 2 & 3 & 4 & 5 & 6 & 7 & 8 & 9 & A & B & C & D & E & F\\ + \textbf{Key} & + \opt{recorder,recorderv2fm}{& F1 & UP & F3 & LEFT & PLAY & RIGHT & F2 & DOWN & ON & & & & & &} + \opt{ondio}{& & UP & & LEFT & MODE & RIGHT & & DOWN & & & & & & &} + \opt{h1xx}{& & UP & & LEFT & SELECT & RIGHT & & DOWN & & & & & & &} + \opt{h300}{& & UP & & LEFT & NAVI & RIGHT & & DOWN & & & & & & &} + \opt{ipodcolor,ipodnano}{& & Scroll back & & LEFT & PLAY & RIGHT & & Scroll forward& & & & & & &} + \\\bottomrule + \end{tabular} + \end{footnotesize} + \end{center} +\end{table} +Some places where can you can find .ch8 files: \begin{itemize} -\item The original chip8 patch had several attached: -\url{http://sourceforge.net/tracker/index.php?func=detail&aid=628509&group_id=44306&atid=439120} +\item The PluginChip8 page on www.rockbox.org has several attached: +\url{http://www.rockbox.org/twiki/bin/view/Main/PluginChip8} \item Check out the HP48 chip games section: \url{http://www.hpcalc.org/hp48/games/chip/} -\item Check out the PC emulator by the guy who wrote the HP48 emulator: +\item PC emulator by the guy who wrote the HP48 emulator: \url{http://www.pdc.kth.se/~lfo/chip8/CHIP8.htm} \item Links to other chip8 emulators: \url{http://www.zophar.net/chip8.html} \end{itemize} - - 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 will carry on playing whilst plugins are being run. \section{Games} -See also the Chip{}-8 emulator on page \pageref{ref:Chip8emulator}. +\opt{recorder,recorderv2fm,ondio,h1xx,h300,ipodcolor,ipodnano} + {See also the Chip{}-8 emulator on page \pageref{ref:Chip8emulator}.} \opt{recorder,recorderv2fm,ondio,h1xx,h300,ipodcolor,ipodnano}{\input{plugins/bejeweled.tex}} @@ -71,7 +72,7 @@ They cannot be run directly but are started by ``playing'' the associated file. Viewers are stored in the \textbf{/.rockbox/viewers/ }directory. -\opt{recorder,recorderv2fm,ondio}{\input{plugins/chip8emulator.tex}} +\opt{recorder,recorderv2fm,ondio,h1xx,h300,ipodcolor,ipodnano}{\input{plugins/chip8emulator.tex}} \opt{recorder,recorderv2fm,ondio,h1xx,h300}{\input{plugins/jpegviewer.tex}} -- cgit v1.2.3