Enhanced MAME UNOFFICIAL Plus (E.M.U+)
Win32 Version 36 Final

Please note this is NOT an official mame/mame32 release.
DO NOT BUG THE MAME/MAME32 TEAMS.
This is E.M.U+ an UNOFFICIAL MAME/MAME32 RELEASE.
USE THIS PRODUCT AT YOUR OWN RISK!
Testing on various different drivers were completed, but there may be bugs.
Please do not send any reports from this emu+ release to the mame/mame32 team.
Again you use this product at your own risk. No warranty or guarantee is given on what
could happen to your particular hardware and software configuration. Thanks and enjoy.

IMPORTANT: E.M.U+ is an UNOFFICIAL, UNSUPPORTED version of mame/mame32. It was designed 
in the spirit of open source and we on the EMU+ team want to thank the MAME/MAME32 teams 
for this wonderful product. We are in no way trying to "compete" with the mame/mame32 
teams. If they didn't release mame/mame32 then we wouldn't be releasing this, so as 
anyone can see mame/mame32 wins if this was a competetion :). Any problems or 
suggestions for E.M.U+  should be sent to the E.M.U+ team. If you choose to bug the 
MAME/MAME32 teams then as Mr. Hat says, "Die, You Die and burn in H..."

Did I say this was an unofficial release? Well just saying it again, can't say it enough. 
We don't want to upset the mame team who gives us this wonderful product we call
M.A.M.E!!! Please don't contact them. Ok I Think that's enuff :)

Credits: Thanks go out to the Mame/Mame32 teams! KBMAME author Deimos (many things). All 
the web sites who support mame (To many to list, but thanks to ALL of them). Derek_M for
correcting my stupid typos on lb2 and qkof. The_Scarf for helping me get arcade mode of lb2
working. BMan2 for the new neogeo drivers. mr2600 for the sound logging stuff. ROBERT
from MAMEGRIP/MAMEJOY for the GRAVIS support. ANDY for his optimame dual mouse support
and other cool stuff, HAZE for helping out and sending in all those crazy video modes. 
_PSI_ got his marp info in. Everyone on #retrogamers, #neogeo, #arcade and #geoshock 
from EFNet IRC who have given suggestions and enhancements.
Plus anyone else we may have missed!

------------------------------
Force 16 Bits Option
------------------------------

OK. you can use the -force16 option to enable 16bit color in ALL games.
(This is now a 16bit DEPTH so with the new palette changes ???)

Also in the Default Options Menu.

------------------------------
Overclocking Options
------------------------------

To access the overclocking options, you use the GUI (tab key -> Under Overclock CPU.)
There you can determine what CPUs you want to overclock, and set the new higher (overclock)
or lower (underclock) CPU speed. To speed up games, try overclocking the main CPU(s) and
underclocking the Sound CPU(s). For example, in NeoGeo games you could overclock CPU #1 to 20 MHz and underclock CPU #2 to 4 MHz.
(Please note: CPU Overclocking is now in the official build in the OSD. I can't say how
this will react if you use both. Stick to one or the other not both. I prefer this
menu as it's based on Mhz and not % plus you see all the cpu's at once.)

Tips:
-----

Some people have been asking just what is the overclocking good for. Well,
here are some examples:

Making Mortal Combat faster: Everyone know that if you disable the sound,
games will run faster. With overclocking, you can leave the sound on, but
underclock the sound CPU so the game runs faster, though it remains with 
sound. Try loading MK, go to the overclock menu, underclock the M6809 
processor to only 1 MHz (make sure you enable overclocking as well) and go
back to the game. It should now be at least 20%-25% faster.

Making Arkanoid games slower: The arkanoid-type games really go too fast,
especially since we don't have at home the original controller used in the 
game. Try and go to the overclock menu, press F10 for full speed, and F11
to see current speed. On most machines, you will se the game running at some
200%. Enable overclocking, and keep increasing the cpus speed until the
speed drops to 60%-70% or so. Press F11 to hide the FPS display and go play
the game (another way to slow down games it to underclock the cpus, though
this may sometimes cause glitches in the game).


------------------------------
Autofire Options
------------------------------

To access the autofire options you use the GUI (tab key -> Under Auto Fire.)
You can turn autofire on/off all buttons, Plus set a delay for games that need a
fast delay (metal slug) and games that need a shorter delay (1942)!
(This is the very last option, under all the other keys).

------------------------------
Save State Options
------------------------------
To access the saves states (NEOGEO GAMES ONLY).
Start a game. When playing hit / to save the game, and [ to load the game.
\ and ] change the Save Game Slot. You can have up to 50 save states
per game. (Save State 0 is used for the autosave state, so don't use it)
Note: STA setting in Directories is the save state directory. It defaults to STA.
This directory MUST exist or no saves states. mmmkay?
(Please note: MAME changed in 36b12 so your old save states prior to 36b12
don't seem to work)

------------------------------
Sound Logging Options
------------------------------
This only works in games with the astrocad driver (WOW), and the dac driver
(MK, Smashtv) You access it from the gui (tab key -> Under Sound Logging). Just turn it on
and off. It stores the files in the mame root dir right now. filename.pcm. I.E. dac0000.pcm
dac0001.pcm. (P.S. Can ANYONE play these? If anyone wants to write a sound capture driver
for everything please send it to me and I'll be happy to include it. Thanks)

------------------------------
Continuous Save States
------------------------------
Type -contsave and this automatically loads the save state for the neogeo game you are
playing. When you quit the game it automatically saves the game at your current point
in the game. Save Slot 0 is used for this.

Also in the Default Options Menu.

------------------------------
Demo Mode
------------------------------
This feature is kind of cool. It cycles thru working available games for a certain time
frame. Basically you get mame as a working screen saver. Sometimes it seems sound and
graphics glitches appear when you turn off limiting or set the demo time to low.
Note: Save states wont autoload in demo mode. Once you start playing a game demo mode 
exits. Hit ESC to quit demo mode and exit also

Turn on Demo Mode, Select a Time and Then Say Play Random Game. Viola.
If You dont say random it will just keep doing the same game over and over

Also in the Default Options Menu.

-------------------------------
Joysticks (This is DOS Only)
-------------------------------
Ok. -joy grip is for Gravis joysticks.
    -joy grip4 makes Gravis pads become a 4 Way Joystick (No Diagonals, great for
     Pacman, DigDug, Mr. Do, Q-bert, all the four way games.)
    -joy Sidewinder. Sidewinder pads.
    - Analog support should work (i.e., the analog pad on the Xterminator
      should work smoothly)
    - Fixes annoying (but harmless) crashes upon exiting that occur on a few 
      systems.
    - Produces a "grip.out" file that shows the state of your joysticks and 
      is useful for debugging.
    - Ability to turn auto-centering on and off from the Analog Control menu,
      thanks to Andy and his OptiMame.
    - The option to choose which analog joystick axis corresponds to which 
      analog axis in the game. Thus, you can swap the analog X and Y axes,
      or use the flippers and throttle on the Xterminator (or an inferior 
      controller) as true analog controls. To use this, select the menu 
      option "Analog Axes" and use left and right to select the axis. Only
      available analog axes will show up. "default" chooses the first analog
      stick. (These settings aren't saved...)
    - Debug output is created for all joysticks, in "joy.out".
    - If an invalid joystick name is entered, the user is asked for a valid
      one, with a menu (like with sound).
    - Unsigned axes (such as throttles, commonly) are fixed in MAME.
    - Throttles register digitally, and can be used as buttons.
    - A held-down button will not mess up the joystick settings process.
    - Some more small Allegro fixes, such as in the axis names.

All controls on the devices should be supported. The names should also be
accurately fetched from the GrIP driver.

Please note: YOU HAVE TO REMOVE THE JOYSTICK FROM GAME CONTROLLERS IN WIN 95/98 FOR THESE
TO WORK FOR SOME REASON (Sidewinder Gamepad). Has to do with the way windows doesn't 
release these pads. 
Go into control panel and remove the pad. This will make it NOT work in win 95/98 so 
you'll have to add it BACK to use it.
DON'T do this if you want it in windows or have something special configured you don't
want to lose without backing it up first. Just letting you know it DOES work.
The newest version of allegro may have fixed these problems. Try it both ways and see
I don't have a gravis pad to test with.

-------------------------------
Screen Modes (DOS Only)
-------------------------------
Added support for many crazy different video modes. Thanks to HAZE and DGEN Author for
this. (Please note: All video modes require 16bpp color except Eagle which supports both
8bpp and 16bpp)
-craptv          - A blurred out tv mode
-eagle           - Eagle routines like those found in kbmame.
-lcdblur         - This is a weird effect. Blurs the screen sorta like an lcd display.
-cleanblur       - This is also used in conjunction with -lcdblur, Some games look better
                   with it on. Baseball Stars doesn't leave the word Strike on the
                   screen for ages. Other games look better with it off, just experiment.
-lcdlarge_screen - Used in conjuntion with -lcdblur Displays large or small screen.
-blur            - This creates a different blur type effect. Draws every other line.
-fifty           - This is a 50% scanlines mode.
Not every game will work with these modes. Most require stretch = Yes in mame.cfg.
You can set these options in mame.cfg but you can only use ONE mode at a time. (If
you say eagle = Yes and craptv = Yes. You will get eagle and not craptv.)
Note: Again with the new palette changes in 36b12 and now the MMX routines
most of these don't work now. Haze and I are looking into it.

- GUI Support in mame.cfg file. (Note: This has been changed slightly)

-------------------------------
Hi Score entry
-------------------------------
Accessed via the tab menu. Highest Score (MARP Info).
Shows you the 3 highest score posted for that game at
marp.retrogames.com (Mame Action Replay). from the hiscores.dat file.
Goto http://marp.retrogames.com/emuplus.htm to get the latest files.

-------------------------------
Screen Control (DOS Only)
-------------------------------
Accessed via the Tab Menu.
You can center your screen. These
settings get saved on a per mode
basis in the screen.cfg file.
nocenter = YES/NO in the mame.cfg file in the [emuplus] settings.
or via commandline -nocenter.
(If you experience weird 1/4 screen anomolies. Try setting nocenter=yes
in the mame.cfg file in the [emuplus] section.)

-------------------------------
Optimame Extras
-------------------------------
This has sensitivity settings.
Axis inputs etc for analog
controllers

-------------------------------
Analog Axis (Dos Only)
-------------------------------
More from mamejoy. Extensive
tweaks.

-------------------------------
Known Bugs
-------------------------------
Sometimes sound goes haywire looping in demo mode.
Can't seem to make it stop but its a timing issue apparently.
Screen bugs happen due to the screen centering. If you have 1/3
screen problems or unknown crashes use the -nocenter command line
option or set nocenter = YES in the mame.cfg file.

-------------------------------
To Do
-------------------------------
- Looking at the ability to add Rumble support for PSX pads, N64 controllers.
  Don't have a clue when this will be implemented tho.
- Want to add MAMELANG support.
- Fix Eagle and other modes.
- Get the Win32 version done sometime (Yes I have it done now for 36final but
  I can't get random game working and a menu pick. Once that is added It's released.)
- Get some help coding emuplus/emuplus32. Contact me at emuplus@hotmail.com

-------------------------------------------------
Thanx! Emu+ Team Bubble, Danmanya, Gato, Kusanagi
-------------------------------------------------

Thanks to the mame team and all the other great emu authors out there. Keep up the good 
work and ignore the lamers.