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

                  *** MySNES 0.03b ***  

                   Created by Martin Johansson
                  email: f94majo@dd.chalmers.se

  official homepage: www.dd.chalmers.se/~f94majo/MySNES/MySNES.htm

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

	-1. WHAT'S NEW
	 0. How to install
	 1. What is this?
	 2. What is emulated?
	 3. Requirements
	 4. How to use emulator and debugger
	 5. Demos that show decent gfx
	 6. Thanks to



-1. WHAT'S NEW
----------------

	* New GUI with Continue button. You can escape from a game and
	   debug for a while, then CONTINUE.
	* Scrolling of all bg's, pixelwise in mode 0 and 1 (decreses speed
	   a bit).
	* Screen size: 32x64, 64x32, 64x64 (i.e. all sizes incl. old 32x32).
	* Sprites: 16x16, 32x32, 64x64 (all sizes incl. old 8x8).
	* New memory map
	* DMA modes 0 and 2

	- Alot of new code needs optimizing.



0. How to install
-------------------

	* copy directory "marble" and file "marble.font" to your font-directory
	* start MySNES.EXE



1. What is this?
------------------

 This is (becoming) a SNES emulator for Amiga.

 Before using this program, please note that:

	* it will not load more than 8 Mbit/1 Mbyte (even if the rom is bigger)
	* it assumes that the rom is in .smc-format, no matter what the extension says
	* it is still rather slow
	* it requires an Amiga with 68020, AGA chipset, at least 4 Mb of ram and reqtools.library
	* I take no responsibility for any damage this program may cause on your computer
	* I don't want rom-requests



2. What is emulated?
-----------------------------------------

	* Full CPU-65816 instructionset
	* Mode 0, 1 and 3 with 8x8 tiles (not 16x16)
	* Screen size 32x32, 32x64, 64x32, 64x64
	* Scrolling in Mode 0 and 1 all bgs
	* Sprites 8x8, 16x16, 32x32, 64x64
	* NMI = vertical blank interrupt
	* Multiply/divide registers
	* Joypad 1 via keyboard (see 4. Keys)


3. Requirements
-------------------

	* Amiga with 68020, AGA, around 4 Mb and reqtools.library
	* Roms in .SMC format



4. How to use emulator and debugger
-------------------------------------

	4.0 Gadgets
	-------------

	* Frameskip = nr. of frames to skip before every frame are rendered
	  frameskip = 0 => all frames are rendered

	* Hcycles% = how many of the 206 horiz.machine cycles you want to do
	  before entering Hblank and jumping to next line.
	  (Many demo roms only need about 50)


	4.1 *** EMULATOR keys ***
	---------------------------

	        F1 - BG1 on/off
	        F2 - BG2 on/off
	        F3 - BG3 on/off
	        F4 - BG4 on/off
	        F5 - SPR on/off
	       Esc - quit emulator
	Left Amiga - Start
	  Left Alt - Select
	         Z - Y button
	         X - X button
	         C - B button
	         V - A button


	4.2 *** DEBUGGER keys ***
	---------------------------

	     STEP - perform instruction at ProgramCounter and goto next instr.
	    STEPS - choose how many instr. to execute with STEP
	NEXT LINE - run until we reach next instr. 
		     (useful if you don't want to follow a jsr instr)
	space key - break if running (after using "next line" gadget)
	 PLUSSIGN - increment ProgramCounter by one
	MINUSSIGN - decrement ProgramCounter by one


5. Demos that show decent gfx (no scroll implemented yet)
----------------------------------------------------------

	* infinity.smc
	* unknown.smc
	* sonic.smc
	* intro-1.smc
	* intro-2.smc
	* intro-3.smc
	* magical.smc
	* censor.smc
	* taurus.smc
	* cdi.smc
	* dwarf.smc
	* tictac.smc	(fully playable!)
	* wa-chess.smc	(seems ok, I can't start playing in Snes9x either)
	* bluesky.smc
	* FinalFantasy 2 (only titlescreen)
	* smile!.smc
	* s-snake.smc	(playable!)
	* rpg1.smc	(freezes when map starts to scroll)
	* rapegame.smc	(playable!)

	* 15puzzle	(fully playable!)
	* Bioworm	(fully playable!)
	* Nuke		(playable)
	
	.. (actually I know a lot more that starts now) ..



6. Thanks to
---------------

	* Morgan "A/NES" Johansson for codes, ideas and testing
	* Savoury SnaX, author of SNEeSe (SNES emulator for PC), for docs on the 65816
	* Yoshi, for the technical docs on SNES
	* Tomas Amsrud for the Icons
	* Jesper Svennevid for the competition with AmiSNESE
	* All other people that have helped


 Martin Johansson, email: f94majo@dd.chalmers.se
     (Please don't ask for commercial roms)