Snes9x: The Portable Super Nintendo Entertainment System Emulator
=================================================================
v1.25 SEPTEMBER-1999
=======================
Home page: www.snes9x.com


Information
===========
This file contains DOS-port specific information.
Read readme.txt for more information.


Changes to DOS port
===================
1.19 to 1.25
------------
-New Image Processing engines:
 Got a fast 450mhz PC and think 3dfx mode looks great? Take a look at this!
        2xSaI FULL SCREEN !!
        2xSaI FULL SCREEN + Grid !!
 Slower than 3dfx though, since it's all done in software.
-Added presets for the above full screen engines for some games, which
 normally wouldn't fill the entire screen. [e.g. Chrono Trigger]
-The DOS port now uses the SEAL library for sound.
-Added reverse stereo option [edit the .ini file].
-Added rapid fire. Press CTRL+[SNES key] to enable/disable for that key.
-Added cheat dialogs from the old [0.xx] GUI. Nothing seems to be working
 though....

See Changes. to see what's new in Snes9x.


Keys
====
Here's a list of keys that which can be used in the emulator:

ESC             Hide/Unhide the GUI
F1              Save SPC
F2              Save a game using a slot
F3              Select a slot to Save/Load
F4              Load a game using a slot
F9              Capture Screen to a .bmp file
F10             Change Scaling Preset. [see below for more info]
F11             Change Renderer [see below]. Interpolation needs to be enabled
F12             Change Renderer [see below]. Interpolation needs to be enabled
ALT+F1          Show frames per second [fps]
ALT+F2          Load game from a file you specify
ALT+F3          Save game to a file you specify
SCROLL LOCK     Pause


See readme.txt for more keys which are not covered in this document.



When interpolation is enabled [-y]
==================================
The renderers are:
1. No renderer: Normal 2x Scale
2. TVMode:      25% scanlines [default renderer in modes 10 and 12]
3. 2xSaI:       \
4. Super2xSaI:  | Non-linear 2x Scale Engines. 
5. SuperEagle:  /
6. Interpolation: Standard "blur" filter.
7. Full Screen: Normal Stretch
8. 2xSaI Full Screen + Grid: Same as below, but only rendering
   half the pixels [a lot faster].
9. 2xSaI Full Screen: Special version of 2xSaI which scales to Full Screen

Press F11 to go up the list. Press F12 to go down the list.
These buttons do nothing when interpolation is not enabled.

Renderers 1 to 6 only work in screen modes 10 and 12.
Renderers 7 to 9 work in screen modes 9,10,11 and 12.

2xSaI and SuperEagle use MMX instructions when an MMX CPU has been detected.
A 266-300Mhz+ system is recommended for 2xSaI, SuperEagle and Super2xSaI.

2xSaI Full Screen is a real CPU cruncher [400mhz+ recommended].
Use the version with the grid for a lot more speed !
Image quality improves [and speed decreases] with higher resolutions.
320x240 looks bad, 512x384 looks okay, 640x480 looks better, 800x600 etc.
Recommended is a resolution of 640x480 or 512x384.



About Scaling presets
=====================
Some games will not entirely fill the whole screen when renderers 7,8 or 9
are selected. Try pressing F10 to remedy this problem. Note not that this
won't always work :(, as it is impossible to have presets for all games.
These are just presets for some of my favorites :).

Default SNES Width/Height = Auto/Auto.
Press F10 1 time: Width/Height = Auto/211 [e.g. Chrono Trigger]
Press F10 2 times: Width/Height = Auto/192 [e.g. SuperStreetFighter2, GundamWing]
Press F10 3 times: Width/Height = Auto/198 [e.g. X-Men: Mutant Apocalypse]
Press F10 4 times: Width/Height = 240/214 [e.g. Final Fantasy 3, Terranigma]
Press F10 5 times: Width/Height = 224/190 [e.g. StarFox]

If you want more presets in the next version, make a snapshot of the SNES
image [and NOT of the screen]. Measure [in pixels] the width and height of
the actual picture [Don't measure the black bands], and the horizontal
and vertical offsets.


Known bugs
==========
There are a few bugs in this emulator which are known by the
authors and are being worked on, for your reading pleasure a 
list is given here:
-Changing resolutions from within the GUI causes crashes.
 [When it says it might crash, it probably will!!]
-Selecting the Sound Blaster AWE32 driver will cause Snes9x to run very slow.
 Select SoundBlaster, SoundBlasterPro, or SoundBlaster16 instead.
-Sometimes the GUI hangs when a ROM is loaded from the command line.
 Start Snes9x, wait for the GUI, and then load the ROM!
-SyncSound does nothing right now. It's not yet implemented.

-----------------------------------------------------------------
Kreed [derek-liauw@usa.net]
TeleKawaru [telekawaru@snes9x.com]
http://www.snes9x.com
