ZiNc
Beta Release 0.9 - April 9, 2002
Emulator by The_Author and DynaChicken
Renderers by Pete Bernert and Lewpy
English readme by R. Belmont
======================================

What's this?
------------
ZiNc is an emulator for Sony ZN-1 (get it?) and ZN-2 and Namco System 11 
arcade hardware.  These systems are all based around the familiar 
PlayStation game console with varying degrees of modifications.  

What's it play?
---------------
Games supported in this version are:

Street Fighter EX (JP)
Street Fighter EX (ASIA)
Street Fighter EX Plus (USA)
Street Fighter EX Plus (JP)
Street Fighter EX 2 (JP)
Street Fighter EX 2 PLUS (JP)
Star Gladiator 2 (JP)
Rival Schools (ASIA)
Justice Gakuen (JP)
Strider Hiryu 2 (JP)
Strider 2 (USA)
Kikaioh (JP)
Battle Arena Toshinden 2 (JP)
Tetris The Grand Master (JP)
Sonic Wings Limited (JP)
Beastorizer (bootleg)
Psychic Force (JP)
Magical Date EX (JP)
Soul Edge (JP) Ver. A
Soul Edge (JP) Ver. C
Tekken (JP) Ver. A
Tekken 2 (JP) Ver. B
Dancing Eyes (JP) Ver. A
Xevious 3D/G (JP) Ver. A
Star Sweep (JP) Ver. A
Kosodate Quiz My Angel 3 (JP) Ver. A

NOTE: R. Belmont is writing this readme, but neither he, Farfetch'd, nor 
Sarayan wrote this emulator and we probably can't help you with any deep 
technical problems with it.

What's new since ZiNc 0.5?
--------------------------
- fixed s11 eeprom
- added test switch to sonic wings limited
- added --renderer=<renderer_name> switch to choose rendering plugin
- added --controller=<controller_name> switch to choose jamma plugin
- fixed crashing bug for Kosodate Quiz My Angel 3
- added test switch to Psychic Force
- added 2nd player to all drivers
- on error now returns 1 and 0 on sucess
- controller plugin support
- tekken 2 geometry fix (BIG HUGE THANKS to calb from ePSXe for this fix!)
- removed dynachicken tuning switches, nobody could understand them and
  everyone managed to piss away all their performance with them so
  we now use hardcoded values that run all games quickly without crashing.
- crc32 checking added for ROMs.  incorrect/hacked ROMs will no longer
  be allowed to load.
- psychic force sample rom renamed to match reality
- input mini-SDK included with instructions on how to write a
  controller plugin.
- default keys remapped a bit for tekken/soul edge.  to remap them
  further write a plugin or wait for someone else to.


Pete's new OpenGL and Direct3D renderers (included with ZiNc 0.8) have
these new features:
- texture fixes for tekken and tekken 2 (still not perfect)
- rotated games now automatically swap the X and Y resolutions, so you 
  get a reasonable aspect ratio (no more fat and wide Sonic Wings Limited).
  NOTE that rotation may introduce garbage lines into the picture with the
  Direct3D renderer.  OpenGL does not have this problem.


What's wrong with it?
---------------------
WARNING WARNING WARNING: Sonic Wings Limited may lock up your entire system 
if you let it go into attract mode after the title appears.  To avoid this, 
insert coins and start a game immediately.  Once you are in game there are 
no hazards and it plays great.

There is no sound in System 11 games because we do not know the "Namco 195" 
sound CPU.  It may be a 680x derivative or a Hitachi Z8 series 
microcontroller.  If you know anything about this or are able to figure 
out info please let us know.

How to use?
-----------
Put roms in the roms/ dir where the emulator is.
Make sure a cfg/ dir exists.

On Win32, you may choose OpenGL, Direct3D, or other rendering by 
using the --renderer switch.  The default "renderer.znc" is the Direct3D
one (it's the same identical file as d3d_renderer.znc).

For users with 3dfx cards, the GLIDE renderer is not included in this 
package but is available for download at http://www.impactemu.com/.

type zinc --help to get help
type zinc --list-games to see games
type zinc x - where x is a game nr to start game

type zinc by itself to see all the available options.

Options are:
--help shows help
--list-games lists all games supported
--version shows the version info
--verify verifies a ROM set
--use-config-file=<value> gets Zinc config info from the filename specified.
--use-renderer-cfg-file=<value> gets renderer config info from the filename 
                                specified.
  A sample renderer config file is provided as "renderer.cfg".
--roms-directory=<value> sets the directory to load ROMs from
--use-sound=<yes|no>            def: yes  turns sound on/off
--renderer=<value>				def: renderer.znc  choose renderer to use
--controller=<value>			def: controller.znc  choose controller plugin
--use-controller-cfg-file=<value>  def: N/A  gets controller config info from
                                   the specified file.  the default
                                   keyboard plugin ignores this.
--sound-filter-enable=<yes|no>  def: no   turns the sound filter on/off,
                                          provides a quality increase 
                                          with a tiny amount more CPU.
--sound-filter-cutoff=<value>   def: 22050   sets the filter cutoff 
                                             frequency.
--sound-surround-lite-enable=<yes|no> def: no  Enables "Lite-Surround".  Try 
                                               it and listen :)
--sound-surround_lite-multiplier=<value> def:  40  Adjusts how powerful the 
                                                   lite-surround is.
--sound-stereo-exciter=<yes|no> def: no   enables "stereo exciter" which 
                                          widens the stereo image.  Try it 
                                          and listen :)
--use-slow-geometry=<yes|no>    def: no	  uses slower but more accurate 
                                          geometry calculations.  if you see
										  errors, try this as a fix.


KEYS:

1 - Start player 1
2 - Start player 2
4 - Enter test menus
5 - Coin player 1
6 - Coin player 2

Cursor Keys - joystick directions (left, right, up, down)

A,S,D,F,G,Z,X,C - buttons

Q,W,E,R - cursors in test menu

ESC - exits the emulator

F5 - take a snapshot (may depend on the renderer)

The renderers also make use of the insert/home/pageup/delete/end/pagedown
keys for various functions.  These should work approximately the same as
in popular PlayStation emulators.

Troubleshooting
---------------

The first time you run Psychic Force you may go into the test menu.
Select "Factory Defaults" then "Yes" then "Exit".  The screen will say 
"RESET" and just sit there.  Wait a second or two then quit the 
emulator and restart it.  Psychic Force will then play correctly.

Enjoy and have fun!
(c) 1997-2002 The_Author and DynaChicken.  All Rights reserved.
This emulator may be freely distributed as long as the ROM files are not
included.  All game names are trademarks of their makers.


Rom info
--------

System 11 games

Dancing Eyes (danceyes.zip)

"dc1ver-a.2l", 0xb164ad67
"dc1ver-a.2j", 0x28e4cb3d
"dc1ver-a.2k", 0xbdd9484e
"dc1ver-a.2f", 0x25a2f06f
"dc1rom0l.5",  0x8b5b4b13
"dc1rom0u.6",  0x93ca9bd0
"dc1rom1l.3",  0x380e0282
"dc1rom1u.8",  0x47d966a7
"dc1rom2l.4",  0x8f130220
"dc1rom2u.7",  0x24514dc6
"dc1rom3l.1",  0xa76bcd4c
"dc1rom3u.9",  0x1405d123

Xevious 3d/g (xevi3dg.zip)

"xv31vera.2l", 0x419e0f13
"xv31vera.2j", 0xdf95373a
"xv31vera.2k", 0x3d58138e
"xv31vera.2f", 0x9e8780a2
"xv31-r0l.5",  0x24e1e262
"xv31-r0u.6",  0xcae38ef3
"xv31-r1l.3",  0x46b4cb72
"xv31-r1u.8",  0xbe0eb5d1
"xv31-r2l.4",  0x8403a277
"xv31-r2u.7",  0xecf70432

Soul Edge ver A (souledge.zip)

"so1ver-a.2l", 0xbafb94c8
"so1ver-a.2j", 0xabe2d28e
"so1ver-a.2k", 0x29bdc6bb
"so1ver-a.2f", 0xc035b71b
"so1rom0u.5",  0xe364d673
"so1rom0l.6",  0x9c5b0858
"so1rom1u.3",  0x8f9d8c5b
"so1rom1l.8",  0x4406ef16
"so1rom2u.4",  0xb4baa886
"so1rom2l.7",  0x37c1f66e
"so1rom3u.1",  0xf11bd521
"so1rom3l.9",  0x84465bcc

Soul Edge ver C (souledge.zip)
"so1ver-c.2l", 0x12b8ae0d
"so1ver-c.2j", 0x938262b0
"so1ver-c.2k", 0x1789e399
"so1ver-c.2f", 0x8cffe1c3
"so1rom0u.5",  0xe364d673
"so1rom0l.6",  0x9c5b0858
"so1rom1u.3",  0x8f9d8c5b
"so1rom1l.8",  0x4406ef16
"so1rom2u.4",  0xb4baa886
"so1rom2l.7",  0x37c1f66e
"so1rom3u.1",  0xf11bd521
"so1rom3l.9",  0x84465bcc

Tekken version A (tekken.zip)

"te1ver-b.2l", 0x4291afee
"te1ver-b.2j", 0x5c534705
"te1ver-b.2k", 0xb9860b29
"te1ver-b.2f", 0x3dc01aad
"te1rom0l.5",  0x03786e09
"te1rom0u.6",  0x75d91051
"te1rom1l.3",  0x81416f8e
"te1rom1u.8",  0xfa7ba433
"te1rom2l.4",  0x41d77846
"te1rom2u.7",  0xa678987e

Star Sweep (starswep.zip)

"stp1vera.1j", BIOS_FILE,	 0x000000,	0xef83e126
"stp1vera.1l", BIOS_FILE,	 0x200000,	0x0ee7fe1e

Tekken 2 version B (tk2b.zip)

"te2ver-b.2l", 0xaa9a4503
"te2ver-b.2j", 0x63706d8c
"te2ver-b.2k", 0x668ca712
"te2ver-b.2f", 0xc4f66a0a
"te2rom0l",	   0xfc904ede
"te2rom0u",	   0x57b38f5d
"te2rom1l",	   0xaa48f04b
"te2rom1u",	   0xb147c543
"te2rom2l",	   0xb08da52c
"te2rom2u",	   0x8a1561b8
"te2rom3l",	   0xd5ac0f18
"te2rom3u",	   0x44ed509d


Kosodate Quiz My Angel 3 version A (myangel3.zip)

"kqt1vera.1j",	0xdf7aef8a
"kqt1vera.1l",	0xffc51c01
"kqt1pr0l.bin",	0xd67eee66
"kqt1pr0u.bin",	0x4d1c7bf3
"kqt1pr1l.bin",	0x298d8eeb
"kqt1pr1u.bin",	0x911783db




ZN-1 and ZN-2 games

ZN-1 BIOS (firmware.zip)
"zn-1.bin"  0x50033af6

Tetris the Grand Master (tgmj.zip)

"ate-04j",  0xbb4bbb96
"ate-05",   0x50977f5a
"ate-06",   0x05973f16
"ate-02",   0xf4f6e82f
"ate-01",   0xa21c6521

Street Fighter EX (Japan) (sfex.zip)

"sfe-04a",	0x08247bd4
"sfe-05m",	0xeab781fe
"sfe-06m",	0x999de60c
"sfe-07m",	0x76117b0a
"sfe-08m",	0xa36bbec5
"sfe-09m",	0x62c424cc
"sfe-10m",	0x83791a8b
"sfe-02",   0x1908475c
"sfe-03",   0x95c1e2e0
"sfe-01m",	0xf5afff0d

SFEX (Asia) (sfex.zip)

"sfe-04a",	0x08247bd4
"sfe-05m",	0xeab781fe
"sfe-06m",	0x999de60c
"sfe-07m",	0x76117b0a
"sfe-08m",	0xa36bbec5
"sfe-09m",	0x62c424cc
"sfe-10m",	0x83791a8b
"sfe-02",   0x1908475c
"sfe-03",   0x95c1e2e0
"sfe-01m",	0xf5afff0d

Street Fighter EX Plus (USA) (sfexp.zip)

"sfp-04e",	0x305e4ec0
"sfp-05",	0xac7dcc5e
"sfp-06",	0x1d504758
"sfp-07",	0x0f585f30
"sfp-08",	0x65eabc61
"sfp-09",	0x15f8b71e
"sfp-10",	0xc1ecf652
"sfp-02",   0x1908475c
"sfp-03",   0x95c1e2e0
"sfp-01",	0xf5afff0d

SFEX Plus (Asia) (sfexp.zip)

"sfp-04j",	0x18d043f5
"sfp-05",	0xac7dcc5e
"sfp-06",	0x1d504758
"sfp-07",	0x0f585f30
"sfp-08",	0x65eabc61
"sfp-09",	0x15f8b71e
"sfp-10",	0xc1ecf652
"sfp-02",   0x1908475c
"sfp-03",   0x95c1e2e0
"sfp-01",	0xf5afff0d

Battle Arena Toshinden 2 (ts2j.zip)

"ts2j-04",	0x4aba8c5e
"ts2-05",	0x7f4228e2
"ts2-06m",	0xcd7e0a27
"ts2-08m",	0xb1f7f115
"ts2-10",	0xad90679a
"ts2-02",   0x2f45c461
"ts2-01",	0xd7a505e0

Star Gladiator 2 (sg2j.zip)

"sg2j-04",	0xcf4ce6ac
"sg2-05m",	0xf1759236
"sg2-06m",	0x33de4f72
"sg2-07m",	0x72f724ba
"sg2-08m",	0x9e169eee
"sg2-09m",	0x33f73d4c
"sg2-02",   0x415ee138
"sg2-03",   0x43806735
"sg2-01m",	0x643ea27b

Street Fighter EX2 (sfex2.zip)

"ex2j-04",	0x5d603586
"ex2-05m",	0x78726b17
"ex2-06m",	0xbe1075ed
"ex2-07m",	0x6496c6ed
"ex2-08m",	0x3194132e
"ex2-09m",	0x075ae585
"ex2-02",   0x9489875e
"ex2-01m",	0x14a5bb0e

Street Fighter EX2 Plus (sfex2p.zip)

"sf2p-04",	0xc6d0aea3
"sf2p-05",	0x4ee3110f
"sf2p-06",	0x4cd53a45
"sf2p-07",	0x11207c2a
"sf2p-08",	0x3560c2cc
"sf2p-09",	0x344aa227
"sf2p-10",	0x2eef5931
"sf2p-02",	0x3705de5e
"sf2p-03",	0x6ae828f6
"sf2p-01",	0x14a5bb0e

Strider Hiryu 2 (Japan) (sr2j.zip)

"hr2j-04",	0x0824ee5f
"hr2-05m",	0x18716fe8
"hr2-06m",	0x6f13b69c
"hr2-07m",	0x3925701b
"hr2-08m",	0xd844c0dc
"hr2-09m",	0xcdd43e6b
"hr2-10m",	0xd95b3f37
"hr2-02",	0xacd8d385
"hr2-01m",	0x510a16d1
"hr2-01m",	0x510a16d1


Strider 2 (USA) (sr2j.zip)

"hr2-04u",	0x6e18a49d
"hr2-05m",	0x18716fe8
"hr2-06m",	0x6f13b69c
"hr2-07m",	0x3925701b
"hr2-08m",	0xd844c0dc
"hr2-09m",	0xcdd43e6b
"hr2-10m",	0xd95b3f37
"hr2-02",	0xacd8d385
"hr2-01m",	0x510a16d1
"hr2-01m",	0x510a16d1

Kikaioh (Japan) (kikaioh.zip)

"kioj-04",	0x3a2a3bc8
"kio-05m",	0x98e9eb24
"kio-06m",	0xbe8d7d73
"kio-07m",	0xffd81f18
"kio-08m",	0x17302226
"kio-09m",	0xa34f2119
"kio-10m",	0x7400037a
"kio-02",	0x174309b3
"kio-03",	0x0b313ae5
"kio-01m",	0x6dc5bd07

Rival Schools (Asia) (rvschool.zip)

"jst-04a",	0x034b1011
"jst-05m",	0x723372b8
"jst-06m",	0x4248988e
"jst-07m",	0xc84c5a16
"jst-08m",	0x791b57f3
"jst-09m",	0x6df42048
"jst-10m",	0xd7e22769
"jst-11m",	0x0a033ac5
"jst-12m",	0x43bd2ddd
"jst-13m",	0x6b443235
"jst-02",	0x7809e2c3
"jst-03",	0x860ff24d
"jst-01m",	0x9a7c98f9

Justice Gakuen (Japan) (rvschool.zip)

"jst-04j",	0x28b8000a
"jst-05m",	0x723372b8
"jst-06m",	0x4248988e
"jst-07m",	0xc84c5a16
"jst-08m",	0x791b57f3
"jst-09m",	0x6df42048
"jst-10m",	0xd7e22769
"jst-11m",	0x0a033ac5
"jst-12m",	0x43bd2ddd
"jst-13m",	0x6b443235
"jst-02",	0x7809e2c3
"jst-03",	0x860ff24d
"jst-01m",	0x9a7c98f9

Sonic Wings Limited (sncwgltd.zip)

"ic5.bin",  0x458f14aa
"ic6.bin",  0x8233dd1e
"ic7.bin",  0xdf5ba2f7
"ic8.bin",  0xe8145f2b
"ic9.bin",  0x605c9370
"ic11.bin", 0xa93f6fee
"ic12.bin", 0x9f584ef7
"ic13.bin", 0x652e9c78
"ic14.bin", 0xc4ef1424
"ic15.bin", 0x2551d816
"ic16.bin", 0x21b401bc

Beastorizer (Japan, bootleg) (beastorizer.zip)

"1",		0x820855e2
"2",		0x1712af34
"4",		0xbff21f44
"5",		0x10fe6f4d

Psychic Force (Japan) (psyforce.zip)

"e22-03.19",  0x8372f839
"e22-04.21",  0x397b71aa
"e22-10.7",   0xf6341d63
"e22-05.2",   0x7770242c
"e22-02.16",  0x03b50064
"e22-07.22",  0x739af589
"e22-01.15",  0x808b8340

Magical Date EX (Japan) (mgcldate.zip)

"e32-01.1",		0xcf5f1d01
"e32-03.12",	0x190d1618
"e32-09.7",		0xdb7ec115
"e32-08.2",		0x3d42cd28
"e32-02.6",		0x61c8438c
"e32-03.12",	0x190d1618
"e32-10.22",	0xadf3feb5
"e32-04.15",	0xc72f9eea
