home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 522.lha / PWKeys_v1.0 / SetPWKeys.Doc.pp / SetPWKeys.Doc
Text File  |  1991-06-10  |  7KB  |  215 lines
  1.  
  2.                              //
  3.                          \\ // SetPWKeys V1.0
  4.                           \//
  5.  
  6.                                1991
  7.                                 by
  8.                           Preben Nielsen
  9.  
  10.  
  11. Note: Below I will talk of both SetPWKeys (off course) AND PWKeys. You
  12.       should also take a look at the PWKeys documentation (maybe first).
  13.  
  14.  
  15. WHAT IS SETPWKEYS ?
  16.  
  17.     SetPWKeys is an program that lets you define key-function bindings
  18.   for use with the PWKeys program. So if you don't use PWKeys then you
  19.   won't have any use for SetPWKeys.
  20.  
  21.  
  22. HOW TO START SETPWKEYS
  23.  
  24.     From CLI      : Type 'SetPWKeys' and press RETURN.
  25.                     There is NO need to use 'RUN', 'RUNBACK', 'ARUN' etc.
  26.                     SetPWKeys is auto-detaching when run from CLI (It
  27.                     won't prevent you from closing the CLI-window)
  28.  
  29.     From Workbench: Double-click on the SetPWKeys icon.
  30.  
  31.                     To use other key-bindings than the default do this:
  32.  
  33.  
  34. WHAT CAN SETPWKEYS DO ??
  35.  
  36.     PWKeys lets you perform 17 functions on windows/screens.
  37.   These functions are:
  38.  
  39.   Window-to-top
  40.   Window-to-bottom
  41.   Window-to-left
  42.   Window-to-right
  43.   Window-to-left-top
  44.   Window-to-left-bottom
  45.   Window-to-right-top
  46.   Window-to-right-bottom
  47.   Window-to-center
  48.   Window-to-front
  49.   Window-to-back
  50.   Activate-previous-window
  51.   Activate-next-window
  52.   Back-window-to-front
  53.   Front-window-to-back
  54.   Back-screen-to-front
  55.   Front-screen-to-back
  56.  
  57.   By default PWKeys binds the functions to following key-combinations:
  58.  
  59.  LAMIGA-KP1        : Window-to-left-bottom \
  60.  LAMIGA-KP2        : Window-to-bottom       \
  61.  LAMIGA-KP3        : Window-to-right-bottom  \
  62.  LAMIGA-KP4        : Window-to-left           \ Take a look at the
  63.  LAMIGA-KP5        : Window-to-center          >numeric keyboard to
  64.  LAMIGA-KP6        : Window-to-right          / why I chose these
  65.  LAMIGA-KP7        : Window-to-left-top      /
  66.  LAMIGA-KP8        : Window-to-top          /
  67.  LAMIGA-KP9        : Window-to-right       /
  68.  
  69.  LAMIGA-LEFTARROW    : Activate-previous-window
  70.  LAMIGE-RIGHTARROW    : Activate-next-window
  71.  
  72.  LAMIGA-UPARROW        : Window-to-back
  73.  LAMIGA-DOWNARROW    : Window-to-front
  74.  
  75.  LSHIFT-LAMIGA-UPARROW    : Front-window-to-back
  76.  LSHIFT-LAMIGA-DOWNARROW: Back-window-to-front
  77.  
  78.  RAMIGA-UPARROW        : Front-screen-to-back
  79.  RAMIGA-DOWNARROW    : Back-screen-to-front
  80.  
  81.  where
  82.  
  83.  LAMIGA     means the left Amiga key
  84.  RAMIGA     means the right Amiga key
  85.  LSHIFT     means the left shift key
  86.  KP1        means '1' on the numeric keyboard
  87.  KP2        means '2' on the numeric keyboard
  88.  KP3        means '3' on the numeric keyboard
  89.  KP4        means '4' on the numeric keyboard
  90.  KP5        means '5' on the numeric keyboard
  91.  KP6        means '6' on the numeric keyboard
  92.  KP7        means '7' on the numeric keyboard
  93.  KP8        means '8' on the numeric keyboard
  94.  KP9        means '9' on the numeric keyboard
  95.  UPARROW    means arrow-up key
  96.  DOWNARROW  means arrow-down key
  97.  RIGHTARROW means arrow-right key
  98.  LEFTARROW  means arrow-left key
  99.  
  100.  
  101.     To use other key-function bindings than the default bindings above,
  102.   you can use SetPWKey.
  103.  
  104.  
  105. SOME TERM EXPLANATIONS
  106.  
  107.     From now on, the term 'qualifier-key' will mean any one of these:
  108.  
  109.      the CTRL-key
  110.      the CAPSLOCK-key
  111.      the left  SHIFT-key
  112.      the right SHIFT-key
  113.      the left  ALT-key
  114.      the right ALT-key
  115.      the left  AMIGA-key
  116.      the right AMIGA-key
  117.  
  118.     The term 'qualifiers' will mean any combination of qualifier-keys.
  119.  
  120.     The term 'action-key' will mean a key that will trigger some action
  121.     (This could also be a qualifier-key).
  122.  
  123.     The term 'hotkey' will mean a combinations zero or more qualifier-keys
  124.     together with ONE action-key.
  125.  
  126.     LMB will mean the left mouse button.
  127.  
  128.     RMB will mean the right mouse button.
  129.  
  130.  
  131. HOW TO MAKE KEY-FUNCTION ASSOCIATIONS
  132.  
  133.     When SetPWKeys is started it will display a single-bitplane screen.
  134.   This screen contains:
  135.  
  136.   1.  In the upper left part of the screen is the names of the
  137.       17 functions.
  138.  
  139.   2.  At the bottom of the screen is a picture of the entire keyboard.
  140.  
  141.   3.  In the upper right part of the screen is 8 gadgets, which will
  142.       be described shortly.
  143.  
  144.   4.  An area at the top of the screen used for displaying messages
  145.       to the user (You).
  146.  
  147. THE FUNCTIONS
  148.  
  149.     To modify the key bindings of any of the 17 functions, simply click
  150.   the mouse on the name of the function. The function is now hilited
  151.   and the keyboard at the bottom of the screen will display the current
  152.   hotkey. When a function that is not hilited appear unreadable it means
  153.   that the function is undefined (i.e. has no hotkey yet).
  154.  
  155.  
  156. THE KEYBOARD
  157.  
  158.     When you have selected one of the 17 functions, the keyboard will
  159.   display the current hotkey. The selected qualifier-keys will appear
  160.   ghosted (like the title-bar on inactive windows under kickstart 1.0-1.3),
  161.   and the selected action-key will appear hilited.
  162.  
  163.     To select a qualifier-key just click the RMB on it. To clear it simply
  164.   click the RMB on it again.
  165.  
  166.     To select an action-key just click the LMB on it. To clear it simply
  167.   click the LMB on it again. A qualifier-key can also be used as an
  168.   action-key. It is possible to define a hotkey such as LALT-LSHIFT-RALT
  169.   (i.e. if you hold down the LALT and the LSHIFT, then pressing the RALT
  170.    would trigger some action)
  171.  
  172.  
  173. THE GADGETS
  174.  
  175.     The screen contains 8 gadgets:
  176.  
  177.     »  The 'Quit' gadget which ends SetPWKeys
  178.  
  179.     »  The 'Check' gadget which will check if there are any duplicates
  180.        amongst the hotkeys and tell you the result (but it won't show
  181.        you which). 'Use' and 'Save' will automatically use the facility
  182.        and fail if it finds any duplicates.
  183.  
  184.     »  The 'Use' gadget which will copy the hotkeys PWKeys handler (iff
  185.        the handler has been installed)
  186.  
  187.     »  The 'Undo' gadget which will undo any modifications you have made
  188.        on the keyboard since you clicked on the current function.
  189.  
  190.     »  The 'Clear' gadget which will undefine the current function by
  191.        wiping the keyboard clean (this can be recoved using 'Undo'). If
  192.        there is any undefined functions when you select 'Save' or 'Use',
  193.        these functions will be disabled (i.e. they accessed through PWKeys).
  194.  
  195.     »  The 'Save' gadget which will save the hotkeys to a file (the file
  196.        can then be used by PWKeys)
  197.  
  198.     »  The 'Load' gadget which will load hotkeys from a file (iff the
  199.        file has been created by SetPWKeys)
  200.  
  201.  
  202. CREDITS:
  203.  
  204.     Davide P. Cervone for his wKeys from Fisk-disk 128.
  205.  
  206. =====================================================================
  207.    Send bug-reports, suggestions, comments etc. to:
  208.  
  209.         ///
  210.        ///  Preben Nielsen
  211.  \\\  ///  Oehlenschlægersgade 72 st. T.V.
  212.   \\\///  1663 Copenhagen V.
  213.    \///  Denmark
  214.  
  215.