MacJoypad V1.0 - 1995 by Francesco Doro (fdoro@gpnet.it)

  MacJoypad is similar to MacJoy (see MacJoy.doc) but it gives support to
the CD32 joypad and all his buttons.  It could be used also with joystick
but in this case you MUST set a tooltype 'JOYSTICK' or you will get
garbage; this tooltype is already in the icon, remove brackets to make it
effective.  When using joystick RED is the first fire button and BLUE the
second (if present).  If the JOYSTICK option is active but you use joypad
it works well but it will not handle all buttons of the joypad, only the
RED, BLUE and directions.  Anyway if you use joystick I RECOMMEND using
MacJoy instead of MacJoypad since MacJoy is more reliable and OS friendly
and takes less CPU time than MacJoypad (it also takes less CPU time than
using keyboard...).  You could use MacJoy also for joypad; in this case
FIRE1 is the red button, FIRE2 is the BLUE botton.  Use MacJoypad only if
you really need all those buttons.

  MacJoypad needs lowlevel.library (not included).  This library is part of
WorkBench 3.1.

  You can configure MacJoypad like MacJoy, using the tooltypes stored in
his icon.  Joypad's buttons have different colors and shapes; some have
special names:  FORWARD is that with the '>>', REVERSE is '<<' and PLAY is
'||>'.  The default configuration is:  directions to cursor keys, RED to
space, BLUE to right alt, GREEN to return, YELLOW to tab, FORWARD to
control, REVERSE to left shift, PLAY to m (like map...).  MacJoypad will
use this config if launched from shell or if it doesnt find tooltypes.  If
launched from shell it's better using 'run >nil:  ...'; if enough people
will ask for a shell interface I'll add it in a next release (only for
MacJoypad).

  MacJoypad is NOT a commodity, it will open a small window on workbench
screen; to remove it you have to close that window.  You can launch and
quit it at any time even during mac emulation.

IMPORTANT:
  MacJoypad is specific for the CD32 joypad, I think it can't work with
other joypads; please don't ask support for other joypads since I own only
the CD32's one.  In general joypads are not as simple to handle like
joysticks, you require docs and a joypad to experiment.
  I've heard rumours that some A1200 have a hardware problem with the CD32
joypad; in my tests I have not found any problem with 500, 1200 and 4000
but usually I'm very lucky with computers (much more than with girls :-).

Known bugs and problems:
  MacJoypad uses some features of lowlevel.library that cannot be shared
between applications, so if another program tries to use them when
MacJoypad is active it will probably fail.
  Lowlevel.library actually is far from perfection; according to autodocs
it should be able to detect what type of device is connected to the
gameport but in my tests this is not reliable:  it recognizes only mouse,
if it find a joystick or a joypad it returns unknown device.  For this
reason you have to tell MacJoypad if there is a joystick instead of joypad.
  MacJoypad requires kickstart 2.0 or better, otherwise it wont do nothing,
not even an error message (but it wont crash).

Copyright:
  MacJoypad is entirely work of mine so I can say it is 100% free and
Public Domain; do with it what you want but don't expect any guarantee from
me about his reliability or eventual damages it could produce.
  Anyway please report any problems or bugs you find and probably I will
fix them; include infos about your system and version of lowlevel.library;
my e-mail address is:  fdoro@gpnet.it.

Credits:
  Thanks to Michel Labbé for hint about lowlevel.library, for beta testing
and for having convinced me to do this small utility.