WinGun V0.2B Readme Author Acorns http://guncon.acornscity.com (View this document with Word Wrap enabled) --About WinGun:-- WinGun is a program which allows you to use a Guncon2 or compatible lightgun with a windows computer, through a composite video connection. The lightgun will only work with your TV or arcade monitor, it will not work with your computer's monitor. WinGun is not exactly a "driver", it is a userlevel program that uses another driver to communicate with the USB Gun device. Because of this, WinGun.exe must be running in order to move the mouse and press the buttons. This program was inspired by Smog's Guncon2Mouse project, however it uses nothing from that project. It does not hack Smog's driver to work with rolling X guns, nor does it use any code from Smog's Guncon2Mouse. Smog's project is an actual driver that emulates a mouse for the system to read, while WinGun only tells your mouse where to move. WinGun exists not to replace or challenge Guncon2Mouse, but because I am impatient and wanted to use a lightgun that had the "Rolling X" problem (See the website for a discription of this problem). WinGun is a very new program and has not been widely tested, don't expect to much out of it. It may work for you, or it may not work for you. Visit the forums on my website for support and questions. --Installation:-- First extract all the files to the same directory. To install the go-between driver and WinGun program you must have your gun connected to the USB port. Some guns require that they be connected to your TV/Arcade monitor and be recieving a stream before they will function. After you have connected your gun, run Install.bat. If you had smogs driver installed previously, this will act as an upgrade - you can roll back to his driver or reinstall it to go back. Two boxes should appear asking you to install an uncertified driver, respond yes to both. Sometimes the console will display a timeout error, this has not effected the installation for me. After running install.bat, run WinGun.exe. A window should pop up, if this happens WinGun is ready to begin calibrating your gun. If no window pops up, after about 5 seconds you should recieve a timeout error. Make sure that your gun is connected, and only one gun is connected (multiple guns will come soon) then try again. --Uninstallation:-- Simply run Uninstall.bat in the directory you extracted WinGun to. --Calibration:-- To begin calibration WinGun must decide if you are using a gun that has the Rolling X problem. Wave your gun across the screen at a medium speed from left to right, then right to left. If you wave your gun to slowly and it has the rolling x problem, it will not be detected. If this happens, just click Recalibrate. If your gun does not have the rolling x problem, you will have to continue waving it for 5-20 seconds before the program will decide you do not have the problem. After WinGun has decided which mode to run it, the numbers for the edges should begin changing. At this point, wave your gun (very slowly) across each of the four sides of your TV. When you are satisfied with the values you can click the "Autocalib OFF" button. Some TV's will return values that are too low or to high, as of yet my autocalibration routine does not detect this very well. After clicking "Autocalib OFF" you may manually adjust the values in the textboxes by entering new ones yourself. You do not need to restart the program for these to take effect. Centering is not yet autodetected at all, you must manually enter values for it. Enter values between -32500 and 32500. Positive values will move the pointer further to the right/bottom, and negitive values to the left/top. This should only be used once you have calibrated the gun so the mouse is located where the lense of the gun is pointing. It can be used to align with your gunsights. You can select the "Normal" or "Rolling" option to overwrite what Autocalibration detects. Do this if your gun is misdetected. When you are finished calibrating, click Finished to save your settings and go to the main WinGun window. --Button Configuration:-- You can assign your Gun's button to any mouse or keyboard button by clicking Button Config on the main screen. This will take you to a screen showing your current configuration. Click on the button that has the name of the button you want to change, then press any key or click anywhere with the key/button you want to assign it to. Currently, only mouse and keyboard mappings are supported. Default Key Config: By default, the buttons on the gun are assigned as such: Trigger = Left Click Trigger (when gun is pointed offscreen) = MAME mode (click once on the very edge of the screen) Start = Enter Select = Space Button A = A Button B = B Button C = C Dpad UP = Up Arrow Key Dpad Down = Down Arrow Key Dpad Left = Left Arrow Key Dpad Right = Right Arrow Key You can reassign the keys in WinGun.ini manually as well. --Troubleshooting/Known problems:-- The Rolling X problem is not fully fixable, we do not have all the information we need. Because of this, support for guns in Rolling X mode is a hack. The user MUST do the following with guns in Rolling X mode: When bringing the gun back onscreen from being offscreen, it must be done on the left or right side of the display. It cannot be on the top or bottom of the display. The gun should not be jerked from side to side, smooth motions work best. Guns in rolling x mode will always experience these problems: After pointing to a black or dark spot for a second or so, the gun may skip to the other side of the screen. Simply wave it offscreen then back on, or across the center in order to regain correct positioning. The gun cannot be moved across a dark center screen. If this situation occurs, you will need to bring the gun to the section you need to point at from the left/right edge (whichever is closer). Some guns (specifically the Namco official one) will jump to the center of the screen occasionally. This can cause the gun to move to the wrong side of the screen the same way a black spot can. I have done all I can to fix this, the gun is returning an incorrect position when it is in a darker but not black area. For all guns with the rolling x problem, you might have best luck shooting targets on the egdes of the screen by bringing the gun onscreen from the closest left/right edge. For both the rolling x and normal mode guns, tracking cannot be done on dark surfaces. So turn your brightness up, and play a light game/use a light desktop. If you are playing a dark game like area51, the best you can do is aim at the target and fire - usually the pointer will be there, even if it did not track visibly across a dark surface to get to the target. For the INI file, completely blank lines can be read fine but the file is saved with none. I use // to add space. Negative numbers cannot yet be inputted into the CenterX or CenterX textboxes. You may put them in the INI however. --Comming Soon:-- An icon. I know. One line and a pic. But I'm that lazy about some things. More button assignment options - F.E. assign a button to a double click, use auto-reload with modes other than mame, assign buttons to turn auto-reload auto-fire off, or assign one button to autofire and another to not. Ability to minimise to system tray Final interface facelifts, more of a walkthrough on calibrating at the calibrating screen --Comming Later or Never:-- Support for multiple lightguns, multiple cfg files one for each. (maybe) Conversion to a "real" driver (very maybe) --Version Log:-- Versions are counted like this: A = Alpha B = Beta D = Development R = Release 0.0X will be the alpha releases 0.X will be the beta releases 0.XX will be development releases, and eventually X.XX X.X will be releases V0.2B Interface for configuring the buttons. (woot!) New calibration routine, some tweaks to calibration. Fixed just about everything I know of that could help the rolling x problem. This is as good as it gets, until we solve it. Redid the interface. Added singlefire firemode, and option to switch in the interface Added the ability to switch between normal and rolling x modes manually in the interface Added auto-fire and auto-reload. Auto-fire is best not used in duck hunt, I've found. Fixed a bug where Buttons A-C wern't being read in from the INI and resorting to using the defaults. Cleaned up code, fixed other random minor bugs V0.1B First public release. Fixed a couple of file write bugs, added in about 10 error messages, and took out some debug code to make ready for a public release. Please note that the interface is brand new, most of the program was written using a console to output errors. It will be improved in the next release. V0.02A - Added ini file saving Added this readme Changed the routine for finding normal/rolling gun mode. The previous one took 30 seconds for guns that sent information at a slower rate. Fixed a couple of bugs V0.01A - First "release", only tested by one person other than myself.