manual/plugins/zxbox.tex

   1 \subsection{\label{ref:ZXBox}ZXBox}
   2 \screenshot{plugins/images/ss-zxbox}{ZXBox}{img:zxbox}
   3 ZXBox is a port of the ``Spectemu'' ZX Spectrum 48k emulator for Rockbox
   4 (\Pointinghand\href{http://kempelen.iit.bme.hu/~mszeredi/spectemu/spectemu.html}
   5 {project's homepage}). To start a game open a tape file or snapshot saved as
   6 \fname{.tap}, \fname{.tzx}, \fname{.z80} or \fname{.sna} in the file browser.\\
   7 \note{As ZXBox is a 48k emulator only loading of 48k z80 snapshots is possible.}
   8
   9 \subsubsection{Default keys}
  10 The emulator is set up for 5 different buttons: Up, Down, Left, Right and
  11 Jump/Fire. Each one of these can be mapped to one key of the Spectrum Keyboard
  12 or they can be used like a ``Kempston'' joystick. Per default the buttons,
  13 including an additional but fixed menu button, are assigned as follows:
  14
  15 \begin{btnmap}
  16     \opt{IPOD_3G_PAD,IPOD_4G_PAD}{\ButtonMenu/\ButtonPlay/}
  17     \opt{RECORDER_PAD,ONDIO_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD,GIGABEAT_PAD,GIGABEAT_S_PAD%
  18         ,IAUDIO_X5_PAD,SANSA_C200_PAD,SANSA_E200_PAD,SANSA_FUZE_PAD,MROBE100_PAD,PBELL_VIBE500_PAD}%
  19         {\ButtonUp/\ButtonDown/}
  20     \opt{IRIVER_H10_PAD}{\ButtonScrollUp/\ButtonScrollDown/}
  21     \opt{IPOD_3G_PAD,IPOD_4G_PAD,RECORDER_PAD,ONDIO_PAD,IRIVER_H100_PAD%
  22         ,IRIVER_H300_PAD,GIGABEAT_PAD,GIGABEAT_S_PAD,IAUDIO_X5_PAD%
  23         ,SANSA_C200_PAD,SANSA_E200_PAD,SANSA_FUZE_PAD,MROBE100_PAD%
  24         ,IRIVER_H10_PAD,PBELL_VIBE500_PAD}{\ButtonLeft/\ButtonRight}
  25     \opt{COWON_D2_PAD}{\TouchTopMiddle{}/\TouchBottomMiddle{}/\TouchMidLeft{}/\TouchMidRight}
  26     \opt{MPIO_HD200_PAD}{\ButtonVolDown / \ButtonVolUp / \ButtonRew / \ButtonFF}
  27     \opt{MPIO_HD300_PAD}{\ButtonRew / \ButtonFF / \ButtonScrollUp / \ButtonScrollDown}
  28   \opt{HAVEREMOTEKEYMAP}{& }
  29     & Directional movement\\
  30     %
  31     \opt{IPOD_3G_PAD,IPOD_4G_PAD,GIGABEAT_PAD,GIGABEAT_S_PAD,IAUDIO_X5_PAD%
  32         ,SANSA_C200_PAD,SANSA_E200_PAD,SANSA_FUZE_PAD,MROBE100_PAD}{\ButtonSelect}
  33     \opt{RECORDER_PAD}{\ButtonPlay}
  34     \opt{IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonOn}
  35     \opt{ONDIO_PAD}{\ButtonMenu}
  36     \opt{IRIVER_H10_PAD}{\ButtonRew}
  37     \opt{COWON_D2_PAD}{\TouchCenter}
  38     \opt{PBELL_VIBE500_PAD}{\ButtonOK}
  39     \opt{MPIO_HD200_PAD}{\ButtonFunc}
  40     \opt{MPIO_HD300_PAD}{\ButtonEnter}
  41   \opt{HAVEREMOTEKEYMAP}{& }
  42     & Jump/Fire\\
  43     %
  44     \opt{RECORDER_PAD}{\ButtonFOne}
  45     \opt{ONDIO_PAD}{\ButtonOff}
  46     \opt{IPOD_3G_PAD,IPOD_4G_PAD}{\ButtonHold{} switch}
  47     \opt{IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonMode}
  48     \opt{GIGABEAT_PAD,GIGABEAT_S_PAD,COWON_D2_PAD}{\ButtonMenu}
  49     \opt{SANSA_C200_PAD,SANSA_E200_PAD,MROBE100_PAD}{\ButtonPower}
  50     \opt{SANSA_FUZE_PAD}{Long \ButtonHome}
  51     \opt{IAUDIO_X5_PAD}{\ButtonPlay}
  52     \opt{IRIVER_H10_PAD}{\ButtonFF}
  53     \opt{PBELL_VIBE500_PAD}{\ButtonCancel}
  54     \opt{MPIO_HD200_PAD}{\ButtonRec + \ButtonPlay}
  55     \opt{MPIO_HD300_PAD}{Long \ButtonMenu}
  56   \opt{HAVEREMOTEKEYMAP}{& }
  57     & Open ZXBox menu\\
  58 \end{btnmap}
  59
  60 \subsubsection{ZXBox menu}
  61 \begin{description}
  62 \item[ Vkeyboard.]
  63     This is a virtual keyboard representing the Spectrum keyboard. Controls are
  64     the same as in standard Rockbox, but you just press one key instead of
  65     entering a phrase.
  66 \item[Play/Pause Tape.] Toggles playing of the tape (if it is loaded).
  67 \item[Save Quick Snapshot.] Saves snapshot into \fname{/.rockbox/zxboxq.z80}.
  68 \item[Load Quick Snapshot.] Loads snapshot from \fname{/.rockbox/zxboxq.z80}.
  69 \item[Save Snapshot.]
  70     Saves a snapshot of the current state. You would enter the full path and
  71     desired name - for example \fname{/games/zx/snapshots/chuckie.sna}. The
  72     snapshot format will be chosen after the extension you specified, per
  73     default \fname{.z80} will be taken in case you leave it open.
  74 \item[Toggle Fast Mode.]
  75     Toggles fastest possible emulation speed (no sound, maximum frameskip etc.).
  76     This is Useful when loading tapes with some specific loaders.
  77 \item[Options.]
  78     \begin{description}
  79     \item[Map Keys To Kempston.]
  80         Controls whether the \daps{} buttons should simulate a ``Kempston''
  81         joystick or some assigned keys of the Spectrum keyboard.
  82     \item[Display Speed.]Toggle displaying the emulation speed (in percent).
  83     \item[Invert Colours.]
  84         Inverts the Spectrum colour palette, sometimes helps visibility.
  85     \item[Frameskip]
  86         Sets the number of frames to skip before displaying one. With zero
  87         frameskip ZXBox tries to display 50 frames per second.
  88     \item[Sound.]Turns sound on or off.
  89     \item[Volume.]Controls volume of sound output.
  90     \item[Predefined Keymap]
  91         Select one of the predefined keymaps. For example \setting{2w90z} means:
  92         map ZXBox's \btnfnt{Up} to \setting{2}, \btnfnt{Down} to \setting{w},
  93         \btnfnt{Left} to \setting{9}, \btnfnt{Right} to \setting{0} and
  94         \btnfnt{Jump/Fire} to \setting{z}. This example keymap is used in the
  95         ``Chuckie Egg'' game.
  96     \item[Custom Keymap]
  97         This menu allows you to map one of the Spectrum keys accessible through the
  98         plugin's virtual keyboard to each one of the buttons.
  99     \item[Quit.] Quits the emulator..
 100     \end{description}
 101 \end{description}
 102
 103 \nopt{ipodvideo}{% no scaling for here, still include it?
 104 \subsubsection{Hacking graphics}
 105 Due to ZXBox's simple (but fast) scaling to the screen by dropping lines and
 106 columns some games can become unplayable. It is possible to hack graphics to
 107 make them better visible with the help of an utility such as the ``Spectrum
 108 Graphics Editor''. Useful tools can be found at the ``World of Spectrum'' site
 109 (\url{http://www.worldofspectrum.org/utilities.html}).}