Fix various size_t related warnings and errors
[kugel-rb.git] / manual / plugins / frotz.tex
blobda817d06247298904ba78be429996a3566c64ff8
1 % $Id$ %
2 \subsection{Frotz}
3 Frotz is a Z-Machine interpreter for playing Infocom's interactive fiction
4 games, and newer games using the same format. To start a game open a
5 \fname{.z1 - .z8} file in the \setting{File Browser}. Most modern games are
6 in the \fname{.z5} or \fname{.z8} format but the older formats used by
7 Infocom are supported.
9 Z-Machine games are text based and most depend heavily on typed commands.
10 The virtual keyboard is used for text entry, both for typing entire lines
11 and for typing single characters when the game requires single character
12 input.
14 Sounds, pictures, colour and Unicode are not currently supported, but
15 the interpreter informs the game of this and almost all games will
16 adapt so that they are still playable. This port of Frotz attempts to be
17 compliant with the Z-Machine Specification version 1.0.
19 Some places where you can find Z-Machine games, and information about
20 interactive fiction:
21 \begin{itemize}
22 \item The Interactive Fiction Archive, where many free modern works
23 can be downloaded:
24 \url{http://www.ifarchive.org/}
25 \item The specific folder on the if-archive containing Z-Machine games:
26 \url{http://www.ifarchive.org/indexes/if-archiveXgamesXzcode.html}
27 \item The Infocom homepage, with information about how to get the
28 classic commercial Infocom games:
29 \url{http://www.csd.uwo.ca/Infocom/}
30 \item The Frotz homepage (for the original Unix port):
31 \url{http://frotz.sourceforge.net/}
32 \item A Beginner's Guide to Playing Interactive Fiction:
33 \url{http://www.microheaven.com/IFGuide/}
34 \end{itemize}
36 \begin{table}
37 \begin{btnmap}{}{}
38 \opt{RECORDER_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonOn}
39 \opt{IPOD_4G_PAD,IPOD_3G_PAD,IRIVER_H10_PAD,GIGABEAT_S_PAD,PBELL_VIBE500_PAD}{\ButtonPlay}
40 \opt{ONDIO_PAD}{\ButtonMenu}
41 \opt{IAUDIO_X5_PAD,MROBE100_PAD}{\ButtonPower}
42 \opt{SANSA_E200_PAD,SANSA_C200_PAD,SANSA_FUZE_PAD}{\ButtonUp}
43 \opt{GIGABEAT_PAD}{\ButtonA}
44 \opt{HAVEREMOTEKEYMAP}{&
45 \opt{IRIVER_RC_H100_PAD}{\ButtonRCOn}
47 & Display keyboard to enter text\\
48 \opt{IRIVER_H100_PAD,IRIVER_H300_PAD,IAUDIO_X5_PAD,IPOD_4G_PAD,IPOD_3G_PAD%
49 ,SANSA_E200_PAD,SANSA_C200_PAD,GIGABEAT_PAD,GIGABEAT_S_PAD,MROBE100_PAD%
50 ,SANSA_FUZE_PAD}
51 {\ButtonSelect}
52 \opt{RECORDER_PAD}{\ButtonPlay}
53 \opt{ONDIO_PAD}{\ButtonUp}
54 \opt{IRIVER_H10_PAD}{\ButtonRew}
55 \opt{COWON_D2_PAD}{\ButtonMenu{}, \TouchCenter{} or \TouchBottomMiddle}
56 \opt{PBELL_VIBE500_PAD}{\ButtonOK}
57 \opt{HAVEREMOTEKEYMAP}{& }
58 & Press enter\\
59 \opt{RECORDER_PAD,ONDIO_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonOff}
60 \opt{IPOD_4G_PAD,IPOD_3G_PAD,PBELL_VIBE500_PAD}{\ButtonMenu}
61 \opt{IAUDIO_X5_PAD,IRIVER_H10_PAD,SANSA_E200_PAD,SANSA_C200_PAD%
62 ,GIGABEAT_PAD,MROBE100_PAD}
63 {\ButtonPower}
64 \opt{SANSA_FUZE_PAD}{Long \ButtonHome}
65 \opt{GIGABEAT_S_PAD}{\ButtonBack}
66 \opt{COWON_D2_PAD}{\ButtonPower{} or \TouchBottomRight}
67 \opt{HAVEREMOTEKEYMAP}{&
68 \opt{IRIVER_RC_H100_PAD}{\ButtonRCStop}
70 & Open Frotz menu (not available at MORE prompts)\\
71 \end{btnmap}
72 \end{table}