!!!**** BY USING THIS SOFTWARE YOU ACCEPT THE TERMS OF THE LICENSE (See Below) ****!!!
JFrotz Version 0.2.3 February 25, 2012
Copyright (c) 2012 William H. Johnson. Significant portions copyrighted by other authors as shown below. See individual files for details.
Please report bugs and issues to: javafrotz@gmail.com
JFrotz for Android is a Java implementation of the Frotz Z-Machine interpreter. JFrotz was developed by converting the Frotz 2.43 C-code to Java Bytecode via Simon Kangstrom's Cibyl programming environment and binary translator. Cibyl enables translation of C source code to Java byte code, which can be executed on J2ME(and Android)-capable phones. (http://code.google.com/p/cibyl/) ** Many Thanks! **
JFrotz is also available as a J2ME version for Blackberry and other MIDP compliant devices.
JFrotz can be used to play Z-Machine compatible interactive fiction games, e.g., the stories created by Infocom (Zork, Enchanter, etc.), or any (or at least most) stories created by the Inform compiler.
* WARNING/DISCLAIMER *
This application DOES ACCESS THE LOCAL FILE SYSTEM OF THE DEVICE to load story files and save games. BY USING THIS SOFTWARE YOU ASSUME THE RISK OF ANY DAMAGE THAT THE SOFTWARE UNINTENTIONALLY DOES TO YOUR DEVICE OR FILES.
LICENSE:
This is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.
This application is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
The following link provides a copy of the GNU General Public License:
http://www.gnu.org/licenses/gpl.txt
If you are unable to obtain the copy from this address, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
SOURCE:
Source code is available at http://sourceforge.net/projects/jfrotz/
AUTHORS:
JFrotz: William H. Johnson
StringTokenizer: Stephen Ostermiller
VT320 Terminal: Matthias L. Jugel, Marcus Meiner 1996-2002, Radek Polak,2011 William H. Johnson
Original Frotz reference code: Stefan Jokisch (stefan.jokisch@gmx.de)
Original Frotz Unix port: Galen Hazelwood (galenh@micron.net)
New Frotz reference code: Jim Dunleavy (jim.dunleavy@erha.ie), David Griffith (dgriffi@cs.csubak.edu)
New Unix port: David Griffith (dgriffi@cs.csubak.edu)
V6 semi-support: Alembic Petrofsky (alembic@petrofsky.berkeley.ca.us)
OSS sound support (from xfrotz 2.32.1): Daniel Schepler
FileChooser (Apache 2.0 License): See http://code.google.com/p/android-filechooser/
JFrotz was adapted from ZaxMidlet and thus likely contains some code fragments from Mathew Kimmel's Zax Java implementation of the Z-Machine. No code is intentionally reused from Zax.
Additional Notes:
What Works:
JFrotz should support most of what the unix version of frotz supports, e.g.:
JFrotz, should be 1.0 Z-machine standard compliant, with the exception of scripting (temporarily broken).
Save/Restore in Quetzal Format (allowing stories to be saved on your device and restored on a computer).
Colors, text formats are supported.
What is currently being worked on:
User interface improvements
Support for autocomplete of text
Support for copy text
Editable Command history
Macro capability
Story Library (in addition to basic file access)
File playback
Frotz hotkey functionality
Z-Machine Issues
Scripting
Timed input (generally works, som eoutlier issues)
Misc improvements
More robust error handling
What I could use some help with:
Fonts for non-english languages. Contact me if you want to help. No programming required, only images are needed.
What will likely never work:
V6 support
Revision History:
0.2.3 (ANDROID ONLY) - Resolved a minor issue reported where ZBoard state is incorrectly stored. 2/25/2012
0.2.2 (ANDROID ONLY) - Added settable number of rows, allowing for backscroll. 2/25/2012
ZBoard state is now remembered.
Story folder and saved games folder are now remembered
Double tapping back button now exits application
Added support for screen gestures to:
Toggle soft keyboard
Toggle Zboard
Send ENTER (useful for dealing with [MORE] when keyboard is hidden
Resolved a threading issue that could temporarily corrupt the screen buffer.
0.2.1 (ANDROID ONLY) - Minor update to keep screen from clearing too often 2/18/2012
0.2.0 - Initial Android and J2ME versions. 2/18/2012
Known Issues:
* Poor error handling when opening an invalid story file
