Gunstar Heroes GG2SMS port
--------------------------
v0.1 (c) 2017 by FRS, all rights reserved

This patch implement the following:

- Two versions: one with a normal palette tweaked to show all the details in the SMS, and one
  that uses the 3D glasses to expand the SMS perceived palette to 261 colors, thus making the
  colors closer to the original GG game. Due to the persistence of vision, the effect also
  works without the glasses, but some flickering will be noticed. 
- Removed a software lock that caused trouble to run the game on the Master Everdrive
- Garbage was removed from nearly all screens
- Enabled the left column masking
- PAUSE button support
- Button-1 of the 1st joypad now acts as START when needed. Moved the text speedup to the 2nd
  button.
- The 2nd joypad has SELECT on its button-1, and PAUSE on its button-2.
- Megadrive joypad support. When one is used, the C button acts as SELECT and the START button
  will pause the game accordingly. There's no need to use two joypads anymore
- Enlarged screen area.
- The Sega logo screen now can be skipped

But the patch is far from finished and still has some known glitches:

- Some elements have an offset when compared to the background. Specially the hitboxes of
  the houses in the 1st stage and their smoke after they explode.
- Some graphical glitches still occur at some specific points in some stages, notably on
  the pyramid of the 1st stage, and when almost reaching some bosses

==============================
How to apply the patch

First, make sure you have the original japanese ROM, which has the following checksum:

SHA1(Gunstar Heroes (J).gg)= c373d3876659095bb869ff0e4bb7ffc68123cf3e

You can use the following tools to verify the SHA1 checksum:
- Windows:
  -MD5 & SHA-1 Checksum Utility 1.1
  - HashTab
- Mac OS-X:
  - DropHash
  - HashTab
  - (or use the Linux solution below)
- Linux:
  - Just type on a shell: openssl dgst -sha1 MYGAME.ROM


==============================
Special Thanks

- The Meka emulator coders,for their excellent emulator and debugger
- The SMSpower! crew, for the place where MSX hobbysts can meet and exchange ideas
- Sjoerd Mastijn and Aprisobal, for the SjASMPlus assembler
- FiXato, for compiling many development tools I use on Mac OS-X

==============================
FAQ
---

Q: I applied the patch and the resulting ROM doesn't work! What is wrong?
A: You're probably trying to apply the patch on a ROM with the incorrect
   checksum.

===========================================================================
	                     License
                           Terms of use
---------------------------------------------------------------------------

1) This patch is gratis for non-commercial purposes, and the author retains
   its copyright. You only can run, make backup copies or distribute the patch
   while observing the non-commercial restriction.

2) You are only allowed distribute the patch files (online or on a removable
   media) under the following conditions:
   2.1) No commercial transaction of any kind is involved
   2.2) All the included files are distributed together inside the same
   compressed file.
   2.3) This README must be included unmodified inside the same compressed file.

3) If you want to use this patch for commercial purposes you MUST contact me
   first to negotiate the terms and conditions. Send an e-mail to
   sdsnatcheralpha@gmail.com to contact me.

4) You cannot distribute ROMs with this patch applied on them.

5) This patch is provided ‘as-is’, without any express or implied warranty.
   In no event will the author be held liable for any damages resulting from the
   use of this patch or the software patched with it.

6) USE THIS SOFTWARE SOLELY AT YOUR OWN RISK.


===========================================================================
                          Donations
---------------------------------------------------------------------------
 If you like the enhancements and fixes here presented and want to show your
 appreciation by donating any amount, or MSX/SMS hardware, it will be very welcome
 and will help future developments.
 Donations can be done via PayPal to sdsnatcheralpha@gmail.com, and for MSX
 hardware, try contacting me on this e-mail address too.

 Have a look at my wishlist in the following link:
 http://frs.badcoffee.info/wishlist.html

