JOYTEST   

			 Copyright © 1992 Michael McCallum



   Ed: This program is CLI-only, so to run it, open a Shell or CLI and enter:

   cd df1:programs/joytest
   run joytest

   (this assumes that this disk is in the external drive, df1:)



   <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<< 29 >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>


INFORMATION

   What more can I say?  The name says it all!  But just in case, here's what
  it does: displays the current status of the joystick directions and buttons
  in order that you may verify that your joystick actually works.  Yep, I
  said buttons in the plural.  The Amiga joystick ports are capable of
  reading up to three buttons in addition to the usual four directions.  The
  only games that I know of that use a second joystick button are Star Ray
  and Z-Out.


STARTING THE PROGRAM

   This program is a CLI-only program, but if there is enough interest I will
  make an Intuition version capable of being run from WorkBench, complete
  with a little joystick that moves as you move yours!

   When started, the program will display something like this:

       ^
       |
    <-- -->
       |
       v    (*) (*) (*)

  but it will be displayed in black.

   The arrows are obvious, and the buttons are 1 (normal), 2 and three from
  the left (those funny (*) things).

   When the joystick in port 2 is moved, or its buttons are pressed, the
  appropriate bit on the little diagram will light up orange.  Releasing the
  joystick and its buttons will return the appropriate bit black again.


QUITTING THE PROGRAM

   To quit the program, press the left mouse button.


FOOTNOTE ON JOYSTICKS

   Although many Amiga joysticks physically have more than one button, they
  are almost always wired to the same port line.  I have a Star Cursor
  joystick (100% Aussie made with a three year guarantee, and mine has lasted
  5 years of severe game-playing, bashing, and bad tempers at dodgy collision
  detection!) and modified it to have three separate buttons.  In short, you
  can use this program to check for a real multiple-button joystick, or a
  fake multiple-button joystick (where they are wired to the same port line).
  If you want to know how to modify your fake multiple-button joystick into a
  real multiple-button joystick, then write to me or call me, and I'll let ya
  know!


COPYRIGHT

   This work is 100% my own blood, sweat and tears, and is copyright by me.
  However, I give one and all the rights to copy and distribute this work as
  long as:

	1.  It is unmodified
	2.  It has its documentation with it (this file).
	3.  Only a minimal fee, if any, be charged for media and time.

   Also, this work may NOT be used in any commercial product without the
  express permission of The Author (Michael McCallum).


FINAL WORDS

   While I don't ask that you send me loadsadosh for this great wizz-bang bit
  of contortery (is there such a word?) - I am a student, and won't say no to
  any contributions of money, disks, hardware, software, etc. that you nice
  people want to send to me!  (No bombs or such, please!)  If you have any
  contributions, comments, suggestions, or wicked jokes, send them to the
  address below!


ME

I can be contacted thus:

	Michael McCallum
	117 Morrison Rd
	Midland, Western Australia 6056

	or

	09-274-3390 (Australia)


Thank you, and enjoy!


   <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<< 29 >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>