*****************************************************************************
* NEOGem ver. 0.005                                                        *                     
*                                                                           *
* URL: http://www.emuspain.com/neogem                                       *
* E-mail: arkaikos@hotmail.com                                              *
*                                                                           *
* Por KRY & HN                                                            *
*****************************************************************************


NO ACEPTAMOS NINGUNA RESPONSABILIDAD POR CUALQUIER EFECTO QUE ESTE CODIGO
PUEDA CAUSAR EN TU ORDENADOR O CUALQUIER COSA QUE TENGAS, USALO A TU
PROPIO RIESGO.

TU NO ESTAS LEGALMENTE AUTORIZADO PARA USAR NINGUNA IMAGEN ROM SI TU NO
TIENES LAS PLACAS O CARTUCHOS ORIGINALES.

POR FAVOR, NO DISTRIBUYAS NEOGem COM NINGUNA ROM.

NEOGEO Y TODOS LOS JUEGOS AQUI MENCIONADOS SON MARCA REGISTRADA DE SNK Y/O
DE SUS RESPECTIVAS COMPAIAS.

Cambios
-------
  * ver 0.001
        -Primera version distribuida

  * ver 0.005
        -Mas juegos funcionan ahora, incluido KOF '97, Fatal Fury Realbout2, ..
        -Puzzle de Pon arreglado (gracias a Allard y al equipo de MAME NEOGEO).
        -Graficos de Nam 1975, Neo bomberman and Magical Drop 3 arregaldos.
        -Aadido modo Arcade y Consola al neogem.ini.
        -Aadido modo Freeplay dentro del modo arcade, y aadido al neogem.ini.
        -Seleccin de pais aadido, ahora se puede elegir entre JAPAN (JAPON) ,
         USA (Estados Unidos) y EUROPE.
        -Las animaciones del background, parece que estan arregladas, por lo
         menos ahora tienen una velocidad mas o menos correcta.
        -Aadida la emulacin del Z80 y la comunicacin con el Motorola 68000,
         lo unico que falta es incluir la emulacin del YM2610 para incluir el
         sonido :-).

Contenido
---------
1.Introduccin
2.Requerimientos
3.Uso del NEOGem
  3.1 Editando el NEOGEM.INI
  3.2 Opciones por linea de comando
  3.3 Teclas del NEOGem mientras esta en marcha
4.Juegos testeados con NEOGem
5.Que es lo que falta
6.Problemas
7.Creditos
8.Contacta con nosotros

1. Introduccion
---------------

Esto es un emulador de NEOGEO para los sistemas Maquina y Cartucho, el
formato CD todavia no lo soportamos pero algn dia caer.
Este programa lo hemos realizado para que funcione en puro DOS, no en
Windows 95/98 de la MOCOSOFT, asi que si te peta pruebalo en DOS y si
todavia sigue petando entonces escribenos y intentaremos responderte.
El sonido todavia no esta implementado. (Ya se que todo el mundo quiere el
sonido, pero yo soy el primero que se quiere viciar al Samurai con sonido,
asi que paciencia).
NEOGem no podra hacer memoria virtual si lo ejecutas dentro de Windows.
Por si alguno no lo sabe, la memoria virtual te puede permitir jugar al
KOF '97 con 32Mb de RAM. (Eso si, te puedes morir de asco cargando la ROM).


2. Requerimientos
-----------------

Requerimientos minimos:
PENTIUM 100 MHZ
16 MB de RAM
Una targeta de video que te soporte 16-bits de color. (si puede ser en 320x240).
NEOGem puede funcionar en ordenas ms lentos pero no te lo recomiendo.

Requerimientos recomendados:
PENTIUM 233 MHZ or superior
64 MB de RAM o ms
Una targeta de video que te soporte 320x240 en 16-bits de color.


3.Uso del NEOGem
-----------------

Para ejecutar una ROM de NEOGEO, tienes que pasarle por la linea de comandos
el nombre del directorio donde se encuentran las ROMs.
Por ejemplo, supongamos que quieres viciarte al King of Fighter's '97 que
esta en el directorio "c:\neogeo\roms\kof97", entonces para poner en mercha el
juego tendras que escribir algo como esto:

NEOGEM c:\neogeo\roms\kof97

NEOGem tambien tiene un archivo de configuracin llamado "neogem.ini".
Tambien podras pasar las opciones al NEOGem por la linea de comandos.
Esta es una breve descripcin de las opciones:


3.1 (OPCIONES DE NEOGEM.INI)
----------------------------

-res X Y : Donde X y Y son las resoluciones X y Y de la pantalla,
           respectivamente.

-vsync (YES o NO) : Esto activa (o no) la sincronizacin vertical, si la
                     activas obtendras menos frames por segundo.

-country (JAPAN, USA o EUROPE) : Aqui puedes seleccionar el pais con el cual
                                  va a ser ejecutado el juego.

-fskip numero : Este es el numero de frames que NEOGem se saltar. El numero
                por defecto es 1.

-NEOGEO_mode (CONSOLE o ARCADE) : Modo en el cual NEOGem va a ejecutar los
 juegos.!!!IMPORTANTE!!!, si en algn juego ves la pantalla anti pirateria
 en el modo arcade ponlo en modo consola y funcionara bien.

-FREEPLAY (YES o NO) : Este modo solo es util en el modo arcade. Si lo
                       activas, tendras creditos infinitos en este modo.

-Coin1 y -Coin2 : Aqui puedes definir los scancodes que quieres para emular
 la entrada de monedas por el Coin1 o el Coin2.
 Por defecto el Coin 1 es la tecla '1' y el Coin2 la tecla '2'.

-player1 y -player2 : Aqui puedes definir las teclas que quieras para jugar a
los juegos. Un fichero con el nombre 'SCANCODE.TXT' esta incluido dentro del
zip donde se indican todas las teclas y sus respectivos scancodes.
Las teclas por defecto para el player1 son :
        FLECHA ARRIBA : ARRIBA
        FLECHA ABAJO : ABAJO
        FLECHA DERECHA : DERECHA
        FLECHA IZQUIERDA : IZQUIERDA
        'Z' : BOTON A
        'X' : BOTON B
        'C' : BOTON C
        'V' : BOTON D
        'A' : BOTON START
        'S' : BOTON SELECT

Las teclas del player2 no estan activas por defecto.


3.2 (OPCIONES POR LA LINEA DE COMANDOS)
---------------------------------------

-res X Y : Donde X y Y son las resoluciones X e Y de la pantalla
           respectivamente.

-v : Esto activara la sincronizacin vertical.

-f numero : Esto es el numero de frames que NEOGem se saltara y no pondr en
            pantalla.

-j : Pone el juego en modo JAPONES.

-u : Pone el juego en modo USA.

-e : Pone el juego en modo EUROPEO.

-a : Pone el juego en modo ARCADE.

-c : Pone el juego en modo CONSOLA.

NOTA : El modo JAPONES eliminara la censura de la mayoria de los juegos
automaticamente.


3.3 TECLAS DE NEOGem MIENTRAS ESTA EN MARCHA
--------------------------------------------

'ESC'     Sale del emulador
'F9'      Captura la pantalla actual de emulador y la guarda en formato TGA.
'F10'     Visualiza los frames por segundo en la esquina superior derecha.
'F11'     Quita la visualizacin de los frames por segundo.
'ESPACIO' Pausa.


4. JUEGOS TESTEADOS CON NEOGem
-------------------------------

3 COUNT BOUT : OK!
8MAN : OK!
2020 BASEBALL : Algunos problemas con los sprites pero jugable.
AGRESSOR OF THE DARK KOMBAT : No funciona en esta version.
ANDRO DUNOS : OK!
ART OF FIGHTING I : OK!
ART OF FIGHTING III : OK!
ALPHA MISSION II : OK!
BASEBALL STARS II : OK!
BLAZING STARS : OK!
BLUE's JOURNEY : OK!
BURNING FIGHT : Se bloquea despues de seleccionar un luchador.
CYBER LIP : OK!
CROSSED SWORDS : OK!
FATAL FURY I : OK!
FATAL FURY III : OK!
FATAL FURY REAL BOUT SPECIAL : OK!
FATAL FURY REAL BOUT II : OK!
FREEZE FOOTBALL : OK!
GHOST PILOTS : Algunos problemas cuando se va ha jugar.
GURURIN : Problemas de escalado.
JOY JOY KID : OK!
KABUKI KLASH : OK!
KARNOV'S REVENGE : OK!
KING OF THE MONSTERS I : OK!
KING OF THE MONSTERS II : No soportado por esta version.
KIZUNA ENCOUNTER : OK!
LAST RESORT : OK!
LAST BLADE : OK!
LEAGUE BOWLING : OK!
LEGEND OF SUCCESS JOE : OK! 
MAGICIAN LORD : OK!
MAGICAL DROP 3 : OK!
MAHJONG : OK!
METAL SLUG : OK!
MUTATION NATION : OK!
NAM 1975 : OK!
NEO BOMBER MAN : OK!
NEO DRIFT OUT : OK!
NEO MR. DO : OK!
NINJA COMMANDO : OK!
NINJA COMBAT : OK!
NINJA MASTER'S : OK!
PULSTAR : No funcina.
PUZZLE DE PON : No funciona en esta version.
PUZZLE BOBBLE : OK!
QUEST OF JONGMASTER : OK!
ROBO ARMY : OK!
SAMURAI SHODOWN I : OK!
SAMURAI SHODOWN II : OK!
SAMURAI SHODOWN III : Se bloquea al iniciar el primer round :-(
SAMURAI SHODOWN IV : OK!  (algunos problemas con las barras de energia).
SAVAGE REIGN : OK!
SENGOKU I : OK!
SENGOKU II : Se bloquea cuando va a comenzar el juego.
SOCCER BRAWL : OK!
STAKES WINNER : OK!
SUPER SIDEKICKS : Se bloquea despues de llevar un tiempo jugando.
TECMO WORLD SOCCER '96 : Problemas con los zooms.
THE KING OF FIGHTERS '95 : Problemas con algunos sprites.
THE KING OF FIGHTERS '97 : OK!
TOP PLAYERS GOLF : OK!
TRASH RALLY : OK!
TURF MASTERS : OK!
TWINKLE STAR SPRITES : OK!
VIEW POINT : OK!
WIND JAMMERS : OK!
WORLD HEROES I : OK!
WORLD HEROES II : Problemas con algunos sprites.
WORLD HEROES II JET : OK!
ZED BLADE : OK!

*Juegos testeados : 71
*Juegos OK : 57


5. QUE ES LO QUE FALTA
----------------------

-Subir la velocidad y optimizarlo.
-Arreglar los problemas de los zooms.
-Algunos juegos todavia no son soportados.
-Un GUI.
-YM2610 todavia no esta emulado, por lo tanto el sonido no esta disponible.
-Tiempo para hacer ms cosas.

6. PROBLEMAS
------------

  6.1 NEOGem dice "Resolution not supported : x y in 16-bit mode" :

        -Problema:
          Tu targeta de video no soporta esa resolucin.

        -Solucin:
          Consigue un driver de tu targeta ms moderno (ej: UNIVBE).
          Prueba a poner NEOGem en otra resolucin editando el "neogem.ini".


  6.2 NEOGem dice "Resolution not supported
                    Lower resolution supported is 320x240" :

        -Problema:
          NEOGem no soporta la resolucin especificada.

        -Solucin:
          Edita el "neogem.ini" y prueba con otra resolucin.

 6.3 NEOGem dice "Error cargando ROMs de xxxxxx" :

        -Problema:
          NEOGem no puede encontrar la ROMs necesarias para su ejecucin
          en el directorio especificado en la linea de comandos.

        -Solucin:
          Comprueba que has escrito el nombre del directorio correctamente, y
          que un juego de NEOGEO esta en ese directorio.

 6.4 NEOGem dice "No se ha podido cargar bios" :

        -Problema:
          NEOGem no ha podido localizar y cargar la bios de la NEOGEO
          necesaria para que funcionen los juegos.

        -Solucin:
          Asegurate de que has puesto la bios (archivo neo-geo.rom) en el
          mismo directorio donde esta el emulador.

 6.5 NEOGem dice "No se ha podido cargar bios ng-sfix.rom" :

        -Problema:
          NEOGem no ha podido localizar y cargar el componente de la bios
          ng-sfix.rom.

        -Solucin:
          Pon el archivo ng-sfix.rom en el mismo directorio donde se
          encuentra el emulador.

 6.6 NEOGem dice "No hay memoria suficiente" :

        -Problema:
          NEOGem no puede reservar la memoria suficiente para cargar y
          ejecutar el juego especificado.

        -Solucin:
          Prueba a ejecutar el emulador en DOS puro, no en ventana de
          Windows.
          Asegurate de que tienes suficiente espacio en el disco duro
          para que NEOGem haga la memoria virtual necesaria.


7. Creditos
-----------
Luis Miguel Dominguez (HAN)
Cristobal Aguilera (KRAY)

Gracias a Luis Mendana (LiM) por dejarnos espacio en EMUSPAIN y por hacer
la mejor pagina de emuladores "http://www.emuspain.com".
Gracias a Neill Corlett por el emulador de M68000 StarScream.
Gracias a Marat Fayzullin por el emulador portable de Z80.
Gracias a Hisham Elfangary por los graficos y animaciones.
Gracias a araCORN y todo el equipo de ROMLIST.
Gracias a toda la gente que hace volcados de juegos de NEOGEO y ROMS en
general.
Gracias a Shin Seiki por sus notas tecnicas y informacin.
Gracias a Allard Van der Bass (neogeo info.)
Gracias a DJ Deloire por el compilador DJGPP.
Gracias a Shawn Hargreaves for la libreria ALLEGRO.

Gracias a todos nuestros colegas.

8. Contacta con nosotros
------------------------

NEOGem JOM PEICH:
http://www.emuspain.com/neogem

E-MAIL:
arkaikos@hotmail.com


-----------------------------------------------------------------------------

Hasta luego lucas.

