                                     NEO
                       (R)eal (A)rcade (G)ame (E)mulator
			
                               Version 0.2d

                 (C) 1998 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 
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. 
        
ATTENTION:

We are VERY dissapointed in many people out there, we are doing alot of work on our spare time
and for free. And we couldn't imagine that so MANY people was so totally out of respect that they use
a hacked version of NeoRAGE. There will always be some scum that doesnt hesitate to hack our work. Even
to use a hacked version is respectless against us. When people that we trust and respect are
doing it we are loosing our motivation.

So don't expect any sound update soon, if ever to the public.

Introduction:
-------------

DO NOT EMAIL US ABOUT MEMORY PROBLEM!!!! You can easily calculate how much memory 
you will need to run the games. Take all _c?.rom and dont double it then add all 
_p?.rom and add about 3 meg for our code and ram areas that NeoRAGE is using.
And Dos4gw can handle memory spaces up to 4gig it has no 64mb limit even in pure dos.

Special Note for ver 0.2 and later:
-----------------------------------
You must have a Neogeo fix file named ng-sfix.rom in the same dir as 
NeoRAGE.exe. This file can be found in the bios package.

Whats New:
----------
NeoRAGE0.2d
- Some games was frezing the first time you started it with 0.2c but that should be eliminated now.
- Savestate bugfix again ;), unfortunally it can made your old state files useless with this version.
- Sidewinder player two bug-fix.
- Character bug-fix in some games.
- Super Sidekicks protection fix (thanks to whom discovered it).
- Fatal Fury 2 protection fix (thanks to whom discovered it).
- We have start to use PMODEW instead of DOS4GW
- Support for Samurai Shodown 4.
- Support for Art Of Fighting 3.
- Support for Blazing Star.
- Support for xxxxxxxxx ;).(Future Romlist releases)
- Support for xxxxxxxxx ;).(Future Romlist releases)
- And MS2(hate to do this:(. Because of the hacking lamers)

NeoRAGE0.2c
- Gigapower bug fix. (Varoius old games didnt like our gigapower support).
- Support for Realbout 2.


NeoRAGE0.2b
- Support for World Heroes 2 Jet.
- Art of Fighting 2 & Power Spikes 2 bug-fix.
- Div. other game related fixes.
- Sidewinder bug-fix.
- Sidewinder L & R button support.
- Gravis GPP support fixed.
- Save state-fix (make sure to wait for titlescreen in every game before loading state).
- Keyboard (UP/SHIFT) bug-fix.


NeoRAGE0.2
- Dipswitch settings
- Hotkey support
- Remappable buttons on sidewinder(untested) 
- Native zip support(only 8.3 names)
- Highscore savings in all games
- Save/load state in all games (F5=SaveState)(F9=LoadState)

New games:
- KOF 96
- Samurai Shodown 3
- Waku Waku 7
- Street Hoop
- Spinn Master
- Twinkle Star Sprites
- Magical Drop 3
- Real Bout Fatal Fury Special
- Fatal Fury 3
- Double Dragon
- Shock Troopers
- Quest of Jongmaster

Improvments on old games:
- Flickering sprite bugfix(Thanks Allard)
- Puzzle Depon fully playable(Thanks Allard)
- Word Heroes 1&2 playable
- King of monsters 2 playable
- Pulstar fully playable

NeoRAGE0.1b
- Non pentium bug-fix.
- Small animation bug-fix
- Small zoom bug-fix
- Super Spy is playable again
- Puzzle de Pon & King Of Monster2 are also back but they are not really playable
- Sidewinder Y-button = A+B and Z-button = C+D

NeoRAGE0.1
- Much lower memory requirements.
- Full background animations.
- Zoomed object clipping bug-fix.
- Language/System selection.
- Native Sidewinder & Gravis Gamepad Pro (not tested) support.
- Vesa bug-fix. More compatible.
- Faded scanlines. Choose between 25%, 50% and 100% (same as double). This is a very
  slow operation so its not recomended on slow machines.


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

Unzip the NeoRAGE.zip and put you roms in any subdirectory as you like.
You will also need the Neo Geo system bios(NeoGeo.rom) and system fix-file(ng-sfix.rom)
installed in the same directory
as NeoRAGE.exe.
Syntax: neorage 'dirname of game' [options] 
This version supports both the home console and arcade system. There is no
need to convert any roms, they will work as they are.

EX1. neorage cyberlip
EX2. neorage 3countb -v -s

Command-line options:
---------------------
-v         - Enable vsync(dissabled by default), dont use this if you have slow framerate.
-f?        - Frameskip ?=1-4 (you can toggle between frameskip settings with numpad +/-)
-vga       - VGA resoloution
-noanalyse - Skip the code analyse
-s         - Scanlines(Vesa)
-s25	   - 25% thinner scanlines, very slow! (Vesa)
-s50	   - 50% thinner scanlines, very slow! (Vesa)
-s100      - No scanlines, doubles every pixel which makes it possible to run 
             without scanlines in res 640x480, very slow! (Vesa)
-j         - Joystick(Not required anymore)
-modex     - Modex 320X240


Supported gameslist (memory requirements inside () are with sound, not supported yet):
---------------------------------------------------------------------------
Game name                            |GENRE          |MEMORY REQUIREMENTS |
---------------------------------------------------------------------------
2020 Super Baseball                  |Sport          | 06 (07) MB         |
3 Count Bout                         |Fighting       | 12 (17) MB         |
Aero Fighters 2 (Sonic Wings 2)      |Shooter        | 13 (16) MB         |
Aero Fighters 3 (Sonic Wings 3)      |Shooter        | 17 (23) MB         |
Aggressors of Dark Kombat            |Fighting       | 21 (26) MB         |
Alpha Mission 2 (ASO 2)              |Shooter        | 08 (13) MB         |
Andro Dunos                          |Shooter        | 12 (13) MB         |
Art of Fighting                      |Fighting       | 12 (16) MB         |
Art of Fighting 2                    |Fighting       | 21 (27) MB         |
Art of Fighting 3                    |Fighting       | 35 (42) MB         |
Baseball Stars 2                     |Sport          | 08 (10) MB         |
Blazing Star                         |Shooter        | 42 (50) MB         |
Blues Journey                        |Platform       | 07 (09) MB         |
Burning Fight                        |Arcade         | 08 (10) MB         |
Crossed Swords                       |3D             | 08 (09) MB         |
Cyber Lip                            |Platform       | 07 (09) MB         |
Double Dragon			     |Fighting       | 19 (24) MB         |		
Eightman                             |Arcade         | 07 (09) MB         |
Far East of Eden (Kabuki Klash)      |Fighting       | 21 (29) MB         |
Fatal Fury                           |Fighting       | 08 (10) MB         |
Fatal Fury 2                         |Fighting       | 12 (16) MB         |
Fatal Fury 3			     |Fighting       | 29 (40) MB         |		
Fatal Fury Special                   |Fighting       | 17 (22) MB         |
Football Frenzy                      |Sport          | 07 (09) MB         |
Galaxy Fight                         |Fighting       | 21 (27) MB         |
Ghost Pilots                         |Shooter        | 09 (10) MB         |
Goal! Goal! Goal!                    |Sport          | 21 (23) MB         |
Joy Joy Kid (Puzzled)                |Puzzle         | 05 (06) MB         |
Karnov's Revenge                     |Fighting       | 16 (18) MB         |
King of Fighters '94                 |Fighting       | 21 (27) MB         |
King of Fighters '95                 |Fighting       | 31 (37) MB         |
King of Fighters '96	             |Fighting       | 42 (48) MB         |	
King of Monsters                     |Fighting       | 08 (10) MB         |
Last Resort                          |Shooter        | 07 (09) MB         |
League Bowling                       |Sport          | 05 (06) MB         |
Magical Drop 3			     |Puzzle         | 21 (26) MB         |
Magician Lord                        |Platform       | 07 (09) MB         |
Metal Slug                           |Platform       | 21 (29) MB         |
Metal Slug 2                         |Platform       | 40 (50) MB         |
Mutation Nation                      |Arcade         | 08 (10) MB         |
Nam 1975                             |Shooter        | 07 (09) MB         |
Neo Drift Out                        |Racing         | 13 (17) MB         |
Neo Turf Masters                     |Sport          | 13 (21) MB         |
Ninja Combat                         |Arcade         | 07 (09) MB         |
Ninja Commando                       |Shooter        | 08 (11) MB         |
Power Spikes 2                       |Sport          | 10 (13) MB         |
Pulstar                              |Shooter        | 37 (41) MB         |
Puzzle Bobble (Bust-A-Move)          |Puzzle         | 09 (12)? MB        |
Quest of Jongmaster		     |Puzzle??       | 8  (11) MB         |	
Real Bout Fatal Fury Special	     |Fighting       | 40 (54) MB         |	
Real Bout Fatal Fury 2   	     |Fighting       | 60 (75) MB         |	
Robo Army                            |Arcade         | 07 (09) MB         |
Samurai Shodown                      |Fighting       | 14 (18) MB         |
Samurai Shodown 2                    |Fighting       | 21 (28) MB         |
Samurai Shodown 3		     |Fighting       | 33 (40) MB         |		
Samurai Shodown 4		     |Fighting       | 42 (51) MB         |		
Savage Reign                         |Fighting       | 21 (27) MB         |
Shock Troopers			     |Shooter        | 42 (49) MB         |
Sengoku                              |Arcade         | 08 (10) MB         |
Sengoku 2                            |Arcade         | 12 (15) MB         |
Soccer Brawl                         |Sport          | 07 (09) MB         |
Spinn Master			     |Platform       | 13 (15) MB         |
Street Hoop			     |Sport          | 21 (26) MB         |	
Super Sidekicks                      |Sport          | 08 (11) MB         |
Super Spy                            |3D             | 13 (17) MB         |
Trash Rally                          |Racing         | 07 (09) MB         |
Top Players Golf                     |Sport          | 08 (11) MB         |
Twinkle Star Sprites		     |Shooter        | 18 (26) MB         |
View Point                           |Shooter        | 08 (12) MB         |
Waku Waku 7			     |Fighting       | 37 (40) MB         |			
Windjammers                          |Sport          | 08 (12) MB         |
World Heroes                         |Fighting       | 12 (15) MB         |
World Heroes 2                       |Fighting       | 17 (21) MB         |
World Heroes 2 Jet                   |Fighting       | 21 (25) MB         |
xxxxxxxxxxRL!                        |Arcade         | xx (xx) MB         |
xxxxxxxxxxRL!                        |Shooter        | xx (xx) MB         |
---------------------------------------------------------------------------


Known problems/todo list:
-------------------------
Sound support, and we are working on that.

Specific game related problems:
Super Sidekicks2 - gfx glitches
TurfMaster - gfx glitches
World heroes 2 have still a minor glitch one tile row are missing sometimes 
(we have tracked all the gfx problems so it is hopefully history soon)

Frequently Asked Questions/Troubleshooting:
-------------------------------------------
I get a message 'Unable to initialize VESA'. Whats wrong?
Your graphic card doesnt support 320x240 vesa res or 640x480 if you use -s, try 
to download scitech display doctor.

My screen just get black when i try to start the games?
Try -n (noscanlines) if your display just gets black.
Try -vga if you have trouble with the modex resoloutions

I have no sound?
It is not implemented yet, but we are working on it.

How could i enter the menu?
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.

The colors are wrong in some moments in vga or modex?
Try to hit Space it will rearrange all colors, we must do some complex palette
mapping to get it to work as good as possible because we have only 256 colors
available in our supported resoloutions and sometimes it would help to rearrange
all colors. We are updating the colors all the time but if the game has
locked up a big scale with colors it could help.

Everything freezes when I load a saved state, why?
Make sure that you wait for the title screen to appear before loading state, right
after starting NeoRAGE.

While defining hotkeys its very hard to press all the buttons at once?
Hold down all the buttons you want to map to the selected key and press [ENTER].


Common Keys:
-----
'1'	- start 1 player game
'3'     - start 2 player game
'2'     - Selectbutton player one
'4'     - Selectbutton player two
'TAB'	- To enter system menu (Key redefenition etc)
'PGD'   - To scroll the visible area in vga mode
'PGUP'  - To scroll the visible area in vga mode
'F10'   - To Toggle between full throttle and not.
'F12'   - HotKey to enter Code Genie
'F8'    - Take a screen dump.
'F5'    - Savestate
'F9'    - Loadstate
'SPACE' - To Rearrange the whole palette.
'ESC'	- Hmmmm... what might this key do?
'+'	- Increase frameskip
'-'	- Decrease frameskip


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

Keys:
UP      - pl1 up
DOWN    - pl1 down
LEFT    - pl1 left
RIGHT   - pl1 right
,       - pl1 Button1
.       - pl1 Button2
/       - pl1 Button3
RSHIFT  - pl1 Button4

T       - pl2 up
G       - pl2 down
F       - pl2 left
H       - pl2 right
LSHIFT  - pl2 Button1
<       - pl2 Button2
Z       - pl2 Button3
X       - pl2 Button4

You can change the key layout in the menu pressing 'TAB'.

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://dspace.dial.pipex.com/dodge/ (The PC arcade)			
http://www.davesclassics.com (Daves Classics)
http://www.emuviews.com (Emu Views)
http://www.myspace.co.uk/dodge/ragemirror/rage.htm (Rage Mirror)


-SPECIAL THANKS TO:
-araCORN for his work with dumps. Without him this emu propably wouldnt exist.
-Peter and Chris at PC Arcade for their superb work with our homepage and keeping a mirror for us.
-Niell Corlett for his StarScream cpu core(68000k). 
-Shin Seiki for his great spec on the Neo Geo hardware.
-Marius Fodor & Robert William Grubbs for their Sidewinder drivers.
-Marius Fodor for the Gravis gamepad pro driver.
-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 readme.html and of course the code genie.
