WinKawaks

===================================================
|¯| /¯/ _____
| |/ / |¯¯¯ |¯| /¯||¯||¯¯¯ |¯| /¯/ / ____|
| / | | | | / || || | | |/ / | /
| | |_| || |/ |/ /| |_| || / | ____
| | | _ || /| / | _ || ____
| | | | | || / | / | | | || | ____/ |
|_| _|_| |_||_/ |_/ |_| |_||_| _|______/
(handmade with pride)
===================================================
THE EMULATOR WITH A FUNNY NAME
===================================================

THIS FAQ IS RELATIVE TO KAWAKS 1.45 (AND LATER, HOPEFULLY)
IF YOU ARE USING AN OLDER KAWAKS, PLEASE UPGRADE, BECAUSE
THE BUGS YOU ARE EXPERIENCING ARE LIKELY TO BE FIXED NOW.
http://kawaks.retrogames.com


First of all, I'd like to thank all those who made Kawaks possible.

- The CPS2Shock team for their wonderfull work and their continuous support.
- Nicola Salmoria and MAMEdev for their invaluable CPS1/2/MVS MAME drivers.
- Mike Coates & Darren Olafson for their great 68000 emulation core.
(used in Kawaks since 1.20)
- Bart Trzynadlowski for his great 68000 emulation core (Turbo68K) and support.
(used in Kawaks up to version 1.14)
- Neil Bradley for his great Z80 emulation core, M-Z80 (used for CPS1&2 emulation)
- Richard Mitton for his excellent Z80 emulation core, RAZE (used for NeoGeo emulation)
- Jarek Burczynski for his YM2151 sound core
- Tatsuyuki Satoh & Hiromitsu Shioya for their YM2610 sound core
- ElSemi for the nice chats, and his precious information :)
- Derek Liauw aka Kreed for his awesome 2xSai/SuperSai/SuperEagle blitters
- My small group of beta testers, who've been extremely patient with all my
babbling and all those useless binaries I kept sending ;)
- The ZLIB team. You have zipped support in Kawaks and just about any other
emulator thanks to them.
- Sardu for showing the way, and providing me with countless hours of intense
fun :)

I just hope I didn't forget anyone...


Now, on to the questions.


===========================================================================
HOW DO I USE THIS ?
THIS GAME DOESN'T SHOW IN THE LOAD BOX WHEN I SET SHOW ONLY AVAILABLE
IT SAYS "COULDN'T FIND 'SOMENAME' (SOMEODDNUMBER) FOR GAME SOMEGAME"
===========================================================================
First, obviously, you need to have the roms for the game you're trying to run.
Do not ask me where you can find them.

Romsets have to be zipped. The zip has to have the correct name
(have a look at the load box, it shows the zip name next to the game title)

Make sure your zips are in a place where Kawaks knows they are.
Set up your rom paths with the item in the Files menu

If you're trying to play NeoGeo games, you need NEOGEO.ZIP, with
NG-LO.ROM, NEO-GEO.ROM and NG-SFIX.ROM

You have to make sure your roms match the ones used by Kawaks
-Try and make an Audit (tools menu) to know what's wrong
-Clean up your romsets with
RomCenter (http://www.romcenter.com)
or ClrMAMEPro (http://www.mameworld.net/clrmame)
The dat files these programs need can be generated by Kawaks (tools menu)
Name errors don't matter much, but the CRC errors do matter.

If you're using old neorage roms (names like N2105465.078) you may need to convert
them with Redump (it's available on my homepage)


===========================================================================
IT CRASHES ON ME ON STARTUP SAYING SOMETHING ABOUT WS2_32.DLL
IT CRASHES ON ME ON STARTUP SAYING SOMETHING ABOUT MFC42.DLL
IT CRASHES ON ME ON STARTUP SAYING SOMETHING ABOUT MSVCIRT.DLL
IT CRASHES ON ME ON STARTUP SAYING SOMETHING ABOUT MSVCRT.DLL
IT CRASHES ON ME ON STARTUP SAYING SOMETHING ABOUT MSVCP60.DLL
===========================================================================
These files are available on the Kawaks homepage.
DLLs should be put into your WINDOWSSYSTEM directory


===========================================================================
NOTHING HAPPENS WHEN I TRY TO LAUNCH KAWAKS
===========================================================================
You may have a wrong version of some files that are needed by Kawaks.
See above.


===========================================================================
KAWAKS MAKES AN ERROR LOADING [INSERTGAMENAME]. IT USED TO WORK :/
===========================================================================
Read ROMCHANGES.TXT


===========================================================================
I GET AN ERROR ABOUT DIRECT SOUND
===========================================================================
I bet you don't have a sound card.
I'm sorry but Kawaks does need one.


===========================================================================
GAMES ASK ME FOR NEO-GEO.ROM OR NG-SFIX.ROM OR NG-LO.ROM
WHERE DO I STICK NEOGEO.ZIP
===========================================================================
For NeoGeo games to run, you need to have the BIOS. The BIOS is composed
of three files : NEO-GEO.ROM, NG-SFIX.ROM and NG-LO.ROM
You must put them in a zip named NEOGEO.ZIP, which you have to
store in one of your roms directories.

You don't have to put NEO-GEO.ROM, NG-SFIX.ROM and NG-LO.ROM in each of your
NeoGeo game zips. Just NEOGEO.ZIP is good


===========================================================================
NEOGEO GAMES DON'T DISPLAY SPRITES OR BACKGROUNDS, JUST SOME TEXT
===========================================================================
You have a wrong 000-lo.lo. Get the good one (size: 64kb, CRC32: e09e253c)


===========================================================================
INSERT COIN DOESN'T WORK IN NEOGEO GAMES
===========================================================================
You have bad NeoGeo BIOS files (inside NeoGeo.zip).
Get a correct NeoGeo.zip


===========================================================================
AUDIT SAYS MY NG-LO.ROM IS BAD :(
===========================================================================
The correct version of NG-LOG.ROM is 64kb. I guess you have the 128kb
version.

The 64kb version is actually a trimmed version of the 128kb one.

Kawaks only reads the first 64kb of the NG-LO.ROM you have, so in the end
for the emulator, it's just as if you had the 64kb version.
It changes nothing emulation-wise, so don't be alarmed, and continue to play :)


===========================================================================
THAT NEOGEO GAME IS IN JAPANESE ! I WANT ENGLISH
===========================================================================
Kawaks has options for you to choose the country of your virtual NeoGeo
Look in the Game menu. You can choose from an arcade machine or a console,
and between Japanese/European and American.
Sometimes though, the European of a game is still in Japanese...


===========================================================================
NOTHING HAPPENS AFTER LOADING THE ROM
===========================================================================
Yes, games do not start automatically. You have to press Enter, or use
that Start/Pause emulation item in the Files menu.

This is the way it is because it allows one (like me) to start using the
68000 debugger before the CPU starts running. It also allows to change
potential emulation options before the game starts. etc etc etc.

If you don't like this, there's an Autostart option that will make games
start automatically after you load them.


===========================================================================
TRIPLE BUFFERING DOESN'T SEEM TO WORK FOR ME
===========================================================================
First, it only works in full screen
Then, make sure you haven't disabled vsync in your video card's parameters


============================================================================
WILL YOU EMULATE [INSERT GAMENAME] ? I EVEN HAVE THE ROMS !!
============================================================================
If a game is not in Kawaks, there are good reasons.

Namely :

CPS2 games that are not supported are not in there because ROMs are encrypted,
and the extra data for decryption is unavailable.

NeoGeo games that are not supported are not in there either because :
- Their encryption is not figured out yet
- They're a lot too recent to be included in an emulator. They still bring
profit to their manufacturers.

Lastly, you're just thinking about a game that runs on a totally different
hardware than what Kawaks emulates.
That includes:
* Marvel Versus Capcom 2
* Capcom Versus SNK
* Capcom Versus SNK 2
* Street Fighter EX 1 / 2 / 1+ / 2+ / 3 ...


============================================================================
WHAT'S WITH THE CAPCOM VS SNK BACKGROUND LOGO THEN ?
============================================================================
That's just because Kawaks emulates some Capcom and some SNK games :))


============================================================================
IT'S SO SLOW HERE :/
HOW TO HAVE IT GO FASTER ?
============================================================================
First, you should try to modify the UseVRAM in the INI. If it's 0, set it
to 1, and if it's 1, set it to 0. It can have a HUGE effect.

Now, if it's still too slow, try using a faster blitter.
Alternate scanlines is a lot faster than regular scanlines, and a LOT faster
than 50% scanlines. Normal blitter may be a little faster than Alternate
scanlines depending on the PC/gfx card.

Don't enable Interframe blending, it slows things down a great deal.

Then, make sure you set DisableJoystick to 1 in the INI if you don't use a
joystick/pad, but you have one.

Then, set a lower sound frequency. Search for SoundFrequency in the INI
and set it to 22050 or even 11025.

Then, you may want to disable effects like BgHi for CPS1 or Masking for CPS2.
The gfx issues they fix may not be worth the slowdown for you.

Then, you might want to set TaskPriority to 128 in the INI, though I'm not sure
this has a big impact.

After all that, you may try and play Kawaks in fullscreen rather than windowed
mode. It should be a tad faster (and it's perfectly normal).


===========================================================================
IT RUNS WAY TO FAST !
===========================================================================
Really ? Just try and see if you haven't enabled Turbo by accident :)


===========================================================================
WHAT BLITTER SHOULD I USE ?
===========================================================================
If you have a fast PC that can run them all, then it's just a matter of taste.
Now, if you have a slower PC here's a classement of the current blitters from
fastest to slowest, with a ratio to indicate approximatively related speed:

Normal : 100%
Alternate scanlines: 100%
Scanlines 180%
Scanlines 50% 340%
Zoom 2x Software 340%
2xSai 580%
Scanlined 75% 2xSai 590%
Super2xSai 600%
SuperEagle 600%


Those figures were obtained on my computer, they may differon yours, but they
should give you fair idea of their respective performances already.

You can see for example that Super2xSai is 6x slower than alternate scanlines.


============================================================================
HOW DO I USE KAWAKS IN 640x480 IN FULLSCREEN ?
============================================================================
Yes, you can use 640x480 by enabling Fullscreen correct ratio (smaller display)
in the menu or setting FullScreenCorrectRatio=1 in WinKawaks.ini


============================================================================
HOW DO I CHANGE DIFFICULTY AND SETTINGS IN GAMES ?
============================================================================
Press F11 while playing.
You can redefine this key in the redefine keys dialog box. ("Test menu" item)


============================================================================
WHAT ARE THE DEFAULT KEYS ?
============================================================================

Test menu: F11
Reset: F10

P1 Coin: F3
P1 Start: F1
P1 Up: Up
P1 Down: Down
P1 Left: Left
P1 Right: Right
P1 b1: A
P1 b2: S
P1 b3: D
P1 b4: Z
P1 b5: X
P1 b6: C

P2 Coin: F4
P2 Start: F2
P2 Up: U
P2 Down: J
P2 Left: H
P2 Right: K
P2 b1: Insert
P2 b2: Home
P2 b3: PgUp
P2 b4: Del
P2 b5: End
P2 b6: PgDn

P3 and P4 work, you can define their keys, but they are by default undefined.