home *** CD-ROM | disk | FTP | other *** search
/ Death Match - The Ultimate Game Player's Kit / CD2.zip / CD2 / WADS / D2FILE / DMS013.TXT < prev    next >
Text File  |  1995-05-09  |  7KB  |  160 lines
  1. New Title               : DOOM Mouse Spinner v0.13 with KEYBOARD Support!
  2. Filename                : DMS013.com
  3. Modified by             : Lincoln Yeoh 
  4. Email Address           : lyeoh@pop.jaring.my
  5.  
  6. ================================================================
  7. Title                   : Doom Mouse Spinner (DMS) v0.12 beta
  8.  
  9. Filename                : DMS.COM
  10. Authors                 : Tom Klok and Dave 'Zoid' Kirsch
  11. Email Address           : a344@mindlink.bc.ca
  12.  
  13. Description             : Ever had the problem of a monster or
  14.                           deathmatch opponent sneaking up behind
  15.                           you?  Ever needed to turn around *now*?
  16.                           With DMS, you can rotate your player
  17.                           180 degrees with a click of the mouse!
  18.  
  19. Release note            : This is a *BETA* release.  DMS has been
  20.                           tested with Logitech 3-button and
  21.                           Microsoft 2-button mice.  It should work
  22.                           with others without problems.  I don't
  23.                           know what it would do with a CyberMan.
  24.  
  25. Release note for DMS v0.13   
  26.                         : Modified by Lincoln Yeoh so you can use a 
  27.                           user definable key on the keyboard to flip!
  28.                           And added -n for people who don't want to use                                            
  29.                           the mouse buttons to flip.
  30.  
  31.                           Seems to work. If it doesn't. Tough! Go fix it.
  32.  
  33. Construction            : TASM 3.1, TLINK 5.1
  34.  
  35. ================================================================
  36.  
  37.  
  38. What it is
  39. ~~~~~~~~~~
  40.  
  41.      DMS is a tiny TSR (443 bytes resident) that intercepts Doom's
  42. calls to the mouse driver.  By clicking the mouse buttons that you
  43. define, it will instantly turn you 180 degrees -- facing the exact
  44. opposite direction.  Cranking up your mouse driver sensitivity can
  45. allow you to do the same, but then your accuracy may fall off.
  46. With this you don't have to make that compromise.
  47.  
  48.      It supports mouse "chords".  For example, if you have a 2-button
  49. mouse you can set it up to spin you only when you press the left and
  50. right mouse button at the same time.  3-button mice permit even more
  51. combinations.  I prefer the Middle+Right button chord on my Logitech.
  52.  
  53. LY> I prefer to flip with the keyboard, and leave the mouse buttons
  54.     for other stuff. That explains this patch :-). This makes it easier
  55.     to run forward, flip, run backward facing opponent, aim, fire, flip
  56.     back again to see where you're going. Also convenient if you back into
  57.     a door- flip, press spacebar..
  58.  
  59. Does it work for Deathmatch?
  60. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  61.  
  62.      Sure, why not?  It shouldn't cause consistency failure.  Some
  63. might consider it cheating, though.
  64.  
  65. LY>     I think Heretic has this function built in. And I think adding
  66.         the keyboard support makes it a bit more fair now... 
  67.         Mouse AND Keyboard is still better!
  68.  
  69. How it works
  70. ~~~~~~~~~~~~
  71.  
  72.      Doom uses two standard Mouse API services:
  73.  
  74.           function AX=0003h             - mouse button status
  75.           function AX=000Bh             - mouse delta mickey counts
  76.  
  77.      A 'mickey' is the smallest unit of mouse movement... sort of like
  78. a pixel on the screen.  Every time Doom requests the new delta mickey
  79. counts, the mouse driver returns the number of mickeys (X and Y,
  80. positive and negative) the mouse has moved since the last request.
  81.  
  82.      DMS hooks interrupt 33h, the mouse driver interrupt, and watches
  83. for those two function requests.  Whenever Doom asks for the latest
  84. button status, DMS passes the request on to the mouse driver and then
  85. checks to see if the special button(s) have been pressed.  If they
  86. have, it masks them out (tells Doom they never happened) and adds 180
  87. degrees to the X-axis mickeys the next time Doom asks for them.
  88.      DMS 0.13 does that too, and also checks the keyboard- in al,060h
  89.  
  90.      DMS was written in assembly language for small size.  Source code
  91. is included.
  92.  
  93.  
  94. How to install it
  95. ~~~~~~~~~~~~~~~~~
  96.  
  97.      Put DMS013.COM in your Doom directory, or some other directory in your
  98. DOS path.  Simply type 'DMS013' to load it.  Be sure you load it AFTER your
  99. mouse driver, not before, or it won't work.  <-- Important!
  100.  
  101.      'dms -?' or 'dms -h' will display some simple usage help.  To
  102. configure your own button preferences, run DMS with a parameter
  103. indicating which buttons you want.  The default is the right mouse
  104. button.  For example, if you prefer the Left+Right buttons to spin
  105. you, enter 'dms -lr'.  Since I like Middle and Right, I use 'dms -mr'.
  106.  
  107.      You can change your button definitions by running DMS again.  It
  108. will detect that it is already loaded and just update the buttons.
  109.  
  110.      DMS may be loaded into conventional memory, or high memory (UMB's).
  111. There really isn't any point in loading it high, however, as Doom doesn't
  112. need much conventional memory and DMS only consumes 384 bytes resident.
  113.  
  114.      Make sure you maximize the mouse sensitivity setting in Doom.
  115. Anything less than full sensitivity will mean you'll turn less than 180
  116. degrees.
  117.      
  118.      ENSURE that you have set your controller type to Keyboard and Mouse 
  119.      in your DOOM config setup. Even if you are just using the keyboard
  120.      you need the mouse driver and mouse enabled under DOOM for it to work!
  121.      It should work with controller type set to just plain Mouse... 
  122.      But that's a weird thing to do!
  123.                                        
  124.  
  125. How to uninstall it
  126. ~~~~~~~~~~~~~~~~~~~
  127.  
  128.      DMS doesn't include software to release itself.  Sorry.  Go
  129. download the MARK/RELEASE tools, or just reboot after you're done.
  130.  
  131.  
  132. Legal stuff
  133. ~~~~~~~~~~~
  134.  
  135.      DMS is Copyright (c) 1994 Tom Klok and Dave Kirsch.  Permission
  136. is granted to distribute it via any media (Internet, BBS, CDROM, etc)
  137. as long as full attributions are maintained and the source code is
  138. included.  If you modify the source and build something new with it,
  139. please have the courtesy of leaving our names on it as well and
  140. mailing us a copy.  If you are a CDROM producer and include this
  141. package with your distribution, we expect a free copy of your disk as
  142. compensation.  Write to Tom Klok at a344@mindlink.bc.ca to notify
  143. us and get a shipping address.
  144.  
  145. -- tk 12Aug94Th
  146.  
  147. I did try to email Tom and Dave a copy, but their email addresses don't seem
  148. to work anymore. Anyone know their email addresses?
  149.  
  150. Thanks to you two anyway. Nice code - finally some PC code that even I can
  151. decipher!
  152.  
  153. Thinking of adding auxiliary keys/button for forward and backwards. Nah,
  154. DOOM isn't a flight simulator!! :-).
  155.  
  156.  Typing DMS013 by itself doesn't seem to select right button by default.
  157.  Can't be bothered to fix that! 
  158.  
  159. -- LY 8 May 1995
  160.