*****************************************************************
Light' Out! v0.7
Author: Anthony Loven
Date: 4-17-05
Email: greenorange5656@gmail.com
*****************************************************************
     This program can be modified at will.  However, my name
(Anthony Loven) must be referenced in documentation, and I must
be listed as a co-author.  This file should not be removed
from the original program.

SOURCE CODE NOW INCLUDED!!!  Same license as the program.
---------------

Introduction:

     Something about the game... the first release was written all on the
calculator.  Yes, I wrote an ASM game all on calc.  How?  With time
and patience.  This was written with Clem Vasseur's on-calc Z80 ASM compiler,
and Clem and Jonah Cohen's on-calc AsmIDE.  This is a Lights Out game with
90 levels, mapped keys, and very fast gameplay.  Version 0.5 and above
_has_ level counting, like I said it would.  This means you gotta play to get
all 90 levels!

     Major addition:  I have added sound to the program.  It plays a little
sequence when you win, when you lose, as well as beeping when you make a
move and select levels.  To hear the sound, you will need headphones that
can fit in the link port.  I suggest heading to:

http://www.angelfire.com/amiga2/anthonyl/archives

Here, you will find out how to make your own 2.5mm to 3.5mm adapter so you
can listen to sounds.  Also, you can use an emulator like VTI to listen.

---------------

Installation:

     Included in the ZIP file is this file, screen*.gif (the screenshots),
and LightOut.86p.  Simple send the 86p file to the calc, and type

asm(LightOut

This will run the program.  A shell can also be used.  If you use one with
icon support (like IShell), notice the icon I made :)

---------------

Gameplay:

     This is a basic Lights Out game.  To start, choose a level with the right
or left arrow keys, and hit enter.  You should see a board with black boxex
filled in.  Now, this is the part of the game that may either annoy you, or
complex you.  The keys are mapped to the board like this:

+-----+-----+-----+-----+-----+
|     |     |     |     |     |
| log | sin | cos | tan |  ^  |
|     |     |     |     |     |
+-----+-----+-----+-----+-----+
|     |     |     |     |     |
| ln  | EE  |  (  |  )  |  /  |
|     |     |     |     |     |
+-----+-----+-----+-----+-----+
|     |     |     |     |     |
| x^2 |  7  |  8  |  9  |  x  |
|     |     |     |     |     |
+-----+-----+-----+-----+-----+
|     |     |     |     |     |
|  ,  |  4  |  5  |  6  |  -  |
|     |     |     |     |     |
+-----+-----+-----+-----+-----+
|     |     |     |     |     |
| sto>|  1  |  2  |  3  |  +  |
|     |     |     |     |     |
+-----+-----+-----+-----+-----+

If you notice, I made the calc keys 5x5 just like the board.  This will test
your hand-eye coordination like never before.  Also, for a little twist,
to actually "beat" a level, you need to make it in less than 25 moves.

The in game keys are:

More - return to title screen
Exit - quit to OS/Shell

---------------

History:

4-17-05  Version 0.7

 - Fourth public release
 - Added sound: After a win
		During game
		After a lose
		During level selection
 - Restructured key coding
 - Got rid of waiting getkey

?-??-05  Version 0.6

 - Attempt at sound
 - Attempt to restructure key coding
 - Attempt to remove all waiting getkey romcalls

2-23-05  Version 0.5

 - Third public release
 - Remembers your last level selection
 - Progressive game; you need to beat a level to unlock the next one

1-25-05  Version 0.4

 - Second public release
 - Compressed -> 2.1 kB

1-23-05  Version 0.3

 - First public release
 - 90 levels
 - Switched title screen to high-power mode
 - 2.5 Kb

1-1?-05  Version 0.1a

 - First working version
 - 30 levels

---------------

Future:

 - External levels?
 - Highscores?
 - Level editor?
 - Code smaller
 - Change graphics
---------------

Credits:

Anthony Loven - programming
ACZ - Assembly Studio 8x
Clem Vasseur - Z80 Assembly compiler (on-calc) and AsmIDE (on-calc)
Jonah Cohen - AsmIDE (on-calc), IShell (TSR REALLY HELPED) and the WRITEBACK procedure!!!
Aaron Curtis - YAS (Yet Another Shell)
Matthew Shepcar - wrote the original TSR
Morgan Davies - For helping me with variables for v0.5
Kirk Meyer - wrote Lite86 II, which saves you a lot of bytes!
Clint Rennie - Made level 4
Tiger Games - Lights Out handheld, and booklet which gave me MANY levels
ticalc.org, calcgames.org, and ti-news.net - Great sites

---------------

Have fun!  Email me bugs, and I will fix them! (90% chance I will!)
