       Title: TI-Bullet Time
     Version: 1.0a
 Platform(s): TI-89, TI-92+, V200
      Author: Greg Dietsche
    Web Site: http://gforce.calc.org/
      E-Mail: gforce@calc.org
Release Date: 07/13/2002
	Size: 1061

_______________________________________________________________________________________________
				DESCRIPTION
Your name isn't Neo?
TI-Bullet Time is a simple program which slows down other programs for those of us blessed
with slow (read normal) reflexes. The calculator will be slowed down from 100% speed to 
approximately 45% of normal speed when patched programs are run!

_______________________________________________________________________________________________
				HOW TO USE
Send neo to the calculator.
type neo("program to patch") and press ENTER.
run the patched program.
The program should run at ~45% of normal speed. (62 clock cycles are wasted
between every user mode instruction)

To removed the patch, simply run neo a second time.

WARNING: This patch has not been tested on any DoorsOS games.
_______________________________________________________________________________________________
				THINGS TO KNOW

Neo will only run on calculators with AMS 2.xx installed. I have tested on AMS 2.05; HW1 and 
HW2 calculators.

TI-Bullet Time may not work on every program in existence. The reasons are very technical, but
it would be safe to say that some compromises had to be made. Option one was to slow down all
programs and possibly cause a few crashes. Option two is what you see here. It slows down most
games without causing crashes, and in the case of ppg (compressed) programs, the decompression
routine is not hindered by TI-Bullet Time.

Essentially, TI-Bullet Time should work on many different games. It may not work on programs
that are designed to do other things... like math... *cough* using a calc for math!?

TI-Bullet Time will prevent the patched program from returning a value to the home
screen like a function. This should not be a problem because I am not aware of
any games that do this.

This patch has not been tested on any DoorsOS games. It is very likely that this program will
cause DoorsOS programs to crash because DoorsOS and other Kernels expect the very beginning
of DoorsOS programs to contain special launcher code.

Disclamer: For any given program, TI-Bullet Time may cause instability and/or crashes.
The only way to find out if TI-Bullet Time works on a specific program is to try it.
If one wishes to have extra insurance against crashes, I recommend a program called KerNO
which was written by myself.
_______________________________________________________________________________________________
			ANOMOLIES, BUGS and MISC OTHER

ERRORS:
	"Low RAM or Archived Var"
		*This means that there is not enough free ram for TI-Bullet Time to install itself
			on a program.

		*Alternatively, the program which you are trying to patch may be
			archived; unarchive the program and try again.

	"Var Length Must Be Odd"
		TI-Bullet Time can only install itself on programs which show an odd length in the
		var-link screen.
	
	"Bad Var Type"
		TI-Bullet Time can only install itself on programs which have an ASM extension in the
		var-link. To use TI-Bullet Time on ppg (compressed) programs, install TI-Bullet Time on
		the ppg launcher.

	"Bad Var Name"
		TI-Bullet Time could not find the specified variable. Because the variable does not exist,
		nothing could be done :)

BUGS:
	*None are known at this point in time.
_______________________________________________________________________________________________
					CONTACT ME
gforce@calc.org
If you have any suggestions or bug reports please email me (I don't bite)
if you don't understand this (documentation) please ask me I will try to
help you out as best as I can. You may also want to visit my web page at 
first though... I may have posted something 
there that could help you!

_______________________________________________________________________________________________
				   LEGAL INFORMATION

The author makes no representations or warranties about the suitability
of the software, either express or implied. The author shall not be liable 
for any damages suffered as a result of using or distributing this software.

This software is shareware. If you use it, please sign my guestbook located at my
website. Thanks :)
_______________________________________________________________________________________________
					CREDITS
MastaZog for the cool name :)  (in early beta tests it was called TI-Turtle)
The TIGCC Team
TI
Motorola for excellent 68k processor documentation
_______________________________________________________________________________________________
					PROGRAM HISTORY
Version 1.0a
	Released 07/13/2002
	Size: 1061 bytes
	Changes: Added code so games which use the TIGCC return value hack won't crash

Version 1.0
	Initial Release: 
	Released 06/14/2002
	-size is 1053 bytes
_______________________________________________________________________________________________
