New Title : DOOM Mouse Spinner v0.15 with KEYBOARD Support, : AND toggle key to disable mouse forward/backward movement! Filename : DMS015.com Modified by : Lincoln Yeoh Email Address : lyeoh@pop.jaring.my ================================================================ Title : Doom Mouse Spinner (DMS) v0.12 beta Filename : DMS.COM Authors : Tom Klok and Dave 'Zoid' Kirsch Email Address : a344@mindlink.bc.ca Description : Ever had the problem of a monster or deathmatch opponent sneaking up behind you? Ever needed to turn around *now*? With DMS, you can rotate your player 180 degrees with a click of the mouse! Release note : This is a *BETA* release. DMS has been tested with Logitech 3-button and Microsoft 2-button mice. It should work with others without problems. I don't know what it would do with a CyberMan. Release note for DMS v0.13 : Modified by Lincoln Yeoh so you can use a user definable key on the keyboard to flip! And added -n for people who don't want to use the mouse buttons to flip. Seems to work. If it doesn't. Tough! Go fix it. DMS v0.15 : More modification so you can use a definable key to disable/enable mouse y-movement. Shortcomings - my code is ugly. Does not clear left over keypresses after getting key when installing. Construction : TASM 3.1, TLINK 5.1 ================================================================ What it is ~~~~~~~~~~ DMS is a tiny TSR (1.3K bytes resident) that intercepts Doom's calls to the mouse driver. By clicking the mouse buttons that you define, it will instantly turn you 180 degrees -- facing the exact opposite direction. Cranking up your mouse driver sensitivity can allow you to do the same, but then your accuracy may fall off. With this you don't have to make that compromise. It supports mouse "chords". For example, if you have a 2-button mouse you can set it up to spin you only when you press the left and right mouse button at the same time. 3-button mice permit even more combinations. I prefer the Middle+Right button chord on my Logitech. LY> I prefer to flip with the keyboard, and leave the mouse buttons for other stuff. That explains this patch :-). This makes it easier to run forward, flip, run backward facing opponent, aim, fire, flip back again to see where you're going. Also convenient if you back into a door- flip, press spacebar.. Also seems like some people had problems staying on top of platforms (tsk tsk), so I decided to add this for them. Does it work for Deathmatch? ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Sure, why not? It shouldn't cause consistency failure. Some might consider it cheating, though. LY> I think adding the keyboard support makes it a bit more fair now... Mouse AND Keyboard is still better! It'll only be cheating if I manage to add another feature. How it works ~~~~~~~~~~~~ Doom uses two standard Mouse API services: function AX=0003h - mouse button status function AX=000Bh - mouse delta mickey counts A 'mickey' is the smallest unit of mouse movement... sort of like a pixel on the screen. Every time Doom requests the new delta mickey counts, the mouse driver returns the number of mickeys (X and Y, positive and negative) the mouse has moved since the last request. DMS hooks interrupt 33h, the mouse driver interrupt, and watches for those two function requests. Whenever Doom asks for the latest button status, DMS passes the request on to the mouse driver and then checks to see if the special button(s) have been pressed. If they have, it masks them out (tells Doom they never happened) and adds 180 degrees to the X-axis mickeys the next time Doom asks for them. DMS 0.13 does that too, and also checks the keyboard- in al,060h DMS was written in assembly language for small size. Source code is included. How to install it ~~~~~~~~~~~~~~~~~ Put DMS015.COM in your Doom directory, or some other directory in your DOS path. Simply type 'DMS015' to load it. Be sure you load it AFTER your mouse driver, not before, or it won't work. <-- Important! 'dms015 -?' or 'dms015 -h' will display some simple usage help. To configure your own button preferences, run DMS with a parameter indicating which buttons you want. The default is the right mouse button. For example, if you prefer the Left+Right buttons to spin you, enter 'dms015 -lr'. I use 'dms015 -n' for none - no spin using mouse buttons. You can change your button definitions by running DMS again. It will detect that it is already loaded and just update the buttons. Same goes for the keyboard. However the message is wrong - default means previous key setting not those stated in the message. DMS may be loaded into conventional memory, or high memory (UMB's). There really isn't any point in loading it high, however, as Doom doesn't need much conventional memory and DMS only consumes 512 bytes resident. IMPORTANT!!!!!! Make sure you maximize the mouse sensitivity setting in Doom. Anything less than full sensitivity will mean you'll turn less than 180 degrees. ENSURE that you have set your controller type to Keyboard and Mouse in your DOOM config setup. Even if you are just using the keyboard you need the mouse driver and mouse enabled under DOOM for it to work! It should work with controller type set to just plain Mouse... But that's a weird thing to do! How to uninstall it ~~~~~~~~~~~~~~~~~~~ DMS doesn't include software to release itself. Sorry. Go download the MARK/RELEASE tools, or just reboot after you're done. Legal stuff ~~~~~~~~~~~ DMS is Copyright (c) 1994 Tom Klok and Dave Kirsch. Permission is granted to distribute it via any media (Internet, BBS, CDROM, etc) as long as full attributions are maintained and the source code is included. If you modify the source and build something new with it, please have the courtesy of leaving our names on it as well and mailing us a copy. If you are a CDROM producer and include this package with your distribution, we expect a free copy of your disk as compensation. Write to Tom Klok at a344@mindlink.bc.ca to notify us and get a shipping address. -- tk 12Aug94Th I did try to email Tom and Dave a copy, but their email addresses don't seem to work anymore. Anyone know their email addresses? Thanks to you two anyway. Nice code - finally some PC code that even I can decipher! Thinking of adding auxiliary keys/button for forward and backwards. Nah, DOOM isn't a flight simulator!! :-). Tried that with DMS014. Doesn't work well sometimes the keys are lost - lose key up events.. So forget that one. Typing DMS015 by itself doesn't seem to select right button by default. Can't be bothered to fix that! -- LY 19 June 1995