home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 441.lha / dmouse_v1.24 / dmouse.doc < prev    next >
Text File  |  1990-11-13  |  11KB  |  306 lines
  1.  
  2. V1.24               DMOUSE.DOC           11 October1990
  3.  
  4.               Matthew Dillon
  5.               891 Regal Rd
  6.               Berkeley, California 94708
  7.               USA
  8.  
  9.     DMouse (c)Copyright 1989 by Matthew Dillon, All Rights Reserved
  10.  
  11.     Refer to BLANKER.DOC and DMOUSE-IPC.DOC for information on external
  12. screen blankers.
  13.  
  14.     NOTES:    * dres.library no longer required.
  15.         * IPC mechanism changed
  16.  
  17.     WORKBENCH USERS:    PLEASE READ THE REVISION HISTORY FOR V1.09 FOR
  18. PARTIAL SOLUTION TO INTUITION WINDOWTOFRONT() BUG.
  19.  
  20.     YAIH (Yet Another Input Handler)... nahh, like DMouse better...
  21. for "Dillon's Mouse"???  V1.20 and beyond are no longer in public domain,
  22. but copyright to me.  They are still 'freeware'.
  23.  
  24.     After looking at and rejecting several mouse-intuition input
  25. handler enhancers (you know, accelerate the mouse, click-to-front, etc...)
  26. and finding them all useless, I have written my own.
  27.  
  28.     - Any option can be turned on or off at any time.
  29.  
  30.     - Screen blanks if keyboard or mouse is idle > N1 secs (default 300)
  31.         (mouse also blanks even if mouse blanking not turned on) One
  32.         can install a more sophisticated screen blanker (e.g. one that
  33.         brings up a pattern or something) if they wish.
  34.  
  35.     - The Pesky Mouse blanks if mouse is idle > N2 secs (def 5)
  36.  
  37.     - Auto Activate a window when the mouse is moved over it.  Window
  38.       also activated (if not already active) when you type.  These
  39.       two features may be turned on/off independantly
  40.  
  41.     - Mouse Accelerator.  Back feeds power into the mouse unit;
  42.       give it a nudge and it is guarenteed to penetrate up to an
  43.       inch and a half of wall plaster (programmable depth).  Once
  44.       you start using it, you won't be able to switch back!
  45.  
  46.     - Programmable command-key and command string ala PopCli, default
  47.       left-Amiga ESC.
  48.  
  49.     - Left Mouse Button click in window brings it to the front
  50.         DOES NOT BRING THE WINDOW TO THE FRONT IF IT IS ALREADY
  51.         IN THE FRONT.  Other programs would call WindowToFront() on
  52.         every click, which is horrible if you have a simple-refresh
  53.         window.  WindowToFront() is NOT called for backdrop windows!
  54.  
  55.         The qualifier along with the LMB is now settable with the -l option.
  56.  
  57.       # clicks required is settable.
  58.  
  59.     - Hold LMB, click Right Mouse Button .. Window to Back!  Great
  60.       for cycling windows.    See next feature for more info.
  61.  
  62.       (the qualifier, normally the left mouse button, can be set with
  63.        the -R option).
  64.  
  65.     - Same sequence as above, but if there is no window under the
  66.       current mouse position, there is only one window on the screen,
  67.       or the window under the mouse is a BACKDROP window, the
  68.       sequence cycles through Screens!
  69.  
  70.     - NO DAMN CLOCK.  Use another utility to get a clock.  No other
  71.       glossy thrills.  DMouse is short, sweet, and functional.
  72.  
  73.     - Does not use a CLI, should be placed in your startup-sequence.
  74.       DO NOT 'RUN' DMOUSE!
  75.  
  76. INSTALLATION:
  77.  
  78.     Place dmouse-handler in L: (or in the 'current' directory when DMOUSE
  79.     is run).
  80.  
  81.     WORKBENCH 1.3 USERS!!!!!!!!!!   There appears to be a bug in
  82.     intuition's WindowToFront() call, which can lock up intuition when
  83.     workbench icons are active.  Under the defaults, this will occur
  84.     whenever you depress the left mouse button over an icon.
  85.  
  86.     A partial fix is in place V1.07 and beyond.  However, if you find
  87.     it still freezing up, the problem can be avoided as follows:  Either
  88.     turn off the left-mouse-button window- to-front feature (-L0) or leave
  89.     it on and set the number of clicks required to 2 (-c2) (and don't use
  90.     the feature while your mouse is over an icon).  V1.09 gives you yet
  91.     a THIRD option which is even more preferable ... change the qualifier
  92.     that goes along with the left mouse button to something other than 0,
  93.     like 3 (either shift). -l3
  94.  
  95.     BLANKER:    To use a third party blanker simply run it.  You might want
  96.     to disable DMouse's blanker in this case.
  97.  
  98.  
  99. EXECUTE FROM A CLI (e.g. WORKBENCH STARTUP SCRIPT), example:
  100.  
  101.     1> dmouse -c2 -l0 -C c:newshell "<nil: >nil: newcon:320/120/320/80/Shell"
  102.  
  103.     There is no need to 'RUN' DMouse.  A double set of quotes may be
  104.     required for the program to work properly with ConMan.
  105.  
  106.     NOTE:   The shell startup script should immediately CD somewhere.  DMouse
  107.         does not remember the cli's path.
  108.  
  109. TO KILL:
  110.  
  111.     1> dmouse QUIT
  112.  
  113. IPC SUPPORT:
  114.  
  115.     IPC support has changed radically due to removal of dres.library from
  116.     the required list.    The reason for the change is that I have been getting
  117.     my programs to compile under both Lattice and Aztec and did not want to
  118.     port dres.library to Lattice C.
  119.  
  120.     Please refer to the example blanker programs and dmouse-ipc.doc for
  121.     more information.  This might not exist in all releases due to limited
  122.     time on my part.
  123.  
  124. SOURCE:
  125.  
  126.     Source will compile under DICE, my C compiler.  Current cost for the
  127.     registered version is $40 (this may change without notice and is better
  128.     described in the freeware distribution of DICE)
  129.  
  130.  
  131. COMMAND LINE ARGUMENTS:
  132.  
  133.     If DMouse is already running, any specified options will be
  134.     incorporated.
  135.  
  136.     quit    QUIT .. remove DMouse
  137.     -h        HELP
  138.     -a#     Set acceleration to #.    Default 3,         1 disables option
  139.     -t#     Set mouse acceleration threshhold, pixs/ev. default 0.
  140.     -s#     Set screen timeout to # (secs), Default 300, 0 disables option
  141.     -m#     Set mouse timeout to # (secs), Defalut 5,    0 disabled option
  142.     -c#     Set # of clicks required to bring window to front (def 1)
  143.     -p#     Set input handler priority (def 51) should always be > 50
  144.         (initial invocation only)
  145.  
  146.     -f#     Allow window-to-front/back even if window has no
  147.         front/back gadget (default).  -f0 will disallow
  148.         window-to-front/back on windows which do not have
  149.         a front/back gadget.
  150.  
  151.     -w#     0 = use UpFrontLayer() etc... 1 = use WindowToFront() etc...
  152.         WindowToFront() properly refreshes SIMPLE_REFRESH windows
  153.         but a bug intuition can cause it to crash the machine if
  154.         a workbench icon is active at the time.
  155.  
  156.         Default is 0 for pre-2.0 OS's, 1 for 2.0 and beyond.
  157.  
  158.     -L0/1    Disable/Enable left-button brings window to front
  159.     -A0-3    Disable/Enable AUTO-ACTIVATE. Bit #0 = mouse auto-activate
  160.                           #1 = keyboard auto-activate
  161.             (default 3, which enables both)
  162.  
  163.     -lqqqq    Set Qualifier (HEX) with LMB for Window To Front (default is
  164.          0, meaning no qualifier).  Example:    -l0003 sets it to
  165.          either shift key.
  166.  
  167.     -Rqqqq    Set Qualifier (HEX) with RMB for Window To Back (default is
  168.          the LMB qualifier).  Setting the qualifier to 0 disables
  169.          the feature.
  170.  
  171.     -Kcccc    Set Keycode (HEX)   for command key (default 0045)
  172.  
  173.     -Qqqqq    Set Qualifier (HEX) for command key (default 0040)
  174.  
  175.     -C CMD    Set Command to run.  Default is NEWCLI.  Remaining arguments
  176.         on command line is the command.
  177.  
  178.     -S/-M    REMOVED.  Obsoleted by new IPC mechanism.
  179.  
  180.             QUALIFIERS (always entered in HEX)
  181.  
  182.     0001    Left Shift
  183.     0002    Right Shift
  184.     0004    Caps Lock
  185.     0008    Control
  186.     0010    Left Alt
  187.     0020    Right Alt
  188.     0040    Left Amiga Key
  189.     0080    Right Amiga Key
  190.     0100    Numeric Key Pad Key (not useful for dmouse)
  191.     0200    Repeat        (not useful for dmouse)
  192.     0400    Interrupt        (not useful for dmouse)
  193.     0800    Multibroadcast    (not useful for dmouse)
  194.     1000    Middle Mouse Button (not normally implemented by intuition)
  195.     2000    Right Mouse Button
  196.     4000    Left Mouse Button
  197.  
  198.     Note:    Combinations are allowed, in which case any one of the
  199.         selected qualifiers along with the left, right mouse button
  200.         or command key will cause the appropriate action to occur.
  201.  
  202.  
  203. RELEASE HISTORY:
  204.  
  205. V1.24
  206.     -Partial fix of mouse-streaking problem (not harmful) when mouse
  207.      is blanked it sometimes streaks instead of blanks due to DMA being
  208.      turned off at just the wrong time.
  209.  
  210. V1.22
  211.     -Fixed (I hope) mouse pointer blanking, should work under 1.3 and 2.0
  212.  
  213. V1.21
  214.     -Added -f option
  215.  
  216. V1.20
  217.     -3rd party IPC mechanism fixed.  A new mechanism is now in place.
  218.  
  219. V1.16
  220.     -Code fixed to compile under either Manx C 3.6 or Lattice C 5.02
  221.     -3rd party screen blanker supported removed due to removal of
  222.      dnet.library (which is too difficult to port at this time).
  223.  
  224. V1.14
  225.     -minor bug fixes.  DLineArt added to distribution (removed again in
  226.      1.16 temporarily)
  227.  
  228. V1.13
  229.     -d option (debug mode if compiled in) not compiled in on release
  230.        binaries
  231.     -You can now bring up a new cli without having to move the mouse from
  232.      its initial (power up) position.
  233.     -Checks if the copper list stuff it modifies is valid.  If not, does
  234.      not modify the copper list stuff (you loose mouse blanking instead of
  235.      crashing the machine for those using the hires board)
  236.  
  237.  
  238. V1.12
  239.     -S option added, external screen blanker supported.
  240.     -M option added, external mouse blanker supported.
  241.     -IPC commands changed to 'mouse on/off' 'screen on/off', they used
  242.      to be 'mouse / nomouse' and 'blank / noblank'.
  243.  
  244. V1.11
  245.     -Intelligent requester handling: auto-activate is disabled while the
  246.      active window has a requester in it.  Slight modification of key
  247.      handling (key-up events are ignored by DMouse).  Addition of
  248.      text-based IPC to blank/unblank the mouse/screen.
  249.  
  250. V1.10
  251.     -Fixed -A bug ... -A2 now enables auto-activate-on-key and disables
  252.      auto-activate-on-mouse
  253.  
  254. V1.09
  255.  
  256.     Workbench users probably want to use the following options: -w1 -l0003
  257.     These use WindowToFront() (your windows get refreshed properly), but
  258.     also requires you to depress a shift key + LMB to get the window-to-front
  259.     feature.
  260.  
  261.     dmouse -w1 -l0003
  262.  
  263.     -SELECTABLE USE OF UpFrontLayer() etc..  OR  WindowToFront() etc...
  264.      Workbench users should use WindowToFront() (-w1), while CLI users
  265.      probably want to use UpFrontLayer() (default).
  266.  
  267.      Reason:    WindowToFront()/Back can crash the Amiga if called while
  268.      a workbench ICON is highlighted.  Unfortunetly, UpFrontLayer(), which
  269.      does not have the bug, also does not automatically refresh
  270.      simple-refresh windows!
  271.  
  272.     -New option -lqqqq (SET QUALIFIER WITH LEFT MOUSE BUTTON TO GET
  273.      WINDOW-TO-FRONT FEATURE).    WORKBENCH USERS NOTE:  By setting this
  274.      qualifier to a shift key, for instance, you can safely move icons
  275.      around without crashing the machine because DMouse will not issue
  276.      the WindowToFront() call unless you are holding the qualifier key
  277.      down while pressing the left mouse button.
  278.  
  279.     -Bug fixed thanks to user persistance!  If you disable mouse blanking,
  280.      and enable screen blanking (which blanks the mouse too when it
  281.      happens), hitting a key would bring back the screen but not the mouse.
  282.  
  283. V1.08
  284.      Botched.
  285.  
  286. V1.07
  287.     -All intuition calls are made from an independant process rather than
  288.      the input handler routine.  This also fixes a couple of deadlock bugs,
  289.      but not the workbench-icon deadlock bug.
  290.     -Mouse response is no longer jerky when the system is loaded down.
  291.     -Keyboard-Auto-Activate-Window independant of Mouse-Auto-Activate-Window
  292.      (enhanced -A option)
  293.     -No need to OR the -Q qualifier with 8000 anymore
  294.     -WindowToFront() never called for backdrop windows, which ought to fix
  295.      the workbench freeze bug and other problems.
  296.     -Mouse automatically blanked when screen blanks, whether mouse blanking
  297.      is enabled or not.
  298.     -Can set input handler priority (initial invocation only).
  299.     -New Timeouts go into effect immediately rather than after the
  300.      next mouse/keyboard event.
  301.  
  302. V1.00-V1.06
  303.     Before Written history
  304.  
  305.  
  306.