ZSNES v1.51 Documentation

================================
    N a v i g a t i o n
================================

    * Index    [Index.txt]

    * Readme    [Readme.txt]

    * GUI    [GUI.txt]

    * Netplay    [Netplay.txt]

    * Advanced Usage    [Advanced.txt]

    * Games    [Games.txt]

    * FAQ    [FAQ.txt]
        1. Universal
        2. Win Port
        3. SDL Port
        4. DOS Port

    - - - - - - - - - - - - - - - - - -

    * Getting Support    [Support.txt]

    * History    [History.txt]

    * About    [About.txt]

    * License    [License.txt]

    - - - - - - - - - - - - - - - - - -

    * NSRT Guide:    [http://zsnes-docs.sf.net/nsrt]

    * ZSNES Home Page:  [ZSNES.com]


================================================================================
~               F.    A.    Q.      (Frequently Asked Questions)
================================================================================

The FAQ page was first included in version 0.390 of ZSNES, released on
April 11, 1998.


~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
            Question Index
~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~

- - - - - - - - - - -
 UNIVERSAL QUESTIONS
- - - - - - - - - - -

   General
       Where do I download games / ROMs?
       What is the "save directory"?
       Why are my games not saving?
       Are the ZSNES data files compatible among the various ZSNES ports
           (Win/DOS/SDL)?
       Is there Toaster Support?
   Games
       Why don't my games work after applying IPS patches to them?
       Does ZSNES support Snes9x, GoodSNES, and NSRT ROMs? Or only ZSNES ones?
   Video
       Why do my scanlines look awful?
       Why am I missing some video filter options?
   Sound
       Why does ZSNES produce a lot of static?
       Why am I missing some sound options?
   Input
       Why can't I press more than 2 keys at a time?
       Why is one direction of the d-pad always held down, even when I'm not
           pressing any keys?
       How do I use both my keyboard and joystick for the 1st or 2nd player?
       Why can't I set the keys/buttons for Player 2?
       Why won't ZSNES accept input when I'm configuring the keys for my
           gamepad?
       This game tells me that it is not compatible with the MultiTap
           (or an external device attached). What should I do?
   Speed
       Why is ZSNES slow?
       Why does the game slow down even though I'm using auto frame rate and
           the FPS is pretty high?
       My games are running too quickly! How do I slow them down?
   Miscellaneous
       Does ZSNES support loading ROMs which are compressed?
       Why doesn't ZSNES support the 7z, RAR, or ZIP deflate64 compression
           formats?
       Does ZSNES support multiple ROMs in a single ZIP or JMA file?
       Can you make a Mac/PocketPC/PS2/whatever port?

- - - - - - - - - - - -
WIN-SPECIFIC QUESTIONS
- - - - - - - - - - - -

   General
       Why does ZSNESw crash and give me an error with dinput.dll?
       I just switched from the DOS port to the Windows port of ZSNES;
           why don't my savestates work? Are they incompatible?
   Video
       Why am I seeing double, with strange colors?
       Why is the video choppy with an FPS of 60 and VSync on?
   Sound
       How come I don't get any sound?

- - - - - - - - - - - -
SDL-SPECIFIC QUESTIONS
- - - - - - - - - - - -

   General
       Can I run ZSNES without X?
       I got ZSNES from my distro and I found a bug. To whom should I report it?
       Should I use SVN?
       I'm getting an error about gzdirect() missing when I try to compile
           ZSNES. What's up?

- - - - - - - - - - - -
DOS-SPECIFIC QUESTIONS
- - - - - - - - - - - -

   Video
       How do you enable transparencies?
       Why is there a layer of fog blocking my view?
       Why am I getting error messages regarding VESA 2 drivers?
   Sound
       Why is there no sound?
       Are there any plans to improve detection for non-SoundBlaster cards
           (or supporting non-SB cards)?
       I get a sound initialization error using my SB Live! (or any other
           PCI card). How do I fix it?
   Input
       Why doesn't my Sidewinder pad work?
       How do I get my daisy-chained Sidewinder to work?
       Why doesn't my Gamepad Pro work?
       Why doesn't my joystick work anymore?
       Why does JB5/JB6 keep getting pressed whenever I try to change a key?
   Freezing/Crashing Issues
       Why does ZSNES freeze when I run it under pure DOS?
       Why does ZSNES crash when I load a ROM?
       Why does ZSNES freeze when I try to enter the GUI?
       ZSNES gives me an "out of memory" error and I only have 16MB of RAM.
           How do I fix this?
   Miscellaneous
       I'm using DJGPP 2.03 and I get an error about missing stdint.h.
           What's wrong?


~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  1.                UNIVERSAL QUESTIONS
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

................................
            General
................................

Q: Where do I download games / ROMs?
A: Due to the questionable legality of ROM images of commercial games (see
   [http://en.wikipedia.org/wiki/Rom_images#Legal_status_of_ROMs]), the ZSNES
   Team *cannot* and *will not* provide you with any games / ROMs. We must do
   this in order to keep ZSNES, as an emulator, legal. Please see the disclaimer
   [Readme.txt].

Q: What is the "save directory"?
A: Please read more about the types of files ZSNES generates and where they are
   created in the Files section of [Readme.txt].

   By default, in the Win and DOS ports of ZSNES, these files will go into their
   corresponding ROM directory (e.g. If your Chrono Trigger ROM is in
   "C:\SNES Games\RPG", its files will go into that folder; if your Harvest Moon
   ROM is in "C:\SNES Games\Simulation", its files will go into that folder).
   In the SDL port of ZSNES, however, saves will go into "~/.zsnes" by default.
   ZSNES SDL under Mac OS X will place them in
   "~/Library/Application Support/ZSNES" instead.

   If you dislike the default settings, you can configure a single, universal
   save path by either going to the Config->Paths menu in the GUI or by editing
   the ZSNES configuration file [Advanced.txt].

Q: Why are my games not saving?
A: If your ROM images are stored on a CD-ROM, you need to define a save
   directory that points to your hard drive. In order to do this, either go to
   Config-->Paths and enter a directory, or edit the ZSNES configuration file by
   typing in a directory after "SaveDirectory=". Make sure that this directory
   is not marked read-only.

   If this still does not solve your problem, enable SRAM Check + Save under the
   Config-->Saves menu.

Q: Are the ZSNES data files compatible among the various ZSNES ports
   (Win/DOS/SDL)?
A: Yes. Unlike certain PC applications and games, ZSNES's various save files
   and formats are completely port-independent; you can share any of your files
   with any user using any port of ZSNES (although some things may be
   version-dependent). Note, however, that ZSNES's configuration file
   [Advanced.txt] contains port-specific options which don't exist in other
   ports, so while they can be transfered between ports, some things won't work
   as expected. Note that when transfering various files, make sure they're
   named properly and in the proper location (see the Files section [Readme.txt]
   for details).

Q: Is there Toaster Support?
A: While we'd love for ZSNES to lace our shoes, feed us, breathe for us, and
   amass wealth for us, we can't add every crazy feature that comes up.
   Even though ZSNES does have many, many features that are not necessarily
   SNES related, they normally don't go beyond features that you'd expect from
   an advanced gaming system.

   Regarding toaster support itself, rumor has it ZSNES does bread toasting
   if you happen to be using it after midnight while paying your respects
   to the master of all controls and considering monetary options.

................................
             Games
................................

Q: Why don't my games work after applying IPS patches to them?
A: If your patched game crashes early or just displays a black screen, you
   probably need to either add or remove the 512 byte offset from the patch.
   Use the program IPSEDIT to do this, which is bundled along with NSRT.

   Alternatively, you could either add or remove a header from your ROM before
   patching. Again, NSRT is capable of doing this. [http://nsrt.edgeemu.com]

Q: Does ZSNES support Snes9x, GoodSNES, and NSRT ROMs? Or only ZSNES ones?
A: ZSNES, Snes9x, GoodSNES, and NSRT ROMs do not exist. All these programs work
   with SNES ROMs. As ZSNES is an SNES emulator, it will work with all SNES ROMs
   (except where ZSNES has a bug or the ROM is in an unsupported interleave
   format).

................................
             Video
................................

Q: Why do my scanlines look awful?
A: Scanlines can be negatively affected by the method of vertical scaling that
   your video card uses, depending on the video mode you have selected for
   ZSNES. This can sometimes result in scanlines that are not of uniform
   darkness. The effect of this video scaling is most noticeable with Full
   scanlines, with 50% and 25% scanlines being less noticeable. To display the
   scanlines effect properly, you should use resolutions based on a multiple of
   256x224 in windowed modes (e.g. 512x448) and 320x240 for fullscreen modes
   (e.g. 640x480).

Q: Why am I missing some video filter options?
A: Please make sure you have MMX Support enabled in the Options dialog. Refer to
   the Video Config description in [GUI.txt] to see what video options require
   MMX support.

................................
             Sound
................................

Q: Why does ZSNES produce a lot of static?
A: There could be many reasons why you are hearing static. If you are using the
   Windows port and you have an ISA sound card, this could be your problem. If
   you are using the DOS port, and you have a PCI sound card, this could also be
   your problem. If your sound card is using SoundBlaster emulation, you
   probably need to use 8-bit sound, but this can make sound output worse. You
   can also try doing the following things to improve your sound: Reduce your
   sampling rate or disable lowpass filtering and stereo sound; Win port users
   can also enable the Primary Sound Buffer.

Q: Why am I missing some sound options?
A: Please make sure you have MMX Support enabled in the Options dialog. Refer to
   the Sound Config description in [GUI.txt] to see what sound options require
   MMX support.

................................
             Input
................................

Q: Why can't I press more than two keys at a time?
A: Many PC ("Personal Computer") keyboards limit the number of key signals that
   can be transmitted simultaneously. For example, certain combinations of three
   or more alphanumeric keys may not work. Conversely, there may be some
   combinations of three or more keys that *do* work. You would just have to
   test by trial-and-error to find out, since these combinations can vary
   between keyboards. Joysticks and gamepads generally don't have this
   limitation.

   If you must use a keyboard, you can set multiple game keys to a single
   keyboard key. Alternatively, you could set some keys to the right and left
   Ctrl and Shift keys, since most keyboards do not restrict signals from
   these keys.

Q: Why is one direction of the d-pad always held down, even when I'm not
   pressing any keys?
A: ZSNES auto-calibrates any connected gamepads/joysticks when it first starts.
   Thus, if one of the buttons or directions is accidentally held down while
   ZSNES is starting, ZSNES will think this is "normal" or "zero" input, even
   when you let go of the button. To fix the problem, simply close ZSNES, make
   sure no buttons are pressed and all axis are centered on your
   gamepad/joystick, and restart ZSNES. It will then auto-calibrate to the
   correct "zero" settings.

Q: How do I use both my keyboard and joystick for the 1st or 2nd player?
A: First, configure the Player 1 pad (Config-->Input--> #1) for your normal
   set-up (for example, a keyboard). Next, configure the Player 3 pad
   (Config-->Input--> #3) to use your alternative set-up (for example, a
   joystick or gamepad). When you want to switch between your regular and
   alternative set-up, go to the Config-->Options menu and check
   USE PL3/4 AS PL1/2. Now the Player 3 controls act as the Player 1 pad, and
   Player 4's controls act as the Player 2 pad. To return to the normal
   controls, simply uncheck this option. Follow the same procedure to create a
   similar set-up for Players 2 and 4.
   Note: Enabling the option USE PL3/4 AS PL1/2 disables MultiTap emulation.

Q: Why can't I set the keys/buttons for Player 2?
A: You need to set the Current Device before ZSNES will allow you to set the
   individual keys for Player 2 (or Players 3, 4, or 5). If NONE is shown after
   CURRENT:, the input cannot be changed (or used, for that matter). See the
   Input section of the GUI page [GUI.txt] for further instructions.

Q: Why won't ZSNES accept input when I'm configuring the keys for my gamepad?
A: Exit ZSNES and calibrate your input device. Then restart ZSNES and see if it
   works.

Q: This game tells me that it is not compatible with the MultiTap (or an
   external device attached). What should I do?
A: Set the input devices of player 3, 4, and 5 to "None". You may also need to
   go to Config-->Options, and enable "Use Player 3/4 as Player 1/2".
   Additionally, you could add an NSRT header to your ROM if you desire.

................................
             Speed
................................

Q: Why is ZSNES slow?
A: First and foremost, does your computer meet the minimum system requirements
   to run ZSNES? If not, there is little you can do to improve performance. That
   being said, you can still try a number of things.

     * Make sure that any major program(s) is/are closed (such as Winamp).
     * Try the default settings of ZSNES before you do anything else. You can
       reset ZSNES to the default settings by deleting all three of its
       configuration files.
     * Ensure that MMX Support is enabled in the Options dialog; this mode
       should provide a noticeable speed increase for computers that can use it.
     * Certain system configurations and video cards work better with certain
       video modes. Try switching between different video modes until you find
       one that has good/better performance. Things to remember when doing this
       are that lower resolutions are faster than higher resolutions, full
       screen modes are faster than windowed modes, and 'R' modes are faster
       than 'S' modes (because no scaling is necessary).
     * Make sure you are using Auto Frame Skipping. If you already are, try
       increasing the Max Frame Skip.
     * Do not use VSync; if you must use VSync, try also enabling Triple
       Buffering.
     * Disable all video filters.
     * Compile ZSNES yourself with optimizations for your CPU's architecture.
     * If you still need more speed, disable sound. If that's not enough,
       disable SPC emulation (you must restart ZSNES for this option to take
       effect). Some games will not work without SPC emulation.

   If you have an old computer, such as one with a 486/100 processor, you will
   probably be better off using older DOS versions of ZSNES, as the minimum
   system requirements have increased slightly with subsequent releases. To
   achieve greater speed, you may want to avoid using VESA video modes (although
   this will disable transparencies). Experiment with the different video modes
   and try the recommendations above to see which configuration provides the
   best speed for you.

Q: Why does the game slow down even though I'm using auto frame rate and the FPS
   is pretty high?
A: If you have ever played a real SNES, you may notice that some games slow down
   even on it. To the extent that ZSNES accurately emulates an SNES, a game will
   slow down in ZSNES in the same places it would slown down on a real SNES.

Q: My games are running too quickly! How do I slow them down?
A: You may have disabled auto frame skipping. Re-enable it in the
   Config-->Speed menu.

   If you don't want to use auto frame skipping, and you want to play in
   windowed mode, you might want to set your monitor's refresh rate to 60hz
   and enable VSync in ZSNES.

   If you want to use fullscreen mode without using auto frame skipping,
   you can enable the KitchenSync by using either the -ks (for NTSC/PAL)
   or -kp (for PAL) command-line parameter (Windows port only) [Advanced.txt].
   Also be sure to enable triple buffering.

................................
         Miscellaneous
................................

Q: Does ZSNES support loading ROMs which are compressed?
A: Yes, but it depends on what compression format is used. ZSNES can currently
   load ROMs that are compressed in the ZIP (method 0 - store and method 8 -
   deflate), GZip, and JMA compression formats.

   Many tools are available to create ZIP files. If you want a fast, commandline
   based ZIP program that is available on many platforms, get Info-ZIP. Info-ZIP
   also has a Windows front end called WiZ available if you prefer a GUI.

   For creating GZip files, there are not too many choices. A fast, commandline
   based compressor for the GZip format, available for several platforms, may be
   downloaded at the GZip site [http://www.gzip.org]. If you use Windows, there
   is a program with a GUI called 7-Zip [http://www.7-zip.org] that has support
   for ZIP, GZip, and others. ZIP and GZip files created by 7-Zip are smaller
   than those created with other programs, but 7-Zip takes a longer time
   creating them. For users of Unix based operating systems who would like a GUI
   front end for both ZIP and GZip, get Ark
   [http://docs.kde.org/en/3.2/kdeutils/ark/], which is part of the KDE project.

   To create JMA files, a format invented by Nach and the rest of the NSRT team
   which offers the best compression ratio for SNES ROMs, you must use NSRT
   [http://nsrt.edgeemu.com]. NSRT is also capable of compressing SNES ROMs into
   ZIP and GZip formats.

Q: Why doesn't ZSNES support the 7z, RAR, or ZIP deflate64 compression formats?
A: ZSNES only supports formats which have an open-source, portable, and
   easy-to-use library. The 7z and RAR formats do not yet have libraries that
   fill those criteria. If you want the best compression ratio for your SNES
   ROMs, you should use JMA. Currently, the only publicly available program that
   can compress and decompress with JMA is NSRT [http://nsrt.edgeemu.com]. ZIP
   deflate64 lacks a decompression library which ZSNES can use, but rumor has it
   that Nach is working on one.

Q: Does ZSNES support multiple ROMs in a single ZIP or JMA file?
A: ZSNES currently does not support more than one ROM in a ZIP or JMA file,
   although such support will probably be implemented in the future.

Q: Can you make a Mac/PocketPC/PS2/whatever port?
A: Since ZSNES is written in assembly, ports to any systems that are not 100%
   x86 compatible are impossible. Try Snes9x [http://www.snes9x.com] for
   portability.

   Apple Computer, Inc. recently switched the Macintosh computers to use Intel
   processors [http://www.apple.com/pr/library/2005/jun/06intel.html], and
   as such ZSNES has already been modified to run on said computers. Just
   compile the SDL port with an up-to-date NASM and zlib and everything normally
   required.

   Another third party developer recently ported ZSNES to the Microsoft Xbox as
   well, and released it under the name "ZsneXbox". Unfortunately, we can not
   provide a download link as this port is being illegally distributed as a
   compiled XBE file. As a result, any link or support requests regarding this
   port will be promptly ignored.


~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  2.               WIN-SPECIFIC QUESTIONS
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

................................
            General
................................

Q: Why does ZSNESw crash and give me an error with dinput.dll?
A: If you get this error, download and install the latest version of DirectX.
   You might also try running the DirectX Diagnostic Tool. You can do this by
   clicking the Start button, then selecting "Run...". Type "dxdiag" after
   "Open:", and click "OK". There are lots of options you can play with, so
   please read everything before you start messing around. Specifically, go to
   the "Display" tab, and under the "DirectX Features" section, click the
   "Disable" button beside each feature. After they are all disabled, re-enable
   them. Exit dxdiag, and try ZSNES again.

   If none of that worked, try re-installing DirectX.

Q: I just switched from the DOS port to the Windows port of ZSNES; why don't my
   savestates work? Are they incompatible?
A: The saves and savestates will work just as well with any port of ZSNES. You
   simply need to rename all files that have .srm and .zst (and .zs1, .zs2,
   etc.) extensions to match the filenames of your ROMs (or the jma/zip archives
   that contain them).

   For example, if you have "Super Mario World.zip" and "Super Mario RPG.zip",
   both games will have saves that are labeled "SUPERM~1.SRM", "SUPERM~1.ZS2",
   etc., and they will be differentiated only by the number after the "~" in the
   filename.

   If you need to find out which "~" number a game uses, open a DOS prompt
   (a.k.a. Command Prompt), change to the ROM directory, and enter "dir /on /p"
   (On some newer systems like Win2k you need to add the "/x" switch for the DOS
   filenames to be displayed). Unfortunately, this method may not be accurate if
   you have moved your ROMs to a different folder or another computer; you may
   need to guess and hope for the best, trying to swap filenames a few different
   ways between the saves before it works for all your games. If it comes down
   to guessing, we recommend that you backup your save files before renaming
   them.

   Don't forget to put the files into your Save directory. A question concerning
   the Save directory is under Universal Questions -> General [FAQ.txt].

................................
             Video
................................

Q: Why am I seeing double, with strange colors?
A: Any change of resolution within ZSNES should correct the problem. Fullscreen
   modes are recommended because they are faster than windowed modes.

   If you still experience problems, see if these suggestions help (each should
   be done/tried separately):
     - The issue can be completely resolved with up-to-date video card drivers.
       Keeping your device drivers fully updated will provide other benefits
       unrelated to ZSNES.
     - Set the resolution for ZSNES to the same one used by the Windows desktop.
     - Try enabling 16-bit color depth in Windows.

Q: Why is the video choppy with an FPS of 60 and VSync on?
A: If you have VSync on, your monitor needs to be set to a refresh rate that is
   a multiple of the framerate of the game. NTSC games natively run at ~60 FPS.
   PAL games natively run at 50 FPS. Thus your monitor would need to be either
   60Hz or 120Hz for NTSC games, or 50Hz/100Hz for PAL games. If you run ZSNES
   with the -6 switch, with a sub-argument of '60', ZSNES will try to switch
   your monitor to 60Hz refresh rate. You can use the -ks switch to make ZSNES
   try to switch your monitor to 120Hz refresh rate. These two switches only
   work in fullscreen modes and are for the Windows port only.
   Please reference [Advanced.txt] for details on command-line switches.

   You can also try enabling Triple Buffering (using the -3 switch or the GUI
   option), however this currently only works in Full Screen modes. One last
   thing you can try is to turn off auto frame-skipping, and set manual frame
   rate to "0".

................................
             Sound
................................

Q: How come I don't get any sound?
A: Either you accidentally disabled sound, you don't have a sound card, the
   sound drivers aren't properly installed in your system, or your sound card is
   not compatible with DirectSound (part of Microsoft's DirectX API
   [Support.txt]). Also make sure that 'Disable SPC Emulation' is NOT checked.
   See [GUI.txt] for more information about sound settings in ZSNES.

   Try (re-)installing the latest version of DirectX, and make sure you have the
   latest drivers for your sound card (WHQL Certified, if possible).

   Please also note that ISA sound cards tend not to work with Windows, while
   they do with DOS.


~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  3.               SDL-SPECIFIC QUESTIONS
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

................................
            General
................................

Q: Can I run ZSNES without X?
A: Yes, but you'll need to have SDL compiled to use SVGAlib.

Q: I got ZSNES from my distro and I found a bug. To whom should I report it?
A: Compile ZSNES yourself and see if the bug still exists. If it does,
   please tell us, otherwise be happy that ZSNES works now, and give your
   distro a heads-up if you feel motivated enough.

Q: Should I use SVN?
A: SVN ("Subversion") is the best way to get the most up-to-date ZSNES source.
   It is best to double-check with SVN if you have a problem, since we might
   have already fixed it. If you find a new problem in SVN, please tell us, but
   be warned that we won't take it too seriously if it involves something that's
   currently being worked on.

   To check out and install ZSNES from SVN, refer to this thread on the ZSNES
   board [http://board.zsnes.com/phpBB2/viewtopic.php?t=7371].

Q: I'm getting an error about gzdirect() missing when I try to compile ZSNES.
   What's up?
A: Make sure you're using zlib 1.2.3 or higher. Some distributions say you have
   zlib 1.2.3 but in reality give you an older version. If your distribution is
   being problematic, compile zlib yourself. Grab the latest version of zlib at
   the official website. [http://www.zlib.net]


~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  4.               DOS-SPECIFIC QUESTIONS
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

................................
             Video
................................

Q: How do you enable transparencies?
A: First, try setting the video mode to a 16-bit color mode in the GUI. (If
   320x240x16b doesn't work, then try 640x480x16b). If it gives you an error
   that says that your video card isn't compatible with VESA 2.0, you might want
   to get Scitech Display Doctor. It provides certain cards with VESA 2.0
   support. Running with transparencies on is definitely slower because of the
   extra math equations, memory, and video space involved.

Q: Why is there a layer of fog blocking my view?
A: You need to either enable transparencies (see above), or you can disable
   certain backgrounds by pressing the 1, 2, 3, or 4 keys. If you get lost while
   pressing those keys, press 6 to re-enable all of the backgrounds.

Q: Why am I getting error messages regarding VESA 2 drivers?
A: Here is a list of the various error codes that you may be coming across,
   along with descriptions of what they mean:
     * VBE not detected - ZSNES failed to detect any VBE interrupts (Your video
         card doesn't support VESA).
     * VESA not detected - ZSNES failed to detect any VESA extensions (Your
         video card doesn't support VESA).
     * VESA 2.0 or greater required - Your video card supports VESA, but it has
         an older version. You may want to use SciTech Display Doctor
         [http://www.scitechsoft.com/sdd.html] to upgrade your VESA driver.
     * VESA 2 mode does not work on your video card/driver - Meaning that the
         resolution you requested does not exist in the supported resolutions of
         your video card. Choose a different resolution or upgrade with SDD,
         which can sometimes help increase the number of resolutions supported.
     * Unable to initialize video mode - A VESA 2.0 driver is found, but the
         video mode failed to start. There could possibly be an error on the
         video card setting, or it may be a defective piece of hardware.
     * Linear frame buffer not detected - Meaning that your video card does not
         support linear frame buffering, which is required for the ZSNES VESA 2
         routines.

................................
             Sound
................................

Q: Why is there no sound?
A: There could be several situations:

   - You haven't enabled sound. You can enable it through the GUI or through
     zsnes.cfg. Also make sure that 'Disable SPC Emulation' is NOT checked.
   - You need to make sure that the SET BLASTER variable is set properly. To do
     this, type SET in DOS and look for a string starting with "BLASTER=". If
     such a string exists, then this is not your problem.
   - You don't have a SB2.0 compatible sound card. If this is your case, there
     is nothing you can do at the moment. ZSNES uses auto-initialization mode
     for sound which requires SB2.0+.
   - Your SB IRQ conflicts with another device. If this is the case, you might
     want to check your sound card settings through Control Panel -> System.
   - ZSNES doesn't like your sound card.
   - You can try using VDMSound [http://sourceforge.net/projects/vdmsound/].

Q: Are there any plans to improve detection for non-SoundBlaster cards (or
   supporting non-SB cards)?
A: There is little effort put into major changes to the DOS code, since so few
   people use that port these days. However, we will gladly accept anyone's help
   in improving the DOS sound code.

Q: I get a sound initialization error using my SB Live! (or any other PCI card).
   How do I fix it?
A: Here is a solution: (Thanks CyberGodz for the post on the forums!)

   SB Live! uses what is known as a NMI, or Non Maskable Interrupt, to emulate
   SB 16 sound. Don't ask us exactly what it does (it's a type of IRQ) but that
   is pretty much all it is good for.

   The problem is that many sound cards either lack NMI support or don't have it
   enabled (No NMI = No DOS support).

   To try and solve this problem, do the following:

     - Check your BIOS. If there is an option for RAM parity checking, enable
       it; it usually turns on NMI support. If there is something that says
       "NMI", turn it on.
     - If you don't find anything in your BIOS, then go to your motherboard's
       website and download the latest BIOS flash. Install it and try your DOS
       sound (You may still have to enable the stuff in the BIOS afterwards).
     - Failing the first two things, you could either get a new motherboard or
       get another compatible sound card alongside the SB Live!. Just attach a
       cable from the line out of the SB 16 to the line in of the SB Live!.
       Enable line in on the mixer of your SB Live! and it should route the
       sound through the old sound card (Don't use the SPDIF to connect the
       cards if you have one; wave sound doesn't pass through SPDIF--only MIDI).

................................
             Input
................................

Q: Why doesn't my Sidewinder pad work?
A: First, for non-USB Sidewinders, you should disable the Sidewinder profiler
   from the Win9x icon tray, run ZSNES, set Input #1 as SidewinderPad1, then
   press the mode button a few times. If that doesn't work, try the following:

   - Try checking or unchecking the Sidewinder Fix option under
     Config Menu -> Options and repeat the above steps.
   - Fully disable the Win9x Sidewinder drivers by going to Control Panel/Game
     Controllers. Then remove the Sidewinder (Thanks Scarlet-Slider for this
     info!).
   - Run ZSNES under pure DOS.
   - Again, try checking or unchecking the Sidewinder Fix in the options menu of
     the GUI and repeat the above 2 steps.
   - Make sure your Sidewinder is plugged in and is not broken.

   For USB joysticks, you can either set ZSNES as a 6-button joystick or
   simulate keyboard keys through the Sidewinder profiler by setting Input #1 as
   a keyboard with those defined keys.

Q: How do I get my daisy-chained Sidewinder to work?
A: First, run ZSNES. Temporarily disconnect the second Sidewinder pad from the
   first one, get the first one to work, then re-connect the second Sidewinder
   pad.

Q: Why doesn't my Gamepad Pro work?
A: For the non-USB version, be sure to have your Gamepad Pro set on 'GrIP' mode.
   Then set the input device as Gamepad Pro P0. For the USB version, you can use
   a keyboard emulator, which should be included with the software that came
   with your joystick.

Q: Why doesn't my joystick work anymore?
A: You might have accidentally clicked the 'Use Joystick Port 209H' check box.
   Just uncheck it.

Q: Why does JB5/JB6 keep getting pressed whenever I try to change a key?
A: Try changing your joystick type from 6-button to 4-button.

................................
    Freezing/Crashing Issues
................................

Q: Why does ZSNES freeze when I run it under pure DOS?
A: Try loading your mouse driver or run ZSNES using the -j switch. For the most
   compatible result, use the Microsoft Mouse driver if possible.

Q: Why does ZSNES crash when I load a ROM?
A: It could be that ZSNES doesn't recognize your sound configuration. To fix it,
   disable sound or try changing your sound configuration. Also see this
   question: (Universal-->Freezing/Crashing Issues) "Why does ZSNES crash
   as soon as I load a ROM?"

Q: Why does ZSNES freeze when I try to enter the GUI?
A: Run ZSNES using the commandline -j.

Q: ZSNES gives me an "out of memory" error and I only have 16MB of RAM. How do I
   fix this?
A: If you are running the DOS port of ZSNES from within Windows, try restarting
   the computer in DOS mode; more RAM should then presumably be available for
   ZSNES to use. To get it running under Win9x, first create a shortcut to the
   DOS prompt on the desktop (the filename 'target' can be "C:\command.com").
   Next, right-click on the icon and go to Properties. Then, select the Memory
   tab and look below for Protected Mode (DPMI) settings and set a high value
   (like 20000). Last, double-click on that icon and load ZSNES as usual.

................................
         Miscellaneous
................................

Q: I'm using DJGPP 2.03 and I get an error about missing stdint.h. What's wrong?
A: You're probably missing this file. Download the latest version of this file
   and put it in DJGPP's include directory.


. . . . . . . . . . . . . . . .
This documentation is best viewed in a fixed-width font such as "Courier New".

Copyright (C) ZSNES Team & ZSNES Documentation Team [License.txt]