 ________________________________________________________________________
  
    Smiley's Adventure - Platform game for the TI-89/TI-92+/Voyage 200!
  
                 Version 0.27 - Released August 20, 2011 
                                                                     
       This program is freely redistributable.  There is no warranty.
  
         pad@ocf.berkeley.edu     http://www.ocf.berkeley.edu/~pad/
 ________________________________________________________________________


 _____________________________________ TABLE OF CONTENTS

 1. Introduction / Instructions ...................................... 24  
 2. System requirements .............................................. 35
 3. Legal stuff ...................................................... 63  
 4. World Items ...................................................... 82
 5. Contacting the Programmer ....................................... 105
 6. Acknowledgements ................................................ 135
 7. Version History ................................................. 168
 8. The Future ...................................................... 188

 _____________________________________ INTRODUCTION / INSTRUCTIONS

Smiley's Adventure is a free platform-style game for the TI-89, TI-92 Plus, 
and Voyage 200 calculators.  This game is currently in an early state of 
development.  It is written in a combination of assembly language and C.
      
This program can be run simply by sending program file and the level files
to your calculator and then running it by typing "smiley()" at the home
screen.  Send the .89z and .89y files if you are using a TI-89, and the
.9xz and .9xy files if you are using a TI-92 Plus or Voyage 200.

 _____________________________________ SYSTEM REQUIREMENTS 

SYSTEMS SUPPORTED:  There are TI-89 and TI-92 Plus versions of the program.
The TI-89 version also supports the TI-89 Titanium, and the TI-92 Plus
version also supports the Voyage 200.  The different execuables are
different so you must select the appropriate one for your calculator.
However, level files can be exchanged between all calculators.

HARDWARE VERSIONS SUPPORTED:  This game will work on all hardware versions.
It is not necessary to install HW2Patch or HW3Patch.
necessary to install HW2Patch for this game.

SOFTWARE VERSIONS SUPPORTED:  This game should work on all AMS versions,
with two exceptions.  If you are using the very old AMS version 1.00 on a
TI-92 Plus you must upgrade to at least version 1.01 before you can run
the game.  Also, if you have AMS 2.03 you cannot run this game due to the
8K size limit (unless you disable the limit first).

MEMORY REQUIREMENTS:  The program may be stored in either RAM or archive
memory.  The only space required is that needed to store the program file
itself.  Note, however, that if you run the program from archive, it must
be temporarily copied to RAM to run, so there must be enough free RAM for
a copy of it in that case.  It is safe to compress the program to a ppg
(exepacked) file to save space.

SHELLS/KERNELS REQUIRED:  No shell or kernel is required to run this game.
However you can start the game from a shell if you like.
    
 _____________________________________ LEGAL STUFF

Since you did not pay me anything for the right to use this software, there
is no warranty of any kind.  This software has been tested, and at the time
of release the author was not aware of any serious problems with it.
However, there is still a possibility of unforeseen problems.  If you do
encounter any problems with this program, please inform me as soon as
possible (of course, I cannot guarantee that I will fix such problems).

All portions of the program made by me are copyrighted by me, but may be
freely used, copied, and/or modified with no restrictions.

However, I would appreciate if you at least do the following if you are
making a modified version:

 - Don't add any restrictions to its distribution or modification
 - Supply complete source code
 - Give me a reasonable amount of credit

 _____________________________________ WORLD DESCRIPTION

Here is a brief description of some of the items you will encounter in this
game.  This is not meant to describe everything in detail; you will need to
discover some things by playing.

BRICKS:  As you might be able to guess, these are things you can walk on top
of, but cannot walk through.

LADDERS:  You can climb up and down these.

EXIT SIGN:  To complete a level, go to one of these.

ELECTRICAL ARCS:  I wouldn't recommend touching them.

PORCUPINES, SPIDERS, BIRDS:  These are your enemies.  You don't need to kill
them in order to win, but you will lose if they manage to kill you.

GUN:  If you collect this (by moving over it) you can then shoot.  Note that
you will get a very limited number of bullets, so use them wisely.

and much much more...

 _____________________________________ CONTACTING THE PROGRAMMER

If you find any bugs in this game or have suggestions or comments about it,
please tell me in E-Mail!  If you are writing to report a bug, please be
sure to tell me exactly what the problem is and describe exactly what you
did before the problem occured.  If you don't do so, it will be very hard
for me to tell what is going wrong!  You should also tell me which version
of the game you have and which calulator you use in any mail you send me.
My main E-Mail address is:

        pad@ocf.berkeley.edu

I will usually answer my E-Mail within a week.  If you don't get any answer
in two weeks, you can try sending to the following backup addresses:

        eeulplek@hotmail.com

If your E-Mail is set up to block all messages except those from certain
addresses, always be sure that you have un-blocked my address before
sending anything to me (best to un-block all of them, since I might answer
from a different one than you sent to).

You can always get the latest version of this game, as well as other
programs of mine, from my web page.  The address is:

        http://www.ocf.berkeley.edu/~pad/

You can also find me on IRC.  I use the nick 'PatrickD' or similar variants
and am usually in #ti on EfNet and various other TI calculator channels.

 _____________________________________ ACKNOWLEDGEMENTS

This game is my own work.  However, there are a few others whose assistance
was invaluable in producing this game, and there efforts will be acknowledged
here, in no particular order:

David Ellsworth            Fargo II and the Fargo II development tools,
                           also a small bit of FLIB code I used

Olivier Lesteven           TEOS and the TEOS development tools

Brian Anderson and         The A68K assembler, used to assemble almost all
Charlie Gibbs              calculator assembly programs

Tleilax                    DB92, an amazing on-calculator debugger

Rusty Wagner of ACZ        The VTI calculator emulator, which provides the
                           ultimate testing environment on a computer

Corey Taylor of the ACZ    the CalcGS map editing software

Zeljko Juric               The TI-GCC library, whose documentation helped
                           to explain some ROM functions and also showed
                           me how to do OS key-reading and HW detection, and
                           from which grayscale and file routines are used

Thomas Nussbaumer          The ExePack utilities which compress the program
                           quite a great deal

Aaron Povolish             The ever-important beta testers, who have made
Adrian Posor               sure that this program is bug-free

The TI-GCC Team            For the TI-GCC compiler, which is used for a
                           large portion of this program

 _____________________________________ VERSION HISTORY

Sizes listed here are for the uncompressed TI-92 Plus version of the program.

Version  Date       C     Asm   Bytes  Description

  0.03a   5-Aug-02  1057  1471  11757  first version

  0.25b  25-Aug-05  1208  1489  12843  now compatible with TI-89 Titanium
                                       level files packed
                                       level size variable
                                       added new brick types
                                       optimized various things

  0.27b  20-Aug-11  1298  1489  12985  added checks for invalid level data
                                       added vertical lightning
                                       can exit when dead with ESC
                                                                            
 ______________________________________ THE FUTURE

In the future I hope this game will be finished.  It is a lot to hope for,
but it might be possible.
