  Program      : joy2key

  Version      : 1.0

  Source       : joy2key.asm

  Copyright    : Michael Rans

  Purpose      : Terminate and Stay Resident Program to convert joystick
                 movements to simulated keyboard key presses. I have
                 mapped the movements to the arrow keys. It does not put
                 keystrokes into the keyboard buffer, but rather programs
                 programs the keyboard directly through ports 60h and 64h.

  Platform     : I have tested it in DOS 7.00 (Win 95 DOS) and from
                 within a DOS shell in Windows 95. My computer here
                 is a 486 DX33. The joystick is plugged into the game
                 port of a Gravis Ultrasound card.
                 When I get back to university, I will test this
                 program on a Pentium 100Mhz with the game port of a
                 Soundblaster AWE 32.
                 The program was assembled with Tasm as a ".com"
                 program.

                 tasm joy2key
                 tlink /3 /t /n /x joy2key

  Quake        : My 486 only runs Quake in DOS (just about). The program
                 works fine in this circumstance. It should work in a
                 Windows 95 DOS shell, but until I get back to
                 university, I won't be able to test this. Please tell
                 me under what circumstances you get it to work.

  Problems     : This program may be hardware specific. I have only
                 tested it on my machine. Use it at your own risk.
                 I designed it for Quake. Quake allows you to map the
                 joystick buttons even after disabling the joystick.
                 For some reason, you can bind buttons and keys, but not
                 joystick (or mouse) movements, hence why I wrote this
                 program. This is why I haven't assigned the joystick
                 buttons to keys. If I receive a number of requests for
                 this, I may code it. Additionally, the keys joystick
                 movements are mapped to are set (the arrow keys), not
                 configurable.
                 The program will not unload itself, but other public
                 domain programs will unload it, so I didn't bother
                 to code this feature.
                 If you screw up the calibration, by moving the joystick
                 incorrectly, you may have to reset since the program may
                 output to the keyboard buffer when the joystick is
                 centred. Just follow the instructions.

  Price:         This program is freeware. (Hooray, I hear you shout.)
                 All I ask is that if you like it, drop me an e-mail
                 saying so.
                 If you have any problems or want to suggest
                 improvements, you can e-mail me on
                 harold.rans@virgin.net
                 Please put "joy2key" in the subject. Feel free to alter it
                 to your own requirements. If you make an improvement, please
                 send me a copy. If you find a bug, tell me, but I can't
                 promise that I will be able to fix it.

