HelioFrotz V1.5b - Earle F. Philhower, III - earle@ziplabel.com
Jan 12, 2002   -   Source/App Released under GNU Public License
http://www.ziplabel.com/helio


HelioFrotz will allow you to play many INFORM z-code games on your Helio.
This includes many Infocom original games such as Zork and Planetfall,
as well as a plethora of newly created interactive fiction titles.


Based upon (but not responsible for the bugs in the Helio port...)
  /--------------------------------------------------------------\
  | FROTZ V2.41 - An interpreter for all Infocom games and other |
  | Z-machine games.                                             |
  | Complies with standard 1.0 of Graham Nelson's specification. |
  | Originally written by Stefan Jokisch in 1995-1997.           |
  | Reference code currently maintained by Jim Dunleavy.         |
  | Ported to Unix by Galen Hazelwood.                           |
  | Unix port currently maintained by David Griffith.            |
  \--------------------------------------------------------------/
See COPYING.TXT for GNU licensing
See CHANGES.TXT for revision changes
See frotz2.41/*.txt for original Frotz documents
--- frotz2.41/HOW_TO_PLAY is a good introduction to "Interactive Fiction"


Helio Installation:
. Start helio desktop
. Right-click on the username to bring up popup menu
. Select "Install PDA Application"
. Select HelioFrotz.app
. Hit the hotsync button and voila


Making HDB Files:
- Get many free ZCODE games at:
     http://www.ifarchive.org/indexes/if-archiveXgamesXzcode.html
. Run MakeZHDB to convert the inform.dat file into Helio format
    ex: makezhdb zork1.dat "Zork I" "Frotz" zork1.hdb
. It is important to keep the 3rd option given to makehdb
  as "Frotz".  That's how these files are detected by the APP.


Installing HDB Files:
** There are sample .HDB files included in the Install directory **
. Copy the resulting HDB file to your hotsync upload dir:
     C:\Program Files\VTech\Helio Desktop 2.0\1\Acc
. Hotsync, and off you go


Getting Fonts into your Helio:
. Download any Palm PDB formatted font (only 1 font per PDB is allowed)
. Run MAKEZHDB with filetype as FontPDB
      ex: makezhdb HKFONT.PDB "HK Font 40x26" "FontPDB" hkfont.hdb
. Hotsync the resulting HDB file and you're set!
. Check out
        http://www.rainerzenz.de/palm/alphafonts.html
  for some good, free Palm fonts to try.
  And get the font HKFONT from
        http://www.rainerzenz.de/palm/alphafontothers.html
  to play the Z-CODE abusers in 40x25 glory!


Playing on the Helio:
. Start HelioFrotz, select a game from the list, and hit Play!
. You can choose the font HelioFrotz will use to display TEXT (standard
  room descriptions, etc.) and FIXED (status bar, some ASCII maps) by
  hitting the appropriate button from the startup screen.
. OK button = ENTER
. MENU button brings up a list of common words
. The crosshair next to the text entry line brings up a compass
. The arrow next to the text entry line shows your last 5 commands,
  last command will be lowest on the list (less pointer movement needed!)
. Tap anywhere on the screen or use the scroll buttons on the side of the
  Helio to advance past a MORE prompt
. Clicking on a word on-screen will copy it to your current text line
. Save and Restore games work, transcripts go to Text documents
  (Get TextView application http://www.ziplabel.com/helio to read these
   or send back to your PC!)
. If your Helio is shut off in the middle of a game, it will autosave a
  file called "power.sav".  Just restart the game file, then enter RESTORE,
  followed by power.sav and you should be back where you left off!


Programmers:
. Changes to Frotz 2.41 source original files are listed under
  #ifdef _VTOS / #endif sections.  Other files are my own creation.
. You will need my_stdio library (or your own) to implement the
  Fnt* functions and fopen/fread/etc.
  my_stdio is available at http://www.ziplabel.com/helio


Have Fun!
earle@ziplabel.com
