8888888b.          .d8888b.  888b     d888  .d8888b.  
888  "Y88b        d88P  Y88b 8888b   d8888 d88P  Y88b 
888    888        Y88b.      88888b.d88888 Y88b.      
888    888 888d888 "Y888b.   888Y88888P888  "Y888b.   
888    888 888P"      "Y88b. 888 Y888P 888     "Y88b. 
888    888 888          "888 888  Y8P  888       "888 
888  .d88P 888    Y88b  d88P 888   "   888 Y88b  d88P 
8888888P"  888     "Y8888P"  888       888  "Y8888P"  

Version 4.00
Sega Master System and Game Gear Emulator for the Gameboy Advance.

Written by Reesy    email: drsms_reesy@yahoo.co.uk
                    web  : http://drsms.bornonapirateship.com  ( cheers RedMage )

What is it?
-----------
DrSMS will allow you to play all of the old Sega 8-bit classics 
on your Gameboy Advance.

How to use it
-------------
Run the program Drsmsver4.exe that is included with this readme 
file. This will display a window, you now need to drag your sms
roms into this window.  To do this, goto your "My Computer" icon
located on your windows desktop. Browse through your folders until
you find the folder where you have your sms/gg roms stored. Now move
"My Computer" window so that you can see both the contents of the
"My Computer window and also the blank window in DrSMS. Now drag
the sms roms from the "My Computer" window to the DrSMS window.
You should need the name of the sms/gg rom appear in the window, when
you have done this right. You can drag multiple files if you want.

To remove a game from the list, simply select it with the mouse
and then press the "delete" key.

When you have all of the sms/gg roms you want you need to enter the 
filename you want to create into the "output file" box and then 
click on "Create Image".  This will start the DrSMS rom creation
process. 

When the injector has finished building the Gameboy Advance rom
it will display a message box.  You then take the rom that the
injector created and either flash it to your GBA flash cart or
run it in a Gameboy Advance Emulator. 

When you run DrSMS, it will first check to see if there is a DrSMS
save in SRAM.  If there is, it will decompress the save states to 
memory.  You will then see a list of the sms/gg roms.  Move up or down
until the game you want to play is highlighted and then press A.
DrSMS will now launch the game.

Loading Save States
-------------------
In order to load a save state, you must first 
load the game associated with the save state. For example if the 
save state I want to load is for Sonic.  I need to load Sonic from 
the game menu first. 

Then you goto the menu by pressing SELECT, then to the SAVE MENU.
Then select the save state and press A

How to use DrSMS's ingame menu
------------------------------
To access DrSMS's menu press the "select" button.
Press UP and DOWN to navigate between menu options.
Button A will select the menu option.
Button B or SELECT will exit the menu and return you back to the sms game

Menu Options - Explained
------------------------

LINES PER FRAME - Because alot of SMS/gg games are very dependant on the display
                  timings of the sms/gg, this menu option allows you to modify 
                  the number of lines DrSMS will process per sms/gg frame. By
                  decreasing the number, you can speed up some games. But on
                  some games decreasing the number of lines can cause emulation
                  problems and the games will crash.  The default is 255 which
                  should be fine for most games.  But if you are having problems
                  its worth playing around with this option.

SELECT NEW GAME - This takes you back to the Game Selection screen. Once you
                  select this option, you will not be able to return to the 
                  current game.

RETURN          - This returns to the current loaded game

MODE            - Because the sms screen is longer than the GBA screen, some
                  screen scaling functions have been provided. You have the 
                  following options - 
                  
                  UNSCALED - This displays the SMS screen as it would normally
                             appear. Because the full screen will not fit on the
                             GBA screen you have to use the L and R buttons to
                             scroll the screen UP or DOWN.

                  SCALED - This compresses the SMS screen into the size of a GBA
                           screen.  It does this by skipping SMS lines.
                  
                  If your running a Game Gear game you don't need to worry about
                  these options as the game gear screen fits on a GBA screen.

COUNTRY         - This allows you to set the country mode that DrSMS runs in.

GAMMA           - This is an option that allows you to increase or decrease the
                  brightness of the screen.  It defaults to the maximum 
                  brightness. 

SAVE MENU       - This will take you to the SAVE MENU where you can save the 
                  current game state.  If a game uses SMS SRAM, DrSMS will also 
                  store this in the save state.  To create a new save just move 
                  cursor until NEW SAVE is highlighted and then press A.  DrSMS
                  will now store the save state to memory and then compress this
                  data to SRAM.  To update a current save, just move up and down
                  until the save you want to update is highlighted and then press
                  A. The old save will be deleted and then a new save will be 
                  created.

                  If you run out of space while attempting a save, a message will
                  be displayed on the screen informing you that the save failed
                  and that you will need to create some free space by deleting 
                  some existing saves.  If the save fails while updating a current
                  save, that save will be deleted.

                  Press B to return to the main menu.

LOAD MENU       - This allows you to load you save states. Just move up or down
                  until the save you want is selected and then press A to load.

DELETE MENU     - This allows you to delete you existing saves.  Just move up or
                  down until the save you want is selected and then press A to
                  delete.  CAUTION... This is not Windows...There is no UNDO and
                  you don't get a message asking you "Are you sure? YES or NO".
                  As soon as you press A, thats its.  So make sure you are on the
                  right save before pressing A.

REBOOT/RETURN TO POGOSHELL - This will restart the Gameboy and return to Pogoshell
                             if DrSMS was launched from Pogoshell.
                  

DrSMS update history
--------------------

Version 4.00

Support for SMS SRAM
Compressed Save States ( huffman "slow as shit" compression, by me ;S )
More Bug fixes
Cleaned up sprite routines, removed support for Alien3 as it caused alot of
problems with loads of other games. The need of the many outweigh the needs
of the few...and all that :)
Removed buffered palette writes, so Space Harrier is now flickery again, but
James Pond now has its parrallex scrolling again.
Removed Game Gear Mask toggle.  Sorry I've always thought it was crap.
Fixed a major bug in the memory paging routines
Added support for Star Trek Game Gear Games, there still not perfect but 
getting there.
Improved the sound routines

Version 3.00 betas

Loads of bug fixes
and somewhere along the line I added Game Gear support

Version 2.04

Fixed screen flickering problem
Fixed sound problem where noise channel was mucking up sound channel 1

Version 2.03

Nothing!!!!, I released a big pile of crap, doh!.  It would appear
an released an test version of drsms by mistake. Oh well

Version 2.02

Scaled Screen mode

Thanks to
---------
TheHiVE   - For all of your help, you da man ;)
RedMage   - For hosting/creating the new web site
Speedis   - for hosting the old web site


Links
-----
http://www.gbax.com/    - A place where you can buy a GBA flash cart, and GP32's ;)  
http://vboy.emuhq.com/  - The best GBA emulator!
