                       Capcom CPS2 Emulator for MS-DOS
         
           (C) Csar Nicols Gonzlez /
     CNGSOFT (13.02.2001-19.11.2001)
     
         http://cpse.emuunlim.com/
    mailto:cngsoft@emuunlim.com
 
               
ܱ            
 ۰                 
                   
                      
                    
               
                                 

Prologue


        This is the second version of CPSE, the Capcom CPS2 Emulator for
MS-DOS. It's still very uncomplete, as there's no M68000. Only Z80, Audio and
Video are emulated, thus making CPSE 0.02 a QSound emulator and Tile viewer.
Wait for further versions to have full CPS2 emulation...

Copyright and warranty


        CPSE was developed by me, Csar Nicols Gonzlez (CNGSOFT).

        CPSE is Freeware. Shareware distributors can distribute it if they
only take fee for copying. Software and documentation are provided "as is"
with no warranty. CPSE is not Public Domain. I retain the copyright.

Requirements


        Minimal requirements are:
                 PC AT + 80386.
                 MS-DOS 3.0.
                 DPMI server. Pure DOS users require extender programs such
        as CWSDPMI; Windows users may use CPSE inside a DOS window.

        Optional requirements are:
                 VGA graphics card.
                 SoundBlaster sound card.

Installation


        CPSE002.ZIP contains the following files:
                 FILE_ID.DIZ: Brief description file.
                 CPSE.EXE: The emulator itself.
                 CPSE.ICO: Icon for Windows.
                 CPSE.INI: The configuration file.
                 CPSE.DAT: ROM file list.
                 CPSE.TXT: This document.

        Default configuration requires ROM files to be located in ROM\.

Configuration


        Configuration may be done either by editing CPSE.INI or by entering
command line parameters when launching CPSE.EXE. CPSE.INI variables are:

                 MODE=0-1 : CPSE mode: Tile viewer (0), QSound emulator (1).
                 SOUND_MODE=0-1 : Sound device: None (0), SoundBlaster (1).
                 SOUND_HIGH=0-2 : Sound quality: From 11KHz (0) to 44KHz (2).
                 SOUND_16BITS=YES/NO : Sound 16 bit mode.
                 SOUND_STEREO=YES/NO : Stereo sound.
                 SOUND_PANNING=0-9 : Sound panning. 0 is none, 9 is maximum.
                 SOUND_FILTER=YES/NO : Sound filter.
                 SOUND_FILTER_DEPTH=0-9 : Sound filter depth, from 0 to 9.
                 SOUND_SAVE=YES/NO : Sound logging.
                 CPS_ROMS_PATH=PATH\;PATH\... : ROM sets paths.
                 GUI_PAL0 ... GUI_PAL7: GUI colours. Normal text colours are
        defined from GUI_PAL0 to GUI_PAL3 while inverse text colours are
        defined from GUI_PAL4 to GUI_PAL7. Colors are defined with three
        hexadecimal numbers, meaning RED, GREEN and BLUE: 000 is black, FFF
        is white, F00 is red, etc.

        Command line parameters are:

                 /m<0-1> : CPSE Mode.
                 /g<0-8> : Screen mode.
                 /s<0-1> : Sound device.
                 /w : Sound logging.
                 /w<0-2> : Sound quality.
                 /f : Sound filter.
                 /f<0-9> : Sound filter depth.
                 /e : Stereo sound.
                 /e<0-9> : Sound panning.

        Command line always require the name of the ROM set to be loaded. ROM
sets can be compressed as ZIP files. They must be in the ROM sets path, one
archive or directory for each ROM set. ROM sets can be split and merged, thus
saving space, as secondary ROM sets don't need primary ROMs to be repeated.

Using CPSE


        CPSE tile viewer mode keys are:
                 UP, DOWN, PAGE UP and PAGE DOWN: Move through graphics.
                 ENTER: Set default palette. There are four different ones:
        full colour scale, black & white scale, Victor from "Darkstalkers",
        and Anakaris from "Darkstalkers".
                 SPACE: Save PCX screen.
                 TAB: Toggle tile type (8x8, 16x16, 32x32).
                 LEFT, RIGHT, HOME and END: Modify palette.
                 ESCAPE: Quit.

        CPSE QSound emulation mode keys are:
                 UP, DOWN, LEFT and RIGHT: Select a code.
                 ENTER: Play code.
                 CONTROL: Fast forward.
                 BACKSPACE: Stop sound.
                 SPACE: Toggle sound logging.
                 TAB: Toggle sound filtering.
                 HOME and PAGE UP: Modify speed.
                 END and PAGE DOWN: Modify pitch.
                 INSERT: Toggle pitch+speed mode. When enabled, pitch and
        speed always share value, otherwise can be independently modified.
                 DELETE: Reset speed and pitch.
                 ESCAPE: Quit.

CPSE.DAT


        The ROM list file contains the list of available games. Its format is
very simple. Every game requires eight lines of normal text. First line is the
name. Second line contains the names of the ROM sets: primary, secondary. Next
five lines are the ROM filenames themselves, their relative address (to 0 if
first ROM, or previous one if not first) and their size, both as hexadecimal
64KB blocks (128KB becomes 2, 1MB becomes 10, etc.). Third line contains
M68000 ROMs, fourth one contains XOR ROMs, fifth one Video ROMs, sixth one Z80
ROMs and seventh one Audio ROMs. Last line is a digit meaning the controls
used by the game: 0 for normal 2 players and 6 buttons, 1 for games such as
"Armored Warriors" and "Powered Gear", 2 for the "Dungeons & Dragons" games,
and 3 for "Quiz Nanairo Dreams".

Acknowledgements


         Thanks to Razoola (CPS2 Decryption Team) for making CPS2 emulation
possible.
         Thanks to Dayvee for Final Burn, the first CPS2 emulator.
         Thanks to ElSemi for Nebula, the first Spanish CPS2 emulator (Te me
has adelantado!).
         Thanks to The Fox of Emulators Unlimited ( www.emuunlim.com ) for
hosting CPSE.
         Thanks for reading!

Registered marks


         Capcom Play System, CPS, CPS1, CPS2 (C) Capcom Co. Ltd.
         MS-DOS (C) Microsoft.
         SoundBlaster (C) Creative Labs.
         Mentioned emulators (C) Their programmers.

History of CPSE


         13.02.2001: First ASM lines.
         03.09.2001 (v0.00): First version, only a QSound emulator.
         10.09.2001 (v0.01): Tiny bug fix (clipping); previous version had
wrong dates in the text files :(
         19.11.2001 (v0.02): Tile viewer. Better QSound mixer.
