home *** CD-ROM | disk | FTP | other *** search
/ Toolkit for DOOM / DOOMTOOL.ISO / misc / dms012b.txt < prev    next >
Text File  |  1994-08-21  |  5KB  |  119 lines
  1.  
  2. ================================================================
  3. Title                   : Doom Mouse Spinner (DMS) v0.12 beta
  4. Filename                : DMS.COM
  5. Authors                 : Tom Klok and Dave 'Zoid' Kirsch
  6. Email Address           : a344@mindlink.bc.ca
  7.  
  8. Description             : Ever had the problem of a monster or
  9.                           deathmatch opponent sneaking up behind
  10.                           you?  Ever needed to turn around *now*?
  11.                           With DMS, you can rotate your player
  12.                           180 degrees with a click of the mouse!
  13.  
  14. Release note            : This is a *BETA* release.  DMS has been
  15.                           tested with Logitech 3-button and
  16.                           Microsoft 2-button mice.  It should work
  17.                           with others without problems.  I don't
  18.                           know what it would do with a CyberMan.
  19.  
  20. Construction            : TASM 3.1, TLINK 5.1
  21.  
  22. ================================================================
  23.  
  24.  
  25. What it is
  26. ~~~~~~~~~~
  27.  
  28.      DMS is a tiny TSR (384 bytes resident) that intercepts Doom's
  29. calls to the mouse driver.  By clicking the mouse buttons that you
  30. define, it will instantly turn you 180 degrees -- facing the exact
  31. opposite direction.  Cranking up your mouse driver sensitivity can
  32. allow you to do the same, but then your accuracy may fall off.
  33. With this you don't have to make that compromise.
  34.  
  35.      It supports mouse "chords".  For example, if you have a 2-button
  36. mouse you can set it up to spin you only when you press the left and
  37. right mouse button at the same time.  3-button mice permit even more
  38. combinations.  I prefer the Middle+Right button chord on my Logitech.
  39.  
  40.  
  41. Does it work for Deathmatch?
  42. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  43.  
  44.      Sure, why not?  It shouldn't cause consistency failure.  Some
  45. might consider it cheating, though.
  46.  
  47.  
  48. How it works
  49. ~~~~~~~~~~~~
  50.  
  51.      Doom uses two standard Mouse API services:
  52.  
  53.           function AX=0003h             - mouse button status
  54.           function AX=000Bh             - mouse delta mickey counts
  55.  
  56.      A 'mickey' is the smallest unit of mouse movement... sort of like
  57. a pixel on the screen.  Every time Doom requests the new delta mickey
  58. counts, the mouse driver returns the number of mickeys (X and Y,
  59. positive and negative) the mouse has moved since the last request.
  60.  
  61.      DMS hooks interrupt 33h, the mouse driver interrupt, and watches
  62. for those two function requests.  Whenever Doom asks for the latest
  63. button status, DMS passes the request on to the mouse driver and then
  64. checks to see if the special button(s) have been pressed.  If they
  65. have, it masks them out (tells Doom they never happened) and adds 180
  66. degrees to the X-axis mickeys the next time Doom asks for them.
  67.  
  68.      DMS was written in assembly language for small size.  Source code
  69. is included.
  70.  
  71.  
  72. How to install it
  73. ~~~~~~~~~~~~~~~~~
  74.  
  75.      Put DMS.COM in your Doom directory, or some other directory in your
  76. DOS path.  Simply type 'DMS' to load it.  Be sure you load it AFTER your
  77. mouse driver, not before, or it won't work.
  78.  
  79.      'dms -?' or 'dms -h' will display some simple usage help.  To
  80. configure your own button preferences, run DMS with a parameter
  81. indicating which buttons you want.  The default is the right mouse
  82. button.  For example, if you prefer the Left+Right buttons to spin
  83. you, enter 'dms -lr'.  Since I like Middle and Right, I use 'dms -mr'.
  84.  
  85.      You can change your button definitions by running DMS again.  It
  86. will detect that it is already loaded and just update the buttons.
  87.  
  88.      DMS may be loaded into conventional memory, or high memory (UMB's).
  89. There really isn't any point in loading it high, however, as Doom doesn't
  90. need much conventional memory and DMS only consumes 384 bytes resident.
  91.  
  92.      Make sure you maximize the mouse sensitivity setting in Doom.
  93. Anything less than full sensitivity will mean you'll turn less than 180
  94. degrees.
  95.  
  96.  
  97. How to uninstall it
  98. ~~~~~~~~~~~~~~~~~~~
  99.  
  100.      DMS doesn't include software to release itself.  Sorry.  Go
  101. download the MARK/RELEASE tools, or just reboot after you're done.
  102.  
  103.  
  104. Legal stuff
  105. ~~~~~~~~~~~
  106.  
  107.      DMS is Copyright (c) 1994 Tom Klok and Dave Kirsch.  Permission
  108. is granted to distribute it via any media (Internet, BBS, CDROM, etc)
  109. as long as full attributions are maintained and the source code is
  110. included.  If you modify the source and build something new with it,
  111. please have the courtesy of leaving our names on it as well and
  112. mailing us a copy.  If you are a CDROM producer and include this
  113. package with your distribution, we expect a free copy of your disk as
  114. compensation.  Write to Tom Klok at a344@mindlink.bc.ca to notify
  115. us and get a shipping address.
  116.  
  117. -- tk 12Aug94Th
  118.  
  119.