Short:        Wheel Bus Mouse Driver Commodity
Author:       Henryk Richter
Uploader:     henryk richter gmx net
Type:         util/mouse
Version:      1.0
Architecture: m68k-amigaos

Introduction
------------

Wheel mouse support is not too common on the classic m68k Amiga platform.
I am aware of two existing approaches: NewMouse for serial mice and
PS2M for PS/2 to DB9 Amiga converters (aminet:hard/hack/ps2m.lha). The former
project included a proposal for intuition mouse wheel events that has been
semi-officially adopted by other parties, too. The latter project provided 
the wheel movement information over the second port (Joystick) from the 
adapter into the Amiga. 

The extended PS2M was accompanied by a driver utility called WBM 
(aminet:util/mouse/WheelBusMouse.lha) that was supposed to be started
from startup-sequence or user-startup.

UWMouse is an alternative driver that's implemented as a Commodity, such
it can be disabled or removed at any time by the Commodities Exchange
program (Sys:Tools/Commodities). It also contains Workbench startup
code so that it might be simply put into "Sys:WBStartup".


Installation
------------

Just copy UWMouse to SYS:WBStartup.

If you insist on starting the tool from Startup-Sequence or User-Startup,
then please note that it won't detach itself from the shell. Hence, put 
a "RUN" in front of the invocation.


Usage
-----

As of this writing, you need three components for Wheel Mouse operation:
- The hardware, which can either be PS2M with a compatible PS/2 mouse and 
  the adapter to the Joystick port -or- the upcoming UWMouse USB mouse 
  adapter hardware.
- A driver (this tool) and Amiga programs that actually support mouse 
  wheel inputs
- Since Amiga software with direct support for wheel mice is rare, the 
  FreeWheel utility should be installed to fill the gap on AmigaOS
  up to 3.9 or 3.1.4, respectively. (aminet:util/mouse/FreeWheel.lha)

The UWMouse commodity supports the following options (commandline or icon
tooltypes):

PRIORITY/K/N,QUIET/S,REVERSE/S,REVERSEX/S,REVERSEY/S

PRIORITY=0 - a number for the Commodity priority

QUIET      - suppress CLI output

REVERSE    - reverse both mouse wheel axes (X and Y)

REVERSEX   - reverse the horizontal wheel axis

REVERSEY   - reverse the vertical wheel axis


Version History
---------------

1.0 
  - initial Aminet release