-------------------------------------------------------------------------
ZBASLIB

Assembly Libary for TI-83 BASIC 
Programmers
Created by Nat Allan
nallan@hotkey.net.au
Version 1.0
-------------------------------------------------------------------------
 Intoduction
-------------------------------------------------------------------------

This ASM Libary was created for all those BASIC programmers out there that
wished for something more.  Don't you just wish you could access the FULL
TI-83 character map?  Perhaps you wanted to easily add sound to your
program?  Or mabey its a little file managment your after?

This libary answers that need.  Now you can access the full character
map, fiddle with the screen, get rid of that annoying run indicator
and turn off your calc mid-program!  All with this libary.

As a quick note, I would like to hear about any BASIC programs made using
this libary.  If youve made a program using this, contact me about it!

This libary is ASHELL and SOS compatiable.  It is also squished, so you
will need to have ZASMLOAD handy

-------------------------------------------------------------------------
 Features
-------------------------------------------------------------------------

  18 Powerful Routines
  
  Print any character from the character map 	- Text mode
  						- Graphics mode
  Print a text mode string in any mode
  Set Invers/Uninverse text in any mode
  Get and set the current contrast
  Set the run indicator on/off
  Protect/Unprotect programs
  Hide/Unhide programs
  Play sound
  Invert the screen
  Turn the calculator off (resumes your prog when turned back on)
  Fast detection of arrow keys supporting multiple directions (diagonals)
  Source code included
  
  
  Please email me at nallan@hotkey.net.au if you have any ideas for
  future routines you would like to see.
  
-------------------------------------------------------------------------
 Usage
-------------------------------------------------------------------------

To set up libary, send ZBASLIB.83P to you calculator.  Thats all.

If you make a program that uses this libary, you MUST always keep your
program with this libary.  You must send it to other calcs to make it
work, you must zip it with your program when you upload it to the
internet.

Actual usage of the libary is covered in the text file 'Developer.txt'
file

-------------------------------------------------------------------------
 Disclaimer
-------------------------------------------------------------------------

This program has been tested and found not to have any bugs.  This does
not mean that there will be no bugs.  This program is written in
assembly, so there is the ever-present possibility of it crashing your
program.

I take no responsibility for any possible or eventuated damage running
this program.  USE AT YOUR OWN RISK.

-------------------------------------------------------------------------
 Thanks
-------------------------------------------------------------------------

My only thanks goes to Andrew Leech, for releasing the source to his
sound program and letting anyone use the code.


-------------------------------------------------------------------------
 Source Code
-------------------------------------------------------------------------

The source code has been included in this ZIP.  You may study the code
and add new functions to it.  You MAY NOT distribute the modified source.
If you write a new function for it, please send the code to me and I
will include it in the next release.


-------------------------------------------------------------------------
 Future Versions
-------------------------------------------------------------------------

Future versions will include:
	
	Generic error handler
	Boundray checking (out of screen, ect)
	More optimized
	Move functions
	Memory check
	Displaying a string in graphics font

-------------------------------------------------------------------------
 Contact
-------------------------------------------------------------------------

Contact me at nallan@hotkey.net.au for any comments, praise, criticism
or especially suggestions.
