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

This is an Amiga port of the Multiple Arcade Machine Emulator 0.28.

Usage:
******

M.A.M.E. 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 in M.A.M.E. is only possible in a window on
WB in hi/true-color or on a custom screen with 256 or more colors.

Note:
*****

Set your stack to at least 10k.

Options:
********

GAME			The game to emulate (WB only).
LIST			Show supported games (CLI only).
LOG				Log error output.
NS=NOSOUND		Disable audio support.
FPS				Show frames per second and audio status text in titlebar.
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.
FT=FIRE2TIME	# 0.1s to wait to hold down fire1 before it becomes a
				fire2. This must be 0 (the default) if a real second fire
				button will be used.
AF=AUTOFIRE		Number of times to fire during a second. A non zero
				here disables the fire2 emulation.
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.
NOJOY			Disables the joystick support.
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.
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.
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
RL=REMOVELINES	If used then the clearing of vector buffers will be done by
				linedrawing instead by drawing a large rectangle. This can be
				used together with LESSFLICKER, DOUBLEBUFFER or alone.
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.

Credits:
********

Amiga port by:

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

CGXHooks routines by:

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

Chunky to planar routine by:

Mikael Kalms