
                            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


    IMPORTANTE
    ----------

    Prima di passare alle novita' di questa versione, ho una cosa
    importante da comunicarvi. MagicEngine ora emula giochi su
    CD-ROM, ma per rendere cio' possibile l' emulatore necessita di
    una image di una System Card. Inizialmente avevo programmato di
    includere un' emulazione interna della Sysrem Card in MagicEngine,
    ma non ho avuto abbastanza tempo per ultimarla - Allo stato
    attuale solamente il 50% della System Card e' emulata, quindi ho
    modificato l' emulatore cosi' da farlo funzionare con un' image
    di una vera System Card. Sono spiacente di tale inconveniente -
    Lo modifichero' nella prossima versione...

    Notate anche che MagicEngine funziona solo con veri CD-ROM, non
    supporta ROM image di CD-ROM...

    NOTA: Riguardo alle System Card, tutte le versioni sono supportate,
    ----  ma solo la versione 3.0 permette di far girare giochi su
          Super CD ROM.


    RESPONSABILITA'
    ---------------

    Questo programma e' distribuito "as is". Non mi assumo alcuna
    responsabilita' per ogni danno o conseguenza diretta o meno,
    intenzionale o meno, che puo' scaturire dall' uso di questo
    programma - LO USATE UNICAMENTE A VOSTRO RISCHIO!


    Files inclusi
    -------------

        -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


    Novita' !
    ---------

    Innanzitutto un saluto a tutti! Ed un grande ringraziamento
    a tutti coloro che mi hanno scritto nei mesi scorsi, ho
    sicuramente ricevuto troppe e-mail, ma e' stato davvero piacevole!
    Grazie per i complimenti che ho ricevuto, e anche per tutte le 
    registrazioni! :) Spero che questa nuova versione vi piacera'
    quanto la precedente, ci ho lavorato molto, specialmente nell'
    emulazione CD-ROM...
    OK, basta con le chiacchiere, vediamo cosa e' cambiato.

    La maggiore innovazione e' ovviamente l' emulazione CD!
    Non e' ancora completa, ma vi permettera' di giocare alla
    perfezione un buon numero di giochi. Non ho potuto testare tutti
    i CD esistenti, ma la compatibilita' si dovrebbe aggirare intorno
    all' 80%, credo. Di regola non dovreste incontrare problemi nell'
    adoperare i vostri CD sul PC, ho usato unicamente funzioni di
    MSCDEX per accedere al CD quindi la compatibilita' dovrebbe essere
    assicurata con qualsiasi lettore CD-ROM. L' unico problema
    accertato si verifica con Windows 95. Per qualche oscura ragione,
    Windows non riconosce tutte le tracce di alcuni CD - ma riconosce
    solamente la prima traccia audio. Non posso fare nulla riguardo a
    questo, e' un problema interno di Windows, e anche tutti gli altri
    programmi hanno il medesimo problema, se si cerca di far partire un
    lettore CD audio, esso riconoscera' solo la prima traccia. Questo
    solo per dire che non e' un bug di MagicEngine. :) D' altra parte
    questo non accade sotto DOS...Ma ripeto che succede solo con alcuni
    CD, e' possibile che i vostri CD funzionino egualmente bene sia
    sotto DOS che sotto Windows...

    A parte questo l' altro grande cambiamento e' nell' emulazione delle
    HuCard, quasi tutti i giochi che non funzionavano, come il tanto
    acclamato Nectaris (Military Madness), ora funzionano alla perfezione
    Infatti sono a conoscenza di soli tre giochi che hanno ancora grossi
    problemi : Burning Angels, Fighting Run e TV Sport Hockey.
    Non ricordo tutti i giochi che non funzionavano, ma ecco una piccola
    lista:

        - 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

    Anche alcuni Bug sono stati corretti, e alcuni giochi sono
    migliori ora, come Afterburner, Bomberman, Power Tennis, Alice
    Dream, Baribari, P-47 e alcuni altri. Ho cercato di non
    alterare troppo la compatibilita', e normalmente tutti i
    giochi che funzionavano prima, funzionano anche in questa
    versione, l' unico problema che ho notato e' con Break In -
    c' e un piccolissimo errore con lo sprite cursore. forse
    ancora uno o due altri giochi ripropongono lo stesso problema,
    ma sono sicuro che mi riporterete tutti gli errori!

    Anche il sonoro e' molto migliore in questa versione, sarei
    stato tentato di dire che e' quasi perfetto, ma non lo diro',
    e vi lascero' giudicare da soli. Il suono stereo e perfettamente
    emulato, e aggiunge realmente un' altra dimensione ai giochi.
    Anche le schede sonore che gestiscono suono a 16bit sono
    supportate, cio non fa una grande differenza, ma si nota.

    Molte persone mi hanno chiesto di implementare una modalita'
    multi-player in cui ogni giocatore potesse essere configurato
    indipendentemente, con la tastiera col joypad e con un Grip pad.
    Ok, adesso si puo' fare!! Spero che il menu che abbiamo
    progettato per voi vi piaccia... Quindi ora ogni cosa e'
    configurabile, potere configurare fino a cinque giocatori, e
    possono essere definite tre differenti configurazioni, cio' vi
    permettera' di definire una configurazione con i vostri settaggi
    preferiti quando giocate da soli, e un' altra o alter due per
    quando invitate degli amici per un torneo di Bomberman! :)

    Cio' per quanto riguarda ll lato dell' emulazione, ci sono anche
    alcuni importanti miglioramenti sul fronte del PC. Due grandi
    novita' sono il supporto VESA 2.0 e il supporto per due nuove
    schede audio : l' Ultrasound e la Soundscape.

    Bhe' c' e' sicuramente un altro paio di cose che ho dimenticato
    di dire, ma ci sono cosi' tante novita'! :) Se volete mettervi
    in contatto con me (in inglese o francese per favore), ecco i due
    indirizzi a cui fare riferimento:

        e-mail    : dmichel@easynet.fr

        snail-mail: David Michel
                    residence du Parc appt n4
                    86330 Moncontour
                    France


    Di che computer avete bisogno ?
    -------------------------------

    Vi servira' come minimo un Pentium per una corrette velocita',
    MagicEngine e' stato sviluppato e testato su un P100 con
    16 MB di EDO RAM e i risultati sono molto buoni su questa
    macchina, la maggior parte dei giochi gira al frame rate
    originale, ma a seconde della vostra configurazione e'
    possibile che ci sia qualche differenza. La macchina ideale e'
    probabilmente un P166 con una buona scheda video. Per quanto
    riguarda il lettore lettore CD-ROM, la cosa piu' importante e'
    il tempo d' accesso, i recenti lettore 12x o 16x sono perfetti,
    ma qualsiasi tipo di drive andra' bene, anche un semplice 2x.
    In ogni caso sara' piu' veloce del vero lettore CD-ROM del PC
    Engine. :) Comunque il piu' lento PC su cui MagicEngine e'
    stato testato, e' un DX4 100 con 8MB di RAM e un lettore CD-ROM
    4x. Era lento ma tutto funzionava perfettamente.


    Dove posso trovare i giochi ?
    -----------------------------

    Per favore non chiedetemi ROM image, non posso e non ho intensione
    di fornire alcuna ROM!


    Come si use l' emulatore ?
    --------------------------

        PCE [opzioni] rom-image

    dove 'rom-image' e' il nome della image del gioco del
    PC Engine. L' emulatore accetta due formati: un' image
    grezza, o una con un header di 512 byte (vedi piu' in
    basso per il formato dell' header).

    Vengono riconosciute varie opzioni :

        -1        ~ Cambia il formato dell' image. Esistono due formati,
                    images normali e images divise [splitted images]. 
                    di solito tutti i files di 384KB (e alcuni altri
                    come la versione da 512KB di 'Devil's Crush') usano
                    il formato diviso, quindi se avete problemi con una
                    di queste images, provate quest' opzione
        -cd       ~ Fa partire direttamente un CD
        -sgx      ~ Abilita l' emulazione Super Grafx, ma prima che
                    me lo chiediate, no non funziona ancora
                    pienamente! :) Ho solo reso opzionale la
                    vecchia emulazione Super Grafx, e la ho
                    disattivata per default, dato che alcuni CD non
                    funzionano se e' attiva
        -us/-usa  ~ inverte l' ordine dei bit di una image, potete
                    provare questa opzione se un gioco non sembra
                    funzionare
        -nojoy    ~ Disabilita i joypad PC
        -nosound  ~ Disabilita la scheda audio


    Funzioni Tastiera
    -----------------

        1) Disposizione dei tasti :
           ------------------------

            F5           ~ Seleziona la configurazione di default
            F6/F7/F8     ~ Seleziona una delle tre configurazioni
                           dell' utente
            Cursor-keys  ~ Direzioni
            Enter        ~ Run
            Space        ~ Select
            Ctrl         ~ Tasto II
            Alt          ~ Tasto I 
            Z            ~ Auto fire II
            X            ~ Auto fire I
            0            ~ Slow motion

            NOTA: Questi tasti di controllo sono disponibili solo
            ----  quando la configurazione e' settata con F5.

        2) Frame Rate :
           ------------

            MagicEngine e' un  emulatore abbastanza veloce, ma su un
            qualche vecchio 486 risulta troppo lento. Per velocizzare
            l' emulazione potete decidere quanti frames saltare.

            F1  ~ mostra tutti i frames   [1/1]
            F2  ~ salta 1 frame           [1/2]
            F3  ~ salta 2 frames          [1/3]
            F4  ~ salta 4 frames          [1/5]

            NOTA: La modalita' F2 ha un effetto collaterale. Molti
            ----- giochi usano un lampeggiamento degli sprites per 
                  rendere degli speciali effetti, i quali non possono
                  essere apprezzati in questa modalita', e ancora
                  peggio, alcuni sprites scompaiono del tutto. In tal
                  caso e' raccomandato di provare ad usare un altro
                  frame rate.

        3) Controllo del Suono :
           ---------------------

            F9  ~ abilita/disabilita il suono
            F10 ~ Effetto riverbero
            +   ~ aumenta il volume
            -   ~ diminuisce il volume

        4) Altri controlli :
           -----------------

            1      ~ Abilita/disabilita gli sprites
            2      ~ Abilita/disabilita lo sfondo
            Tab    ~ Tasto magico che fa funzionare alcuni giochi.
                     Potete provare ad usarlo quando un gioco sembra
                     essere bloccato (notare che funziona solo con
                     pochi giochi)
            Esc    ~ menu
            Pause  ~ mette in pausa il gioco
            Prtscr ~ Cattura un' immagine della corrente schermata
                     (sotto Windows 95 premere shift + prtscr)"
            F11    ~ abilita/disabilita l' info screen
            F12    ~ abilita/disabilita lo scanlines video mode

            NOTE: In pausa, il tasto 'prtscr' e' attivo,
            ----  a parte cio' premete ancora 'pause' o 'esc' per
                  uscire da questa modalita'.

    Il menu principale
    ------------------

        BOOT CD ~ Seleziona una system card per caricare un gioco da
                  CD-ROM
        RESET   ~ Resetta completamente il gioco. Potete anche
                  premere Run e poi Select per resettare
        PLAY    ~ Ritorna al gioco, come premere 'esc' di nuovo
        LOAD    ~ Questa opzione e' presente quando un archivio di giochi
                  e' presente nella stessa directory del file PCE.EXE o
                  se MagicEngine trova qualche ROM (vedi l' opzione
                  'path' nel file .ini)
        CONFIG  ~ Permette di ridefinire completamente la configurazione
                  dei cinque giocatori
        HELP     ~ Mostra gradevoli schermate sulle funzioni di tutti i
                   tasti
        ABOUT    ~ La schermata dei copyright
        QUIT     ~ Esce dall' emulatore

    Il menu di configurazione
    -------------------------

    MagicEngine ora ha un menu per configurare i controlli del giocatore.
    Per editare un giocatore, selezionatelo con "freccia su" e "freccia
    giu'" e premete "spazio" per modificare i settaggi oppure "invio" per
    selezionare un controller (tastiera, joystick, ...). Sono disponibili
    tre configurazioni, selezionabili con i tasti da F6 a F8. riguardo
    ai joystick, vengono autocalibrati, basta muoverlo appena e 
    MagicEngine lo calibrera' automaticamente.


    Il file INI
    -----------

    In condizioni normali, non avrete bisogno di modificare questo file,
    ma in alcune situazioni potrebbe tornarvi utile.

        frame_rate=[1|2|3|5]
        --------------------
            E' come usare i tasti da F1 a F4, ma vi permette di
            selezionare il vostro frame rate preferito all' avvio.

        default_config=[0|1|2|3]
        ------------------------
            Seleziona la configurazione da utilizzare all' avvio.
            Potete cambiarla in seguito con i tasti da F5 a F8.

        delay=[999999|...]
        ------------------
            Indica il delay per la slow motion (potete usare qualsiasi
            valore). La cosa migliore e' sperimentare e vedere quale
            delay e' adatto.

        keyboard=[0|1|2]
        ----------------
            Seleziona il tipo di tastiera:
 
                0 -> AZERTY
                1 -> QWERTY
                2 -> QWERTZ"

        joypad=[0|1|2]
        --------------
            Abilita o disabilita il joypad PC :

                0 -> disabilita il joypad
                1 -> modalita' automatica
                2 -> modalita' manuale

            In questa versione la modalita' automatica e quella manuale
            fanno la stessa cosa, entrambe abilitano il joypad.

        button_1=[0|1|2|3]
        button_2=[0|1|2|3]
        button_3=[0|1|2|3]
        button_4=[0|1|2|3]
        ------------------
            Determina come sono configurati i 2 o 4 tasti del joypad PC:

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

        soft_reset=[y|n]
        ----------------
            In alcuni giochi, se premete 'run' e poi 'select'
            resettate il Pc Engine. Quest' opzione evitera' che cio'
            accada. Se e' abilitata, solo l' opzione 'reset' del
            menu vi permettera' di resettare.

        graphic_format=[0|1]
        --------------------
            Le schermate possono ora essere salvate in due formati,
            Quest' opzione vi permettera' di scegliere quello che
            preferite.

                0 -> PCX
                1 -> BMP

        vesa=[y|n]
        ----------
            Se abilitato l' emulatore adoperera' una modalita' video
            VESA, altrimenti adoperera' un semplice mode-x.

        video_mode=[0|1|2|3]
        --------------------
            Seleziona la modalita' video:

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

            Quando siete in modalita' automatica, l' emulatore
            seleziona da solo piu' quella appropriata per ogni
            gioco, diversamente la modalita' e fissa. Le ultime 4
            modalita' sono disponibili solo quando 'vesa' e' settato
            su 'y' e se il vostro BIOS VESA li supporta.

        fullscreen=[y|n]
        ----------------
            La modalita' fullscreen, e' una speciale risoluzione
            a 256x 240 che riempie l' intero schermo, tutti i
            bordi neri intorno all' area del display spariranno.
            Purtroppo, questa modalita' non funziona con tutte le
            schede video...

            NOTA: Questa modalita' non funziona in modo
            ----  VESA.

        scanlines=[0|1|2]
        -----------------
            Seleziona il tipo di modalita' video scanlines. Questa
            modalita' tenta di simulare una TV NTSC sul vostro PC
            inserendo piccole linee nere tra le linee dello schermo.
            La modalita' software e' sicura per tutti i monitor,
            ma la modalita' hardware fa uso di una speciale fraquenza
            di refresh di 97Hz. I monitor piu' nuovi supportano tale
            fraquenza, ma qualche monitor piu' vecchio non lo fa.
            Se non siete sicuri, selezionate la modalita' software '2'
            oppure disabilitate del tutto lo scanlines mode '0'.
            Questa opzione viene attivata dal tasto F12.

                0 -> disabilitato
                1 -> hardware
                2 -> software

            NOTA: Questa modalita' non funziona in modo
            ----  VESA.

        laptop=[y|n]
        ------------
            Disabilita la modalita' 360x240 per i laptop.

        sound=[y|n]
        -----------
            Abilita o disabilita l' output sonoro.

        16bit=[y|n]
        -----------
            Abilita o disabilita il suono a 16 BIT.

        stereo=[y|n]
        ------------
            Abilita o disabilita il suono stereo.

        reverb=[y|n]
        ------------
            Se abilitato, l' effetto riverbero verra' attivato all'
            avvio.

        master_vol=[0-100]
        dac_vol=[0-100]
        cd_vol=[0-100]
        --------------
            Controlla il settaggio del volume iniziale della vostra
            scheda audio. Se i suoni sono troppo alti o troppo
            bassi, cambiate questi valori. Se non viene assegnato
            alcun valore MagicEngine non alterera' i volumi.

            NOTA: 'dac_vol' non ha alcun effetto sull' Ultrasound.
            ----

        adpcm_vol=[0-200]
        -----------------
            Controlla il volume interno del canale ADPCM presente
            nell' unita' CD ROM del PC Engine. Il normale volume
            massimo e' 100; e' possibile aumentarlo ulteriormente,
            ma in tal caso e in relazione al gioco, il suono
            potrebbe distorcersi.

        sound_card=[0|1|2|3]
        --------------------
            Seleziona la scheda sonora da usare in MagicEngine :

                0 -> auto detect
                1 -> Sound Blaster
                2 -> SoundScape
                3 -> UltraSound

        sync_dma=[y|n]
        --------------
            Abilita la sincronizzazione del DMA. Provate ad
            attivarlo se sentite un sonoro zoppicante!

        info_screen=[y|n]
        -----------------
            Abilita lo schermo informativo all' avvio. Questo schermo
            mostra l' attuale volume per i sei canali sonori, lo stato
            dei tasti auto-fire, il frame-rate selezionato, e quanti
            frames al secondo vengono visualizzati. premete F11 per
            accendere o spegnere questo schermo.

        cache=[y|n]
        -----------
            Mentre gira un gioco su CD-ROM MagicEngine puo' tenere
            una cache interna in memoria. Cio' puo' velocizzare alcuni
            giochi, specialmente se avete un lettore DC-ROM con un
            tempo di accesso lento.

        cache_size=[4096|...]
        ---------------------
            Definisce la grandezza della cache del CD-ROM in KB.

        cd_drive=[D|...]
        ----------------
            Per default MagicEngine trova da solo la lettera del 
            vostro lettore CD-ROM, ma se avete piu lettori potete
            specificare qui' la lettera del drive che verra'
            adoperato da MagicEngine.

        system_card_1=[SYSCARD1.PCE|...]
        system_card_2=[SYSCARD2.PCE|...]
        system_card_3=[SYSCARD3.PCE|...]
        system_card_4=[GE.PCE|...]
        --------------
            L' emulazione CD attualmente non funziona senza una
            System Card. Potete selezionare 4 differenti percorsi
            di System Card qui', MagicEngine vi permettera' di
            selezionarle dal menu 'boot cd'.

            NOTA: Se non e' specificato nessun file, MagicEngine
            ----  cerchera' i file indicati sopra nella sua stessa
                  directory.

        path=[GAMES.DAT|GAMES.IDX|C:\PCE\GAMES\|...]
        --------------------------------------------
            Dice all' emulatore di usare un archivio di giochi o
            una directory. MagicEngine ora puo' creare un menu
            al posto vostro automaticamente, voi dovete solo
            indicare il percorso di dove sono le ROM e l' emulatore
            creera' il menu e carichera' le ROM individualmente. Non
            c' e' piu' necessita' di creare un archivio.

            NOTA: MagicEngine riconosce solo i files con estensione
            ----  .PCE, se avete alcune ROM con estensioni diverse
                  potete aggiungerle manualmente al file GAMES.IDX
                  creato dall' emulatore, o semplicemente rinominarle.


    Il formato dell' header
    -----------------------

    In questa versione il formato dell' header e' stato migliorato
    per supportare HuCard piu' grandi, come Stret Fighter 2'. L'
    header e' lungo 512 byte; ecco una breve descrizione di tutti
    i byte utilizzati :

    offset  grandezza   descrizione
    ------  ---------   -----------
      0         1       numero di banchi di 8KB presenti nella ROM, il
                        valore massimo e' 128
      1         1       formato della ROM:
                        -----------------
                        bit 0: settato se la ROM e' divisa
                        bit 1: settato quando l' header contiene il titolo
                               del gioco (vedi oltre)
                        bit 6: settato per HuCard estese (> 1MB)
                        bit 7: settato per invertire il numero di bit
                               della ROM
      2         1       numero di banchi da 512KB extra (usato per HuCard
                        estese).
     448        1       lunghezza del titolo
     449        1       checksum del titolo (XOR di tutti i byte) 
     450       62       titolo del gioco

    Il resto dell header non viene ancora utilizzato, ma per compatibilita'
    futura, e' consigliabile riempire quest' area con zeri ('0').


    Ringraziamenti
    --------------

    Molte persone hanno contribuito a rendere MagicEngine quello
    che e' adesso, vorrei ringraziarle qui, in special modo:

                         Peter Kriegesmann
                          Stuart Campbell
                        Jens Ch. Restemeier
                            Dave Shadoff
                               Indi
                    e mio fratello Cedric Michel

    Ringraziamenti speciali a :

        - Tutti i miei beta tester! Bel lavoro ragazzi!!
        - Tutti gli utenti registrati! Grazie!!
        - Tutti coloro che mi hanno mandato suggerimenti su come
          migliorare MagicEngine!
        - Alex Martin, per aver tradotto la documentazione in spagnolo!
        - Mauro Grauso, che ha reso MagicEngine piu' internazionale
          con la sua traduziona in italiano!
        - Jun Fukushima, per aver tradotto la documentazione
          in Giapponese! 
        - Bt Garner, per avermi fornito una homepage per MagicEngine.
        - Achillefs Margaritis, per aver programmato questo bel
          'fullscreen' mode.
        - DJ Delorie e tutte le persone dietro a DJGPP.
        - Shawn Hargreaves, la sua fantastica libreria ALLEGRO mi
          ha risparmiato un sacco di lavoro durante lo sviluppo di
          MagicEngine.
        - Charles Sandmann, per avermi lasciato distribuire CWSDPMI
          insieme al mio emulatore. Se siete interessati potete
          procurarvi l' ultima versione del suo programma e il codice
          sorgente a questo indirizzo :

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

          O se lo volete contattarlo per posta normale:

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


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

