nookZax version 0.0.1 - William H. Johnson - 1/27/2011
Copyright (c) 2011 William H. Johnson
Please report bugs and issues to: zaxmidlet@gmail.com
nooZax is an Android implementation of the Zax Z-Machine interpreter optimized for the nook hardware.
nookZax 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.
** nookZax requires FileSelector.apk (available at www.nookdevs.com) to run. **
************************************ WARNING/DISCLAIMER *************************************
This is a very early version of the software, so I am sure that there are many things that do not work.
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.
I AM NOT RESPONSIBLE FOR ANY DAMAGE THAT nookZax DOES TO YOUR DEVICE OR FILES.
Feel free to contact me at zaxmidlet@gmail.com with any comments or suggestions.
TO USE THIS SOFTWARE YOU NEED A "ROOTED NOOK." I AM NOT IN ANY WAY RECOMENDING THAT YOU "ROOT" YOUR NOOK DEVICE.
IF YOU DECIDE TO DO THIS IT WILL BE AT YOUR OWN RISK.
I WILL NOT BE HELD RESPONSIBLE OR ABLE TO HELP IF YOU DAMAGE YOUR DEVICE OR FILES IN THE PROCESS.
************************************ INSTALLATION **********************************
1. To install this software you need a "rooted" nook. I will not even begin to describe how to do this and YOU DO THIS AT YOUR OWN RISK. See www.nookdevs.com
2. adb install nookZax.apk
3. adb install FileSelector.apk (nookZax requires FileSelector.apk, available from www.nookdevs.com)
UNINSTALL
1. adb uninstall com.zaxmidlet.nookZax
2. adb uninstall com.nookdevs.fileselector
******************************** LICENSE *****************************
LICENSE
This software is licensed under the GNU GENERAL PUBLIC LICENSE Version 3, See LICENSE.TXT for LICENSE information
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: SEE LICENSE.TXT
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
Portions of this software are copyrighted/licensed as follows:
GNU General Public License:
StringTokenizer - Copyright (C) 2001 Stephen Ostermiller
VT320 Terminal - Copyright(c) 2008 Matthias L. Jugel, Marcus Meiner 1996-2002, Radek Polak,2011 William H. Johnson
MIT LICENSE:
Z-Machine Engine (Zax) - Copyright(c) 2008 Matthew E. Kimmel
Apache License, Version 2.0:\n Nook Specific API calls - Copyright(c) 2010 nookDevs
******************************** VERSIONS of nookZax*****************************
0.0.1 Adapted to Android OS and Nook specific hardware
******************************** VERSIONS of ZaxMidlet*****************************
0.1.0 - Initial Release
0.1.1 - Fix issue with 2nd line not scrolling up on <=V3 Games.
0.1.2 - Fix double colon on Status Bar for time games.
Fix issue with Bureaucracy, Enter key always now forced to ASCII 13
Added Text input menu item to allow unusual characters to be entered. Also can be used to input text from non QWERTY keyboards.
0.1.3 Resolved Deadlock issue when key pressed while text is being printed to upper window
Improved input textbox, allowing multiple commands to be entered.
Implemented op code for disabling buffer mode for v4+ games
Increased speed of text output
0.1.4 Added nesting to stream 3
Fixed problem with Tokenizer that caused multiple commands entered on a single line (separated by periods) not to be processed.
Exit button no longer quits application on blackberry. Now pauses.
0.1.5 Cleaned up LCD Fonts to make them grey scale. This looks better on most devices.
0.1.6 Vastly improved fonts - (No more LCDFont, replaced with a new fixed point font)
Added support for colors
Added support for bold and italic(underlined) fonts
A number of bug fixes with respect to timed character input.
Zaxmidlet waits for a keypress before closing, allowing the user to see any messages printed at the end of the story.
0.1.7 Resolved an issue with the parser that prevented v5+ games from parsing correctly.
Versions of Zax <0.91 included a bug in the READ opcode that improperly placed the typed text in the text-buffer for v5+ stories.
Zaxmidlet 0.1.6 included this bug. For example in the story "Aisle," the command "woman, hello" is not parsed properly.
Version 0.91 of Zax fixes this issue, but improperly places the the typed text in the read buffer for V1-4 stories
This version of ZaxMidlet resolves this issue by placing the text in the appropriate location based on the story version.
Using the ENTER TEXT command will now enter a carriage return if no text is entered.
0.1.8 No substantive changes, HOWEVER, the Blackberry version of the executable is now signed, thus,
for Blackberry devices no more ANNOYING MESSAGES ASKING IF YOU ARE SURE YOU WANT TO ALLOW FILE ACCESS!
*********************************** MISC *******************************************
STORY FILES:
Story files must be located in the "my interactive fiction" directory. nookZax will attempt to create this directory the first time it is run.
** SAVING and RESTORING **
With version 0.0.1, no file dialog is included for saved games. You must select 1 of 12 save positions. Files are saved as storyfile_directory/saved games/storyfile.save.X
What works:
V1-5,7,8 games
File save/recall
colors
bold/italic(underline) typeface
What does not work(yet):
Command history.
UNICODE character set
Zax is not fully compliant to the 1.0 spec of the z-Machine, see ZAX_README.TXT
The software is based almost entirely on ZAX v0.91 Z-Code Application Executor - Copyright(c) 2008 Matt Kimmel and licensed under the MIT license.
See the ZAX_README.txt and ZAX_LICENSE.txt
I'd like to thank Matt Kimmel for recently making the source code to Zax Open Source, as that made this project possible.
The rest of the code is based on:
1. MidpSSH - Copyright (c) 2005 Karl von Randow, and licensed under the GNU General Public License. Code from this application is no longer used.
2. The Java Telnet Application - (c) Matthias L. Jugel, Marcus Meiner 1996-2002, and licensed under the GNU General Public License
3. LCDFont - Copyright 2005 Roar Lauritzsen, and licensed under the GNU General Public License.
Note: LCDFont was removed in version 0.1.6
4. ZeeME - A Midlet implementation of Zax Copyright (c) 2004 Craig Setera and Licensed under the Academic Free License version 1.2
- No code from ZeeME is used in this implementation (mostly because the Academic free license is incompatible with the GNU General Public License), but credit is given because it was very helpful to see how the problems were solved by the author of that application.
Basically, the implementation is a combination of Zax, and the terminal emulation provided by MidpSSH.
