Introduction:
*************

This is an Amiga port of the Multiple Arcade Machine Emulator 0.30.
Every release should be considered as a beta release. I guarantee
that there are bugs. You can help me removing bugs by mailing me
bug reports on mats.hansen@triumph.no. Try to include as much
information as possible. It's better with too much information than
too little.

Usage:
******

MAME can be used both from CLI and WB. The options can be used as
tooltypes in the program icon and project icons. Options can be saved
into the program icon and project icons from the menu. If
ENV:Sys/def_mame.info exists it will be used as the default icon for
saving options. The default options are saved into the program icon.
As a result of this the default options are only available when started
from WB. The new chunky to planar routine by Mikael Kalms is only used on
8 bit custom screens so AGA users should use that with double buffering
turned on. Correct colors for all games is only possible in a window on
WB in hi/true-color or on a custom screen with 256 or more colors.

MAME searches for ROMs in these directories/archives:

1.  <ROMSDIR>/<GAME>/           Only if the ROMSDIR option is used.
2.  <ROMSDIR>/<GAME>.zip        Only if the ROMSDIR option is used.
3.  <ROMSDIR>/<GAME>.lha        Only if the ROMSDIR option is used.
4.  <ROMSDIR>/<GAME>.lzx        Only if the ROMSDIR option is used.
5.  PROGDIR:roms/<GAME>/
6.  PROGDIR:roms/<GAME>.zip
7.  PROGDIR:roms/<GAME>.lha
8.  PROGDIR:roms/<GAME>.lzx
9.  PROGDIR:<GAME>/
10. PROGDIR:<GAME>.zip
11. PROGDIR:<GAME>.lha
12. PROGDIR:<GAME>.lzx

MAME uses external programs to unarchive the needed files so "unzip",
"lha" and "lzx" must be in the default path.

Highscores are stored in PROGDIR:hi/ and game configurations (dip settings,
keyboard and joystick setup) are stored in PROGDIR:cfg/.

Ingame keys:
************

Right-Amiga-N   New game.
Right-Amiga-Q   Quit MAME.
Tab             Enter coonfiguration menu. Press Tab or Esc to get back to the
                emulation.
P               Pause game.
F3              Reset game.
F4              Show the game graphics. Use cursor keys to change set/color,
                F4 or Esc to return to the emulation.
F7              Toggle speed display.
F8              Change frameskip on the fly)
F9              To change volume percentage through 100,75,50,25,0 values.
F10             Toggle speed throttling.

Options:
********

GAME            The game to emulate.
LIST            Show supported games (CLI only).
LOG             Log error output.
NS=NOSOUND      Disable audio support.
SCREEN          Open the emulator on a custom screen. The screen mode
                is set to the "best" mode for the game.
CHANNELS        A string containing one hex number for each of the four
                audio channels. The hex number decides which virtual channel
                is going into the audio channel.
FS=FRAMESKIP n  Skip n frames to speed up the emulation. 0>=n<=3.
NOJOY           Disables the joystick support.
MOUSE           Enables the mouse support. The mouse emulates a trakball so it
                only works on games that support a trakball. Remember that the
                sensitivity of the trakball can be adjusted.
JOY2            Enables support for a joystick in port 1.
BBT=BUTTONBTIME # of 0.1s to wait before holding down button a is treated
                as if it's button b that's being held down. This must be 0
                (the default) if a real button b should be used.
J2BBT=J2BUTTONBTIME Same as the above, but for the joystick in port 1.
AF=AUTOFIRE     Number of times to fire during a second. A non zero
                here disables the button b emulation.
J2AF=J2AUTOFIRE Same as the above, but for the joystick in port 1.
ROL             Rotate the display to the left.
ROR             Rotate the display to the right.
DISPLAYID       ID of the desired screenmode. If the ID has the 0x prefix it
                will be treated as a hex number.
DEPTH           Bits per pixel of the desired screen.
NOSCAN          Disables the scanning of the installed games in the GUI.
W=WIDTH         Width of the window. Vector games will be scaled to fit the
                window. Bitmap games will be centered. The window will allways
                be large enough to show the bitmap graphics so this defaults
                to 0.
H=HEIGHT        Height of the window. See above.
LF=LESSFLICKER  A redraw method that reduces the flicker of vector games. When
                running games in a window this uses less bandwidth than the
                DOUBLEBUFFER method.
DB=DOUBLEBUFFER The prettiest redraw method and the best one to use if a
                custom screen is used. It should be used when using a
                a custom 8 bit AGA screen
FLIPX           Flip display horizontally.
FLIPY           Flip display vertically.
MC=MINCHIP n    If less than n kilobytes of chip ram is available then any
                remaining samples will be loaded into fast ram. This defaults
                to 64 which is a ok value for graphics card users but AGA
                users normally need a larger value. This option is only needed
                if sound is turned on and the emulated game uses many and/or
                large samples.
SMR=SCREENMODEREQ   Open the emulator on a custom screen. An ASL screen mode
                    requester will be opened.
ROMSDIR dir     Search for ROMs in the given directory first.
SAMPLESDIR dir  Search for samples in the given directory first.
RECORD file     All movements made by the player will be recorded in a file
                with the given name and the ending ".inp" added.
PLAYBACK file   Player movements are read from a file with the given name with
                the ending ".inp" added.
TB=TRIPLEBUFFER Looks as good as double buffering and is a bit faster, but
                uses more memory.

Credits:
********

Amiga port by:

Mats Eirik Hansen / Triumph
mats.hansen@triumph.no
http://www.stud.ntnu.no/~matsha

CGXHooks routines by:

Trond Werner Hansen / Triumph
trond.hansen@triumph.no
http://www.stud.ntnu.no/~tronhan

Chunky to planar routine by:

Mikael Kalms

Commercial:
***********

_____________  _  _   _  ____ ___ _______  _   _
\            \| || | | |/   //   \|      \| | | |
 --+ +-----/ /| || | | || +-/ /+ |+----/ /| | | |
   | | /| / / | || | | || |/ / | | /| / / | |_| |
   | || |/ /_ | || | | || | /  | || |/ /  |     |
   | || |\   \| || | | || |/   | ||   /   | +-+ |
   | || | -+ || || +-+ || |    | ||  /    | | | |
   | ||_|  |_||_| \____||_|    |_||_|     |_| | |
    \|                /_/                      \|
           w w w . t r i u m p h . n o

  Visit our homepage for other Triumph projects.