ZaxMidlet version 0.1.5 - William H. Johnson - 4/16/2010 This software is licensed under the GNU GENERAL PUBLIC LICENSE Version 3, See LICENSE.TXT for LICENSE information ******************************** VERSIONS ***************************** 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. *********************************** MISC ******************************************* Note: ZaxMidlet is an UNSIGNED midlet. This means that you will likely get a number of annoying messages every time you load a story file or save or recall a saved game, e.g., "The application ZaxMidlet has attempted to open local content. Would you like to allow this?" You will need to repeatedly answer "yes" to this question. Fortunately, this is only an issue during the initial load and when you save or recall a saved game. The only way to avoid this is for the application to be signed. This would cost me between $200 and $500 per year so I have not done so for obvious reasons. Portions of this software were originally licensed under: 1. Zax 0.91- The MIT License - See Below 2. The code in FileDialog.java was licensed by Sun Microsystems, Inc. as FileBrowser.java- See Below If you want to use the code from these applications under the less restrictive licenses that they were originally licensed under, it is recommended that you locate the original source. Zax is readily available on www.ifarchive.org FileBrowser.java is one of the example programs made available with the Sun Microsystems Wireless Toolkit, Other source used in this application was licensed under the GPL, which is why the entire project needs to be licensed under the GPL. ************************************ INSTALLATION ********************************** 1. Copy the deployed/ZaxMidlet.jar file to your device 2. open it and install (With Blackberry, explore using the Media Browser) It is NOT SIGNED. Sorry, no over the air installation yet. ***************************************************************************************** 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 ZAXMidlet DOES TO YOUR DEVICE OR FILES. Feel free to contact me (William H. Johnson) at zaxmidlet@gmail.com with any comments or suggestions. ** WHAT IS ZaxMidlet? ** This is a J2ME Midlet implementation of the Zax Z-Machine interpreter copyright(c) 2008-2010 by William H. Johnson. It should work on any QWERTY device that supports MIDP2.0 and allows local file access. It has only been tested on a blackberry curve. What works: V1-5,7,8 games File save/recall What does not work(yet): Command history. colors bold/italic typeface The code is currently a mess. It needs major refactoring and cleanup. 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 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. 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. ****************************************FileBrowser.java LICENSE ******************************************** * This license applies only to the original unmodified version of FileBrowser.java, available with the Wireless Toolkit ** ** FileDialog.Java * Copyright (c) 2007, Sun Microsystems, Inc. * * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions * are met: * * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of Sun Microsystems nor the names of its contributors * may be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ *************************************** Zax 0.91 LICENSE ******************************************** * This license applies only to the original unmodified version of Zax 0.91, available from www.ifarchive.org ** MIT License Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.