

        ___________    ___    ___    __________
       /  ________/   /  /   /  /   /___   ___/
      /  /           /  /   /  /       /  /       GUI
     /  /           /  /   /  /       /  /        The ultimate graphic library
    /  /  _____    /  /   /  /       /  /         Version 0.1
   /  /  /_   /   /  /   /  /       /  /          By Geoff Lywood aka KrYpT
  /  /____/  /   /  /___/  /   ____/  /___        <glywood@yahoo.com>
 /__________/   /_________/   /__________/



Table Of Contents
-----------------
1. What is GUI?
2. Included Files
3. Installation
4. Thanks
5. Version Info
6. Known Issues
7. Legal Stuff
8. Contact Info



1. What is GUI?
---------------
GUI is a universal acronym for Graphic User Interface. This application
is meant to provide just such an interface, letting the user interact with
programs in an easily comprehendible graphic manner.

The GUI app runs on a variant of OOP (Object-Oriented Programming), making
it flexible and easy to program for. Simply put, it is a library of methods,
each of which provides for a commonly used function (displaying a window,
for example). The application is meant as an extension to the current
operating system, providing more functionality than ever before.

The GUI application is roughly divided into two parts. The first is just a
collection of common UI methods, for displaying windows, inputting text, etc.
The second part is a form handler. It draws forms, and polymorphically draws
all objects thereupon, as well as handling cursor activity.

GUI is for everyone! Whether you are a programmer and want to make your programs
look cooler, be more versatile, and have a smaller size, or you are the average
joe that just wants to play better games and fit more of them on your calculator,
GUI is for you.



2. Included Files
-----------------
There are an awful lot of files included with GUI, but which do you want?
Here's what they all are:
 Readme.txt		This file
 GUI.8xk		The app itself
 LibSpecs.htm		Contains all the specs for using the library.
 GUI.inc		The GUI Include File
 LoadGUI.asm		The GUI loader/initializer
 source\*.*		The source files


3. Installation
---------------
Installation can be completed in two easy steps.
 - Send the GUI.8xk file to the calculator. Use either TI Connect or your Graph Link
   software. With TI Connect, just right click the 8xk file, click "Send To", then
   "Connected TI Device". With the Graph Link, select the Link menu, then "Send Flash
   Software", then "Applications and Certificates".
 - Install the app on the calculator. Choose the application from the Apps menu. It
   should read "GUI Installed!" on the screen. You are now ready to go.

Note: The application creates an appvar. DO NOT ARCHIVE THE GUI APPVAR. It will cause
your programs to crash and the calculator to reset.

If you ever wish to uninstall GUI, just run the app. It will uninstall itself. Then
you may delete the app.

On rare occasions, particularly after deleting other apps, GUI will stop functioning.
Programs that use it will indicate that it is not installed, yet the appvar exists. This
is meant to prevent outright crashes (the appvar is indicating the wrong flash page). Just
run the app twice (uninstall then reinstall) and it should function properly again.


4. Thanks
---------
Uh, you should be thanking me, shouldn't you? :)
Really now...
 Brandon Sterner - for inspiration (and you didn't even know it)
 Dan Englender - for nextstr, more inspiration, calcsys
 "Evil Sam" - I don't even know who you really are... for the mouse movement in solytare
 Ahmed El-Helw - ditto
 Joe W. - just because
 Patrick Davidson - the Legal Stuff section
 TI - for the bcall code (then i improved it. mwahaha), and all the romcalls, and Wappsign
 ZiLOG + Squak Valley Software - for assemblers
 If I missed you, please let me know...



5. Version Info
---------------
v0.1 released 8/31/02
	No editor
	First working version
	9 form elements, 55 routines

v0.2 released 9/18/02
	Is an editor, but produces UNICODE (bad) output (must convert later)
	We found out the previous version didn't totally work
	9 form elements, 55 routines
	Fixed guiDrawSprite so it didn't uninstall the app.



6. Known Issues
---------------
 - When using the mouse, sometimes the select buttons (2nd, Enter) carry
   over and activate things after the program quits.



7. 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). Also
be aware that such problems may not actually be this software's fault, as
this software is intended to interact with other software which may be the
source of the problems.

This software is in the public domain, which means that it is not copyrighted
at all.  Thus you may use, copy, or modify it any way you want. However, such
modifications are not encouraged, as they leave open the potential to break
compatability. So instead of modifying it yourself, send an email my way, and
I might change it for you, possibly including your suggestion if I think it
is good enough and suits the goal of the software.



8. Contact Info
---------------
If you missed it up above, or just want to know more:

Geoff Lywood aka KrYpT
Email: glywood@yahoo.com
ICQ: 117312247
MSN: glywood@hotmail.com  (don't email this!)
