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