WinGun V0.1B 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 your TV-Out connection. The lightgun will only work with your TV. 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). Because WinGun is less than 3 days old in this release, 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. --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 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. 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. 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 --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: 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, blank lines can be read fine but the file is saved with none. 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:-- Interface for configuring the keys. More options in the existing interface. The initial release was going to be a console program, but I decided to add a windows interface in the last couple of hours. I'll also add an icon, and make it better looking. Autofire and autoreload options. Two more firing modes, SingleFire and DoubleFire. Currently the only mode is Drag, in which the button is held down until you release it. This can make it hard to click on things like icons. SingleFire will click once at the position of the gun where it was when you first pressed the button. DoubleFire will fire once at your current location, then once at your last (handy for people who have the "jump to center" problem) Better autocalibration, and a calibration routine that has you shoot targets. Better handling of the Rolling X problem. Support for multiple lightguns, multiple cfg files one for each. --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.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.