Snes9xGP port documentation v1.08

This readme file is for Snes9xGP v0.97
Snes9xGP is a gp32 port of Snes9x.

*** Don't forget about the new options menu...
 just press start+select after loading a file ***

New in version 0.97
- Even better speed, some more bug fixes, updated sound mixing
- Final version (really!)

Final notes:
- If things look corrupted, try restarting the gp32 -> but run corrupted program first.
- If things look frozen, then wait 5 minutes and see if it comes back.
- If things still don't work, then use fresh batteries.
- If it still don't work, thats too bad :)

- If any artists/game designers/programmers/musicians/translators out
there like original rpgs or shooters, or any kind of game and are
looking for a good team to join, send us a mail before October 15th
at joehol64@hotmail.com. If anyone wants more info, like conditions, etc.,
or is thinking about considering in the future such a project for
publishing, just let us know (reply before Oct. 15, of course!).

This is the final version of our program, and we thank everyone that has
supported us for the entire time.

We understand that there are other coders working on similar projects,
and we wish them good luck.

We hope you like our program! We worked extremely hard.

--Snes9xGP Team

New in version 0.96
- Better speed, faster and clearer sound, new options, and a few bug fixes.
- final version (hey, we can't do this for eternity!)
- not released

New in version 0.95b
- Better speed and added some menu options
- Hey, I need a job, so if anyone has something: --------------
- You can also send emails there for bug reports or suggestions

New in version 0.72a
- Snes9xgp is public again... takes the load off the authors lowly phone modem :)
- Just fixed the in-game menu cursor speeds a little
- For anyone that hasn't used this program in awhile:
don't forget to access the new in-game options menu by pressing start+select

New in version 0.72p private
- Removed those funny numbers from the screen that were in the previous one
- Clear sound

New in version 0.71p private
- Fixed an "auto-magical sound" bug thanks to _cr4sh_

New in version 0.7p private
- In-game options menu (press START+SELECT)
- Fixed many sound bugs
- some assembly optimizations
- don't release my program to anyone or there will be no more versions!

New in this version 0.64a
- Release cancelled
- got 100% speed with sound on a few games

New in this version 0.32a
- (quick fix)Fixed a controller bug (phew!), improved compatibility now :)
- And that's all folks! We thank you all for your support :)

New in this version 0.3b
- Just about zapped all of the gp32 power, to make it any faster you would have to write a program from scratch
- A little more speed
- Final beta
- added option to increase frame skip
- Please report any final bugs

New in this version 0.2b:
- 4MB files can be loaded.
- Higher compatibility rate.
- Improved speed.
- New file select menu.
- Sound, although it only plays at the speed it runs at with sound on!
- Much more!

version 0.1b
- I heard some folks saying that this version was "just to show we had something going" :)


If you want to write to a save file, you must save in the menu before
turning off your gp32.  Access the menu by pressing start+select
after loading a file.


We hope everyone likes our new version!
--Snes9xGP team


Finally... after all the doubt and all the rumors... snes9xgp, the gp32
port of snes9x, is finally here.


The latest version of this program can always be found at the official
snes9xgp site:
http://www.snes9xgp.com02.com/





Important:
*Put all the .smc and .srm files into the "GPMM" directory.*

When you first load the program... it displays a screen that lets you
select the .smc file you wish to load from the "GPMM" directory. Do not
select another directory, just a file.

And... it only loads .smc (with .srm file in same directory if there is one)
files... don't try to load files with any other extension.

If there is a .srm file that corresponds to the .smc file... make sure you
put that in the "GPMM" directory, too... otherwise you may get problems.
Oh yeah... and make sure the .smc and .srm file have identical names.

The maximum size of a file that you can load is 4MB.

Instructions:
 To change sound, key, and frameskip settings, press start+select. I
usually do this by holding start and pressing select or holding select
and pressing start.

The four button configuration is good for games that use 4 buttons or less.
It lets you map the gp buttons a, b, l, and r to any snes buttons you choose.
If you don't want to map that button (say, if that game doesn't use that
button), then just press the SELECT key. In the 4 button configuration,
the gp START and SELECT buttons work as the snes START and SELECT buttons.

The 6 button configuration lets you create 2 different 5 button mappings,
so that if a game requires you to use all six buttons... and some buttons
need to be pressed at the same time... you can have a button mapped more
once. In the 6 button configuration, START and SELECT also get mapped.
During the game in the 6 button configuration, the SELECT button toggles
the mappings between button mapping 1 and button mapping 2. The number
of the mapping is shown in the upper left hand corner of the screen.


If everything was done correctly and the .smc file is 4MB or less, then it
should run.
Hint: there are only one or two .smc files in existence that exceed 4MB.


Special thanks to Costis and mr. spiv for testing the pre-release beta
and giving me suggestions. And thanks to DKM for designing and maintaining
the official snes9xgp site.

And thanks to the folks in #gp32dev who verified that most files work
on this thing :)

Special Thanks to:
DKM - maintains official snes9xgp page and provides artwork for snes9xgp
mr_spiv - provided code and utilities for clk speed and sound, the code guru man!
pekele - The man we most trust with testing our stuff :)
Costis - testing, suggestions
Don_Migue - testing, suggestions
groepaz - we use his code for the sound
DarkFader - we use the gcc file i/o lib on his site
and everyone else who we just forgot to mention.



PLEASE READ:
  This software is provided 'as-is', without any express or implied
  warranty.  In no event will the author(s) be held liable for any damages
  arising from the use of this software.

  Permission is granted to anyone to use this software and redistribute it
  freely, subject to the following restrictions:

  1. The origin of this software must not be misrepresented; you must not
     claim that you wrote the original software. If you use this software
     in a product, an acknowledgment in the product documentation would be
     appreciated but is not required.
  2. Altered source versions must be plainly marked as such, and must not be
     misrepresented as being the original software.
  3. This notice may not be removed or altered from any distribution.


This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.


