
 Sega System C2 Emulator for windows 
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 Version 0.2b/wa
 ---------------

 based on the original dos version :
 by Charles Mac Donald
 E-mail: cgfm2@hooked.net
 WWW: http://cgfm2.emuviews.com/

 Windows port :
 by NeoZeed / Pascal Bosquet
 E-mail: pastorama@hotmail.com
 WWW: http://www.system16.com/pastorama/sc

 Requirements
 ~~~~~~~~~~~~

 Windows 9x with at least DirectX5

 Because the port share mainly all DirectX code with Past-O-Rama
 (www.system16.com/pastorama) , the emu'll not work properly under Windows NT !!!

 I don't have tried under Windows 2000 and Me.

 What's New
 ~~~~~~~~~~
 [ Version 0.2b/wa ]
 - initial release
 - In synchro with the 0.2b dos version
 - missed options : - scanlines rendering
                    - stereo sound
                    - FPS
 - added option   : - Blur

 the following is mainly extracted (99,99%) from the original readme text :

 Known Issues
 ~~~~~~~~~~~~
 It is important to know that this emulator is by no means complete, and
 as such has some problems.

 Due to protection, not all games are playable, and playable games may have
 problems (such as missing sound, resets / lockups, or gameplay issues).

 YM3438 sound does not work properly in some games, due to a lack of timer
 emulation. uPD7759 sample playback is too slow, and banked sample ROMs
 aren't supported.

 Not all games will display correct colors. You can switch between a
 fixed palette suitable for all games, or a dynamic palette which may
 work for others. The default palette mode is picked based on the game
 being played.

 The emulation will only works with windows desktop colors set to 16 bits !!!!
 The port support both 16 bits format (565 or 555) , but the 555 was not tested.    

 Don't hassle Charles for any problem with this Windows version. 

 Required ROMs
 ~~~~~~~~~~~~~

 ROM files can be put in two places:

     /ziproms/<gamename>.zip        (for zipped ROMs)

     /roms/<gamename>/<files>       (for unzipped ROMs)

 I haven't tried running games from archives with excess junk or
 directory structures within them. I use clean archives myself, and
 the ZIP loading code can handle that.

 See the configuration section for details on changing directories, if
 you want to store your ROM files elsewhere.

 Use and Options
 ~~~~~~~~~~~~~~~

 Usage: c2emu <gamename> or just launch the program and use the gui
 
 for the windows version, you can not append options to the command line.
 just leave them in the "c2emuw.cfg" 

     -blur <on|off>          enable blur effect (16-bit color only)
     -scale <on|off>         scale display to width of screen (only fullscreen mode)
     -vsync <on|off>         enable vsync polling
     -throttle <on|off>      enable speed throttling
     -skip <n>               specify frame skip level (1=no frames skipped)
     -sound <on|off>         enable sound output
     -sndrate <n>            specify sound sample rate (8000-44100)
     -dipdir <d>             specify directory for storing dip switch settings
     -zipdir <d>             specify directory for loading zipped game files
     -romdir <d>             specify directory for loading game files
     -snapdir <d>            specify directory for saving screen snapshots

 windows specific options

     -joy1 <n>               specify the joypad number to use for P1
     -joy1_a <n>             specify the button number for the  A button of P1
     -joy1_b <n>             specify the button number for the  B button of P1
     -joy1_c <n>             specify the button number for the  C button of P1
     -joy2 <n>               specify the joypad number to use for P2
     -joy2_a <n>             specify the button number for the  A button of P2
     -joy2_b <n>             specify the button number for the  B button of P2
     -joy2_c <n>             specify the button number for the  C button of P2
     -winsize <n>            specify the size of the windows (1,2,3)
     -videomem <on-off>      enable use of video memory 
                             (can be speedier, thanks to final burn for the idea www.finalburn.com:)
     -winx <n>               windows x position
     -winy <n>               windows y position

 You can put these options in a plain text file called "c2emuw.cfg"--one
 option per line, please. Command line options will override anything
 in the configuration file.

 If using VSync polling or speed throttling, don't enable frame skipping.
 Enabling sound automatically enables speed throttling.

 Sound emulation takes a *lot* of CPU time.

 There's no other friendly features at the moment, like auto frameskipping,
 save states, or game pausing. Sorry.

 Default directories:

    Zipped ROM images   =   ./ziproms
    Unzipped ROM images =   ./roms
    DIP switch settings =   ./dip

 When specifying directories, use forward slashes, and don't append a
 trailing slash to the end of the path.
 E.g. `-dip e:/c2emuw/dip'


 Supported games:

    bloxeedc      `Bloxeed'
    borench       `Borench'
    columns       `Columns (Japan)'
    columns2      `Columns II - The Voyage Through Time (Japan)'
    ichident      `Ichident-R (Puzzle & Action 2) (Japan)'
    potopoto      `PotoPoto (Japan)'
    puyopuyo      `Puyo Puyo (Program Revision ?, Japan)'
    puyopuya      `Puyo Puyo (Program Revsion A, Japan)'
    puyopuy2      `Puyo Puyo 2 (Expert?) (Japan)'
    spainpa       `SpainDumps version of Puzzle & Action (Bad Dump?)'
    stkclmns      `Stack Columns (Japan)'
    tantr         `Tant-R (Puzzle & Action) (Japan)'
    tantrbl       `Tant-R (Puzzle & Action) (Japan, Bootleg?)'
    tforceac      `Thunder Force AC (US/Europe)'
    tfacjp        `Thunder Force AC (Japan)'
    tfacbl        `Thunder Force AC (US/Europe, Bootleg)'
    zunkyou       `Zunzunkyou No Yabou (Japan)'

 Keys
 ~~~~
 Arrow keys -   Joystick
 a, s, d    -   Buttons A, B, C
 1, 2       -   1P, 2P start
 3, 4       -   1P, 2P coin
 5, 6       -   Test, Service

 7          -   Toggle YM3438 FM sound output
 8          -   Toggle SN76489 PSG sound output
 9          -   Toggle uPD7759 sound output
 0          -   Enable all sound channels

 End        -   Quit emulator
 Tab        -   Reset emulator
 F1-F4      -   Set frame skip level (F1=no skip, F2=every other frame, etc.)

 F10        -   Toggle speed throttling
 F11        -   Toggle VSync polling

 F12        -   Switch between a fixed palette suitable for all games, or
                a hack that may display partially correct colors in some
                games.

 Alt-R      -   Dump the program ROM to '<gamename>.rom'

 F6         -   Switch between DIP switch banks 1 and 2.
 Numpad 1-9 -   Toggle DIP switch bits 0-7 for the current bank selected.


 Game Descriptions
 ~~~~~~~~~~~~~~~~~
 Haze has written up a list of how well game performs.
 Please read the list before asking questions about game problems.

 Bloxeed (System C Version) (English)
 Rom Name: bloxeedc
 Genre: Puzzle (Vs.)
 Graphics: Good
 Sound: None
 Playable: Yes

 Borench (English)
 Rom Name: borench
 Genre: Puzzle
 Graphics: Good
 Sound: Partially (Missing Samples)
 Playable: Yes

 Columns (Japanese)
 Rom Name: columns
 Genre: Puzzle
 GraGood
 Sound: Full
 Playable: Yes*
 *Points System doesn't work Correctly (Starscream Bug?)

 Columns II - The Voyage Through Time (Japanese)
 Rom Name: columns2
 Genre: Puzzle
 Graphics: Good
 Sound: Full
 Playable: Yes

 Ichident-R (Puzzle & Action 2) (Japanese)
 Rom Name: ichident
 Genre: Puzzle (Mini-Games)
 Graphics: Bad Colours*
 Sound: Partial (Missing Samples)
 Playable: Yes*
 *Colour Issues will cause problems in some Sub-Games

 Poto Poto (Japanese)
 Rom Name: potopoto
 Genre: Puzzle (Vs.)
 Graphics: Good
 Sound: Partial (Missing Samples)
 Playable: Yes

 Puyo Puyo (Japanese, Program Revision ?)
 Rom Name: puyopuyo
 Genre: Puzzle (Vs.)
 Graphics: Good
 Sound: Partial (Missing Some Samples)
 Playable: Yes

 Puyo Puyo (Japanese, Program Revision A)
 Rom Name: puyopuya
 Genre: Puzzle (Vs.)
 Graphics: Good
 Sound: Partial (Missing Some Samples)
 Playable: Yes

 Puyo Puyo 2 (Japanese)
 Rom Name: puyopuy2
 Genre: Puzzle (Vs.)
 Graphics: Good
 Sound: Partial (Missing Some Samples)
 Playable: Partial*
 *Game Won't Move to Level 2 When You Win .. Protection

 Puzzle and Action (Spain Dumps, Bad?)
 Rom Name: spainpa
 Genre: Puzzle (Mini-Games)
 Graphics: n/a
 Sound: n/a
 Playable: No*
 *This is Probably a Bad Dump, half sized roms?

 Stack Columns
 Rom Name: stkclmns
 Genre: Puzzle (Vs.)
 Graphics: Good
 Sound: Partial (Missing Samples)
 Playable: Yes*
 *Some Protection(?) Problems, eg You can't enter your Hi-Score name

 Tant-R (Puzzle and Action) (Japanese)
 Rom Name: tantr
 Genre: Puzzle (Mini-Games)
 Graphics: Partial (Needs Palette Raster Effects)
 Sound: Partial (Missing Samples)
 Playable: No*
 *There are Protection Issues, Use the Bootleg

 Tant-R (Puzzle and Action) (Japanese, Bootleg)
 Rom Name: tantrbl
 Genre: Puzzle (Mini-Games)
 Graphics: Partial (Needs Palette Raster Effects)
 Sound: Partial (Missing Samples)
 Playable: Yes

 ThunderForce AC (English)
 Rom Name: tforceac
 Genre: Shoot 'em Up
 Graphics: Partial*
 Sound: No
 Playable: No*
 *There are Protection Issues, Use the Bootleg

 ThunderForce AC (Japanese)
 Rom Name: tfacjp
 Genre: Shoot 'em Up
 Graphics: Partial*
 Sound: No
 Playable: No*
 *There are Protection Issues, Use the English Language Bootleg

 ThunderForce AC (English, Bootleg)
 Rom Name: tfacbl
 Genre: Shoot 'em Up
 Graphics: Good
 Sound: No
 Playable: Yes

 Zunzunkyou No Yabou! (Japanese)
 Rom Name: zunkyou
 Genre: Shoot 'em Up
 Graphics: Good
 Sound: Partial (Missing Samples)
 Playable: Yes


 Thanks and Greetings
 ~~~~~~~~~~~~~~~~~~~~
 I'd  like to thank Haze for providing valuable information about the C2
 hardware. This emulator would not have been possible without his help.
 Also for beta testing, and source code fixes / improvements.
 
 In alphabetical order, everybody else:

 - Bart Trzynadlowski
 - Christian Schiller
 - Flavio Morsoletto
 - Omar Cornut
 - Stephane Dallongeville
 - Ulrich Hecht

 And last but not least, the ROM dumpers:

 - Team Japump
 - Thierry Lescot & Gerald
 - D-Zine
 - Spain Dumps.

 And NeoZeed'd like to add
 - Charles Mac Donald :)
 - Francois Claessens 

 If I'm forgetting someone, let me know.

 Miscellaneous
 ~~~~~~~~~~~~~
 - I'm interested in schematics for any Sega arcade game board.

 If you can help with these, please contact Charles (cgfm2@hooked.net)
 
 Legal
 ~~~~~
 "Starscream 680x0 emulation library by Neill Corlett
  (corlett@elwha.nrrc.ncsu.edu)"

 SEAL Synthetic Audio Library API Interface Copyright (C) 1995, 1996
    Carlos Hasan. All Rights Reserved.

 YM2612, SN76496, and uPD7759 emulation came from the MAME source code.
    http://www.mame.net/


