home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d6xx / d697 / qmouse.lha / QMouse / QMouse.doc < prev    next >
Text File  |  1992-07-13  |  7KB  |  210 lines
  1. QMouse V2.10
  2.  
  3. Written by Dan Babcock
  4.  
  5. -- This program REQUIRES Kickstart 2.0 or higher. --
  6.  
  7. I missed one program more than any other when I switched to
  8. Kickstart 2.0: QMouse, the venerable mouse-utility. I tried every
  9. other program of its type that I could find, but every utility I
  10. tried had quirks, lacked important features, and worst of all was
  11. HUGE. Discouraged (and annoyed), I decided to write my own.
  12. QMouse 2.0 (this program) is a completely new program, not an
  13. update to QMouse, but I couldn't think of a more fitting name;
  14. after all, my intent was to make a utility "like QMouse" - why
  15. not call it QMouse!? I hope this doesn't lead to too much
  16. confusion. On to the all-important feature list...
  17.  
  18. FEATURES:
  19.  
  20. * Automatic window activation after Amiga-M and Amiga-N: the
  21. previously active window will be made active. VERY useful!!! Does
  22. not poke screen structure like the original QMouse did (bad :-)).
  23.  
  24. * Optional top-line blanking for 2320/3000 owners who wish to
  25. mask the "half line flicker" effect. Does not blank the border,
  26. just the top line.
  27.  
  28. * System-friendly mouse blanking. Uses only the documented
  29. function SetPointer. Does not interfere with other sprites (e.g.
  30. JRComm's cursor).
  31.  
  32. * Mouse acceleration/threshold
  33.  
  34. * "PopCLI" feature. The CLI (actually any program may be
  35. executed) will have a sensible current directory, stack, and
  36. path.
  37.  
  38. * Click-to-front and click-to-back. New for V2.02: Click-to-Back
  39. will intelligently decide whether to perform a Window-To-Back or
  40. Screen-To-Back operation.
  41.  
  42. * SunMouse (activates window under mouse pointer). Personally I
  43. don't care for this feature, but if you like it, it's here.
  44.  
  45. * Screen blanking. No special effects; use another program for
  46. that stuff.
  47.  
  48. * NoClick - turn off drive clicking for any combination of
  49. drives.
  50.  
  51. * Can turn on the shell's *=#? feature (like "WildStar" etc.)
  52.  
  53. * Option to completely disable DisplayBeep (some programs overuse
  54. it and it gets VERY annoying!)
  55.  
  56. * Option to remap a few Northgate keys.
  57.  
  58. * Starts own background process (no need to RUN).
  59.  
  60. * Written in assembly (efficient). Not a commodity.
  61.  
  62. * Fully public domain. Source code included.
  63.  
  64. * ONLY 3K !!!!!!!!!!!
  65.  
  66.  
  67. -------
  68. Changes
  69. -------
  70.  
  71. V2.02 -> V2.10 adds a couple simple options (e.g. noclick and
  72. wildstar), and some internal changes permit left-amiga-cursor
  73. mouse movements to work with mouse blanking enabled.
  74.  
  75. -----------------
  76. Using QMouse V2.0
  77. -----------------
  78.  
  79. To see the parameter template type "Qmouse ?". Most likely it
  80. looks like gibberish to you, though, so I'll explain the options:
  81.  
  82. (Please note: If you don't specify an option, the option is OFF.
  83. The default set of options is therefore all OFF, except for some
  84. basic features that don't have an option).
  85.  
  86. MBLANK (abbreviated M):
  87.  
  88. This specifies the number of seconds of mouse inactivity     
  89. before the mouse pointer is blanked. The mouse pointer is also
  90. blanked whenever you hit a key.
  91.  
  92. Examples: m=3, mblank=9, M 10
  93.  
  94. SBLANK (abbreviated S):
  95.  
  96. Screen blanking - works same as mouse blanking basically.
  97.  
  98. NOFLICKER (abbreviated N):
  99.  
  100. This option will blank the top line of the display. (Only useful
  101. to 2320/3000 owners). This function inspects the system copper
  102. list, so it probably won't work in future Kickstarts.
  103.  
  104. CMD:
  105.  
  106. Specifies the command to execute when the user hits left-Amiga-
  107. ESCape. Default is "newcli". Use like this: CMD="newcli
  108. con:0/0/640/400". Important!!! The current directory, stack, and
  109. path of the newly created CLI will be that of the CLI where
  110. QMouse was originally executed. Therefore, place QMouse in your
  111. startup-sequence *after* STACK and PATH commands!!
  112.  
  113. ACCELERATION (abbreviated A):
  114.  
  115. Specifies mouse speed-up factor. QMouse uses the same
  116. acceleration/threshold algorithm as DMouse, by the way (I got
  117. used to the feel).
  118.  
  119. Examples: acceleration 3, a=4, a 9
  120.  
  121. THRESHOLD (abbreviated T):
  122.  
  123. Specifies a threshold (minimum movement) required to apply
  124. acceleration factor. The default is zero. Example: T=1.
  125.  
  126. CLICKTOBACK (abbreviated CTB):
  127.  
  128. Specifying "ctb" or "clicktoback" will enable a feature whereby
  129. both mouse buttons being pressed simultaneously will send the
  130. window under the mouse pointer to the back, OR, if the mouse is
  131. not over a window, or if the window is a backdrop window, or if
  132. the window is the only non-backdrop window on its screen, then a
  133. screen-to-back operation will be performed instead.
  134.  
  135. CLICKTOFRONT (abbreviated CTF):
  136.  
  137. This option specifies the number of mouse clicks required to
  138. bring the window under the mouse pointer to the front. Example:
  139. ctf=2.
  140.  
  141. SUNMOUSE:
  142.  
  143. Specifying "sunmouse" turns on the "Sun Mouse" feature. I don't
  144. recommend you use it because it's annoying and causes problems
  145. with some programs. (Unless you happen to like it :-)).
  146.  
  147. NOBEEP:
  148.  
  149. Completely disables DisplayBeep (the routine that flashes the
  150. screen).
  151.  
  152. NORTHGATE:
  153.  
  154. For Northgate keyboard users only: remaps a couple keys. (Page Up
  155. -> Shift-Cursor-Up, etc). Sorry, if you want to change it you'll
  156. have to edit the source and reassemble.
  157.  
  158. NOCLICK:
  159.  
  160. Turns off drive clicking option in trackdisk, just like many 2.0-
  161. only 'noclick' programs. The argument to this option is a decimal
  162. number whose (4-bit) binary equivalent corresponds to what drives
  163. should receive the noclick treatment. For example, the number 3
  164. is "0011" in binary, and means drives 0 and 1 (but not 2 and 3)
  165. should be NoClick'ed. To turn off clicking on all drives, specify
  166. NOCLICK=15. Note: This is a toggle.
  167.  
  168. VERIFY:
  169.  
  170. Toggles the floppy disk verify feature of Hackdisk (my
  171. trackdisk.device replacement). If you aren't using Hackdisk this
  172. option is useless. (Actually it's probably useless even if you
  173. ARE using Hackdisk since verify should always be on :-)).
  174.  
  175. STAR:
  176.  
  177. Toggles the *=#? shell feature, similar to programs called
  178. "WildStar" etc.
  179.  
  180. QUIT:
  181.  
  182. Completely de-installs QMouse. Note that executing QMouse when
  183. already installed will cause a QUIT to happen first. Due to
  184. extensive SetFunction-ing of the OS, this is considered unsafe.
  185. So please, use only for initial testing (i.e. deciding what
  186. features of QMouse you like and which you don't, etc). Once
  187. you're happy, put QMouse in your startup-sequence and don't mess
  188. with it.
  189.  
  190. ----
  191. Bugs
  192. ----
  193.  
  194. So far (since the first release of QMouse2) I have received one
  195. bug report (I think -- if I've forgotten some others email me). A
  196. user reported that using the screen blanking caused system clock
  197. problems. One possible explaination is that the crude method of
  198. screen blanking (turning off display DMA) might be excluding
  199. virtical blanking interrupts. I haven't been motivated enough to
  200. investigate (I don't use screen blanking. :-))
  201.  
  202. ----------
  203. The Author
  204. ----------
  205.  
  206. If you want to contact me for some reason, please send email to
  207. Dan_E_Babcock@cup.portal.com. I'm on Portal now! (beats the pants
  208. off Bix and the rest)
  209.  
  210.