Gelide - Readme
===============

Tabla de contenidos:

	1. Acerca de Gelide
	2. Características
	3. Estado + Sistemas Incorporados (v 0.1.5)
	4. Proyecto
		4.1. Cómo contribuir
	5. Instalación
		5.1. Dependencias
	6. Acerca de las Roms
	7. Ficheros Dat
	8. Disclaimer
	9. Agradecimientos
	10. Licencia



1. Acerca de Gelide

	Gelide es un frontend multi sistema y multi emulador que te permitirá
gestionar cualquier tipo de sistema emulado (ordenador, consola, arcade, etc)
así como catalogar y lanzar cualquier juego para el que exista un emulador bajo
Gnu/Linux.

	Te permite configurar cualquier emulador que soporte parámetros por linea de
comandos, sin tener que recordarlos una y otra vez simplificando así su uso.

	Gelide es un proyecto libre, licenciado bajo la GNU General Public Licence 
(ver el archivo COPYING para obtener más información) y escrito en C++
utilizando como base las librerías Gtkmm.

	Visita la web del proyecto en http://gelide.sf.net para obtener más
información.



2. Características

	* Gui simple, intuitiva y totalmente configurable.
	* Soporta cualquier tipo de sistema (plataforma).
	* Permite la configuración de cualquier emulador que soporte parámetros por
	  linea comandos.
	* Para cada sistema es posible configurar cualquier número de emuladores.
	* Soporta la inserción de datos de juegos desde ficheros DAT. Actualmente
	  soporta tres formatos: ClrMamePro, Mame XML, Logiqx XML.
	* Realiza chequeo y comparación simple de los juegos contra ficheros dat.
	* Incluye previsualización de imágenes de los juegos (Captura, Titulo,
	  Frontal, Trasera y Medio).
	* Soporta imágenes del juego por nombre o crc lo cual permite soportar los
	  sets de imágenes del "no-intro screenshot archive".
	* Permite exportar e importar las configuraciones de sistemas (incluyendo 
	  las configuracioens de sus emuladores).
	* Gestión de sistemas, emuladores y juegos mediante menús simples.
	* Incluye un panel de filtros para los listados de juegos.
	* Soporta filtrado de juegos por nombre.
	* Modo pantalla completa.



3. Estado + Sistemas Incorporados (v 0.1.5)

	Actualmente Gelide está en estado beta, esto significa que aunque es muy
funcional, es probable que tenga multitud de errores. Además, no incluye todas
las funcionalidades que pretendo implementarle ni todos los sistemas y
emuladores que me gustaría preconfigurarle.

	En la versión actual, lleva incorporados un total de 38 sistemas y 36
emuladores diferentes, preconfigurados de la siguiente manera:
	* Amstrad GX4000:
		Mess, Sdlmess
	* Atari 2600:
		Stella, z26, Mess, Sdlmess, Xmess
	* Atari 5200:
		Mess, Sdlmess, Xmess
	* Atari 7800:
		Mess, Sdlmess, Xmess
	* Atari Jaguar:
		Virtual Jaguar, Mess, Sdlmess
	* Atari Lynx:
		Mednafen, Sdlmess, Handy/SLD, Mess, Xmess
	* Bandai Wonderswan:
		Mednafen, Xe, Mess, Sdlmess, Xmess
	* Bandai Wonderswan Color:
		Mednafen, Xe, Mess, Sdlmess, Xmess
	* Coleco ColecoVision:
		Mess, Sdlmess, Xmess
	* Emerson Arcadia 2001:
	 	Mess, Sdlmess, Xmess
	* Entex Adventure vision:
	 	Mess, Sdlmess, Xmess
	* Fairchild Channel F:
	 	Mess, Sdlmess, Xmess
	* GCE Vectrex:
	 	Mess, Sdlmess, Xmess
	* Magnavox Odyssey2:
		Mess, Sdlmess, Xmess
	* Mame:
	 	Mame, Sdlmame, Xmame
	* Mattel Intellivision:
		Mess, Sdlmess, Xmess, jzIntv
	* NEC Pc Engine:
		Hu-go!, Mednafen, Xe, Mess, Sdlmess, Xmess
	* NEC Super Grafx:
		Mednafen, Mess, Sdlmess
	* Nintendo DS:
		DeSMuME
	* Nintendo Famicom Disk system:
	 	FCEUX, Nestopia, Mednafen, Xe, Mess, Sdlmess
	* Nintendo Game Boy:
	 	Gambatte SDL, Gngb, Gnuboy, VisualBoyAdvance, Mednafen, Xe, Mess,
	 	Sdlmess, Xmess
	* Nintendo Game Boy Color:
	 	Gambatte SDL, Gngb, Gnuboy, VisualBoyAdvance, Mednafen, Xe, Mess,
	 	Sdlmess, Xmess
	* Nintendo Game Boy Advance:
	 	VisualBoyAdvance, BoyCott Advance-SDL, Mednafen, Xe, Mess, Sdlmess
	* Nintendo Entertaninment System (NES):
	 	FCEUX, Nestopia, Mednafen, Xe, Mess, Sdlmess
	* Nintendo Super Nintendo Entertaninment System (SNES):
	 	SNes9x-gtk, BSnes, Zsnes, Xe, Mess, Sdlmess, Xmess
	* Nintendo 64:
	 	Mupen64Plus, Mess, Sdlmess
	* Raine:
		Raine, Mame, Sdlmame, XMame
	* RCA Studio II:
		Mess, Sdlmess, Xmess
	* SEGA 32X:
		Gens/GS, Mess, Sdlmes
	* SEGA Game Gear:
	 	Osmose, Mednafen, Xe, Mess, Sdlmess
	* SEGA Master System:
	 	Osmose, Mednafen, Xe, Mess, Sdlmess, Xmess
	* SEGA Mega Drive:
	 	Gens/GS, Regen, Xe, Generator,	Mess, Sdlmess, Xmess
	* SEGA SG-1000:
	 	Mednafen, Xe, Mess, Sdlmess
	* Sinclair ZX Spectrum:
		FBZX, Fuse, SpectEmu, Mess, SdlMess
	* SNK Neo Geo:
		Mame, Sdlmame, GnGeo, XMame 
	* SNK Neo Geo Pocket:
		Mednafen, Xe, Mess, Sdlmess
	* SNK Neo Geo Pocket Color:
		Mednafen, Xe, Mess, Sdlmess
	* ZiNc:
		ZiNc, Mame, Sdlmame, XMame
	 	
	He incluido el documento "Systems&Emulators-HowTo" en el que podéis
encontrar una extensa documentación sobre como encontrar, instalar y configurar
cada uno de los emuladores soportados por la versión actual. Podéis encontrarlo
bajo el directorio doc del tarball.

NOTA: Este apartado puede que no esté actualizado aunque intentaré modificarlo
con cada nueva versión de Gelide. Podréis encontrar este mismo apartado
actualizado (eso espero) en la web del proyecto: http://gelide.sf.net.



4. Proyecto

	Gelide es un proyecto hospedado en sourceforge.net. Si necesitas ayuda o
cualquier otra cosa solo tienes que pasar por nuestro tracker de soporte:
	http://sourceforge.net/tracker2/?atid=1026807&group_id=213712&func=browse
también puedes visitarnos en el apartado de foros:
	http://sourceforge.net/forum/?group_id=213712
	Para cualquier otra cosa, puedes contactar con nosotros en la dirección de
correo electrónico del proyecto: <[email protected]>

4.1. Cómo contribuir

	Hay muchas maneras de las que puedes ayudar sin necesidad de programar nada.
Simplemente utilizando Gelide e informandonos de aquellos problemas con que te
encuentres, puede sernos de gran ayuda:
	http://sourceforge.net/tracker2/?group_id=213712&atid=1026806
también son bienvenidas todas aquellas ideas para mejorar gelide, tanto la 
interfaz como cualquier otra parte del programa:
	http://sourceforge.net/tracker2/?group_id=213712&atid=1026809

	Puedes ayudarnos también a que Gelide esté traducido a tu lenguaje nativo
para lo cual no necesitas conocimientos de programación, simplemente tendrás
que traducir las cadenas que aparecen en el archivo "gelide.pot" que puedes
encontrar en el directorio "po" del tarball. Puedes hacerlo con cualquier editor
de textos, aunque mi consejo es que utilices algún editor de archivos po, como
PoEdit o GTranslator. Una vez que tengas la traducción terminada, me la puedes
enviar a <[email protected]> para que la pueda añadir a la siguiente versión
de Gelide.

	Otra forma de ayudarnos es con la traducción de otros documentos del
proyecto, como por ejemplo "doc/Systems&Emulators-HowTo.es_ES.txt" o este mismo
que estás leyendo.

	También puede ser interesante que nos remitas tus configuraciones de 
sistemas y emuladores que no vienen preconfigurados en Gelide, o aquellos para
los que crees que has encontrado unos parámetros más adecuados para su uso. Solo
tienes que exportarlos desde Gelide (Menú Archivo -> Exportar sistemas) y
enviarnos los archivos exportados a la dirección de correo del proyecto
<[email protected]>.


5. Instalación

	Las instrucciones de instalación las podéis encontrar en el archivo INSTALL
en la raiz del archivo tarball con el código fuente del programa. Para compilar
Gelide desde los fuentes necesitarás como mínimo Gtkmm 2.6.x instalado en tu
sistema además de las autotools y lo necesario para compilar aplicaciones en
C/C++ bajo GNU/Linux.

5.1. Dependencias

	Gelide en su versión actual, solo depende de las librerías libgtkmm y
libxml2, no obstante para compilar desde los archivos fuente, necesitarás tener
instaladas las versiones de desarrollo de estas dos librerías (-dev) y también
la utilidad intltool.


6. Acerca de las Roms

	Gelide está desarrollado sin ningún ánimo más alla de mi propia inquietud
por la programación y el mundo GNU/Linux y PARA NADA está a favor del uso ilegal
de Roms. Si no tienes el juego original, no estás autorizado a jugar con la Rom
del juego por lo que no me preguntes donde conseguir Roms ni cualquier otro tema
relacionado, no responderé.
	Hay multitud de roms legales, libres y gratis, googlea un poco y las podrás
encontrar sin dificultad.


7. Ficheros Dat

	Los archivos Dat, son una especie de base de datos donde se almacena 
información referente a un sistema, sus juegos y los datos de sus roms. Son
utilizados, o más bien requeridos, por gestores de Roms (Roms managers) tales
como ClrMamePro y RomCenter para poder construir y auditar los sets de roms para
que sean usables por los emuladores.

	Hay vários formatos de archivos dat tales como ClrMamePro dat, Mame XML,
Logiqx XML, RomCenter 1, RomCenter 2, etc. aunque tanto la versión actual del
ClrMamePro como del RomCenter parecen estar dando soporte a los formatos basados
en XML como el Dat XML genérico que parece haber surgido desde la web
http://www.logiqx.com, aunque de esto no estoy muy seguro.

	La versión actual de Gelide soporta ficheros dat en formato ClrMamePro, Mame
XML, Logiqx XML, aunque no es capaz de auditar roms. Estos dats se usan para
obtener los datos de un sistema determinado y para realizar una comparación con
las roms del usuario basada en el nombre del fichero para establecer algunos
flags del listado de juegos.

	Estos son algunos de los lugares donde se pueden obtener ficheros dat:

	* http://www.no-intro.org/datset.htm: Dats del grupo No-Intro posiblemente
	  los mejores y más limpios dats de internet.
	* http://www.romshepherd.com: Una gran recopilación de dats.
	* http://www.emuxhaven.net/cowering.shtml: Recopilación de dats basados en
	  las GoodTools
	* http://www.4shared.com/dir/795431/2c9f835/sharing.html: Una buena
	  recopilación de dats.
	* http://www.logiqx.com/Dats: Buena recopilación de dats Arcade.
	* http://emulationrealm.net/modules/wfdownloads/viewcat.php?op=&cid=275:
	  Recopilación extensa de ficheros dats en diferentes formatos.


8. Disclaimer
	
	Ni mi perro ni yo, nos hacemos responsables de lo que te pueda pasar a ti o
a tu ordenador, por utilizar Gelide. Esta claro ¿no?.


9. Agradecimientos

	A Minisoriex Vimatoga por sus ideas y ayuda.
	A JesusDa por darme la idea para los nombres de las versiones.
	A Tom G.P. por ponerme en la pista de los emuladores Regen y Gambatte.
	A Loris Cuoghi, Emeric Grange, Niklas Grahn, Manuel Wächter,
Daniel Nylander, Kamil Ślepowroński, Oleg Koptev por sus esfuerzos para traducir
Gelide a otros idiomas.
	A Pablo Casas (pablo33) por todas sus sugerencias y por reportar el solo
prácticamente todos los bugs de la versión 0.1.4. 
	Quiero dar las gracias muy especialmente a todas y cada una de las personas
que participan o han participado en el diseño e implementación de un emulador,
así como a todas aquellas personas que han pasado horas y horas documentando el
funcionamiento de un sistema determinado, sin vosotros el mundo de la emulación
no existiría. 

	
10. Licencia

Gelide
Copyright (C) 2008-2011 Juan Ángel Moreno Fernández

Gelide is free software.

You can redistribute it and/or modify it under the terms of the GNU General
Public License, as published by the Free Software Foundation; either version 3
of the License, or (at your option) any later version.

Gelide is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE.
See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with
Gelide. If not, see <http://www.gnu.org/licenses/>


-------------------------------------------------------------------------------
Para obtener más información, visita la página web del proyecto, que podrás 
encontrar en:
http://gelide.sourceforge.net
-------------------------------------------------------------------------------