
                            MagicEngine v0.9
                    Copyright (c) 1997 David Michel
                    ===============================

                         MagicEngine's Homepage
                      Copyright (c) 1997 Bt Garner
                      ----------------------------
                 http://joyce.eng.yale.edu/~bt/turbo/emu

                     MagicEngine's Spanish Homepage
                     Copyright (c) 1997 Juan Carlos
                     ------------------------------
                        http://milu.fut.es/~bzr/

                     MagicEngine's French Homepage
                  Copyright (c) 1997 Frederic Schmitt
                  -----------------------------------
                 http://www.imaginet.fr/~schmitt/emuls/

                    MagicEngine's Japanese HomePage
                   Copyright (c) 1997  Jun Fukushima
                   ---------------------------------
                       http://www.hucard.com/me/

                    MagicEngine's Benelux HomePage
                   Copyright (c) 1997 J.H. Schulte
                   -------------------------------
                http://www.filiaal.net/magic/index.html


    IMPORTANT
    ---------

    Avant que nous voyons ce qu'il y a de nouveau dans cette version,
    j'ai une chose importante  vous dire. MagicEngine mule maintenant
    les jeux en CD-ROM, mais pour que a marche l'mulateur a besoin
    d'un fichier ROM d'une carte systme. Initialement j'avais prvu
    d'inclure une mulation interne de la carte systme dans MagicEngine,
    mais je n'ai pas eu assez de temps pour la finir - Actuellement
    seulement 50% sont muls, donc j'ai rcemment chang l'mulateur
    pour qu'il marche avec un fichier ROM d'une vraie carte systme.
    Je m'excuse pour ce petit inconvnient - Je changerai a dans la
    prochaine version...

    Veuillez noter galement que MagicEngine ne marche qu'avec de
    vrais CD-ROMs, il ne marche pas avec un fichier ROM d'un CD-ROM... 

    NOTE: Au sujet de la carte systme, toutes les versions sont supportes
    ----  mais seulement la version 3.0 vous permettra de jouer aux Super
          CD-ROMs.


    AVERTISSEMENT
    -------------

    Ce programme est fourni tel quel. L'auteur ne prend aucune
    responsabilit, quelque soit les dommages ou consquences directs
    ou indirects, intentionnels ou non intentionnels, qui pourraient
    rsulter de l'usage de ce programme - VOUS L'UTILISEZ A VOTRE
    PROPRE RISQUE.


    Fichiers
    --------

        -CWSDPMI.EXE     20 217 bytes
        -PCE.EXE        218 624 bytes
        -PCE.INI          1 169 bytes
        -PCE.TXT         14 205 bytes
        -README.1ST       2 205 bytes


    Nouveauts!
    -----------

    Tout d'abord un grand merci  tous ceux qui m'ont crit ces
    derniers mois, j'ai certainement reu beaucoup trop d'e-mails,
    mais c'tait sympa! Merci pour tous les compliments que j'ai reu
    et pour tous ces enregistrements aussi! :) J'espre que vous
    apprcierez cette nouvelle version autant que la prcdente, j'ai
    mis beaucoup de travail dedans, surtout dans l'mulation des
    CD-ROMS... Ok assez parl, voyons un peu les nouveauts.

    Le plus gros changement c'est bien sr l'mulation des CDs! 
    C'est pas encore tout  fait complet, mais a vous laissera
    jouer parfaitement  un bon nombre de CDs. J'ai pas encore eu
    la possibilit de tester tous les CDs existants mais la
    compatibilit devrait avoisiner les 80% je pense. Sinon vous
    ne devriez pas rencontrer de problmes particulier pour faire
    marcher les CDs sur votre PC, je n'ai utilis que les fonctions
    de MSCDEX donc a devrait marcher sur tous les lecteurs de
    CD-ROM. Le seul problme connu c'est avec Windows 95, pour
    une raison inconnu il ne veut pas reconnatre toutes les pistes
    de certain CDs - Il reconnait seulement la premire piste audio.
    Je ne peux rien faire pour a, c'est un problme interne  Windows,
    et tous les autres programmes ont le mme problme aussi, si par
    exemple vous lancez un player de CD, il ne jouera que la premire
    piste. Tout a pour vous dire que ce n'est pas un bug dans
    MagicEngine. :) Mais par contre il n'y a aucun problme quand
    l'mulateur est lanc sous DOS... Mais je le repte a n'arrive
    qu'avec certain CDs, c'est possible que les CDs que vous avez
    marchent parfaitement sous DOS et sous Windows...

    Le deuxime grand changement c'est au niveau de l'mulation des
    HuCards, quasiment tous les jeux qui ne marchaient pas avant,
    comme Nectaris (Military Madness), marchent parfaitement maintenant.
    En fait je ne connais que trois jeux qui ont encore de gros
    problmes, il y a Burning Angels, Fighting Run et TV Sport Hockey.
    Je ne me rappele plus tous les jeux qui ne marchaient pas mais
    voici une petite liste :

        - College Pro Baseball '89 & '90 
        - Darius Plus
        - Davis Cup Tennis
        - Gunboat
        - Jack Niclaus Golf
        - Legendary Axe 1 & 2
        - Metal Stoker
        - Naxat Open Golf
        - Nectaris
        - Populous
        - Power Drift
        - Super Volleyball
        - TV Sports Football
        - USA Pro Basketball
        - Valkyrie
        - Volfiev

    Sinon quelques bugs ont t corrigs ici et l, et pas mal de
    jeux marchent mieux maintenant, comme Afterburner, Bomberman,
    Alice Dream, Baribari, P-47 et quelques autres. J'ai essay de
    ne pas trop altrer la compatibilit et normalement tous les
    jeux qui marchaient avant, marchent avec cette version; le seul
    problme que j'ai remarqu c'est avec Break In - Il y a un tout
    petit dfaut avec le sprite du curseur. Peut tre un ou deux
    autres jeux ont des problmes similaires aussi, mais je suis
    sr que vous me rapporterez tous les dfauts!

    Le son a t pas mal amlior aussi, je serais tenter de dire
    qu'il est presque parfait, mais bon je ne le dirais pas; vous
    jugerez par vous mme. La stro est maintenant parfaitement
    mule, et donne vraiment une autre dimension aux jeux. Sinon
    les cartes son 16bit sont supportes, la diffrence n'est pas
    si importante mais on se rend compte du changement.

    Beaucoup de personnes m'avaient demand de rajouter un mode
    multi-joueurs o chaque joueur pourrait tre configur
    sparment, soit sur le clavier, soit sur un joypad ou soit
    sur un joypad GrIP... Eh bien c'est fait! J'epre que vous
    apprcierez le petit menu de configuration que nous avons conu
    pour vous... Donc maintenant tout est configurable, cinq joueurs
    peuvent tre dfinis, et trois configurations diffrentes
    sont disponibles, a vous permet de dfinir une configuration
    quand vous jouez seul et une ou deux autres pour quand vous
    invitez quelques potes  faire un tournoi de Bomberman! :)

    Ceci tant pour l'mulation, le support du PC a aussi subit
    quelques amliorations. Les plus importantes tant le support
    des modes VESA 2.0 et l'addition de deux nouveaux drivers pour
    les cartes son; maintenant MagicEngine supporte l'UltraSound
    et la SoundScape.

    Voil! J'ai srement du oublier une ou deux choses, mais bon
    il y avait tellement de nouveauts! :) Si vous voulez m'crire
    un petit mot, n'hesitez pas. Voici mon adresse e-mail et
    postale :

        e-mail    : dmichel@easynet.fr

        postale   : David Michel
                    residence du Parc appt n4
                    86330 Moncontour
                    France


    Machine requise
    ---------------

    Vous aurez besoin d'au moins un Pentium pour avoir une vitesse
    correcte; MagicEngine a t dvelopp et test sur un P100 equip
    de 16MO d'EDO RAM, a donne de bon rsultat, la plupart des
    jeux tournant  60 frames par seconde mais bon selon votre
    config a peut varier un peu. La machine idal est probablement
    un P166 avec une bonne carte vido. Pour le lecteur de CD-ROM
    le plus important c'est le temps d'accs, les tous derniers
    12x ou 16x vitesse sont parfaits mais sinon tous les types de
    lecteur feront l'affaire, mme un bon vieux 2x vitesse. Et dans
    tous les cas ce sera toujours plus rapide que le lecteur
    de CD-ROM de la PC Engine. :) Sinon la plus petite configuration
    sur laquelle MagicEngine a t test, est un DX4 100 equip de
    8MO de RAM et un 4x vitesse pour lecteur de CD-ROM. C'tait lent
    mais tout marchait bien.


    O trouver des jeux ?
    ---------------------

    S'il vous plait ne me demandez pas de fichiers ROM pour l'mulateur,
    je ne peux pas vous en donner et je ne vous en donnerai pas!


    Comment a marche ?
    -------------------

        PCE [options] rom-image

    O 'rom-image' est le nom d'un fichier contenant l'image d'un
    jeux PC Engine. L'mulateur accepte deux formats diffrents:
    une image brute et une image avec un entte de 512 octets
    (voir plus loin pour le format de l'entte).

    Plusieurs options sont acceptes :

        -1        ~ change le format du fichier ROM. Deux formats
                    existent, les ROMs normales et les ROMs en deux
                    parties. Gnralement tous les fichiers de
                    384KO (et quelques autres comme la version 512KO
                    de Devil's Crush) utilisent le second format,
                    si vous avez des problmes avec des ROMs de ce
                    type, essayez cette option
        -cd       ~ lance directement un jeux en CD-ROM
        -sgx      ~ active l'mulation Supergrafx, mais avant que
                    vous ne me demandiez, non a ne marche pas encore! :)
                    J'ai juste mis l'ancienne mulation Supergrafx
                    optionnelle, et dsactive par dfaut,  cause
                    de certains jeux en CD-ROMs qui refusent de
                    fonctionner si elle est prsente
        -us/-usa  ~ inverse l'ordre des bits d'une ROM, vous pouvez
                    essayer a si un jeu n'a pas l'air de fonctionner
        -nojoy    ~ dsactive le joypad du PC
        -nosound  ~ dsactive le son


    Clavier
    -------

        1) Contrle du joueur :
           ------------------

            F5           ~ slectionne la configuration par dfaut
            F6/F7/F8     ~ slectionne une des trois configurations
                           dfinissables par l'utilisateur
            Cursor-keys  ~ direction
            Enter        ~ run
            Space        ~ select
            Ctrl         ~ bouton II
            Alt          ~ bouton I 
            W            ~ auto fire II
            X            ~ auto fire I
            0            ~ ralentissement

            NOTE: Ces dernires touches de contrle ne sont disponibles
            ----  que quand la configuration est rgle sur F5

        2) Contrle des frames :
           -------------------

            MagicEngine est assez rapide, mais bon sur certain
            vieux 486 a rame un peu. Pour acclerer l'mulation
            vous pouvez contrler combien de frames seront sautes.
        
            F1  ~ affiche toutes les frames [1/1]
            F2  ~ saute 1 frame             [1/2]
            F3  ~ saute 2 frames            [1/3]
            F4  ~ saute 4 frames            [1/5]

            NOTE: Le mode F2 a un effet secondaire. Beaucoup de jeux
            ----  utilisent le clignotement des sprites pour rendre
                  certains effets. Vous ne pourrez pas les voir dans
                  ce mode, et mme pire, il peut arriver que les
                  sprites disparaissent compltement. Dans ce cas
                  le mieux c'est de passer en F3 ou dans un autre mode.

        3) Contrle du son :
           ---------------

            F9  ~ active/dsactive le son
            F10 ~ effet reverb
            +   ~ augmente le volume
            -   ~ baisse le volume

        4) Autres contrles :
           -----------------

            1      ~ bascule les sprites on/off
            2      ~ bascule l'cran de fond on/off
            Tab    ~ touche magique qui peut faire marcher certains
                     jeux rcalcitrants. Vous pouvez essayer a quand
                     un jeu semble s'arrter (mais notez que a ne
                     marche que pour un nombre trs restreint de
                     jeux)
            Esc    ~ fait apparatre le menu
            Pause  ~ pause le jeu
            Prtscr ~ fait une copie de l'cran courant
                     (sous Windows 95 appuyez shift + prtscr)
            F11    ~ active/dsactive le petit cran d'information
            F12    ~ active/dsactive le mode scanlines

            NOTE: Quand vous tes en mode pause, la touche 'prtscr'
                  est toujours active, sinon appuyez  nouveau sur
                  'pause' ou appuyez sur 'esc' pour sortir de ce mode.


    Le menu principal
    -----------------

        BOOT CD ~ slectionne une carte systme pour lancer un jeu
                  CD-ROM
        RESET   ~ reset compltement le jeu. Dans certains jeux vous
                  pouvez aussi appuyer 'run' puis 'select' pour faire
                  un reset
        PLAY    ~ retourne au jeu. Mme effet que de presser 'esc'
                   nouveau
        LOAD    ~ cette entre est active seulement quand une archive
                  est prsente dans le mme dossier que PCE.EXE ou si
                  MagicEngine a pu trouver des ROMs par lui-mme (voir
                  l'option 'path' dans le fichier INI)
        CONFIG  ~ ouvre la fentre de configuration des cinq joueurs
        HELP    ~ jolis petits crans d'aide pour vous rappeler les
                  fonctions des touches du clavier
        ABOUT   ~ cran d'information sur MagicEngine
        QUIT    ~ quitte l'mulateur

    Le menu de configuration
    ------------------------

        MagicEngine possde maintenant un menu pour configurer les
        contrles des joueurs. Pour diter un joueur, slectionner
        le avec les touches 'haut' et 'bas' puis pressez 'espace'
        pour changer les paramtres ou 'entre' pour changer de
        contrleur (ex. clavier, joystick, ...). Trois configurations
        sont disponibles, pressez F6  F8 pour les slectionner.
        Pour les joysticks, ils sont auto-calibrs, bougez un peu
        le manche et MagicEngine les calibrera automatiquement.


    Le fichier INI
    --------------

    Normalement vous n'aurez pas  modifier ce fichier, mais dans
    certains cas a peut tre utile...

        frame_rate=[1|2|3|5]
        --------------------
            C'est comme les touches de fonctions F1  F4, mais a vous
            permet de slectionner automatiquement votre vitesse prfre
            au dmarrage.

        default_config=[0|1|2|3]
        ------------------------
            Slectionne la configuration active au dmarrage. Vous
            pourrez la changer plus tard en appuyant sur F5  F8.

        delay=[999999|...]
        ------------------
            Dfini le dlai du ralentissement. Vous pouvez utiliser
            n'importe quelle valeur mais le mieux c'est d'exprimenter
            un peu pour trouver le dlai qui vous convient.

        keyboard=[0|1|2]
        ----------------
            Slectionne le type de clavier :

                0 -> AZERTY
                1 -> QWERTY
                2 -> QWERTZ

        joypad=[0|1|2]
        --------------
            Active ou dsactive le joypad du PC :

                0 -> dsactive le joypad
                1 -> mode automatique
                2 -> mode manuel

            Dans cette version le mode automatique et manuel font la
            mme chose, ils activent tous les deux le joypad.

        auto_fire_speed=[1|...|10]
        --------------------------
            Slectionne la vitesse de l'auto fire.

        button_1=[0|1|2|3]
        button_2=[0|1|2|3]
        button_3=[0|1|2|3]
        button_4=[0|1|2|3]
        ------------------
            Dtermine  quoi correspondent les deux ou quatre boutons
            du joypad :

                0 -> bouton I
                1 -> bouton II
                2 -> select
                3 -> run

        soft_reset=[y|n]
        ----------------
            Dans certains jeux, si vous pressez 'run' puis 'select'
            cela fera un reset de la PC Engine. Cette option peut
            empcher ce reset de se produire. Si elle est active,
            seule l'entre 'reset' du menu vous permettra de faire
            un reset.

        graphic_format=[0|1]
        --------------------
            Les copies d'crans peuvent maintenant tre sauves dans
            deux formats, utiliser cette option pour choisir le
            format qui vous convient :

                0 -> PCX
                1 -> BMP

        vesa=[y|n]
        ----------
            Si cette option est active l'mulateur utilisera un mode
            vido VESA, sinon il utilisera un classique mode-x.

        video_mode=[0|1|2|3]
        --------------------
            Choisi le mode vido :

                0 -> automatique
                1 -> 256x240
                2 -> 320x240
                3 -> 360x240
                4 -> 320x240 |
                5 -> 400x300 | modes VESA
                6 -> 512x384 |
                7 -> 640x480 |

            En mode automatique, l'mulateur choisit lui-mme le
            mode vido appropri selon le jeu, sinon le mode est
            vrouill. Les quatre derniers modes ne sont disponibles
            que si 'vesa' est positionn sur 'y' et si le BIOS VESA
            de votre carte vido les supportent.

        fullscreen=[y|n]
        ----------------
            Le mode 'fullscreen' est un mode spcial de 256x240
            qui remplit toute la surface du moniteur, tout le bord
            noir autour de la zone d'affichage disparait. Mais
            malheureusement ce mode n'est pas compatible avec toutes
            les cartes vido...

            NOTE: Ne marche pas en mode VESA.
            ----

        scanlines=[0|1|2]
        -----------------
            Slectionne le type du mode video 'scanlines'. Ce mode
            essaie de simuler une tl NTSC sur le PC en insrant
            de petites lignes noires entre les lignes de l'cran.
            Le mode software est sans danger pour tous les moniteurs,
            mais par contre le mode hardware utilise un taux de
            rafrachissement de 97Hz. Les moniteurs les plus rcents
            supportent sans problme de telles frquences, mais
            certains anciens modles non. Si vous n'tes pas sr,
            choisissez le mode software '2' ou dsactiver compltement
            ce mode '0'. Ce mode vido est activ plus tard en
            pressant la touche F12

                0 -> pas de mode scanlines
                1 -> mode hardware
                2 -> mode software

            NOTE: Ne marche pas en mode VESA.
            ----

        laptop=[y|n]
        ------------
            Dsactive la rsolution de 360x240 - Certains portables ne
            supportant pas cette rsolution.

        sound=[y|n]
        -----------
            Active ou dsactive le son.

        16bit=[y|n]
        -----------
            Active le rendu 16bit pour le son, 8bit sinon.

        stereo=[y|n]
        ------------
            Active ou dsactive la stro.

        reverb=[y|n]
        ------------
            Permet d'activer l'effet de reverb au dmarrage.

        master_vol=[0-100]
        dac_vol=[0-100]
        cd_vol=[0-100]
        --------------
            Contrle les volumes initiaux de votre carte son. Si jamais
            vous exprimentez un volume trop faible ou trop fort,
            changez ces paramtres. Si aucune valeur n'est spcifie
            MagicEngine ne changera pas les volumes de votre carte
            son.

            NOTE: 'dac_vol' n'a pas d'effet sur la GUS.
            ----

        adpcm_vol=[0-200]
        -----------------
            Contrle le volume interne de la voix ADPCM prsente
            dans l'unit CD-ROM de la PC Engine. La valeur maximale
            est normalement de 100; c'est possible de l'augmenter
            encore, mais dans certains cas et selon les jeux, le son
            peut tre distordu...

        sound_card=[0|1|2|3]
        --------------------
            Slectionne la carte son que va utiliser MagicEngine :

                0 -> dtection automatique
                1 -> Sound Blaster
                2 -> SoundScape
                3 -> UltraSound

        sync_dma=[y|n]
        --------------
            Active la synchronisation du DMA de la carte son.
            Essayez a si jamais il y a des craquements dans
            le son.

        info_screen=[y|n]
        -----------------
            Active le petit cran de contrle au dmarrage. Cet
            cran montre le volume des six voix sonores, la vitesse
            d'affichage et combien de frames par seconde sont
            mules. Appuyez sur F11 pour cacher ou montrer cet
            cran.

        cache=[y|n]
        -----------
            Quand vous lancez un jeu en CD-ROM, MagicEngine peut
            maintenir un cache interne en mmoire. Cela peut acclrer
            les accs disques de certains jeux, surtout si votre lecteur
            de CD-ROM a un temps d'accs trs lent.

        cache_size=[4096|...]
        ---------------------
            Dfinit la taille du cache CD-ROM en KO.

        cd_drive=[D|...]
        ----------------
            Par dfaut MagicEngine cherche lui-mme la lettre utilis
            par le lecteur de CD-ROM, mais si jamais vous en avez 
            plusieurs, vous pouvez indiquer ici la lettre du lecteur
            que MagicEngine utilisera.

        system_card_1=[SYSCARD1.PCE|...]
        system_card_2=[SYSCARD2.PCE|...]
        system_card_3=[SYSCARD3.PCE|...]
        system_card_4=[GE.PCE|...]
        --------------
            L'mulation des CD-ROMs ne peut actuellement pas marcher
            sans une carte systme. Vous pouvez dfinir le chemin
            d'accs de quatre cartes ici, MagicEngine vous laissera
            les choisir depuis son menu 'boot cd'.

            NOTE: Si aucun fichier n'est specifi MagicEngine cherchera
            ----  les fichiers cits plus haut dans son propre rpertoire.

        path=[GAMES.DAT|GAMES.IDX|C:\PCE\GAMES\|...]
        --------------------------------------------
            Indique  l'mulateur d'utiliser une archive ou un
            rpertoire contenant des ROMs. MagicEngine peut maintenant
            construire automatiquement un menu pour vous, indiquez
            juste le nom d'un rpertoire o se trouve des ROMs et
            l'mulateur crera un menu et chargera les ROMs
            individuellement. Cela n'est plus ncessaire de faire
            une archive pour utiliser le menu 'load'.

            NOTE: MagicEngine reconnat seulement les fichiers ayant
            ----  l'extension .PCE, si vos fichiers ont d'autres
                  extensions, rajouter les manuellement dans le fichier
                  GAMES.IDX cr par l'mulateur ou renommez les.


    L'entte des fichiers ROM
    -------------------------

    Dans cette version le format de l'entte a t amlior pour
    supporter de plus grandes HuCards, comme celle de Street Fighter 2'.
    L'entte fait 512 octets de long; voici une courte description
    de tous les octets utiliss :

        position taille  description
        -------- ------  -----------
          0        1     nombre de segments de 8KO prsent dans la ROM,
                         la valeur maximun est 128
          1        1     format de la ROM:
                         ----------------
                         bit 0: positionn quand la ROM a deux parties
                         bit 1: positionn quand l'entte contient le
                                titre du jeu (voir plus bas)
                         bit 6: positionn pour les HuCards tendues (> 1MO)
                         bit 7: positionn pour inverser l'ordre des bits
                                de la ROM
          2        1     nombre de segments supplmentaires de 512KO
                         (utilis par les HuCards tendues)                         HuCards).
         448       1     longueur du titre
         449       1     somme de contrle du titre (XOR de tous les octets) 
         450      62     titre du jeu

    Le reste de l'entte n'est pas encore utilis, mais au cas o il le
    serait ultrieurement, c'est mieux de tout remplir avec la valeur
    zro.


    Remerciements
    -------------

    Plusieurs personnes ont contribues, d'une manire ou d'une autre,
     faire ce que MagicEngine est maintenant, je voudrais les remercier
    ici, et tout particulirement :

                         Peter Kriegesmann
                          Stuart Campbell
                        Jens Ch. Restemeier
                            Dave Shadoff
                               Indi
                    et mon frre Cedric Michel

    Remerciements additionnels  :

        - tous mes bta-testeurs! Bon boulot les gars!!
        - toutes les personnes enregistres! Merci!!
        - tous ceux qui m'ont envoy des suggestions pour amliorer
          MagicEnigne!
        - Alex Martin, pour avoir traduit la documentation en Espagnol!
        - Mauro Grauso, qui a rendu MagicEngine plus international avec
          sa traduction en Italien!
        - Jun Fukushima, pour avoir traduit la documentation en
          Japonais!
        - Bt Garner, pour m'avoir fourni une homepage pour MagicEngine
        - Achillefs Margaritis, pour avoir programm ce chouette mode
          'fullscreen'
        - DJ Delorie et toutes les personnes derrire DJGPP
        - Shawn Hargreaves, sa librairie ALLEGRO pour DJGPP m'a pargn
          bien du travail durant toute la phase de dveloppement de
          MagicEngine
        - Charles Sandmann, pour m'avoir autoris  distribuer CWSDPMI
          avec mon mulateur. Si vous tes intress par la dernire
          version de son programme, vous la trouverez sur ce site :

              ftp.simtel.net:pub/simtelnet/gnu/djgpp/v2misc/csdpmi*.zip

          Si vous voulez le contacter:

              Charles W Sandmann (sandmann@clio.rice.edu)
              1206 Braelinn, Sugar Land, TX 77479


David Michel
------------
dmichel@easynet.fr

