
                            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
    ----------

    Antes de ver que hay de nuevo en esta version, debes tener en cuenta lo
    siguiente. MagicEngine ahora emula juegos en CD-ROM, pero para que la
    emulacion sea posible, es necesaria la imagen de una "System Card" 
    ( Tarjeta de Sistema ). Inicialmente tenia planeado incluir emulacion
    interna de la "System Card" en el propio emulador MagicEngine, pero
    no he tenido suficiente tiempo para acabarlo - Actualmente solo el 50%
    de la "System Card" esta emulado, asi que finalmente he modificado el 
    emulador para que trabaje con una imagen de la "System Card". Siento
    este pequeo inconveniente - Espero arreglarlo en la proxima version.

    Por favor, obeserva que MagicEngine trabaja solo con autenticos CD-ROMS,
    no soporta ni ejecuta imagenes de CD-ROM...

    NOTA  Acerca de las "System Cards", todas las versiones estan soportadas
    ----  pero solo la version 3.0 podra ejecutar juegos Super CD-ROM.


    AVISO
    -----

    Este programa se ofrece tal cual. No acepto responsabilidades de ningun 
    dao causado directa o indirectamente, intencionado o no intencionado, 
    que pueda causar el uso de este programa -
    USALO BAJO TU PROPIO RIESGO!


    Ficheros en este paquete
    ------------------------

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


    Que hay de nuevo!
    -----------------

    Primero un saludo a todos! Y agradezco a todos los que me habeis escrito
    estos ultimos meses, ciertamente he recibido gran cantidad de e-mails, 
    pero ha sido agradable! Gracias por todos los agradecimientos que he 
    recibido, y gracias por todos los que se registraron! :) Espero que
    disfruteis esta nueva version tanto como la anterior, he dedicado mucho
    esfuerzo en este proyecto, especialmente en la emulacion de CD-ROM...
    Bien, basta de palabras, vemos que hay de nuevo.

    La gran novedad es la emulacion de CD desde luego! No esta completa del
    todo, pero podras jugar perfectamente con un buen numero de juegos.
    No he podido probar todos los CDs existentes, pero la compatibilidad debe
    rondar el 80% creo. Normalmente no deberias tener problemas ejecutando el
    CD siempre que sea compatible con todos las unidades de CD-ROM. El unico
    problema conocido es con Windows 95, por alguna razon desconocida Windows
    no quiere reconocer todas las pistas de algunos CDs - Solo reconoce la
    primera pista de audio.

    No puedo hacer nada en ese aspecto, es un problema interno de Windows, y
    todos los otros programas tienen el mismo problema, si intentas ejecutar
    un reproductor de CDs audio, solo reconocera la primera pista.
    Solo decir que no es un fallo de MagicEngine :) Por otro lado esto no
    ocurre bajo DOS... Pero repito, solo ocurre con algunos CDs, es posible 
    que los CDs que tengas funcionen sin problemas en DOS y Windows...

    Aparte de esto, el otro gran cambio es la emulacion de "HuCard", casi
    todos los juegos que no funcionaban; como el deseado Nectaris (Military
    Madness), funcionan perfectamente ahora. De hecho solo conozco tres juegos
    que aun tiene problemas: Burning Angels, Fighting Run y TV Sports Hockey.
    No recuerdo todos los juegos que no funcionaban pero aqui tienes una
    pequea 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

    Asimismo algunos fallos se han corregido tambien, y algunos juegos
    se ejecutan mejor ahora, como Afterburner, Bomberman, Power Tennis, 
    Alice Dream, Barbari, P-47 y algunos mas. He intentado no alterar la 
    compatibilidad en exceso y todos los juegos que funcionaban antes lo
    siguen haciendo en esta version; el unico problema que he detectado
    es en Break In - Hay un pequeo error con el sprite del cursor.
    Probablemente uno o dos juegos mas tienen problemas similares, pero
    estoy seguro de que me informaras de esos errores!

    Tambien el sonido es mucho mejor en esta version, estoy tentado ha decir
    que es casi perfecto, pero no lo hare, dejare que lo juzgues tu mismo. 
    El estereo se emula perfectamente ahora, y realmente los juegos adquieren
    otra dimension. Las tarjetas de sonido de 16 bit tambien estan soportadas,
    no es que haya una gran diferencia, pero si que es audible.

    Mucha gente me ha pedido la implementacion de un modo multi-jugador donde
    cada jugador podria ser configurado independientemente: en el teclado, 
    en un joypad o en un GrIP pad. Bien, ahora esta impelemetado!! Espero que
    te guste el agradable menu que hemos diseado para ti... Asi que ahora
    todo es configurable, puedes configurar hasta cinco jugadores, y puedes
    definir tres configuraciones diferentes, esto te permitira definir una 
    configuracion con tus ajustes preferidos cuando juegues solo, y una o
    dos mas para cuando invites a algunos amigos para un torneo al 
    Bomberman! :)

    Eso es todo acerca de la emulacion, hay tambien algunas mejoras respecto
    al PC. Las dos novedades son el soporte para VESA 2.0 y el soporte para
    dos nuevas tarjetas de sonido: la UltraSound y la SoundScape.

    Bien, seguramente he olvidado contarte un par de cosas, pero es que hay
    muchas novedades! :) Si quieres contactar conmigo, aqui tienes dos 
    direcciones que puedes usar:

        e-mail    : dmichel@easynet.fr

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

    Que maquina se necesita?
    -------------------------

    Necesitas al menos un Pentium para una velocidad correcta, MagicEngine
    ha sido desarrollado y probado en un P100 con 16MB EDO RAM y los resultados
    son muy buenos en esa maquina, muchos de los juegos corren a toda 
    velocidad de "frames" pero dependiendo de tu configuracion puede haber
    algunas diferencias.
    La maquina ideal es probablemente un P166 con una buena tarjeta de video.
    Para el lector de CD-ROM lo mas importante es el tiempo de acceso, los
    ultimos 12x o 16x son perfectos pero cualquier tipo de lector sera bueno,
    incluso un simple lector 2x. En todo caso sera mas rapido que la autentica
    unidad de CD PC Engine. :) De todos modos el PC mas lento que he probado
    con MagicEngine ha sido un DX4 100 con 8MB de RAM y un lector de CDs 4x.
    Era lento pero todo ha funcionado perfectamente.

    Donde consigo juegos?
    ----------------------

    No me pidas imagenes de ROM, no puedo mandar, ni mandare,  ninguna ROM!

    Como se usa el emulador?
    -------------------------

        PCE [options] rom-image

    Donde "rom-image" es el nombre de la imagen del juego PC Engine.
    El emulador acepta dos formatos: una imagen "raw" o una imagen 
    con una cabezera de 512 byte ( mira abajo para los formatos de cabezera).

    Las siguientes opciones estan disponobles :

        -1       Cambia el formato de la imagen. Hay dos tipos de
                 formato existentes, imagenes normales y imagenes
                 separadas. Normalmente todos los ficheros de 384KB
                 ( y algunos otros como la version de 512KB de 
                 "Devils Crush") usan el formato separado, asi
                 que si tienes problemas con esas imagenes, prueba
                 esta opcion
        -cd      Ejecuta un CD-ROM directamente
        -sgx     Activa la emulacion de Supergraf, pero antes de que
                 me preguntes, no funciona del todo! :)
                 He hecho la emulacion de la antigua Supergraf
                 opcional, y desactivada por defecto, porque algunos
                 CDs no se ejecutan si la opcion esta activada
        -us/-usa Invierte el orden del bit en la imagen, puedes
                 probar esta opcion si el juego parece no funcionar
        -nojoy   Desactivar el joypad del PC
        -nosound Desactivar la tarjeta de sonido


    Funciones del teclado
    ---------------------

        1) Disposicion del control:
           ------------------------

            F5          Selecciona la configuracion por defecto
            F6/F7/F8    Selecciona una de las tres configuraciones del
                        usuario
            Cursor-keys Direccion
            Enter       Ejecutar
            Space       Seleccion
            Crtl        Boton II
            Alt         Boton I
            Z           Auto fire II
            X           Auto fire I
            0           Ralentizar

            NOTA: Estas teclas de control estan solo disponibles cuando la
            ----  configuracion ha sido ajustada con F5.


        2) Cantidad de frames :
           --------------------

            MagicEngine es un emulador muy rapido, pero en algunos
            viejos 486 aun es demasido lento. Para acelerar la emulacion
            puedes controlar cuantos "frames" (fotogramas) seran 
            omitidos.

            F1  visualiza todos los frames [1/1]
            F2  omite 1 frame              [1/2]
            F3  omite 2 frames             [1/3]
            F4  omite 4 frames             [1/5]

           NOTA: El modo F2 tiene un efecto secundario. Muchos juegos usan
           ----  el parapadeo de sprites para crear efectos especiales.
                 En este modo no se puede visualizar el efecto, y aun peor,
                 algunos sprites pueden desaparecer completamente. En este
                 caso se recomienda usar otra cantidad de "frames".


        3) Control de sonido:
           -----------------

            F9   activa/desactiva el sonido
            F10  efecto de reverberacion
            +    aumentar el volumen
            -    disminuir el volumen


        4) Otros controles:
           ---------------

            1       Alterna los sprites on/off ( visibles / no visibles )
            2       Alterna el fondo on/off ( visible / no visible )
            Tab     Tecla magica que puede arreglar algunos juegos.
                    Puedes probarla cuando un juego se bloquea ( por favor
                    ten en cuenta que solo funciona en muy pocos juegos )
            Esc     Ir al menu
            Pause   Pausa en el juego
            Prtscr  Hace una instantanea de la pantalla actual
            F11     activa/desactiva la pantalla de informacion
            F12     activa/desactiva el modo video "scanlines"

            NOTA: Cuando estas en el modo de pausa, la tecla "prtscr" esta 
            ----  activa, de otro modo pulsa "pause" otra vez o "esc" para
                  salir de este modo.


    El menu principal
    -----------------

        BOOT CD   Selecciona un "system card" para ejecutar un juego CD-ROM
        RESET     Reinicia completamente el juego. Tambien puedes pulsar
                  "run" y luego "select" para reiniciar
        PLAY      Volver al juego, otra vez esto es igual que pulsando "esc" 
        LOAD      Esta opcion esta presente cuando hay un fichero de juego
                  presente en el mismo directorio donde esta PCE.EXE o si
                  MagicEngine ha encontrado alguna ROM ( mira la opcion
                  de "path" en el fichero INI )
        CONFIG    Te permite redefinir completamente la configuracion
                  de los cinco jugadores
        HELP      Visualiza unas agradables paginas graficas con todas
                  las funciones de todas las teclas
        ABOUT     La pantalla de copyright
        QUIT      Sale del emulador


    El menu de configuracion
    ------------------------

        MagicEngine tiene ya un menu para configurar los controles de los
        jugadores. Para editar un jugador, seleccionalo con "arriba" y 
        "abajo" y entonces pulsa "espacio" para cambiar los ajustes
        o "entrar" para seleccionar un controlador ( teclado, joystick...)
        Hay tres configuraciones disponibles, seleccionalas pulsando de F6
        a F8. Los joysticks se auto-calibran, simplemente mueve un poco tu
        joystick y MagicEngine lo calibrara automaticamente.


    El fichero INI
    --------------

    Normalmente no tendras que modificar este fichero, pero en algunas 
    situaciones puede ser util.

        frame_rate=[1|2|3|5]
        --------------------
            Es como las teclas F1 a F4, pero te permite hacer tu 
            seleccion favorita en el arranque.

        default_config=[0|1|2|3]
        ------------------------

            Selecciona la configuracion a usar en el arranque.
            Puedes cambiarlo mas tarde usando de F5 a F8.

        delay=[999999|...]
        ------------------

            Indica el retardo para el modo ralentizado (puedes usar 
            cualquier valor ). Lo mejor es experimentar y ver cuanto
            retardo necesitas.

        keyboard=[0|1|2]
        ----------------
            Selecciona el tipo de teclado :

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

        joypad=[0|1|2]
        --------------
            Activa o desactiva el joypad del PC :

                0 -> desactiva el joypad
                1 -> modo automatico
                2 -> modo manual

            En esta version el modo automatico y manual tendran las mismas
            consequencias, ambas activaran el joypad.

        boton_1=[0|1|2|3]
        boton_2=[0|1|2|3]
        boton_3=[0|1|2|3]
        boton_4=[0|1|2|3]
        ------------------
            Determina el mapeado de los dos o cuatro botones del joypad
            del PC

                0 -> boton I
                1 -> boton II
                2 -> seleccion
                3 -> ejecutar

        soft_reset=[y|n]
        ----------------

            En algunos juegos, si pulsas "ejecutar" y luego "seleccion"
            reiniciaras el PC Engine. Esta opcion prevendra que esto
            ocurra. Si esta activada solo la opcion "reset" del menu
            te permitira reiniciar.

        graphic_format=[0|1]
        --------------------

            Las instantaneas pueden ser guardadas en dos formatos, esta
            opcion te permite elegir la que prefieras :

                0 -> PCX
                1 -> BMP

        vesa=[y|n]
        ----------

            Cuando se activa, el emulador hara uso del modo de video 
            VESA, de otra manera el emulador usara un simple modo de
            video "mode-x".

        video_mode=[0|1|2|3]
        --------------------
            Selecciona el modo de video en pantalla :

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

            Cuando el emulador este en modo automatico, el mismo seleccionara
            el modo apropiado para cada juego, de otra forma, el modo es fijo.
            Los ultimos cuatro modos solo estan disponibles cuando "vesa" se 
            ajusta a "y" y si tu BIOS VESA los soporta.

        fullscreen=[y|n]
        ----------------

            El modo de pantalla completa es un modo de video especial en 
            256x240 que ocupa toda la pantalla, todo el borde negro que 
            rodea la pantalla desaparecera. Este modo no funciona en todas
            las tarjetas de video...

            NOTA: Este modo no funciona en VESA
            ----

        scanlines=[0|1|2]
        -----------------

            Selecciona el tipo de lineas del modo video. Este modo intenta
            simular un TV NTSC en tu PC insertando unas pequeas lineas negras
            entre las lineas de pantalla. El modo "software" es seguro para 
            todos los monitores, pero el modo "hardware" usa una cantidad
            de refresco especial de 97Hz. Los monitores mas nuevos
            pueden manejar esta frequencia, pero algunos antiguos no.
            Si no estas seguro, selecciona el modo "software 2" o sin
            "scanlines" modo "0". Esta opcion se activa con la tecla F12.

                0 -> ninguno
                1 -> hardware
                2 -> software

            NOTA: Este modo solo funciona en "VESA mode".
            ----

        laptop=[y|n]
        ------------
            Desactiva la resolucion de pantalla de 360x240 para los
            equipos portatiles.

        sound=[y|n]
        -----------
            Activa o desactiva la salida de sonido.

        16bit=[y|n]
        -----------
            Activa o desactiva el sonido 16 bit.

        stereo=[y|n]
        ------------
            Activa o desactiva el stereo.

        reverb=[y|n]
        ------------
            Si se activa ( "y" ) el efecto reverb se activara en el arranque.

        master_vol=[0-100]
        dac_vol=[0-100]
        cd_vol=[0-100]
        --------------
            Controla el ajuste inicial del volumen de tu tarjeta de sonido.
            Si experimentas mucho o poco volumen, cambia estos ajustes.
            Si no se ajusta ningun valor, MagicEngine no cambiara los 
            volumenes.

            NOTA: "dac_vol" no tiene ningun efecto en tarjetas Ultrasound.
            ----

        adpcm_vol=[0-200]
        -----------------
            Controla el volumen interno del canal ADPCM presente en la unidad
            de CD-ROM del PC Engine. El valor maximo normalmente es 100; es
            posible aumentarlo, pero en ese caso y dependiendo del juego, el
            sonido podria distorsionar.

        sound_card=[0|1|2|3|4]
        ----------------------
            Selecciona la tarjeta de sonido a usar con MagicEngine :

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

        sync_dma=[y|n]
        --------------
            Activa la sincronizacion de el DMA de sonido. Prueba a activar esta 
            opcion si oyes un sonido defectuoso!

        info_screen=[y|n]
        -----------------
            Activa la pantalla de info el arrancar. Esta pantalla muestra el
            volumen actual para los seis canales de sonido, la cantidad de 
            frames seleccionados y cuantos frames se visualizan cada segundo.
            Pulsa F11 para alternar esta pantalla visible/no visible.

        cache=[y|n]
        -----------
            Cuando se ejecuta un juego en CD-ROM, MagicEngine puede gestionar
            una cache interna en memoria. Esto puede acelerar algunos juegos,
            especialmente si tienes una unidad lectora con un tiempo de acceso
            bajo.

        cache_size=[4096|...]
        ---------------------
            Define el tamao cache del CD-ROM en KB.

        cd_drive=[D|...]
        ----------------
            Por defecto MagicEngine busca la letra de tu lector CD-ROM, pero
            si tienes varios lectores puedes especificar la letra de unidad 
            que MagicEngine usara.

        system_card_1=[SYSCARD1.PCE|...]
        system_card_2=[SYSCARD2.PCE|...]
        system_card_3=[SYSCARD3.PCE|...]
        system_card_4=[GE.PCE|...]
        --------------------------
            La emulacion de CD no se puede ejecutar sin una "System Card". 
            Puedes ajustar el "path" para cuatro "System Cards" diferentes,
            MagicEngine te permitira seleccionarlas desde su propio menu
            "boot cd".

            NOTA: Si no hay ficheros especificados, MagicEngine buscara los 
            ----  ficheros indicados arriba en su propio directorio.

        path=[GAMES.DAT|C:\PCE\GAMES\|...]
        ----------------------------------
            Indica al emulador que use un archivo de juego o un directorio de
            juegos. MagicEngine puede ahora crear automaticamente un menu para
            ti, solo tienes que indicar el "path" donde tus ROMS estan 
            localizadas y el emulador creara el menu y cargara las ROMs 
            individualmente. Ya no hay que crear ningun archivo.

            NOTA: MagicEngine reconoce solo ficheros con la extension .PCE, si
            ---   tienes algunas ROMs con otras extensiones puedes aadirlas
                  manualmente en el fichero "GAMES.IDX" creado por el emulador,
                  o simplemente renombralas.


    El formato de cabezera
    ----------------------

    En esta version el formato de cabezera ha sido mejorado para soportar 
    "HuCards" mayores, como Street Fighter 2 . La cabezera es de 512 bytes;
    aqui tienes una corta descripcion de todos los bytes usados :

        offset  size    description
        ------  ----    -----------
          0       1     numero de bancos de 8KB presentes en la ROM, el 
                        valor maximo es 128
          1       1     formato de ROM:
                        ----------
                        bit 0: activo si la rom esta partida ( split )
                        bit 1: activo cuando la cabezera contiene el nombre
                               del juego ( ver abajo )
                        bit 6: activo para una "HuCard" extendida (> 1MB)
                        bit 7: activa el bit invertido de la ROM
          2       1     numero de bancos extra de 512KB ( usado para 
                        "HuCards" extendidas )                     
         448      1     longitud del titulo
         449      1     checksum del titulo ( XOR de todos los bytes ) 
         450     62     titulo del juego

    El resto de la cabezera no se usa de hecho, pero para futuras 
    compatibilidades, se recomienda llenar ese area con ceros ( "0" ).


    Agradecimientos
    ---------------

    Muchas personas han contribuido a hacer posible que MagicEngine sea
    lo que es, quisiera agradecerles desde aqui, especialmente :   

                         Peter Kriegesmann
                          Stuart Campbell
                        Jens Ch. Restemeier
                            Dave Shadoff
                               Indi
                     y mi hermano Cedric Michel

    Agradecimientos especiales :

        - Todos mis beta-testers! Buen trabajo chicos!!
        - Todos los usuarios registrados! Gracias!
        - Todos los que habeis enviado vuestras sugerencias para mejorar
          MagicEngine!
        - Alex Martin, por haber traducido la documentacion en Espaol!
        - Mauro Grauso, que hizo MagicEngine mas internacional
          con su traduccion al Italiano.
        - Bt Garner, por ofrecerme una pagina para MagicEngine.
        - Achillefs Margaritis, por haber programado ese maravilloso
          modo "fullscreen".
        - DJ Delorie y a todas las personas en DJGPP.
        - Shawn Hargreaves, su gran libreria ALLEGRO que me ha salvado 
          de un duro trabajo mientras desarrollaba MagicEngine.
        - Charles Sandmann, por permitirme distribuir CWSDPMI junto a mi
          emulador. Si te interesa la ultima version o quieres el codigo
          fuente, puedes obtenerlo en la siguiente direccion :

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

          O si quieres contactar con el por correo ordinario :

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


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

