NeoSMS v0.3b Documentation
~~~~~~~~~~~~~~~~~~~~~~~~~~

Thank you for downloading NeoSMS!  First, some legalities, then we'll get to
the good stuff.

Legal
~~~~~

This software comes with no warrenty, either written or implied.  USE AT YOUR
OWN RISK.

What is NeoSMS?
~~~~~~~~~~~~~~~

NeoSMS is an emulator for the Sega Master System and Game Gear.  The SMS was 
Sega's 8bit entry into the video game market.  Sega then released the Game
Gear portable which was a slightly scaled down version of the SMS with a
larger color palette.

System Requirements
~~~~~~~~~~~~~~~~~~~

An Intel Pentium PC
Windows 95, 98 or 2000 with DirectX 7 -OR-
Windoows NT4 with Service Pack 3 or greater

The slowest PC I've tested NeoSMS on is a PII-400.  It ran at full speed on
this machine with plenty of CPU power to spare.  At one time the emulator
ran on a P200MMX at full speed on many games, but this may no longer be the
case.

unfnknblvbl, of S8-Dev fame, wrote in saying he gets 40-50% on a P133.
That's a good start and hopefully I can improve that in the future.

If you get it to run at decent framerates on a low-end system, please let
me know your configuration.  In the future I'd like some low-end testers
when I optimize the emulator for speed.

Running NeoSMS
~~~~~~~~~~~~~~

Double click the executable.  Find the menu bar at the top of your screen,
click File, Load Cart.  Select a cart and you're off!

Controls
~~~~~~~~

Here are a list of keyboard controls:

Joystick 1:

  Up	    - Up Arrow
  Down	    - Down Arrow
  Left      - Left Arrow
  Right	    - Right Arrow

  Button 1  - Z
  Button 2  - X

Joystick 2:

  Up	    - I
  Down	    - K
  Left      - J
  Right	    - L

  Button 1  - Q
  Button 2  - W

Misc:

  GG Start  - S
  Pause     - P
  Reset     - R

  FrameRate - F
  Break     - B
  SpritesOff- Space Bar

NeoSMS also supports one joystick automatically.  If you joystick is correctly
setup in the Control Panel then the first two joysticks that NeoSMS finds will
be automatically used as Joypad 1 and Joypad 2.

NeoSMS automatically maps the first analog control to the D-pad.  The rest of
the buttons are as follows:

  Button 1 -- Joypad Button 1
  Button 2 -- Joypad Button 2
  Button 3 -- Game Gear Start
  Button 4 -- SMS Pause Button

In the future the joystick mapping will be fully configurable.

Misc
~~~~

If you have any problems running NeoSMS please let me know about them.  I
definatly want it to work for you.

GameGear support is now fully working!  Hurray!  Compatibility seems to
be high, but I haven't fully tested it for compatibility yet.

None of the UI or cool features like savestates are in yet.  Once I've
solved the compatibility problems I'll be added new features.


If you have a problem
~~~~~~~~~~~~~~~~~~~~~

If you have a problem with NeoSMS please write me at the email address below.
Be sure and include information about the computer you are running on
including the Operating System, Processor, Video Card, Sound Card, current
display depth, and type of joysticks.  That information will help me fix
your problem much quicker.

Contacting the Author
~~~~~~~~~~~~~~~~~~~~~

Web:	http://www.emuhq.com/neosms/
Email:	tarix@emuhq.com

Credits
~~~~~~~

You can't do an emulator alone!  Here are the people who helped:

Marat Faizullin		- Provided the original Z80 emulation
James McKay 		- For Massage and providing source code
Neyf			- For DarkNES and providing source code
Omar "Zoop" Cornut	- Author of MEKA, for answering my dumb questions :)
Charles Mac Donald	- For his awesome VDP documentation
Neon Spiral Injector 	- For the documentation that got me started
venca			- Author of CHASMS, for providing motivation and help!
ATani			- Provided much more compatible keyboard input
All of S8-Dev		- Your discussions and help are invaluable!

JA NE!
~~~~~~

Now go enjoy, and send all bitches, complaints, comments, suggestions, and
praise to me. :)

- Michael "Tarix" Montague, author of NeoSMS (tarix@emuhq.com)
