home *** CD-ROM | disk | FTP | other *** search
/ 17 Bit Software 3: The Continuation / 17-Bit_The_Continuation_Disc.iso / c / joymouse.doc < prev    next >
Text File  |  1994-01-27  |  2KB  |  43 lines
  1. joymouse v40.2
  2. (c) Copyright 1993 Commodore-Amiga, Inc.  All Rights Reserved
  3. Usage: joymouse [XMOVE=n YMOVE=n DELAY=nframes ACCEL CREATEKEYS] OR [OFF]
  4. Defaults: XMOVE=4 YMOVE=4 DELAY=1 and no CREATEKEYS or ACCEL
  5. Re CREATEKEYS see lowlevel.doc SystemControl() and libraries/lowlevel.h
  6. For CD32 game controller mouse emulation. Requires lowlevel.library
  7.  
  8. Joymouse uses lowlevel.library to read the CD32 port1 game controller
  9. and convert directions and the lower right/left (red/blue) buttons into
  10. mouse input events for CD32 titles which absolutely require the game
  11. controller to emulate the Amiga mouse for Intuition.
  12.  
  13. The additional CREATEKEYS keyword tells joymouse to turn on the
  14. SCON_AddCreateKeys feature of lowlevel.library SystemControl().
  15. When CREATEKEYS is used, you will also receive RAWKEY events
  16. for all gamecontroller buttons.  Note that you will even receive
  17. RAWKEY events for the directions and buttons which have been
  18. converted to mouse events.  This means that if you ask for MOUSEBUTTON
  19. or MOUSEMOVE events you will see both those AND the created RAWKEY
  20. events for those actions.  You could ignore either (just remember
  21. to ReplyMsg them).  See libraries/lowlevel.h for the port1 RAWKEY
  22. values you will receive.
  23.  
  24. The ACCEL option adds mouse acceleration.  This should not be
  25. used in drawing programs, and probably shouldn't be used in programs
  26. for young children, since it makes the pointer harder to control.
  27. But it can be good for titles with widely spaced things to click
  28. on.  For a HIRES LACE screen, try XMOVE=6 YMOVE=6 ACCEL [CREATEKEYS].
  29.  
  30. If joymouse is required, it should be used only if running under V40+,
  31. and only in startup-sequence (since if user started you from an icon,
  32. they would have a real mouse).  Although if the user has a real game
  33. controller you may want to use joymouse even if started from an icon.
  34. If your application exits, be sure to do JOYMOUSE OFF.
  35.  
  36. Will return RETURN_FAIL if lowlevel.library is not available.
  37. Will return RETURN_WARN if joymouse is already running.
  38.  
  39. standard usage:
  40.  
  41. failat 21
  42. run >NIL: joymouse
  43.