 _________           ___   
/\   ___  \         /\  \
\ \  \__\  \ urple  \ \  \  _____ aze 
 \ \   _____\        \ \  \/ __  \
  \ \  \____/         \ \   /_/\  \
   \ \__\              \ \__\ \ \__\
    \/__/Special Edition\/__/  \/__/
-----------<By: Adam Koch>-----------

>Backround Information
This program is much like the shell by Joe Wingbermuehle known as Ion, heh if you don't know what Ion is you should be smacked with a rubber chicken. This is an assembly language shell, both for TI-83+ and TI-83. I do not know if it will totally work for the TI-83 because well this was designed for the TI-83+ and I dont have a TI-83, so I couldn't test it. Programming for this shell is exactly like programming for Ion, because well, it uses the same include file (Ion.inc). The reason for this is because I wanted to make sure that different programs would not have to be made just to run for this particular shell. It makes programming for this much easier, and prevents anyone from having to make different files for different shells.

>Requirements
A TI-83+ (recommended), or TI-83 and a TI-Graph Link.
The TI-Graph Link is the cable that runs from your computer's com port to the calculator, to load the programs into the calculator from your computer. If you do not have one you can goto Best Buy and buy one. Or you can goto: www.ti.com/calc to buy one online.

>Installation
Send pse.8xg to your TI-83+ or send pse.83g to your TI-83.
If you do not know how to send programs to your calculator and you already have the TI-Graph Link. Then download the TI-Graph Link software from http://education.ti.com/product/accessory/link/down/download.html and then make sure that you have checked the proper port from which the cable is hooked to your calculator on. Then goto [Link:Send To:Ram] and find where you put the files double click on it then click [Ok]. Once its sent find the file prgmPSE and run it. Then prgmA will appear in your program list. Run it and then you are all set. Don't worry if the shell does not load when you run prgmA that's just because you have no programs in your Flash Rom or Ram. You can delete prgmPSE and prgmPSEZ after you install it, but if you wish to send the shell to another calculator then you have to keep it.
-Note: I recommend that you keep the group (pse.8xg) in your archive, that way if you ram gets deleted you can easily ungroup the files and you wont have to wait till you get home in order to reinstall the files.

>Keys
Run program:    [Y=] or [Enter]
Move Cursor:    [(up)] or [(down)]
Next/Prev List: [(left)] or [(right)]
Exit PSE:       [Quit] or [Clear]
Power Down:     [On]
-Note different keys may be used as long as you have the appropriate modules installed. I will cover the ones that came with the shell later.

>Files
These are the files included in the group file pse.8xg or pse.83g
-prgmPSE        The installer for Purple Haze SE
-prgmPSEZ       Data file for the installer
-prgmZMDEL      Module that deletes the files
-prgmZMCONT     Module that changes the screens contrast
-prgmZMINVER    Module that will change the inverse option
-prgmZMLCASE    Module that will activate/deactivate lowercase
-prgmZMBAT      Module that will check your battery status
-prgmZMABOUT    Module that will show you come info about PSE
-prgmZMALPHAN   Module that will arrange the names in alpha order
-prgmZMTURBO    Module that will turn on/off the turbo of PSE
-prgmZMVIRUS    Module that will protect your calc from teachers
*Note: The modules are not necessary for PSE to run, they just add some functionability. And well they are cool damn it. By the way all of the modules included in the group file are designed for PSE only. If they are tried to run on Ion, yes they will work but they wont look right (except for ZMVIRUS and ZMCONT)
*Note: The reason I did not include the source in this program yet, is because this program is not bug free yet and I dont it to release a program that will not teach someone. And besides that it's not fully documented.

>Module Keys
-ZMDEL          Press [Del] twice. Second time confirms
-ZMCONT         Press [+] to increase contrast
                Press [-] to decrease contrast
-ZMINVER        Press [Window] to activate inverse
                Press [Zoom] to deactivate inverse
-ZMLCASE        Press [] to activate lowercase
                Press [x] to deactivate lowercase
-ZMBAT          Press [Prgm] to test batteries
-ZMABOUT        Press [Math] to view information
-ZMTURBO        Press [2nd] to activate turbo
                Press [Alpha] to deavtivate turbo
-ZMVIRUS        Press [APPS] to activate lockdown. See NOTE
*Note: When you turn the calculator back on after activating the ZMVIRUS module it will display the "RAM Cleared" screen. But don't worry your screen is not cleared. Then the only way to go back to the GUI is to press [Trace] and [Graph] at the same time and it will go back to normal.

>Notes and Troubleshooting
-As usual please make sure that you read the entire file before you  e-mail me with a bug that you have found.
-TI-83+ and TI-83 files are not compatible, meaning that you can not    send either file to either calculator. TI-83+ files have the extention  *.8xp and TI-83 files have the extention *.83p. Make sure that you     send the appropriate file to the right calculator or else the program  wont work and could cause your calculator harm.
-When you first run prgmPSE it should come up and say "Purple Haze SE"  and them some other text. If it does not say this then this probally   means that you do not have enought free RAM.
-Although Purple Haze allows for programs to be located in Flash ROM or  RAM, I highly recommend that you keep the programs that you use most   often in RAM. This is because it takes time for PSE to load the        program in the RAM from ROM.
-In this version, external levels (for the most part) can be run if     they are located in Flash ROM, but most programs who use external      levels also save the high scores in those files. So if they are Flash  ROM they can not have a high score.
-All modules must be located in the RAM in order for them to work.
-If a program refuses to run that is located in the Flash then that     generally means that there is not enough memory to move the program    from the Flash ROM to the RAM. Free up some RAM and then try again.
-If you are EVER asked to do a Garbage Collect in PSE always select     "Yes", this is so your calculator can use the memory efficiently.
-If you have any other programs please email me at "FadeToAJ@aol.com"   and put as the subject "Trouble with PSE"
-By the way if you try to make a program that will start up PSE on its  own by using the command Asm(prgm0PSE) or Send(9prgm0PSE) it makes PSE  very unstable. I'm not sure why it does this but you can make a
 program that will only run PSE, but do not make it so after you exit   PSE it will return to the program execution (using the "Return" 
 command in TI-Basic). This has happened with my experiences using Ion.

>Bugs
I have yet to find any bugs with the program, but there is always the possibilty that I could have overlooked a bug (hey I'm not perfect). Before you report a bug to me make sure that you have read this file completely. If it is not covered in here then send me an email at FadeToAJ@aol.com and put as the subject "Bug Report", and as always the more information you can give me about the bug the better. If it is something minor it will be ignored.

>Disclaimer (This must be here)
This program is not likely to cause any harm to your calculator, but if something does happen (and I'm not saying it will) I nor anyone who is affiliated with this program can be held responsible for what happens. This program was tested hundreds of times and it has yet to fail. Besides, PSE is freeware, you download it at your own risk.

>History
Project started on February 1, 2001
Version Special Edition <> 3/18/01
	-First public release!
	-This is my first attempt at a shell. Let me know about some 	 feedback.

>Credits
I have to show some love to all of the people who have helped me create this program
	-Julie Cline <> She is my girlfriend (love you Babe) and she is 	 the one who named this program. Thanks babes :-).
	-Jason Kovaces <> He helped me with countless things, such as           making the top and bottom of the screen inverse. And also 	 me in created the module that will delete the files.
	-Dan Englender <> His modules for Ion gave me the ideas for 	 creating the modules for PSE.
	-Joe Wingbermuehle <> His original shell ion is the backbone 	 for this shell. It is much like his and even uses the same 	 include file.
	-You, for using this thing! :-)
	-And finally the countless number of people who have encouraged		 me to learn asm and got me into programming. You know who you		 are. :-)
	-If you helped me in creating this shell and I left you off of 	 here please let me know. :-)

Adam Koch - 3/18/01
FadeToAJ@aol.com


                         
 