Masterlator GP v0.3
Copyright (c) 2001-2004 by Christian Nowak
------------------------------------------

-> 16 Days Coding Competition special version <-

This software may only be distributed on the website(s) of the 16 Days GP32 
Coding Competition and my website, http://chn.roarvgm.com/. If you want to 
distribute it on a different website or by other means, you must contact me to 
get a permission.

Masterlator is not intended to save you money by using illegal copies of 
commercial titles. You must own the original game cartridge to play it legally 
on the emulator.

What is it?
-----------

Masterlator is a Master System and Game Gear emulator written completely from 
scratch in very portable ANSI-C (well, at least gcc -Wall -ansi -pedantic as 
well as the ADS compiler compile it without any warnings). That means, 
Masterlator is _not_ a derivative of any existing emulator or parts of any 
existing emulator. I'm emphasizing that because most (not all) emulators for the 
GP32 are ports of existing emulators which is why many people are tempted to 
believe that a new emulator is yet another port. Well, Masterlator is not.

Masterlator uses the zlib for zipped ROM file support: http://www.gzip.org/zlib/

How to install it?
------------------

Copy the fxe to gp:\gpmm and your SMS and GG games to either gp:\gpmm\sms32 or 
gp:\gpmm\sms. The emulator will detect which of the directories exists. Save 
games and states will be saved in the detected directory. Your games can be 
zipped or uncompressed.

Usage
-----

Well, the menu should be self-explaining. Just a few notes:

Masterlator can save one SRAM file and one machine state file per game. The file 
names consist of the game ROM's CRC32 in hex plus the suffix ".sav" (SRAM) or 
".stt" (state), for example

d8c4165b.sav
d8c4165b.stt

The CRC32, along with the name (from the GoodSMS/GoodGG database) of the 
currently loaded game is displayed in the scroll text of the main menu.

While playing a game, press the right shoulder button to return to the menu and 
the left shoulder button to reset the virtual machine.

The emulator itself runs at 133MHz, but while in the menu, the CPU is switched 
back to 66MHz to conserve the batteries.


Have fun!

Christian Nowak.
chnowak@web.de
