Mame for Dreamcast

1) Introduction
---------------

MAMEDC is an attempt to port MAME to the (wonderful) Dreamcast console.

2) License
----------

Copyright (C) 2001 Christophe Thibault.

This software is provided 'as-is', without any express or implied
warranty.  In no event will the authors be held liable for any damages
arising from the use of this software.

Permission is granted to anyone to use this software for any purpose,
except commercial applications, and to alter it 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. It is ILLEGAL to distribute MAMEDC along with copyrighted ROMs.
4. This notice may not be removed or altered from any source or binary 
   distribution.

3) Features
-----------

- Some games work at 100% framerate, others are slower. 
- Supports the following drivers: PacMan, Arkanoid, Super Qix (bootleg), Psychic5, Pang, Super Pang
  Ghosts'n Goblins, Commando, BombJack, Bubble Bobble and Contra.
- Sound support (thanks to James Surine!)
- 2 controllers support
- VERY unoptimized for now 

4) Credits
----------

MAME - The MAME Team (Do NOT bother them about MAMEDC) 
MAMEDC port - Christophe Thibault 
Kallistios - Dan Potter 
Some source code from Multipac and sound engine rewrite - James Surine 

5) Burning instructions
-----------------------

Burn the DiscJuggler 2+ image with discjuggler. You can download it from http://www.padus.com/
Then, you have to make the ROM images cd. You need to burn a Mode1 cd with the following directory
structure:

/
|
|-roms

In the roms games folder, you need to put the ZIPPED rom files.

Also, you can put each rom in its own directory under the /roms/ folder. but for now, it looks
like it's a bit buggy so keep on using zipped roms :)

The roms you can put on the CD have to be named like the following:
pacman.zip
arkanoid.zip
sqixbl.zip
psychic5.zip
pang.zip
spang.zip
gng.zip
commando.zip
bombjack.zip
contra.zip
bublbobl.zip

Otherwise, you can make another selfbootable cd with MAMEDC along with the roms on the same cd.
You can get some instructions about that on the dcemulation.com site.
http://www.dcemulation.com/help/selfboottutorial.htm
(note: if you got the binary distribution, IP.BIN and 1ST_READ.BIN are already patched and scrambled.
Use kallistios.bin as 1ST_READ.BIN if you want to boot MAMEDC with the UTOPIA boot cd)

6) Usage
--------

Put the MAMEDC cd in your dreamcast and boot it up!
If you have the rom files on an external CD, you need to wait for MAMEDC to show its game
launch screen. Then, you need to put the ROM cd in your dreamcast.

If you don't have a DC keyboard, you can press the "OK" keys at the MAME screens by
pressing LEFT and RIGHT consecutively on the 1st dreamcast controller.

You can get back to the main menu by pressing Analog down+Start.

Be sure to try the games with sound disabled to get the maximum available framerate.

Enjoy!

7) Release history
------------------

v0.3:
- cd swapping code should be fixed (thanks to James Surine)
- James also fixed a small bug in the sound code
- zip support fixed! put all your zipped roms in the /roms/ folder
- looks like some roms HAVE to be zipped otherwise they won't work
- added bubble bobble, bombjack & contra drivers!
- second controller support

v0.2:
- James Surine provided working sound support!
- added Ghosts'n Goblins and Commando drivers
- now uses the TA hardware for displaying the screen so
  it's somewhat faster and looks way better
- zip support added but it doesn't work right so keep on
  using unzipped roms

v0.1:
- first release