diff options
Diffstat (limited to 'manual')
-rw-r--r-- | manual/plugins/images/ss-zxbox-112x64x1.png | bin | 0 -> 782 bytes | |||
-rw-r--r-- | manual/plugins/images/ss-zxbox-128x128x16.png | bin | 0 -> 1320 bytes | |||
-rw-r--r-- | manual/plugins/images/ss-zxbox-132x80x16.png | bin | 0 -> 1055 bytes | |||
-rw-r--r-- | manual/plugins/images/ss-zxbox-138x110x2.png | bin | 0 -> 1282 bytes | |||
-rw-r--r-- | manual/plugins/images/ss-zxbox-160x128x1.png | bin | 0 -> 1502 bytes | |||
-rw-r--r-- | manual/plugins/images/ss-zxbox-160x128x16.png | bin | 0 -> 1549 bytes | |||
-rw-r--r-- | manual/plugins/images/ss-zxbox-160x128x2.png | bin | 0 -> 1515 bytes | |||
-rw-r--r-- | manual/plugins/images/ss-zxbox-176x132x16.png | bin | 0 -> 1713 bytes | |||
-rw-r--r-- | manual/plugins/images/ss-zxbox-176x220x16.png | bin | 0 -> 2456 bytes | |||
-rw-r--r-- | manual/plugins/images/ss-zxbox-220x176x16.png | bin | 0 -> 2512 bytes | |||
-rw-r--r-- | manual/plugins/images/ss-zxbox-240x320x16.png | bin | 0 -> 3551 bytes | |||
-rw-r--r-- | manual/plugins/images/ss-zxbox-320x240x16.png | bin | 0 -> 3557 bytes | |||
-rw-r--r-- | manual/plugins/main.tex | 2 | ||||
-rw-r--r-- | manual/plugins/zxbox.tex | 95 |
14 files changed, 97 insertions, 0 deletions
diff --git a/manual/plugins/images/ss-zxbox-112x64x1.png b/manual/plugins/images/ss-zxbox-112x64x1.png new file mode 100644 index 0000000000..089bf28cdb --- /dev/null +++ b/manual/plugins/images/ss-zxbox-112x64x1.png | |||
Binary files differ | |||
diff --git a/manual/plugins/images/ss-zxbox-128x128x16.png b/manual/plugins/images/ss-zxbox-128x128x16.png new file mode 100644 index 0000000000..9b37aea645 --- /dev/null +++ b/manual/plugins/images/ss-zxbox-128x128x16.png | |||
Binary files differ | |||
diff --git a/manual/plugins/images/ss-zxbox-132x80x16.png b/manual/plugins/images/ss-zxbox-132x80x16.png new file mode 100644 index 0000000000..d779645796 --- /dev/null +++ b/manual/plugins/images/ss-zxbox-132x80x16.png | |||
Binary files differ | |||
diff --git a/manual/plugins/images/ss-zxbox-138x110x2.png b/manual/plugins/images/ss-zxbox-138x110x2.png new file mode 100644 index 0000000000..c9de1ea3ce --- /dev/null +++ b/manual/plugins/images/ss-zxbox-138x110x2.png | |||
Binary files differ | |||
diff --git a/manual/plugins/images/ss-zxbox-160x128x1.png b/manual/plugins/images/ss-zxbox-160x128x1.png new file mode 100644 index 0000000000..fa2b637ea0 --- /dev/null +++ b/manual/plugins/images/ss-zxbox-160x128x1.png | |||
Binary files differ | |||
diff --git a/manual/plugins/images/ss-zxbox-160x128x16.png b/manual/plugins/images/ss-zxbox-160x128x16.png new file mode 100644 index 0000000000..9ea77d25f1 --- /dev/null +++ b/manual/plugins/images/ss-zxbox-160x128x16.png | |||
Binary files differ | |||
diff --git a/manual/plugins/images/ss-zxbox-160x128x2.png b/manual/plugins/images/ss-zxbox-160x128x2.png new file mode 100644 index 0000000000..7da5081f93 --- /dev/null +++ b/manual/plugins/images/ss-zxbox-160x128x2.png | |||
Binary files differ | |||
diff --git a/manual/plugins/images/ss-zxbox-176x132x16.png b/manual/plugins/images/ss-zxbox-176x132x16.png new file mode 100644 index 0000000000..fb5e8e3f33 --- /dev/null +++ b/manual/plugins/images/ss-zxbox-176x132x16.png | |||
Binary files differ | |||
diff --git a/manual/plugins/images/ss-zxbox-176x220x16.png b/manual/plugins/images/ss-zxbox-176x220x16.png new file mode 100644 index 0000000000..3cf08ea882 --- /dev/null +++ b/manual/plugins/images/ss-zxbox-176x220x16.png | |||
Binary files differ | |||
diff --git a/manual/plugins/images/ss-zxbox-220x176x16.png b/manual/plugins/images/ss-zxbox-220x176x16.png new file mode 100644 index 0000000000..1a5b248e0e --- /dev/null +++ b/manual/plugins/images/ss-zxbox-220x176x16.png | |||
Binary files differ | |||
diff --git a/manual/plugins/images/ss-zxbox-240x320x16.png b/manual/plugins/images/ss-zxbox-240x320x16.png new file mode 100644 index 0000000000..85e68bde67 --- /dev/null +++ b/manual/plugins/images/ss-zxbox-240x320x16.png | |||
Binary files differ | |||
diff --git a/manual/plugins/images/ss-zxbox-320x240x16.png b/manual/plugins/images/ss-zxbox-320x240x16.png new file mode 100644 index 0000000000..e88e7dc18a --- /dev/null +++ b/manual/plugins/images/ss-zxbox-320x240x16.png | |||
Binary files differ | |||
diff --git a/manual/plugins/main.tex b/manual/plugins/main.tex index b478d9733b..456d9d9153 100644 --- a/manual/plugins/main.tex +++ b/manual/plugins/main.tex | |||
@@ -129,6 +129,8 @@ the associated file. Viewers are stored in the | |||
129 | 129 | ||
130 | \opt{recorder,recorderv2fm,ondio}{\input{plugins/wavplay.tex}} | 130 | \opt{recorder,recorderv2fm,ondio}{\input{plugins/wavplay.tex}} |
131 | 131 | ||
132 | \opt{lcd_bitmap}{\input{plugins/zxbox.tex}} | ||
133 | |||
132 | \section{Applications} | 134 | \section{Applications} |
133 | 135 | ||
134 | \opt{player,recorder,recorderv2fm}{\input{plugins/alpinecdc.tex}} | 136 | \opt{player,recorder,recorderv2fm}{\input{plugins/alpinecdc.tex}} |
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}. | ||