FPiano version 1.0B - My 1st Fargo Program
 (c) 1997 Matt House
--------------------

	Welcome to FPiano v1.0B.  This is my first Fargo program, and
it was written while I was learning A68K, so the code may be very bad,
but it still works.  This is a version of a keyboard for the TI-92 which
includes graphics, multiple key press ability and SOUND!  The program
checks for repeated key presses and can actually make noises that resemble
chords when multiple keys are pressed down.  The sound isn't very smooth,
but it was the best that I could get.

	Feel free to use anything that you see in my code and learn from
it if you can.  I tried to document everything that was being done
well enough.  This program can be copied freely so long as it is in the
original version.  Apart from that, have fun and go ahead and rip the code
to shreds.

	For all of you out there that don't have sound and are afraid to
chop your link cable and then ruin a pair of headphones READ THIS!  All
that you have to do is go to your local Radio Shack and buy a 1/8" stereo
to 3/32" stereo converter and put it on a good pair of headphones.  Take
this and stick it into the TI-92's link port (not so far that it locks
up temporarily) and keep moving it around and trying to make sound.
Eventually you will get it, and it becomes easier with practice.  It
definitely is worth $3.00 or so.

Control
--------------------
	The keys are labeled on the screen and change color when pressed
(i.e. black on white text to white on black text, etc.)  The bottom and
middle rows of the qwerty keypad are used for the keys and the ESC key is
used to quit.  The program is pretty much self explanatory.

Future Versions
--------------------
Maybe I'll add in the other octaves later, but who knows for now?


Libraries Required
--------------------
Flib, Romlib and Linelib

Bugs
--------------------
	None known except for a few unavoidable ones.  Because of the
TI-92's internal wiring, if four corners in the keyboard matrix are held
down the TI-92 will think that you are also holding down the fourth
(i.e. you can be holding down only three keys on the piano, but the
TI-92 will think that four are held down)  This usually doesn't matter,
but just try holding down some different keys and watch what happens.
	Another problem is that sometimes keys will jump on and sound
by themselves.  It only lasts a moment, but it can get annoying.  I don't
know how to fix this, but if you look at IOView, it does the same thing.
The program can get very interesting if you hold down the keys that are at
the top of the major keyboard matrix.  Just hold down either diamond,
shift or both and watch and listen.
	The last known problem is with the sound.  I made it as smooth as
I possibly could, but it still isn't exactly right.  I think that the
problem is in the delay between making the sound, reading the keyboard,
and then making the sound again.  The sounds are also sequential when you
hold down multiple keys, so that one sound will be made and then another.
It blends together fairly well with the duration set at 12(d).  Higher
values were too distinct and lower values did not sound right.
	Overall, though, the program is yet to crash my calc, so I consider
this to be something at least.

Version History
--------------------
	0.001a		Lines were drawn for the outline of the keys
	0.001b		Keyboard looked right
	0.10		All text and graphics done
	0.20		Keypresses detected and the labels changed color
	0.50		Z and S keys made sound
			(although not the right tones)
	1.00b		All graphics and sound finished
			(first public release)

Thanks
--------------------
David Ellsworth		-Keep up the great work! Looking forward to v2.0.0
Markus Klisics &	-I learned everything that I know about sound
Tim Gerla		 on the TI-92 from you guys!
Jimmy Mårdell		-For Linelib, Guide for Fargo Programmers,
			 FCamera, Tetris... Shall I go on?
All other Fargo		-We're few and far between, but maybe more will
Programmers		 see the light...


That's all that I can think of for now, so enjoy it, look at the code,
and feel free to copy it. I don't have an E-mail address because I'm
not on the internet at home, so don't even worry about contacting me.

THIS SOFTWARE COMES WITH NO WARRANTY, EXPRESSED OR IMPLIED.. blah blah