QMouse V2.02

Written by Dan Babcock

-- This program REQUIRES Kickstart 2.0 or higher. --

I missed one program more than any other when I switched to
Kickstart 2.0: QMouse, the venerable mouse-utility. I tried every
other program of its type that I could find, but every utility I
tried had bugs/quirks, lacked important features, and worst of
all was HUGE. Discouraged (and annoyed), I decided to write my
own. QMouse 2.0 (this program) is a completely new program, not
an update to QMouse, but I couldn't think of a more fitting name;
after all, my intent was to make a utility "like QMouse" - why
not call it QMouse!? I hope this doesn't lead to too much
confusion. On to the all-important feature list...

FEATURES:

* Automatic window activation after Amiga-M and Amiga-N: the
previously active window will be made active. VERY useful!!! Does
not poke screen structure like the original QMouse did (bad :-)).

* Optional top-line blanking for 2320/3000 owners who wish to
mask the "half line flicker" effect. Does not blank the border,
just the top line.

* System-friendly mouse blanking. Uses only the documented
function SetPointer. Does not interfere with other sprites (e.g.
JRComm's cursor).

* Mouse acceleration/threshold

* "PopCLI" feature. The CLI (actually any program may be
executed) will have a sensible current directory, stack, and
path.

* Click-to-front and click-to-back. New for V2.02: Click-to-Back
will intelligently decide whether to perform a Window-To-Back or
Screen-To-Back operation.

* SunMouse (activates window under mouse pointer). Personally I
don't care for this feature, but if you like it, it's here. (And
in this version, it actually works. :-)).

* Screen blanking. No special effects; use another program for
that stuff.

* Option to completely disable DisplayBeep (some programs overuse
it and it gets VERY annoying!)

* Option to remap a few Northgate keys.

* Starts own background process (no need to RUN).

* Written in assembly (efficient). Not a commodity.

* Fully public domain. Source code included.

* ONLY 3K !!!!!!!!!!!


-----------------
Using QMouse V2.0
-----------------

To see the parameter template type "Qmouse ?". Most likely it
looks like gibberish to you, though, so I'll explain the options:

(Please note: If you don't specify an option, the option is OFF.
The default set of options is therefore all OFF).

MBLANK (abbreviated M):

This specifies the number of seconds of mouse inactivity 	
before the mouse pointer is blanked. The mouse pointer is also
blanked whenever you hit a key.

Examples: m=3, mblank=9, M 10

SBLANK (abbreviated S):

Screen blanking - works same as mouse blanking basically.

NOFLICKER (abbreviated N):

This option will blank the top line of the display. (Only useful
to 2320/3000 owners). This function inspects the system copper
list, so it probably won't work in future Kickstarts.

CMD:

Specifies the command to execute when the user hits left-Amiga-
ESCape. Default is "newcli". Use like this: CMD="newcli
con:0/0/640/400". Important!!! The current directory, stack, and
path of the newly created CLI will be that of the CLI where
QMouse was originally executed. Therefore, place QMouse in your
startup-sequence *after* STACK and PATH commands!!

ACCELERATION (abbreviated A):

Specifies mouse speed-up factor.

Examples: acceleration 3, a=4, a 9

THRESHOLD (abbreviated T):

Specifies a threshold (minimum movement) required to applyacceleration factor. The default is zero. Example: T=1.

CLICKTOBACK (abbreviated CTB):

Specifying "ctb" or "clicktoback" will enable a feature whereby
both mouse buttons being pressed simulatenously will send the
window under the mouse pointer to the back.

CLICKTOFRONT (abbreviated CTF):

This option specifies the number of mouse clicks required to
bring the window under the mouse pointer to the front. Example:
ctf=2.

SUNMOUSE:

Specifying "sunmouse" turns on the "Sun Mouse" feature. I don't
recommend you use it because it's annoying and causes problems
with some programs. (Unless you happen to like it :-)).

NOBEEP:

Completely disables DisplayBeep (the routine that flashes the
screen).

NORTHGATE:

For Northgate keyboard users only: remaps a couple keys. (Page Up
-> Shift-Cursor-Up, etc). Sorry, if you want to change it you'll
have to edit the source and reassemble.

QUIT:

Completely de-installs QMouse. (Why would anyone want to do
that??!!). It may fail to quit if some other utility has taken
over the same library vectors.

----------
The Author
----------

If you want to contact me for some reason, please send email to
d6b@ecl.psu.edu.