diff options
author | Torne Wuff <torne@wolfpuppy.org.uk> | 2010-01-17 22:15:13 +0000 |
---|---|---|
committer | Torne Wuff <torne@wolfpuppy.org.uk> | 2010-01-17 22:15:13 +0000 |
commit | 7f28c94eda576e3f972fc05468188986f2e45885 (patch) | |
tree | e03b94613028d16855a5d3df0f4853e077931214 /manual/plugins/frotz.tex | |
parent | 563f2602f471208cb8544a36539a79dcceaad643 (diff) | |
download | rockbox-7f28c94eda576e3f972fc05468188986f2e45885.tar.gz rockbox-7f28c94eda576e3f972fc05468188986f2e45885.zip |
New plugin: frotz, a Z-machine interpreter, for playing interactive fiction.
The interpreter more or less passes all the tests in the z-machine test suite.
It should build for every target except Archos (for which it is disabled).
git-svn-id: svn://svn.rockbox.org/rockbox/trunk@24267 a1c6a512-1295-4272-9138-f99709370657
Diffstat (limited to 'manual/plugins/frotz.tex')
-rw-r--r-- | manual/plugins/frotz.tex | 67 |
1 files changed, 67 insertions, 0 deletions
diff --git a/manual/plugins/frotz.tex b/manual/plugins/frotz.tex new file mode 100644 index 0000000000..c1d59e4905 --- /dev/null +++ b/manual/plugins/frotz.tex | |||
@@ -0,0 +1,67 @@ | |||
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. | ||
8 | |||
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. | ||
13 | |||
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. | ||
18 | |||
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} | ||
35 | |||
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}{\ButtonPlay} | ||
40 | \opt{ONDIO_PAD}{\ButtonMenu} | ||
41 | \opt{IAUDIO_X5_PAD,MROBE100_PAD}{\ButtonPower} | ||
42 | \opt{SANSA_E200_PAD,SANSA_C200_PAD}{\ButtonUp} | ||
43 | \opt{GIGABEAT_PAD}{\ButtonA} | ||
44 | \opt{HAVEREMOTEKEYMAP}{& | ||
45 | \opt{IRIVER_RC_H100_PAD}{\ButtonRCOn} | ||
46 | } | ||
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}{\ButtonSelect} | ||
50 | \opt{RECORDER_PAD}{\ButtonPlay} | ||
51 | \opt{ONDIO_PAD}{\ButtonUp} | ||
52 | \opt{IRIVER_H10_PAD}{\ButtonRew} | ||
53 | \opt{COWON_D2_PAD}{\ButtonMenu{}, \TouchCenter{} or \TouchBottomMiddle} | ||
54 | \opt{HAVEREMOTEKEYMAP}{& } | ||
55 | & Press enter\\ | ||
56 | \opt{RECORDER_PAD,ONDIO_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonOff} | ||
57 | \opt{IPOD_4G_PAD,IPOD_3G_PAD}{\ButtonMenu} | ||
58 | \opt{IAUDIO_X5_PAD,IRIVER_H10_PAD,SANSA_E200_PAD,SANSA_C200_PAD,GIGABEAT_PAD% | ||
59 | ,MROBE100_PAD}{\ButtonPower} | ||
60 | \opt{GIGABEAT_S_PAD}{\ButtonBack} | ||
61 | \opt{COWON_D2_PAD}{\ButtonPower{} or \TouchBottomRight} | ||
62 | \opt{HAVEREMOTEKEYMAP}{& | ||
63 | \opt{IRIVER_RC_H100_PAD}{\ButtonRCStop} | ||
64 | } | ||
65 | & Open Frotz menu (not available at MORE prompts)\\ | ||
66 | \end{btnmap} | ||
67 | \end{table} | ||