
                             //
                         \\ // PWKeys V1.0
                          \//

                               1991
                                by
                          Preben Nielsen


WHAT IS PWKEYS ?

    PWKeys is an input-handler that allows you to move windows and
  screens by pressing keys on the keyboard (a lot faster than using
  the mouse).


HOW TO START PWKEYS

    From CLI      : Type 'PWKeys' and press RETURN.
                    There is NO need to use 'RUN', 'RUNBACK', 'ARUN' etc.
                    PWKeys terminates immediately leaving only the handler
                    in memory (only 1124 bytes).

                    To use other key-bindings than the default type:
                    'PWKeys filename' where 'filename' is the name of
                    a file created by the program SetPWKeys.

    From Workbench: Double-click on the PWKeys icon.

                    To use other key-bindings than the default you
                    can do two thing:

                    1.
                      a. Single-click on the PWKeys icon (its a Tool Icon)
                      b. Select 'Info' from the 'Project' menu
                      c. In the 'Tool Types' field write 'FILE=filename'
                         where 'filename' is the name of a file created
                         by the program SetPWKeys.

                    2.
                      a. Create a Project icon
                      b. Single-click on the the icon
                      c. Select 'Info' from the 'Project' menu
                      d. In the 'Tool Types' field write 'FILE=filename'
                         where 'filename' is the name of a file created
                         by the program SetPWKeys.
                      e. In the 'Default Tool' field write the pathname
                         of PWKeys program (e.g. 'SYS:utilties/PWKeys' if
                         PWKeys is in the utilities drawer on SYS:


HOW TO END PWKEYS

    To remove PWKeys simply
    1. double-click its icon again
     or
    2. type 'PWKeys' RETURN in a CLI.


WHAT CAN PWKEYS DO ??

    PWKeys lets you perform 17 functions on windows/screens.
  These functions are:

  Window-to-top		    : Moves the active window to the
			      top of the screen

  Window-to-bottom	    : Moves the active window to the
			      bottom of the screen

  Window-to-left	    : Moves the active window to the
			      left of the screen

  Window-to-right	    : Moves the active window to the
			      right of the screen

  Window-to-left-top	    : Moves the active window to the
			      upper left corner of the screen

  Window-to-left-bottom	    : Moves the active window to the
			      lower left corner of the screen

  Window-to-right-top	    : Moves the active window to the
			      upper right corner of the screen

  Window-to-right-bottom    : Moves the active window to the
			      lower left corner of the screen

  Window-to-center	    : Centers the active window on the
			      screen

  Window-to-front	    : Moves the active window in front
			      of all others on the screen

  Window-to-back	    : Moves the active window behind all
			      others on the screen

  Activate-previous-window  : Activates the window behind the
			      currently-active one.

  Activate-next-window	    : Activates the window above the
			      currently-active one.

  Back-window-to-front	    : Moves the back-most window to the
			      front and activates it

  Front-window-to-back	    : Moves the front-most window to the
			      back and activates the new front-most
			      window

  Back-screen-to-front	    : Moves the back-most screen to the
			      front and activates it's top-most window

  Front-screen-to-back	    : Moves the front-most screen to the
			      back and activates the top-most window on
			      the new front-most screen


  By default PWKeys binds the functions to following key-combinations:

 LAMIGA-KP1		: Window-to-left-bottom \
 LAMIGA-KP2		: Window-to-bottom       \
 LAMIGA-KP3		: Window-to-right-bottom  \
 LAMIGA-KP4		: Window-to-left           \ Take a look at the
 LAMIGA-KP5		: Window-to-center          >numeric keyboard to
 LAMIGA-KP6		: Window-to-right          / why I chose these
 LAMIGA-KP7		: Window-to-left-top      /
 LAMIGA-KP8		: Window-to-top          /
 LAMIGA-KP9		: Window-to-right       /

 LAMIGA-LEFTARROW	: Activate-previous-window
 LAMIGE-RIGHTARROW	: Activate-next-window

 LAMIGA-UPARROW		: Window-to-back
 LAMIGA-DOWNARROW	: Window-to-front

 LSHIFT-LAMIGA-UPARROW	: Front-window-to-back
 LSHIFT-LAMIGA-DOWNARROW: Back-window-to-front

 RAMIGA-UPARROW		: Front-screen-to-back
 RAMIGA-DOWNARROW	: Back-screen-to-front

 where

 LAMIGA     means the left Amiga key
 RAMIGA     means the right Amiga key
 LSHIFT     means the left shift key
 KP1        means '1' on the numeric keyboard
 KP2        means '2' on the numeric keyboard
 KP3        means '3' on the numeric keyboard
 KP4        means '4' on the numeric keyboard
 KP5        means '5' on the numeric keyboard
 KP6        means '6' on the numeric keyboard
 KP7        means '7' on the numeric keyboard
 KP8        means '8' on the numeric keyboard
 KP9        means '9' on the numeric keyboard
 UPARROW    means arrow-up key
 DOWNARROW  means arrow-down key
 RIGHTARROW means arrow-right key
 LEFTARROW  means arrow-left key


    To overwrite the default bindings above use the program SetPWKeys
  which will let you bind each of the 17 function to any key-combination
  you may prefer.


WHY WON'T IT SOMETIMES WORK ??

  1.  Intuition will not let you manipulate screens and windows in
      any way if the active window has an active gadget in it (especially
      stringgadgets), so in these cases PWKeys won't try to do anything.

  2.  PWKeys won't try to MOVE backdrop-windows


HOW DOES PWKEYS WORK ?

    PWKeys works by installing an input-handler at priority 51. This
  handler recieves every input-event before Intuition does. It then
  compares every raw-key event with the key-bindings you have made
  (using binary search) and executes the associated function if it
  finds a match.


FUTURE FEATURES:

 » The ability to minimize/maximize windows

 » The ability to bind a function to more than one key-definition. This
   would allow something like SHIFT-UPARROW (i.e. the ability to activate
   a function by pressing either LSHIFT-UPARROW or RSHIFT-UPARROW). It is
   actually not PWKeys fault that this is not currently possible. SetPWkeys
   is to blame for this.


CREDITS:

    Davide P. Cervone for his wKeys from Fisk-disk 128.

=====================================================================
   Send bug-reports, suggestions, comments etc. to:

        ///
       ///  Preben Nielsen
 \\\  ///  Oehlenschlægersgade 72 st. T.V.
  \\\///  1663 Copenhagen V.
   \///  Denmark

