
     The SNES emulator SNEeSe version 0.16f released on  19 September 1998
       -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

!!READ THIS!!
"""""""""""""

  I had never imagined that Version 0.16a would be the last proper release
of SNEeSe, I had planned for so much more, however it has become the case.
This release (SNEeSe Version 0.16f) marks the end of SNEeSe development
for myself, and since I have been out of touch with the emulation world, it
could well be the last ever!
  This code is not complete, it does not contain anything to emulate FX or 
DSP, the sound code has not changed at all and the GUI load function will
still not work as well as the commandline load function. I have made NO code
input to this version, all work has been done by Charles Bilyue. 
  The reasoning behind this last release is quite simple, the code has been
decaying on my hard drive for over 3 months and my new job and other
hobbies leave little time to develop this project further. Besides which
this project is just too damn complex (and messy) for me to make much head-
way anymore.


  So to all those numerous people who have supported this project in the 
past and to those who just have to obtain the newest versions of emulators
no matter how slow, I leave this version. Thanks for all the support and
perhaps a future system will take my fancy and I will be back, but for now
goodbye and good luck to all the authors of emulators world wide!

				Savoury SnaX - Lee Hammerton

Credits
"""""""

 Savoury Snax           - Overall Development, testing. (Upto V0.16a)
 Charles Bilyue		- IRQ, HDMA, bug fixes + final version 0.16f
 Santeri Saarimaa       - GUI Improvements, testing.
 Shawn Hargreaves & co. - Allegro 3.0 library!

Greets
""""""

 archeide,Tim Riemann, Brad Martin, Qwertie, Martijn Kersbergen, B. Walker,
 Paul Robson, Aquarius-1, D.Kieselhof, _zsknignt, demo, Pastor M.M. Angel,
 Yoshi, Albert LLoyd Sawyers, Zachary Williams, Lord ESNES, Jonathan Turner,
 W/\re\/\/0lf, James Cartrette, Duncanthrax, rRNA, Dark Claw, Poiple Shadow,
 Flash, Windwalker, Chris Lacey, MaJiC, Dark Elf, Shade + any I forgot.

--------------! For True SNES Emulation Buy A SNES ;-) !--------------

Quick list of new things in 0.16f
"""""""""""""""""""""""""""""""""

 - Compatability is vastly improved, more roms play music, new
  screen modes available and bug fixes etc... Its been so long
  I can't remember I'm afraid!

 - If I remember correctly pushover now works correctly!

Requirements To Run
"""""""""""""""""""

Here is a rough guide to the things you need to run this emulator:

 - 4-12 megabytes of memory (dependant on rom size).

 - A lot of patience, this emulator is lower than beta stage and is slow and
   incomplete.

 - VGA graphics card capable of mode 13h, ie a VGA gfx card ;-)

 - A reasonable monitor (if you want to use MODEX modes!).

 - IBM PC compatible.. you guessed didn't you? Must be at least a 486!!!

 - Some SNES rom images to try out. We will NOT give images due to copyright
   laws.

 - A Sound Blaster compatable sound card, only needed if you enable SPC
   with sound emulation.

 - A VESA 2 compatable video card capable of 640x480x16bit. You could also
   try a software VESA 2 driver (like univbe). This is only needed if you
   (for some insane reason!!) want to use hicolour mode (at present the only
   difference is its slower!).


The config file
"""""""""""""""

 A config file is now used so SNEeSe remembers what state it was in when the
user quit. It can be edited in dos for those interested, only a few config
options exist at present sorry!

 If you want to use the standard .SRM extension for save ram files instead
of SNEeSe's .RAM (exists to prevent corruption of saved files (incase of
bugs)) simply edit the SNEeSe.CFG file and change the line :

saveextension=RAM

to

saveextension=SRM

 Simple eh?


The GUI
"""""""

 The GUI can be opened by pressing ESC during emulation. From here you
can RESUME emulation, RESET the emulation, LOAD a new SNES rom into
the emulator, setup the CONFIGURATION options (see below) and EXIT the
emulator. Pressing ESC while in the GUI closes the current window, if
the last window is closed, emulation resumes. To move the bar use the
cursor UP/DOWN controls, to choose an option press ENTER (either one
will do). In the loading option PAGE UP/PAGE DOWN allow you to travel
through the listing faster than UP/DOWN.

 The CONFIGURATION menu allows you to change some features of the
emulation as follows:

  ???x???x???              - The first option in the list this will
                             show the current resolution as its text.
                             When you press ENTER then a window will
                             open allowing you to choose a new
                             resolution. If the resolution cannot be
                             opened it will revert to standard mode.

  Frameskip: ?             - You can modify the amount of frames to
                             skip by pressing left or right arrow.
                             Default is 4 (show every 4th frame), you
                             would probably need a P2/375 to keep 1 here.

  Keyboard on player 1     - This option toggles joystick or keyboard
                             mode for controller 1. Now toggles to
                             mouse support, in mouse mode joypad will
                             still function using keyboard controls.

  Keyboard on player 2     - This option toggles joystick or keyboard
                             mode for controller 2. NB: Only 1
                             joystick is supported so don't map it to
                             both!!! Also toggles to mouse support.

  Define keys for player 1 - This option lets you redefine the
                             keys for controller 1. Since version 0.15
                             this has been done through the GUI, it
                             shows a nice picture of the SNES joypad
                             and asks the keys. You can press ESC
                             anytime to stop redefining.

  Define keys for player 1 - This option lets you redefine the
                             keys for controller 2.

  Emulate SPC              - Enable/Skip SPC emulation. Must be
                             enabled with below option for sound.

  Sound Enabled            - Enable/disable sound output when
                             emulating the SPC. Selects mono or
                             stereo too, NB stereo uses 2* more
                             voices so not all cards / systems
                             may support it.

Readme Or Dont Bother Emailing Me
"""""""""""""""""""""""""""""""""

 The SNEeSe project is at an end, the homepage will stay up (hopefully for
many years to come) but no new developments will be released!

 When you attempt to run a rom you should take note of any information
displayed on the screen. For instance if a rom just bombs back to dos and
all the information displayed looked like rubbish the rom image format may
not be supported by the emulator.

 To run the demonstration type SNEESE.EXE and then the file name of the rom
to load (leave a space ie. SNEESE.EXE file).Once the rom title is displayed,
press a key to start the emulation.

 To exit emulation press ESC. A new GUI will pop up and you should select
EXIT using the cursor keys, press ENTER to select the option under the bar.

 Feel free to email me (but not about bugs etc because development has
ceased) at :

	savoury.snax@usa.net

Or you can visit the SNEeSe homepage at :

        www.fortunecity.com/olympia/baberuth/24/index.html

The source code for SNEeSe is found at the above address too.

 Any email about obtaining copyright ROMs will be forwarded to the
appropriate authorities, so dont even bother!


What can SNEeSe do in this version of the program ?
"""""""""""""""""""""""""""""""""""""""""""""""""""

Implemented features follow:

 - 254/256 opcodes (not instructions) implemented. The last two remain
   unimplemented since they do nothing too important and can help detect
   runaway roms!

 - Memory mappings for lo-rom modes done including SRAM.

 - Memory mappings for hi-rom modes done including SRAM.

 - DMA operations 0-4, 5-7 are supported but may not be correct.

 - Video Modes 0-7, tile flipping and palette mapping + most special
   attributes (like 16x8 tiles and offset change) are supported also
   tile priorities are supported.

 - NMI interrupt running although timings may be a little out.

 - IRQ interrupt running although timings may be a little out.

 - Keyboard working as follows :
				Cursor Keys	- joypad direction
				Q,W		- L & R Buttons
				N,M		- SELECT & START
				A,S		- Y & X Buttons
				Z,X		- B & A Buttons
				ESC		- Open GUI
				1-4		- Toggle BKG 1-4
				5		- Toggle Sprites
				0		- Save PCX piccy

 - SNES Joypads 1 & 2 are supported.

 - A 4 or 6 Button joystick (joypad) can be used in place of the keyboard,
   selectable from the GUI.

 - All hardware registers should now be done ('cept some undocumented stuff).

 - Sprites are supported 8x8,16x16,32x32,64x64 + name and base and priority
   rotation.

 - Screen Sizes 32x32,64x32,32x64 & 64x64 supported.

 - Addition of a squashing copy routine so entire SNES screen is visible on
   a standard VGA mode screen..

 - Backgrounds can be disabled using keys 1-4 for BKGs 1-4, and sprites can
   be disabled using key 5. These are toggle controls.

 - SPC processor support. Only TCALL, BRK and BCD instructions are not
   supported yet. Sound emulation exists for many roms.

 - Its got a gui, for those who care & a config file.

 - HDMA operations 0-4 now implemented. Absolute and indirect (NB indirect
   is still buggy).

 - Mouse support is working for those roms that use it.


Playable Roms ?
"""""""""""""""

 The following are a sample of game roms known to work to some extent
(please dont laugh.. this is a SNES emu in its very early stages!):

 Pacman (The elitendo PD Rom)       - Completely playable! + Sound.
 7th Saga              - Somewhat playable. + Sound.
 Actraiser             - Disable SPC emulation and it Works.
 Cartoon Addams        - Works! + Sound.
 Contra 3              - Not sure, sometimes works sometimes doesn't.
 Pushover              - Playable, but cant go to second level!
 SD The Great Battle   - Disable SPC emulation and it Works.
 SimCity               - Works! + Sound.
 Super Ghouls & Ghosts - Disable plane 3 and SPC emulation and its ok!
 Super Mario World     - Works! + Sound.
 Super Valis           - Sprites Ok, BKGs not! Not sure why ?
 Wheel Of Fortune      - Works! + Sound.
 Whirlo                - Works! + Sound.
 Zelda 3               - Works! + Sound - No windowing so not completable!


History
"""""""

  SADLY HISTORY IS NOW A THING OF THE PAST (oh dear!) I HAVE NOT HAD TIME
 TO UPDATE THIS SECTION AND NOW FORGET WHAT HAS HAPPENED AND WHEN SORRY !!

