/usr/share/doc/fizmo-common/README.txt is in fizmo-common 0.7.10-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 | ABOUT FIZMO
fizmo represents a generic a Z-Machine interpreter — "fizmo interprets z-
machine opcodes" — supporting all Z-Machine kinds except version 6,
allowing you to run Infocom-made and most other Z-Machine based
interactive fiction, also called text adventures. It also provides a
generalized, plain-C interpreter library, as well as interfaces /
implementations for various display and sound output methods, providing an
interpreter-engine for you own project, even for closed-source
implementations due to it's BSD-style license.
- About Infocom and interactive fiction in general, see the "New to IF"
at http://www.ifarchive.org section at the Interactive Fiction Archive.
- To download Z-Machine games, see the IF-Archive's "Z-Code" at http://
www.ifarchive.org/indexes/if-archiveXgamesXzcode.html section.
---
FRONTENDS
Currently three frontends are available:
- fizmo-ncursesw
The default frontend uses ncurses "wide" variant for story output.
Ncurses at http://www.gnu.org/software/ncurses/ is commonly used for
output on fixed-width text displays. The wide extensions will ensure
correct unicode display.
- fizmo-console
This frontend will simple read and write from the console / terminal.
No fance functionality whatsoever, but may be useful for automization
or voice output.
- fizmo-glktermw
An example Glk at http://en.wikipedia.org/wiki/Glk_(software) frontend.
Requires glktermw — notice the trailing "w" — which may be downloaded
from the GLK-Implementations at http://www.ifarchive.org/indexes/if-
archiveXprogrammingXglkXimplementations.html at the Interactive Fiction
archive.
---
INTERFACES
For developers, interfaces translate the Z-machine specific output —
window management, output, scrolling and so on — into more display-
specific commands, easing implementation considerably.
- libcellif
This interface will convert output into simple "goto-xy"- and "print"-
commands, providing support for implementations on a fixed-width
display. This interface is used by fizmo-ncursesw.
- libglkif
The GLK-interface translates Z-Machine output into GLK-specific
instructions. This is used by Andrew Plotkin's iOS-fizmo at https://
github.com/erkyrath/iosfizmo/.
---
LIBRARIES
- libfizmo
This provides the interpreter core. It is a plain-C implementation
which requires no external libraries (libxml2 is used by default, but
in case babel support is not needed even libxml2 is not required).
- libdrilbo
Provides support for jpeg, png and infocom's mg1 image reading as well
as X11-based output.
- libsndifsdl2
Supplies a SDL2-based sound interface.
---
INSTALLATION
Please see “INSTALL.txt” on how to bulid the packages.
---
MISCELLANEOUS
Please send bug reports (or other requests) to fizmo@spellbreaker.org at
mailto:fizmo@spellbreaker.org.
Fizmo was written by Christoph Ender in 2005 -- 2014.
Please note:
Currently fizmo is in beta status, meaning it might do unexpected things
such as stop with an error message, crash or cleesh your machine into a
frog. There is no warranty of any kind whatsoever and you're entirely on
your own when running it.
|