                                     NEO
                     (R)eal (A)rcade (G)ame (E)mulator X
			
                               Version 0.6

                 (C) 1999 Anders Nilsson & Janne Korpela

Legal Disclaimer:
-----------------

YOU USE THIS PROGRAM AT YOUR OWN RISK, WE CANNOT BE HELD RESPONSIBLE FOR ANY 
LOSS OR DAMAGE CAUSED.

THIS PROGRAM REQUIRES THE ORIGINAL ARCADE MACHINE ROMS. THESE ROMS ARE 
OWNED BY AND COPYRIGHTED BY SNK. UNLESS YOU OWN THE ORIGINAL GAME BOARDS,
YOU ARE NOT LEGALLY ENTITLED TO USE THEM. WE CANNOT BE HELD RESPONSIBLE 
FOR ANY REACH OF COPYRIGHT.

THIS PROGRAM DOES NOT SHIP WITH ROM IMAGES. DO NOT DISTRIBUTE THIS
PROGRAM WITH ROM IMAGES.

PLEASE DO NOT ASK US TO SUPPLY YOU WITH ROM IMAGES OR ASK US WHERE TO FIND 
THEM. WE CANNOT HELP YOU.


Please DO NOT send us any roms. 


What can you do to help us:
---------------------------

Make sure to put alot of money in the real NeoGeo Arcades... they do deserve it!
Dont support ANYONE that tries to make money on other peoples hard work... it seems
like both romdumpers and emu authors have changed lately and alot of them just wants
donations for either cartidges or payment for their rom/emulator. We think this hurts
the very soul of emulation. In either case above go and buy the real stuff instead.


Whats New:
----------

Special Note:
Why do we have to double certain roms? Well, because we dont use any game specific
drivers. We allocate dynamically as much memory as the roms require and restrict
NeoGeo to fetching gfx from any location outside of that. MAME has the possiblity 
to allocate any amount of memory they want and load the same rom twice or just fill 
the area with Zeros because of their driver system. Then you may ask why we dont
use drivers as MAME? Because we want NeoRAGEx to be able to run any dump not just
those that are out for the moment. But remember... we dont claim these dumps to be
incorrect... just not correct for NeoRAGE(x).

V0.6:
-----

- Major Changes in the drawing routines (faster and more accurate).
- Optimised ADPCM decoding.
- Sound drop bug fix (first boss in Aero Fighters 2 etc).
- 44khz sound output.
- VSYNC option if Tripple buffering enabled.
- Interpolated Sound option (44khz/MMX only).
- Possibility to record sound into wave file while playing(Output format will always be 22khz).
- Frameskip option (AUTO/0-11 out of 12).
- Full throttle mode supported (only if VSYNC is turned off) have always been there but undocumented.
- Option to show Frames/Sec.
- Volume +/- buttons remaped to '5' & '6'.
- Preview shot save (8-bit mode only) have always been there but undocumented.
- Faster loading times.
- And other stuff we have forgotten.


V0.5c
-----

- Sound bugfixes for some games that had problems before.
- Autofire option.
- Ability to select/deselect all objects in Shotfactory.
- And some other small fixes.

V0.5b
-----

- Joystick bug-fix.
- S3-chip hang at startup fix(If it still not works for you turn off 3dhardware accelaration).
- Samurai Shodown 4 hang fix (could fix some other oddities in other games too).
- Neo Bomberman support for existing sound dump.
- Gfx or exit bug fixed (occured when running several games without exiting the menu).
- Possibility to select Alternative background color in shots factory.
- Launch game with double click in gamelist.
- Vsync replaced with tripple buffering (no more tearing).
- Super sidekick works.
- Hit ENTER,SPACE or klick to skip menu init sequence.
- COIN is replaced with SELECT Buttons in consol mode.


Already supported in V0.5 but forgotten ;):
- Kiwi_Slt's CodeGeine Supported... press ABCD simultaneously to enter his menu. Use
  a hotkey if you have problems entering his menu.


V0.5:
-----
- Everything!

Installation:
-------------

Complete setup version:

Just click on NeoRAGEx_Setup.exe and follow the instructions. Put you roms in any 
subdirectories as you like (max 2 dirs). You will also need the Neo Geo system 
bios (neo-geo.rom) and system fix-file(ng-sfix.rom) or a zip-file named neogeo.zip 
with both these files in installed in the same directory as NeoRAGEx.exe or in your 
rom subdirectories.

Zip-setup version:

Unzip the NeoRAGEx.zip and put you roms in any subdirectories as you like (max 2 dirs).
You will also need the Neo Geo system bios(neo-geo.rom) and system fix-file(ng-sfix.rom)
or a zip-file named neogeo.zip with both these files in installed in the same directory 
as NeoRAGEx.exe or in your rom subdirectories.


Requirements:
-------------

Any Windows95/98/NT3.1 or later compatible computer with DirectX 3.0 or later installed.


A Breif users manual:
---------------------

First you have to import any roms into the NeoRAGEx system. To do that put your NeoGeo roms
into any directory that you want. Then change rompath1 or rompath2 in options/directories
so that they point at the directory with your roms in. As you might have noticed every game
in the gamelist to the left has been grey (unavailable) until now. Now press the IMPORT button. 
If everything went fine then some of the games in the gamelist should be white now (Remember
that the roms must be in a zip-file!!! NeoRAGEx doesnt support unzipped roms anymore). Select
a detected (white) game from the list and then press LAUNCH button to run it. To toggle between
Options menu and the game without exiting the game use TAB-key. You can only use Menu Option 
Shots Factory when in the menu from within a game by pressing TAB as mentioned above. You
can also save your position in the game using the F11-key. Pressing this key brings up the
Save State Menu. Just select any slot you desire to save into and press ENTER. You can load
a previus state by pressing F12. This brings up tha Load State Menu... 
BTW. All unrecognized dumps will be located at the bottom if the gamelist with a (?) mark.

The existing dumps of World Heroes Perfect, KOF 95, Kizuna Encounter all 
have incorrect sized roms to run with NeoRAGEx (KOF 95 was correct once 
before MAME cut it), so they will not work with NeoRAGEx as they are. 

Use romfix.bat to fix these 3 games. Unzip the files below that you want to fix 
into the same directory as romfix.bat and then run it. Put the modified roms back 
into their zip-files respectively. (TRY YOUR ROMS BEFORE YOU RUN THE ROMFIX THEY 
COULD BE THE CORRECT DUMP FOR NEORAGE!!!)

These are the correct sizes:
KOF95: KOF95_C5.ROM = 4MB
       KOF95_C6.ROM = 4MB
       KOF95_V2.ROM = 4MB
WHP:   WHP_C3.ROM = 4MB
       WHP_C4.ROM = 4MB
       WHP_C5.ROM = 4MB
       WHP_C6.ROM = 4MB
KE:    KE_C1.ROM = 4MB			
       KE_C2.ROM = 4MB			
       KE_C5.ROM = 4MB			
       KE_C6.ROM = 4MB			

Well, guess thats all for now... the rest is up to you to explore, enjoy!

Recomendations:
---------------

Certain Video cards force VSYNC if you use tripple buffering... this slows
down the emulation alot. If you have problems with speed turn tripple
buffering off.

If you have 60hz as refreshrate at res640x480 or res320x240
use tripple buffering with VSYNC and enable full 
throttle (press '9') to get the most steady frame rate.

Remember to try all the different options in Video menu to find out what 
works best on your hardware. And dont forget to checkout interpolation...


Known problems/todo list:
-------------------------

Linescrolling. Lack of this feature gives certain games gfx-glitches.

All games that don't have a preview picture on and are in the game list 
have some kind of defect either linescrolling or other bugs. The preview
pics are only included in the complete setup.

MAJOR sound optimisations is needed, we haven't optimised it at all. So its not
NeoRAGE speedy ;-). Exlude the ADPCM part.


Frequently Asked Questions/Troubleshooting:
-------------------------------------------

Where do I have to put my neo-geo bios files?
You can have them either unpacked or in a zip-file named neogeo.zip. Put them in
the same directory as NeoRAGEx.exe or in either rompath1 or rompath2.

Where do I put my roms?
In either rompath1 or rompath2. You can define your own rompaths in the 
options/directories menu.

How could i enter the menu without exiting the game?
Hit TAB

How could i enter the Dipswitch settings menu?
There are 2 ways to do this:
1. You can use F1 to switch between Dipswitch menu directly. No need to go through
NeoRAGE menu at all.
2. Or Enter the machine settings from the main menu. Select MVS Settings=ON. Accept
changes and reset NeoRAGE. Now you can change the softdip settings as you like.
When you are done leave the softdip and enter the NeoRAGE Main Menu again. 
Change MVS-Settings=OFF and reset NeoRAGE.
Note! Remeber to leave the dip-menu before Pressing F1 or reseting.

What does the (?) mean in the gamelist?
It means that the game is not a tested dump. But propably will run ok anyway. It has
nothing to do with the name of the dump!


COMMON KEYS:
------------

'TAB'	- Toggle in/out to system menu (Key redefenition etc)
'1'	- start 1 player game
'2'     - Coin1/Select
'3'     - start 2 player game
'4'     - Coin2/Select
'5'     - Volume -
'6'     - Volume +
'7'     - Record sound output
'8'     - Show/Hide frames/Sec
'9'     - Full throttle (ON/OFF)
'0'     - Save preview shot (8-bit only)
'F1'    - Reset (Toggle in/out to MVS-settings)
'F2'    - Audio Setting (ADPCM/FM/OFF)
'F3'    - 8/16-bit audio output
'F4'    - Audio channels (MONO/STEREO)
'F5'    - 8/16-bit colordepth
'F6'    - Scanlines (ON/50%/OFF)
'F7'    - Interpolation (ON/OFF)
'F8'    - Edge enhancement (ON/OFF)
'F9'    - Take Screenshot
'F11'   - Save state menu
'F12'   - Load state menu
'ESC'	- Hmmmm... what might this key do?

----------------------------------------------------------------------
KEYSETTINGS:
----------------------------------------------------------------------

Keys:
UP      - pl1 up
DOWN    - pl1 down
LEFT    - pl1 left
RIGHT   - pl1 right
A       - pl1 Button1
S       - pl1 Button2
D       - pl1 Button3
F       - pl1 Button4

NUMP 8  - pl2 up
NUMP 2  - pl2 down
NUMP 4  - pl2 left
NUMP 6  - pl2 right
B       - pl2 Button1
N       - pl2 Button2
M       - pl2 Button3
,       - pl2 Button4

Z       - pl1/pl2 hotkey1
X       - pl1/pl2 hotkey2
C       - pl1/pl2 hotkey3
V       - pl1/pl2 hotkey4

You can change the key layout in the options menu.

We will not respond on any questions about NeoGeo roms or bios.

e-mail:
-------
Anders Nilsson
anders.nilsson@mbox8.swipnet.se
Janne Korpela
janne@mbox370.swipnet.se


WORLD WIDE WEB
--------------

The NeoRage emulator will be available from the following sites:-

http://home5.swipnet.se/~w-50884 (Home Page)
http://www.emuclassics.com/pcarcade (The PC arcade)			
http://davesclassics.warzone.com (Daves Classics)
http://www.emuviews.com (Emu Views)


SPECIAL THANKS TO:
------------------

-araCORN for his work with dumps. Without him this emu propably wouldnt exist.
-Apollo69 for his work with dumps. Especially sound redumps.
-Peter and Chris at PC Arcade for their superb work with our homepage.
-Niell Corlett for his StarScream cpu core(68000k).
-Richard Bush for providing us with his YM2610 source and for being our favorite emu author.
-Hiromitsu Shioya for his remarkable work with the YM2610 source.
-Shin Seiki for his great spec on the Neo Geo hardware.
-Lance McKay for the idea with the faded scanlines.
-Peter and Chris at PC Arcade again :) for helping us out with the bugreports and suggestions. 
-Kiwi_slt for his great work on the code genie.


A FINAL WORD:
-------------

- We do not claim that we are the best and that all the other emu authors are lousy
  programmers as certain other emu authors do.

- We do not claim that we code entirely in machine code cause we stopped do that when
  we threw our C64's away. Only a fool would claim such a thing. Besides why do that 
  when writing in asm compiles just as fast code as writing it in machine code? Remeber 
  there is a difference between asm and machine code.

- We do not promise things that we cant keep as certain other emu authors do. We let 
  the users create their own opinion after using our emu.

- Our emu will cost exactly as much as it always has... nothing, nada, zippa, njetto!

- But, perhaps we are just two stupid swedes :-)
