@DATABASE FreeMouse
@AUTHOR Alastair M. Robinson
@COPYRIGHT ©1999 - Alastair M. Robinson.

@NODE MAIN "FreeMouse V1.0  -  © 1998,1999 Alastair M. Robinson"

  @{b}A little tool to fine-tune your mouse@{ub}

  Copyright © 1998,1999  by  Alastair M. Robinson

Is your mouse too slow or too fast?

Have you tried a mouse-speeder, but found that the control isn't fine enough?

Are you sick of trawling through prefs directories to slow down the
mouse every time your kids use the computer?

Have you ever wished you could make your mouse @{B}just 20% faster?@{ub}

If this sounds like you, then you'll love FreeMouse!


FreeMouse provides continuous adjustment of mouse speed,
between 38% and 300%, via a hotkey-accessible GUI.


@{"Legal" link Legal}

@{"Features" link Features}

@{"Configuring" link Configuring}

@{"Credits" link Credits}

@ENDNODE


@NODE Legal "The obligatory legal mumbo-jumbo..."

THIS SOFTWARE IS PROVIDED AS IS, WITHOUT WARRANTY OF ANY KIND.  ALL USE IS
AT YOUR OWN RISK, AND THE AUTHOR CANNOT BE HELD RESPONSIBLE FOR DAMAGES OF ANY
KIND, ARISING FROM THE USE OR MISUSE OF THE PROGRAM OR ANY OF ITS ACCOMPANYING
FILES.

While this program is copyrighted, this is done merely to prevent others from
claiming it as their own work.  The name FreeMouse is intended to imply its
free status - you may pass the complete package on to whoever you wish, on
a non-profit basis.

Full source code is provided, in the hope that it will be of help and interest
to others.  You are encouraged to incorporate any of the source files into
your own projects, as long as you credit me.

FreeMouse may be placed on the Cover CDs of Amiga magazines, and any other
Amiga CDs which contain predominantly Shareware, Freeware or PD software.

@ENDNODE


@NODE Configuring "How to configure FreeMouse...."

FreeMouse is configured entirely through ToolTypes:

CX_POPKEY  -  the hotkey combination to bring up the GUI.  Default: ctrl-alt-f

CX_POPUP  -  set to YES if you want the GUI to appear when FreeMouse loads.

Speed  -  set to the desired mouse speed, in percent.

ClickToFront  -  set to YES if you want the ClickToFront mode switched on.

MMBShift  -  set to YES if you want the middle mouse button hack switched on.

The Speed, ClickToFront, and MMBShift settings can be changed at runtime via
a simple GadTools GUI which can be shown by pressing the HotKey combination.
You will have to change the tooltypes to change the settings permanently.

@ENDNODE


@NODE Features "Features...."

So what does FreeMouse actually do?

»   It provides fractional scaling of mouse movements.  The mouse speed can
    be adjusted continuously from 38% to 300%.

»   It provides my personally favoured Click-To-Front behaviour.  Double-click
    anywhere within the border of a window and it will jump to the front.

»   It provides the stereotypical middle mouse button shift function, with a
    slight twist - a click of the middle mouse button will mapped to a left-click
    with the shift key held down, so icons can be multi-selected with the middle
    button.

The latter two functions were included simply to reduce the number of hacks in
my WBStartup Drawer, and can be turned off easily.

@ENDNODE


@NODE Credits "Credits...."

FreeMouse was written during 1998 and 1999 by Alastair M. Robinson, mainly
for fun and to brush up on my C skills.

It was compiled with VBCC 0.6a, which is totally brilliant.  The provided
build script should work as long as both VBCC and the Native Developers Kit
includes (which can be obtained on the Amiga Developers CD) are installed.

I can be reached at the following address:

Alastair M. Robinson
 The Old Chapel,
  Syderstone,
   Kings Lynn,
    Norfolk,
     PE31 8SD,
      (England)

EMail: blackfive@fakenhamweb.co.uk

@ENDNODE

