readme.txt

著名SFC模拟器Snes9x的源代码。

   of the SNES display. The value before the slash (/) indicates how many
   frames per second are being rendered compared to a real SNES, the value of
   which is displayed after the slash.

Sound options:
-ns or -nosound
   Disable sound CPU emulation and sound output, useful for the Starfox 2 beta
   floating around that has corrupt sound CPU code, causing the game to hang
   with sound emulation turned on. Disabling sound also speeds up emulation
   speed, at the expense of no music or sound effects during the game and
   reduced game compatibility.
-sk 0-3 or -soundskip 0-3 (default: 0)
   ONLY USED IF SOUND IS DISABLED. The algorithm to use when trying to fool
   a ROM into thinking that the SPC700 sound CPU is there when actual emulation
   of it is turned off (for speed reasons).
-stereo or -st (default: stereo)
   Enable stereo sound output.
-mono (default: stereo)
   Enable mono sound output. Slightly faster, but doesn't sound as nice.
-r 0-7 or -soundquality or -sq 0-7 (default: 4)
   Sound playback rate/quality:
       0 - disable sound, 1 - 8192, 2 - 11025, 3 - 16500, 4 - 22050 (default),
       5 - 29300, 6 - 36600, 7 - 44000.
-envx or -ex (default: off)
   Enable volume envelope height reading by the sound CPU. Can cure sound
   repeat problems with some games (e.g. Mortal Kombat series), while causing
   others to lock if enabled (eg. Bomberman series). Use with -sy option below
   to fix the problems this option can otherwise create.
-ts or -threadsound
   Starts to feed data to the sound card using a separate thread rather than
   using timers, signals and polling. Use to work around a bug in the beat Sound
   Blaster Live Linux driver that keeps telling Snes9x that the sound card
   can accept more sound data, when it actually cannot and Snes9x slows down
   or locks up. A multi-CPU system could benifit from using this option - 
   sound processing could take place on another CPU for speed.
-sy or -soundsync
   Turns on sound-sync code where sound data is generated in sync with the
   emulation of the SNES sound CPU instructions. Slightly slower emulation speed
   but helps reduce note and sound effects timing problems and one or two 
   games actually require this mode, notably Williams Arcade Classics.
   Also turns on interpolated sound and envelope height reading.
   Pressing the ']' key during gameplay toggles sound-sync only on and off.
   Not very effective/useless when thread sound is enabled due to mutex data
   locking timing problems.
-is or -interpolatedsound (default: off)
   Turns on interpolated sound. Any samples played at a lower frequency than
   the current playback rate (-r option) have additional sample points
   computed and played where previously the same sample data was played
   repeatedly. Lower frequency sounds have improved bass and sound much less
   harsh - I suspect the real SNES does this.
   Pressing '[' during gameplay toggles the feature on and off.
-b size or -buffersize size or -bs size (default: auto-select)
   Sound playback buffer size in bytes 128-4096.
-nosamplecaching or -nsc or -nc (default: on)
   Disable decompressed sound sample caching. Decompressing samples takes time,
   slowing down the emulator. Normally the decompressed samples are saved
   just in case they need to be played again, but the way samples are stored
   and played on the SNES, it can result in a click sound or distortion when
   caching samples with loops in them.
-alt or -altsampledecode (defalt: off)
   Switch to using Anti Resonance's sample decoding method. Some games, 
   notably Squaresoft RPG games, make use of a SNES hardare sample decoding bug/
   feature to generate wind and swish-type sound effects; selecting this option
   enables code that tries to simulate the feature. The disadvantage is that
   it can decode some 'normal' samples incorrectly.
-noecho or -ne (default: on)
   Turn off sound echo and FIR filter effects. Processing these effects can
   really slow down a non-MMX Pentium machine due to the number of calculations
   required to implement these features.
-ratio 1+ or -ra 1+ (default: 2) (OBSOLETE)
   Ratio of 65c816 to SPC700 instructions. The value is no longer used
   because SPC700 cycle counting is now implemented giving much more accurate 
   timing.
-nomastervolume or -nmv (default: on)
   Disable emulation of the sound DSP master volume control. Some ROMs set
   the volume level very low requiring you to turn up the volume level of
   your speakers introducing more background noise. Use this option to
   always have the master volume set on full and to by-pass a bug which
   prevents the music and sound effects being heard on Turrican.

Cheat options:
-gg <code> or -gamegenie <code>
   Supply a Game Genie code for the current ROM. Up to 10 codes can be in
   affect at once. Game Genie codes for many SNES games are available from:
   http://vgstrategies.miningco.com/games/vgstrategies/library/ggn/bl_ggnsnes.htm
-ar <code> or -actionreplay <code>
   Supply a Pro-Action Reply code for the current ROM. Up to 10 codes can be in
   affect at once. At the moment, codes which alter RAM do not work.
-gf <code> or -goldfinger <code>
   Supply a Gold Finger code for the current ROM. Up to 10 codes can be active
   at once.

Speed up/slow down options: (See "Speeding Up The Emulation")
-f <frame skip count> or -frameskip <frame skip count> (default: auto-adjust)
   Set this value to deliberately fix the frame skip rate and disable auto-
   speed regulation. Use a larger value faster emulation but more jerky
   movement and a smaller value for smooth but slower screen updates.
   Use '+' and '-' keys to modify the value during a game.
   Ideal for some Super FX games that confuse the auto-adjust code or
   for games that deliberately flash the screen every alternate frame.
-frametime <time in milliseconds> or -ft <time in milliseconds>
   (default: 16.6ms NTSC games and 20ms for PAL games)
   If auto-adjust frame skip option is in effect, then the emulator will try
   to maintain a constant game and music speed locked to this value by skipping
   the rendering of some frames or waiting until the required time is reached.
   Increase the value to slow down games, decrease it to speed up games.
   During a game the value can be adjusted in millisecond steps by pressing
   Shift '-' or Shift '+'.
-h <0-200> or -cycles <0-200>(default: 100)
   Percentage of CPU cycles to execute per scan line, decrease value to
   increase emulation frame rate. Most ROMs work with a value of 85 or above.
-j or -nojoy
   Turn off joystick, SideWinder and GrIP detection (joystick polling on the
   PC slows the emulator down).

ROM image format options:
-i or -interleaved (default: auto-detect)
   Force interleaved ROM image format.
-i2 or -interleaved (default: can't be auto-detected)
   Force alternate interleaved format (i.e. most Super FX games).
-hirom or -fh or -hr (default: auto-detect)
   Force Hi-ROM memory map for ROMs where the Hi-ROM header test fails.
-lorom or -fl or -lr (default: auto-detect)
   Force Lo-ROM memory map for ROMs where the Hi-ROM header test fails)
-header or -hd (default: auto-detect)
   Force the detection of a ROM image header. Some ROM images have been 
   hand-edited to remove unused space from the end of the file; if the
   resultant image size is not a multiple of 32k then Snes9x can't 
   auto-detect the presence of a 512 byte ROM image header.
-noheader or -nhd (default: auto-detect)
   Force Snes9x into thinking no ROM image header is present. See -header
   above.
-p or -pal (default: auto-detect)
   Fool ROM into thinking this is a PAL SNES system and adjust frame time
   to 20ms (50 frames per second)
-n or -ntsc (default: auto-detect)
   Fool ROM into thinking this is a NTSC SNES system and adjust frame time
   to 16.7ms (60 frames per second)
-l or -layering (default: off)
   Swap background layer priorities from background involved in sub-screen
   addition/subtraction. Can improve some games play-ability - no need to
   constantly toggle background layers on and off to read text/see maps, etc.
   Toggle feature on and off during game by pressing '8'.
   Not used if transparency effects are enabled.
-l <freeze game file name> or -loadsnapshot <freeze game file name>
   Load snapshot file and restart game from saved position.
-nh or -nohdma (default: H-DMA enabled)
   Turn off the H-DMA emulation. Pressing '0' during a game toggles H-DMA on
   and off.
-n or -nospeedhacks (default: speed hacks)
   Turn off a couple of speed hacks. The hacks boost the speed of many ROMs
   but cause problems a few ROMs.
-nw or -nowindows (default: graphics windows emulated)
   Disable graphics windows emulation. Use 'backspace' key during a game to
   toggle the emulation on and off.

Joystick options:
-joymap[1|2|3|4] followed by 8 numbers
   Specify the SNES joypad buttons to Linux joystick driver buttons mapping for
   each of the four supported joypads.
   Specify the Linux joystick button number for the corresponding SNES button
   in the following order: A, B, X, Y, TL, TR, Start and Select
   The default map is: 1 0 4 3 6 7 8 9 
   which is suitable for Sidewinder gamepads.
-s or -swap
   Swap emulated joy-pad 1 and 2 around, pressing '6' during a game does the
   same thing.
-j or -nojoy
   Turn off joystick, SideWinder and GrIP detection (joystick polling on the
   PC slows the emulator down).

For example, to start a game called "mario", with sound, and transparency
effects, type:

snes9x -tr mario.smc

Keyboard Controls
=================

While the emulator is running:
'Escape'                 Quit the emulator
'Pause' or 'Scroll Lock' Pause the emulator
Alt+'f' or PrtSc	 Toggle the Linux X11 port full-screen mode on and off.

Joy-pad 1:
'up' or 'u'             Up direction
'down', 'j' or 'n'      Down direction
'left' or 'h'           Left direction
'right' or 'k'          Right direction
'a', 'v' or 'q'         TL button
'z', 'b' or 'w'         TR button
's', 'm' or 'e'         X button
'x', ',' or 'r'         Y button
'd', '.' or 't'         A button
'c', or 'y'             B button
'return'                Start button
'space'                 Select button

'Mouse left'            Mouse left button or SuperScope fire button.
'Mouse right'           Mouse right button or SuperScope cursor button.

'tab'                   Emulation turbo speed button for skipping past long
                        ROM intros.
'`', '~' or '#'         SuperScope turbo toggle switch.
'/'                     SuperScope pause button.

'0'                     Toggle H-DMA emulation on/off.
'1'                     Toggle background 1 on/off.
'2'                     Toggle background 2 on/off.
'3'                     Toggle background 3 on/off.
'4'                     Toggle background 4 on/off.
'5'                     Toggle sprites (sprites) on/off
'6'                     Toggle swapping of joy-pad one and two around
'7'			Rotate between Multi-player 5, mouse on port 1,
                        mouse on port 2 and SuperScope emulation.
'8'                     Toggle background layer priorities for backgrounds
                        involved in sub-screen addition/subtraction.
'9'			Toggle transparency effects on and off - only if
			16-bit screen mode selected.
'Backspace'		Toggle emulation of graphics window effects on/off.

'-'			Decrease frame redraw skip rate
'+'			Increase frame redraw skip rate
			The sequence is auto-frame rate adjust, render every
                        frame, render 1 frame in two, render 1 frame in three,
                        render 1 frame in four, etc.

Shift+'-'		Decrease frame time in 1ms steps.
Shift+'+'		Increase frame time in 1ms steps.
			The frame time value is the average length of time a
			single frame should take to emulate - works only if
			the auto-frame rate adjust is operational.
			The code will skip the rendering of some
			frames in order to try and reach the required value.
Shift+'F1-F10'          Quick save a freeze game file.
'F1-F10'                Quick load a freeze game file, restoring a game to an
                        exact position.
Alt or Ctrl+'F1'        Save the state of the SPC700 sound CPU into a file
                        called <romname>.spc. Separate programs are available
                        that can load and then 'play' these state files. Ideal
                        for 'ripping' music from a game and playing it at a
                        later date.
Alt/Ctrl+'F2' or 'F11'  Load a game's saved position.
Alt/Ctrl+'F3' or 'F12'  Save a game's position.

Alt/Ctrl+'F4' -> 'F11'  Toggle sound channels on/off.
Alt/Ctrl+'F12'          Turn on all sound channels.

Joystick Support
================

The Linux port makes use of the v1.x joystick kernel drivers written by
Vojtech Pavlik ([e-mail]) to allow the use of a wide varity of different
joystick/joypad types to control SNES games.

If you are still using the older versions of the drivers, you can download the
latest driver version from http://atrey.karlin.mff.cuni.cz/~vojtech/joystick/

Refer to the documentation that comes with the drivers to enable support for
your type of joystick/pad in Snes9x.

Game Saving
===========