*****************************************************************************
* NEOGem ver. 0.022                                                        *                     
*                                                                           *
* 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 CON 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 :-).

  * ver 0.022
        -Ligero incremento de la velocidad.
        -Aadida emulacin YM2610 (por HAN).
        -Sistema de banqueo del Z80 aadido.
        -Aadido soporte para cargar ROMS en zip.
        -Algunos juegos que no funcionaban, ahora funcionan.
        -Aadida opcion de frame skip automatico.
        -Seleccin del idioma del neogem.ini y del emulador.
        -Aadido soporte para PAD/Joystick 2,4,6 botones.
        -Nueva funcin para poder salvar y cargar partidas.
        -Opcin para guardar las puntuaciones, de una partida a otra.
        -Mas juegos funcionan, King of Monsters II, Kizuna Encounter...
        -Arreglado fallo de graficos del Metal Slug.
        -Velocidad de las animaciones de fondo arreglada (otra vez..).
        -Sonido o Musica Seleccionable.
        -Carga de ZIPs mencionadas especificamente.
        -mas...

   
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.Gracias
9.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.

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

Las ROMS de este directorio podran estar comprimidas en ZIP, o sin comprimir,
NEOGem lo detectara automaticamente.
Si las ROMS estan comprimidas en un archivo ZIP, tambien las podras cargar
directamente.

Por ejemplo sigamos con el ejemplo anterior, que quieres cargar el
King of Fighter's '97 que esta comprimido el archivo kof97.zip y esta colocado
en el directorio "c:\neogeo\roms\kof97, entonces para poner en marcha el juego,
lo podras hacer de dos formas:

NEOGEM c:\neogeo\roms\kof97



NEOGEM c:\neogeo\roms\kof97\kof97.zip


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) (en castellano)
----------------------------

-Idioma_NEOGem (CASTELLANO o ENGLISH) : Esto selecciona el idioma en el que
                se quiere que este el archivo NEOGEM.INI.

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

-pais (JAPON, USA o EUROPA) : 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 por cada
                frame mostrado en pantalla. Se puede poner la palabra "auto",
                lo cual har que el propio programa determine cuantos frames
                se ha de saltar para ir a la velocidad correcta.

-Sonido (SI o NO) : Esta opcin, activar o desactivar la emulacin del
                    sonido de la NEOGEO.

-Musica (SI o NO) : Esta opcin, activar o desactivar la emulacin del
                    FM de la NEOGEO. Se recomienda su desactivacin ya que
                    la emulacin es muy alpha. (esta emulado sobre el OPL2
                    de la Sound Blaster, pufff!!)

-Salvar_Puntuaciones (SI o NO) : Esta opcin activar o desactivar, la funcin
                                 de salvar las puntuaciones al salir del juego.

-Modo_NEOGEO (CONSOLA 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.

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

-Control_Jugador1 (Teclado Joy2b Joy4b Joy6b FsPro Wingex)
-Control_Jugador2 (Teclado Joy2b Joy4b Joy6b Fspro Wingex)
 Aqui se define el tipo de control que tendra cada jugador :
        Teclado : El control de jugador sern las teclas definidas abajo.
        Joy2b  : Joystick standard de 2 botones.
        Joy4b  : Joystick de 4 botones.
        Joy6b  : Joystick de 6 botones.
        Fspro  : Flight Simulator pro.
        Wingex : Wingman Extreme.

 Nota: Si se elige dos pads, osea un pad para el jugador1 y otro para el
       jugador2, el maximo de botones por pad seran de 2. 

-Monedas1 y -Monedas2 : 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'.

-Jugador1 y -Jugador2 : 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 Jugador2 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.
'F5'      Reset de la consola.
'F6'      Recalibrar joystick/pad.
'F7'      Cargar estado.
'F8'      Salvar estado.
'F9'      Captura la pantalla actual de emulador y la guarda en formato TGA.
'F11'     Visualiza los frames por segundo en la esquina superior derecha.
'F12'     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 : OK!
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 : OK!
CYBER LIP : OK!
CROSSED SWORDS : OK!
FATAL FURY I : OK!
FATAL FURY II SPECIAL : 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 : OK!
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 : Not run.
PUZZLE DE PON : 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! 
SAVAGE REIGN : OK!
SENGOKU I : OK!
SENGOKU II : OK!
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 : OK!
THE KING OF FIGHTERS '97 : OK!
THE KING OF FIGHTERS '98 : 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 : OK!
WORLD HEROES II JET : OK!
ZED BLADE : OK!

*Juegos testeados : 72
*Juegos OK : 65


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.
-Mejorar la emulacin del YM2610.
-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 especialmente a "RIKIN Cadenas" el fan numero 1 de NEOGem. ;-)

8. Gracias
----------
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 Neil Bardley por el Multi-Z80 CPU emulator (neil@synthcom.com)
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 por la libreria ALLEGRO.

Gracias a todos nuestros colegas y a toda la pea del IRC:
(BraiNiack,ChandlerB,CBeard,Seia,Azote,Rikin,markos,etc..).
Nos vemos en #emuroms #emuladores #emu del IRC hispano.

9. Contacta con nosotros
------------------------

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

E-MAIL:
arkaikos@hotmail.com


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

