home *** CD-ROM | disk | FTP | other *** search
/ Magazyn Exec 5 / CD_Magazyn_EXEC_nr_5.iso / Recent / util / mouse / WheelBusMouse.lha / wbm.readme < prev   
Text File  |  2001-06-03  |  4KB  |  120 lines

  1. Short:    Bus Mouse wheel support
  2. Author:   rdc@cyberlan.mtu-net.ru
  3. Uploader: rdc@cyberlan.mtu-net.ru
  4. Type:     util/mouse
  5. Version:  1.4
  6.  
  7. At this moment (June 2001) there was only one software wheel mice
  8. driver on Ami - NewMouse.  This driver works only with serial mice,
  9. that have two serious disadvantages - them allocates serial port
  10. (useful for modem) and them have VERY SLOW update rate, with bad
  11. flickering of mouse pointer as result (typical 40fps for 2button and
  12. 25fps for 3button mice).
  13.  
  14. There are simple solution to adapt PC mice for Ami, as described in
  15. many documents - you can simply remove mouse chip and replace it with
  16. Schmitt-trigger, and mouse will be Amiga-like.  Unfortunately, this
  17. solution forced you to lose wheel and other mouse features... up to
  18. this moment. :)
  19.  
  20. Now you can add two Schmitt-trigger elements and connect wheel
  21. optopairs to joystick port pins 1 and 3.  Amiga has two similar pairs
  22. of mouse counters, and second pair will be used for mouse wheel.
  23. This driver reads second counter every vertical blank and generates
  24. NewMouse-standard input events.  It is fully NewMouse compatible, you
  25. can use it with any NewMouse aware applications like DirOpusMagellan.
  26.  
  27. If your mouse has two wheels, you can connect second wheel through
  28. another two Schmitt-trigger elements to joystick port pins 2 and 4.
  29.  
  30. If your mouse has only one wheel, but you want have horizontal
  31. scrolling, you can select qualifier for scrolling direction change.
  32. It may be any keyboard control key, and any button on joystick/mice
  33. ports.  You can even simultaneously use several qualifiers - for
  34. example, you can do horizontal scrolling by pressing any Shift key.
  35.  
  36. If you mouse has additional button(s), you can connect them to
  37. joystick fire(s).  Any of them (fire0 and fire1) can generate
  38. NewMouse-compatible fourth-button event.  Unfortunately, NewMouse
  39. standard does not describe fifth button - but you can use even two
  40. additional buttons: one as fourth and another for temporary X-Y
  41. scroll direction change.
  42.  
  43. If you don't want to modify mouse, you can solder my PS/2 controller
  44. (aminet:hard/hack/ps2m.lha) and use WBM with it.  This controller
  45. fully simulates quadrature wheel signals.  Or you even can connect
  46. second mouse and use it as a scroller :-)
  47.  
  48. Please don't ask me how to modify mouse, what is a Schmitt-trigger.
  49. If you don't know this, you anyway can't modify mouse.
  50.  
  51. Full C source code included.  Installation is very simple - add
  52. following string in you startup-sequence or user-startup:
  53.  
  54. c:wbm
  55.  
  56. If you want to remove copyright message:
  57.  
  58. c:wbm quiet
  59.  
  60. If you want to reverse wheel action:
  61.  
  62. c:wbm reverse
  63.  
  64. If you want to reverse only horizontal scrolling:
  65.  
  66. c:wbm rx
  67.  
  68. If you want any Shift for horizontal scrolling:
  69.  
  70. c:wbm lshift rshift
  71.  
  72. If you want that 4th/5th buttons work as system-wide 4th mouse button:
  73.  
  74. c:wbm lfb rfb
  75.  
  76. Additional parameter - priority (0 by default):
  77.  
  78. c:wbm priority=10
  79.  
  80. Priority will be important in cases when you have continuous working
  81. program (for example, archiver) with priority higher than WBM.  WBM
  82. priority is recommended to be higher than priority of any continuous
  83. task.
  84.  
  85. Of course, you can mix options in any way.  See "wbm ?"
  86. and history for full list of options in current version.
  87.  
  88. Driver may be terminated by break signal on WheelBusMouse process.
  89.  
  90.  
  91. History:
  92.  
  93.   History:
  94.  
  95. 1.4
  96. - my email was changed - now it is rdc@cyberlan.mtu-net.ru
  97. - added support of 4th button event
  98.   CLI options: LFOURTHBUTTON=LFB/S,RFOURTHBUTTON=RFB/S
  99.  
  100. 1.3 [absent - for version synchronize with ps2m]
  101.  
  102. 1.2
  103. - added two wheels support
  104. - added reverse of concrete wheel direction: RX and RY
  105. - added qualifiers for scrolling direction change as
  106.   CLI options: LMB/S,MMB/S,RMB/S,JOYFIRE0=JF0/S,JOYFIRE1=JF1/S,
  107.                JOYFIRE2=JF2/S,CTRL/S,LSHIFT=LSH/S,RSHIFT=RSH/S,
  108.                LALT/S,RALT/S,LCOMMAND=LCMD/S,RCOMMAND=RCMD/S
  109.  
  110. 1.1
  111. - you don't need c:run for wbm startup anymore
  112. - driver eats less CPU time (WaitTOF() instead of Delay())
  113. - added CLI options: REVERSE/S,PRIORITY/N,QUIET/S
  114.  
  115. 1.0
  116. - initial Aminet release
  117.  
  118.  
  119. Have fun!
  120.