home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 424.lha / EasyMouse / easymouse.doc.english < prev    next >
Encoding:
Text File  |  1990-09-29  |  6.2 KB  |  105 lines
  1. EasyMouse V1.0 (c)1989 Oliver Enseling
  2. --------------------------------------
  3.  
  4.  Everybody that works on the Amiga with the Workbench and all the windows
  5. on it gets slightly irritated about the circumstantial procedures and
  6. acrobatic movements that have to be performed with the mouse to arrange
  7. the windows in a suitable way. Besides that the handling of inputs from
  8. that keypad could be designed a bit more elegant. To do so EasyMouse was
  9. created.
  10.  Though already there ecxists already a bunch of similar programs I decided
  11. to write my one of my own that exactly fits my needs.
  12.  EasyMouse can be started from Workbench or via "RUN EasyMouse" from the
  13. CLI. I recommend that EasyMouse is being started in the startup-sequence.
  14. After it is started EasyMouse opens a window on the Workbench screen
  15. showing the time and the memory available in system. Besides this window
  16. has a pull-down menu which is explained later on.
  17.  First let me shortly elucidate what exactly EasyMouse does. After the
  18. Window is set up EasyMouse installes an input handler. The input handler
  19. is a routine, that checks all the input events from the mouse and the
  20. keypad and calls routines that do certain things according to those
  21. input events. For example all the normal window operations like dragging
  22. them around or pushing them to the back etc. are performed by the standard
  23. intuition input handler. Now, EasyMouse installs its own handler that gets
  24. executed before the intuition one. This handler performs the following
  25. operations: - accelerating the mouse
  26.             - activating windows automatically
  27.             - pushing windows to the back or pulling them to the front
  28.               by simple mouse clicks
  29.             - turning off the screen display after a certain time span
  30.             - turning of the mouse pointer
  31.             - simplify the input of qualified keycodes
  32. All these operations work permanently i.e. when they are turned on they are
  33. applied on every input event until they are turned off.
  34.  Let me now depict the above mentioned menu of the EasyMouse window.
  35. It consists of two menu columns. The first one entitled "Actions" has all
  36. the actions in it. It serves as a help menu to show all the actions
  37. EasyMouse can perform and how they can be invoked. Besides every menu item
  38. a keycode can be found that performes the respective action. You have to press
  39. the given key and the Shift-Alt. Some of the actions
  40. may be invoked directly from the menu, too, while others are only listed.
  41. Below the menu items and their meanings are listed:
  42.  
  43. Screen display off : The screen is turned off immediately.
  44. Screen to back     : The front screen is pushed behind all other screens.
  45. Window to back     : The front window is pushed behind all other windows.
  46. Window small       : The window below the mouse pointer is reduced to its
  47.                      minimum size, if it is a sizeable window.
  48. Window big         : The winfdow below the mouse pointer is brought to it
  49.                      maximum size.
  50. Window to left     : The window below the mouse pointer is drawn to the left
  51.                      border of the screen.
  52. Window to right    : The window below the mouse pointer is drawn to the right
  53.                      border of the screen.
  54. Window to top      : The window below the mouse pointer is drawn to the top
  55.                      border of the screen.
  56. Window to bottom   : The window below the mouse pointer is drawn to the bottom
  57.                      border of the screen.
  58. Activate window    : The window below the mouse pointer is being activated.
  59. Info               : An important note is shown in a submenu.
  60. Quit               : EasyMouse terminates.
  61.  
  62. The second menu column, named "Options" is designed to configure the
  63. EasyMouse input handler. You can turn certain features on or off and
  64. select certain values. Selected values and features turned on are marked
  65. by a checkmark. The following list explains the meaning of each menu item.
  66.  
  67. Auto-Activate      : With this menu item marked a window is automatically
  68.                      activated when the mouse pointer is moved above it.
  69. Click-To-Front     : You can determine if windows should be pulled to front
  70.                      by one or two clicks or if this options is turned off.
  71. Click-To-Back      : With thid option selected the window below the mouse
  72.                      is pushed beihnd all other windows, if the right mouse
  73.                      button is pressed while the left one is held down.
  74. EasyMouse to front : This option makes the EasyMouse display window come to
  75.                      the front if it is covered by another window.
  76. Low memory warning : Here you can put in at what amount of memory the display
  77.                      should turn red to inform about low memory.
  78. Display            : You can vary the output in the display window. You can
  79.                      select different informations being showed or not.
  80. Screen blanking    : You can select the time span after which the screen
  81.                      should be turned off if no user input is received or
  82.                      turn this option off.
  83. Mouse blanking     : You can select the time span after which the mouse
  84.                      pointer is turned off if no mouse movement takes place
  85.                      or turn this option off.
  86. Mouse-Acceleration : You can select a value for mouse acceleration. The values
  87.                      represent the acceleration factor.
  88. Acceleration-Treshold: You can determine the minimum of pixels the mouse must have
  89.                      been moved before it is getting accelerated. This lets
  90.                      you carefully adjust the mouse pointer with acceleration
  91.                      turned on.
  92. Qualifier-Collection: This option collects all the keypad qualifiers until
  93.                      a normal key is pressed. The collected qualifiers are
  94.                      attached to the key pressed. For example to type Shift-Alt-a
  95.                      you type Shift, release the key, type Alt, release the key
  96.                      and type 'a'.
  97. Save configuration : This option saves your current configuration to the file
  98.                      "S:EasyMouse.config". This file is automatically loaded
  99.                      when EasyMouse is started and the options are adjusted
  100.                      according to it. Thus you need not do thta by hand
  101.                      every time you invoke EasyMouse.
  102.  
  103. OE
  104.  
  105.