
-----------------------------------------------------------------
MULTIPAC GP32 1.0 by Franxis (fjmar@hotmail.com) (November, 2004)
-----------------------------------------------------------------


1. INTRODUCTION
---------------

It is a port of Multipac by Nicola Salmoria (the preceder to MAME) for the GP32 
console. It emulates arcades with Pac Man hardware: Pac Man, Ms Pac Man, Crush 
Roller, Piranha and all clones or hacks of previous games.

It is done as a contribution to ADIC 2004 Compo (December, 2004).

It is an experiment to start now with MAME (I will see..)


2. CONTROLS
-----------

Controls for the emulator are the next ones: 
- Joystick: Movement. 
- SELECT or B button: Insert Credits. 
- START  A button: Play. 
- L button: Pause. 
- R button: To change screen orientation (it is rotated by default, but it can 
be played with normal orientation lossing some lines in upper part and lower 
part of screen). 
- L+R simultaneously: Exit to select game screen.


3. INSTALLATION
---------------

There are three different executables, to be copied to \GPMM in the SMC:

- multipac.fxe: Version of the emulator running at 133 MHz. It runs almost 100% 
with some slowdowns in Ms Pac Man.

- multi156.fxe: The same emulator running at 156 MHz. It runs a bit faster than 
arcade version (I don't know why). There are no slowdowns.

- multi166.fxe: Emulator running at 166 MHz. It runs as fast as arcade. Also 
there are no slowdowns (NOTE: Not every GP32 consoles support the 166 MHz 
overclocking).

The ROMs of arcade games have to be placed in \GPMM\MULTIPAC directory following 
the created directory structure into it. The ROMs have to be unzipped (the 
emulator does NOT support ZIP or RAR files).


4. SUPPORTED GAMES
------------------

TOTAL=63

Oficial ones:
- Pac Man
- Ms Pac Man
- Crush Roller
- Hangly Man
- Pac Man Mod
- Puck Man
- Pac Man Namco
- Pac Man Plus
- Piranha

Pac Man hacks:
- Abort Man
- Baby Pac Man
- Brakman
- Crazy Pac
- Dizzy Ghost
- Euro Pac
- Pac Man Hearts
- Maze Man
- Pac 2600
- Pac Man 3D
- Pac Man Crunchy
- Pac Man Desert Storm
- Pac Man Inviso
- Pac Man Jail
- Pac Man Mini
- Pac Man Shuffle
- Pac Man Six Map Weird
- Pac Man Snowy Day
- Pac Man Speedy
- PengMan
- Puck Man 2
- Puck Man Renaissance
- Robo Man
- Summertime Elton
- UltraPac
- Ultra Pacman TwoBit Score Mazes
- Vector Pac Man
- Xens Revenge
- Xens Revenge Vector
- Pac Man (generic clone/hack)

Ms Pac Man hacks:
- Cookie Mon
- Ms Heart Burn
- Mr Pac Man
- Ms Baby Pac Man
- Ms Pac Man Berzerk
- Ms Droid
- Ms Elton
- Ms F1 Pac Man
- Ms Hangly Man
- Ms Pac Man Hearts
- Ms Pac Man Mini
- Ms Pac Man After Dark
- Ms Pac Crazy Mazes
- Ms Pac Man Deluxe
- Ms Pac Man Renaissance
- Ms Pac Mortem
- Ms Pac Strange Mazes
- Ms Pac Rumble
- Ms Ultra Pac Man
- Vector Ms Pac Man
- Pac Man Unleashed
- Sue's World
- Ms Yak Man
- Ms Pac Man (Generic clone/hack)


5. ROM NAMES
------------

Pac Man - \GPMM\MULTIPAC\PACMAN\
	pacman.5e
	pacman.5f
	pacman.6e
	pacman.6f
	pacman.6h
	pacman.6j

Ms Pac Man - \GPMM\MULTIPAC\MSPACMAN\
	5e
	5f
	boot1
	boot2
	boot3
	boot4
	boot5
	boot6

Crush Roller - \GPMM\MULTIPAC\CRUSH\
	cr1
	cr2
	cr3
	cr4
	cr5
	cr6
	cr7
	cr8
	cra
	crb
	crc
	crd

Hangly Man - \GPMM\MULTIPAC\HANGLY\
	hangly.5e
	hangly.5f
	hangly.6e
	hangly.6f
	hangly.6h
	hangly.6j

Pac Man Mod - \GPMM\MULTIPAC\PACMOD\
	5e
	5f
	6e.mod
	pacman.6f (original Pac Man ROM)
	6h.mod
	pacman.6j (original Pac Man ROM)

Puck Man - \GPMM\MULTIPAC\PUCKMAN\
	puckman.5e
	puckman.5f
	puckman.6e
	puckman.6f
	puckman.6h
	puckman.6j

Pac Man Namco - \GPMM\MULTIPAC\NAMCOPAC\
	namcopac.5e
	namcopac.5f
	namcopac.6e
	namcopac.6f
	namcopac.6h
	namcopac.6j

Pac Man Plus - \GPMM\MULTIPAC\PACPLUS\
	pacplus.5e
	pacplus.5f
	pacplus.6e
	pacplus.6f
	pacplus.6h
	pacplus.6j

Piranha - \GPMM\MULTIPAC\PIRANHA\
	pacman.5f
	pr1.cpu
	pr3.cpu
	pr4.cpu
	pr5.cpu
	pr6.cpu
	pr7.cpu
	pr8.cpu

Abort Man - \GPMM\MULTIPAC\ABORTMAN\
Baby Pac Man - \GPMM\MULTIPAC\BABY\
Brakman - \GPMM\MULTIPAC\BRAKMAN\
Crazy Pac - \GPMM\MULTIPAC\CRAZYPAC\
Dizzy Ghost - \GPMM\MULTIPAC\DIZZY\
Euro Pac - \GPMM\MULTIPAC\EUROPAC\
Pac Man Hearts - \GPMM\MULTIPAC\HEARTS\
Maze Man - \GPMM\MULTIPAC\MAZEMAN\
Pac 2600 - \GPMM\MULTIPAC\PAC2600\
Pac Man 3D - \GPMM\MULTIPAC\PACMAN3D\
Pac Man Crunchy - \GPMM\MULTIPAC\PCRUNCHY\
Pac Man Desert Storm - \GPMM\MULTIPAC\PACSTRM\
Pac Man Inviso - \GPMM\MULTIPAC\PACINVIS\
Pac Man Jail - \GPMM\MULTIPAC\PACJAIL\
Pac Man Mini - \GPMM\MULTIPAC\PACMINI\
Pac Man Shuffle - \GPMM\MULTIPAC\PACSHUF\
Pac Man Six Map Weird - \GPMM\MULTIPAC\PACWEIRD\
Pac Man Snowy Day - \GPMM\MULTIPAC\SNOWPAC\
Pac Man Speedy - \GPMM\MULTIPAC\PACSPEED\
PengMan - \GPMM\MULTIPAC\PENGMAN\
Puck Man 2 - \GPMM\MULTIPAC\PUCKMAN2\
Puck Man Renaissance - \GPMM\MULTIPAC\PUCKREN\
Robo Man - \GPMM\MULTIPAC\ROBOMAN\
Summertime Elton - \GPMM\MULTIPAC\SUMELTON\
UltraPac - \GPMM\MULTIPAC\ULTRAPAC\
Ultra Pacman TwoBit Score Mazes - \GPMM\MULTIPAC\ULTRA2\
Vector Pac Man - \GPMM\MULTIPAC\VECTRPAC\
Xens Revenge - \GPMM\MULTIPAC\XENSREV\
Xens Revenge Vector - \GPMM\MULTIPAC\VECTXENS\
	<NAME>.5e
	<NAME>.5f
	<NAME>.6e
	<NAME>.6f
	<NAME>.6h
	<NAME>.6j

Pac Man Pac Man (generic clone/hack) - \GPMM\MULTIPAC\GENERIC\
	generic.5e
	generic.5f
	generic.6e
	generic.6f
	generic.6h
	generic.6j

Cookie Mon - \GPMM\MULTIPAC\COOKIEM\
Ms Heart Burn - \GPMM\MULTIPAC\HEARTBRN\
Mr Pac Man - \GPMM\MULTIPAC\MRPACMAN\
Ms Baby Pac Man - \GPMM\MULTIPAC\MSBABY\
Ms Pac Man Berzerk - \GPMM\MULTIPAC\MSBERZK\
Ms Droid - \GPMM\MULTIPAC\MSDROID\
Ms Elton - \GPMM\MULTIPAC\MSELTON\
Ms F1 Pac Man - \GPMM\MULTIPAC\MSF1PAC\
Ms Hangly Man - \GPMM\MULTIPAC\MSHANGLY\
Ms Pac Man Hearts - \GPMM\MULTIPAC\MSHEARTS\
Ms Pac Man Mini - \GPMM\MULTIPAC\MSMINI\
Ms Pac Man After Dark - \GPMM\MULTIPAC\MSPACAD\
Ms Pac Crazy Mazes - \GPMM\MULTIPAC\MSPACCM\
Ms Pac Man Deluxe - \GPMM\MULTIPAC\MSPACDX\
Ms Pac Man Renaissance - \GPMM\MULTIPAC\MSPACREN\
Ms Pac Mortem - \GPMM\MULTIPAC\MSPACRIP\
Ms Pac Strange Mazes - \GPMM\MULTIPAC\MSPACSM\
Ms Pac Rumble - \GPMM\MULTIPAC\MSRUMBLE\
Ms Ultra Pac Man - \GPMM\MULTIPAC\MSULTRA\
Vector Ms Pac Man - \GPMM\MULTIPAC\MSVECTR\
Pac Man Unleashed - \GPMM\MULTIPAC\PUNLEASH\
Sue's World - \GPMM\MULTIPAC\SUEWORLD\
Ms Yak Man - \GPMM\MULTIPAC\MSYAKMAN\
	5e
	5f
	boot1
	boot2
	boot3
	boot4
	boot5
	boot6

Ms Pac Man Pac Man (generic clone/hack) - \GPMM\MULTIPAC\GENERICM\
	5e
	5f
	boot1
	boot2
	boot3
	boot4
	boot5
	boot6


6. CREDITS
----------

- Original MultiPac for DOS by Nicola Salmoria (http://www.mame.net).

- Z80 Core by Marat Fayzullin and Marcel de Kogel (http://fms.komkon.org).

- GP32 port by Franxis (fjmar@hotmail.com) starting from source code of MultiPac 
0.8 (dated 29/01/1997).


7. DEVELOPMENT
--------------

After some tries with WinPie (http://www.ascotti.org/programming/pie/pie.htm) as 
a contribution to "16 Days Coding Compo" (I had no success because of C++ code 
of the emulator), I started to work with MultiPac because it is ANSI C to be run 
in a 486 PC machine, and defintivelly it is done. It is 100% speed now in GP32 
with frameskip 0 and 44 KHz 8 bit sound.

Developed with:
- GP32IDE (http://www.nigelibrown.pwp.blueyonder.co.uk/gp32/developer/gp32ide/).
- DEVKITADVANCE (http://chn.roarvgm.com/).
- Official GPSDK by GamePark.
- Sound with GpSoundBuf (http://chn.roarvgm.com/).
- http://www.pararakels.com/gpidetuto/
- http://www.thaworx.co.uk/ninja/tut3.htm


8. KNOWN BUGS
-------------

- Piranha: Graphic errors. It is 'normal' because original MultiPac does not 
support this game. It is only an experiment trying to add more games to the 
emulator.

- Ms Pac Man: It does not run at 100% speed with 133 MHz. Also if credits are 
added just the game is showing the intro screen the labyrinth appears in violet 
color instead of orange, but the bug is solved when the player losses its first 
live ;-). If you wait some seconds before inserting credits there is no such 
bug.

- Clones & Hacks: Some of them have some bugs (No scenario in Pacman Renaissance 
or some blinking in PengMan).

- General: Original Multipac had no GUI and no support to change the game played 
by the emulator. Then I'm not sure if the behaviour of the emulator is the same 
after some played games from the emulator game selection screen. In example 
sometimes after loading some different games, one of the sound channels are in 
mute for the first seconds of playing with a game.


9. TO BE IMPROVED
-----------------

I don't know if there will be more MultiPac GP32 versions, but...
- Improved sound.
- ZIP and RAR support for ROMs.
- Update ROMSets to actual MAME ones.
- Add support to all clones & hacks.


10. THANKS TO
-------------

In alphabetic order ;-):
- Chui
- D_Skywalk
- Locke
- Rlyeh


11. INTERESTING WEBS ABOUT PACMAN
---------------------------------

- http://www.mameworld.net/pacman/
- http://www.marcianitos.org/revisnombre/pacman.htm


12. SOME OTHER INTERESTING SPANISH WEBPAGES
-------------------------------------------

- http://www.talfi.net
- http://www.gp32spain.com
