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