********************** Millennium Advanced Programming **********************
-----------------------------------------------------------------------------

  High Score Library 83
  Version 1.0
  TI-83
  Adam Ziemba



2000 MAP Software

2000 Millennium Adcanced Programming


Contact Me:
	http://map.50megs.com
	mailto:ASony5@hotmail.com
	mailto:Samnmax200@aol.com
	AIM - ASony5
	AIM - Samnmax200


~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Contents
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

	Introduction
	Instructions
	Notice
	Acknowledgements


~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Introduction
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
	High Score Lib 83  is a very useful library  that you can use in your
programs. It enables you to store the initials of the player who had the high
score in one of your programs. The TI-83 does have strings, so you could just
store  the player's  initials into a string.  But, on the TI-83,  strings are
extremely common. Many other programs may destroy the string you're using for
the initials.
	With  High Score LIB,  you  can  use a  list to  store  the  player's
initials.  All you have  to do is just  store a couple numbers  into a couple
variables and then run the program. Read the next portion of this readme file
to get the full description on how to use the library.

Enjoy.


~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Instructions
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
	Before we move  on to  the instructions,  let me tell you  something.
I will be giving you example coding in the instructions. Please note that all
the ` characters  in the  examples should  be replaced with the  store symbol
when your typing  it in to your program on your calculator.  Also,  all the @
characters should be replaced with the theta character,  which you can access
be pressing ALPHA and then the 3 key on your calculator.
	Also,please note the fact that HSLIB will only function on the graph.
Or in other words, you can't make it display the initials on the home screen.
I hope to have this feature included in Version 1.3 of HSLIB.

1)	First,  find in your program's code  where you want the current  high
	score initials to be displayed. Notice that I said "in your program's
	code", and not on the graph or something.
2)	Once you have found it,  you will need to define  a couple variables.
	Here is a table of those variables and their proper values:
	+----------+-------------------------------------------------+
	| Variable |  Description                                    |
	+----------+-------------------------------------------------+
	    W      Store 0 into this variable. It has a purpose,   
	           which I will explain later.                     
	    V      The Y-coordinate of where you want HSLIB to     
	           display the initails.                           
	    X      The X-coordinate of where you want HSLIB to     
	           display the initials.                           
	+----------+-------------------------------------------------+
	After defining these variables, on the next line, execute HSLIB. Here
	is an example of what you should have so far:
		:coding...
		:coding...
		:1`W
		:0`V
		:30`X
		:prgm@HSLIB
		:coding...
		:coding...
3)	Now you have  made it so that the program will display the high score
	initials. (wait to test it until you've completed all the steps.) But
	what are you going to do when the player surpasses the old high score
	and wants to enter his initials? Well, you're going to need to define
	a couple variables,  and then execute HSLIB.  Here is a table of  the
	variables you need to define:
	+----------+-------------------------------------------------+
	| Variable |  Description                                    |
	+----------+-------------------------------------------------+
	    W      When this is 0, HSLIB will display the initials.
	           When it is 1, it will allow a user to store his 
	           initials. (Store 1 for this part)               
	    C      The Y-coordinate of where you want HSLIB to     
	           display "NEW HIGH SCORE!".                      
	    D      The X-coordinate of where you want HSLIB to     
	           display "NEW HIGH SCORE!".                      
	    E      The Y-coordinate of where you want HSLIB to     
	           display "ENTER YOUR INITIALS:".                 
	    F      The X-coordinate of where you want HSLIB to     
	           display "ENTER YOUR INITIALS:".                 
	    V      The Y-coordinate of where you want HSLIB to     
	           display the initails as they are entered.       
	    X      The X-coordinate of where you want HSLIB to     
	           display the initials as they are entered.       
	+----------+-------------------------------------------------+
4)	Here is an example of the coding you should have so far:
		:coding...
		:coding...
		:0`W
		:15`V
		:15`X
		:prgm@HSLIB
		:coding...
		:coding...
		:coding...
		:coding...
		:1`W              \
		:0`C               |
		:0`D               |     This should be  located in your code
		:7`E               |---- where you want HSLIB to wait for the
		:0`F               |     user to enter his/her initials.
		:13`V              |
		:3`X              /
		:prgm@HSLIB
	HSLIB will  store the initials into L3 (List 3).  The problem is that
	you won't  be able to use HSLIB  for more than one of your  programs,
	UNLESS you store List 3 into a different list. On the TI-83,  you can
	name  your own lists,  using the  little L symbol.  In the  following
	example,  I will use the ~ character to represent the little L.  Copy
	this code after running HSLIB the second time in your coding:
		L3`~ADAMZ
		ClrList L3
	If you'd like,  you can store the  list into a different  list called
	something  other than ADAMZ.  Yet I prefer ADAMZ. :-)  ClrList L3  is
	optional,  but preferred because List 3 has no purpose  in the memory
	if it has already been stored into a different list.  Also,  you will
	need to copy this code just before running HSLIB the first time:
		:For(Z,1,3
		:[B](1,Z)`L3(Z
		:End
5)	Here is an  example of what  the finished product  of a program using
	HSLIB should look like:
		:ClrDraw
		:0`S
		:Text(0,0,"THIS IS A PROGRAM BY ADAM Z.
		:Text(7,0,"SCORE: 0
		:Text(14,0,"HIGH SCORE:
		:Text(14,39,H
		:Text(14,47,"-
		:0`W
		:14`V
		:51`X
		:~ADAMZ`L3
		:prgm@HSLIB
		:ClrList L3
		:Text(28,0,"PRESS ENTER REPEATIVELY
		:Lbl G
		:Text(7,22,S
		:Getkey`G
		:If G=105:S+1`S
		:If S>H:Goto 1
		:Goto G
		:Lbl 1
		:S`H
		:ClrDraw
		:0`C
		:0`D
		:6`E
		:0`F
		:5`X
		:14`V
		:1`W
		:prgm@HSLIB
		:L3`~ADAMZ
		:ClrList L3
		:ClrDraw
	This is just some stupid  program I'm using for an example.  It waits
	for you to press the ENTER key.  If you've pressed it more times than
	the high score, than it will allow you to enter your own initials. If
	you would like to test it out on your own calculator,  before running
	the program,  store 10 into the H variable  and then type this on the
	home screen and then press ENTER (you'll only have to do this once):
		{65,41,73}`~ADAMZ
6)	Okiedookie! Your done!


~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Notice!!!
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
	At map.50megs.com  you can download  all the best  games and programs
by MAP Software? The URL is, well, www.map.50megs.com


~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Acknowledgements
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
	In all  the other  text files I've  made for  my programs,  this part
usually says a whole bunch  of stuff about thanking people and thanking other
people and  stuff like that,  but in this text file,  I've decided not  to do
that. I have no reason not to, Im just not.

- Adam Ziemba






  _____________
 |\ ___________\
 | |            |
 | |   _    _   |    ____      ____
 | |  | |  | |  |   /    \    |    \
 | |  | |  | |  |   |    |    |    |
 | |  | |  | |  |   |____|    |____/
 | |  | |  | |  |   |    |    |
  \|__|\|__|\|__|   |    |    |
    S   O   F   T   W   A   R   E

   Millennium Advanced Programming

Contact Us:
	http://www.map.50megs.com
	http://map.50megs.com
	mailto:ASony5@hotmail.com
	mailto:ShaggyKAR@hotmail.com
	mailto:BiteMe84@aol.com
	mailto:WarBirdx2g@aol.com
	mailto:Samnmax200@aol.com
	mailto:ShaggyKAR@aol.com
        mailto:WarBirdx2g@yahoo.com
	AIM - ASony5
	AIM - Samnmax200
	AIM - ShaggyKAR
	AIM - BiteMe84
	AIM - WarBirdx2g

