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

Tabla de contenidos:

	1. Acerca de Gelide
	2. Features
	3. Estado + Sistemas Incorporados (v 0.1.3)
	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 una interfaz de usuario configurable 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.sourceforge.net.


2. Features

	* 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
	  solo dat's de ClrMamePro).
	* 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 Cartucho).
	* Soporta imágenes del juego por nombre o crc (no-intro screenshot).
	* 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.3)

	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, estos son los sistemas y emuladores que incluye:
	* Amstrad GX4000:
		Sdlmess
	* Atari 2600:
		Stella, Sdlmess, Xmess
	* Atari 5200:
		Sdlmess, Xmess
	* Atari 7800:
		Sdlmess, Xmess
	* Atari Jaguar:
		Virtual Jaguar, Sdlmess
	* Atari Lynx:
		Mednafen, Sdlmess, Xmess
	* Bandai Wonderswan:
		Mednafen, Xe, Sdlmess, Xmess
	* Bandai Wonderswan Color:
		Mednafen, Xe, Sdlmess, Xmess
	* Coleco ColecoVision:
		Sdlmess, Xmess
	* Emerson Arcadia 2001:
	 	Sdlmess, Xmess
	* Entex Adventure vision:
	 	Sdlmess, Xmess
	* Fairchild Channel F:
	 	Sdlmess, Xmess
	* GCE Vectrex:
	 	Sdlmess, Xmess
	* Magnavox Odyssey2:
		Sdlmess, Xmess
	* Mame:
	 	Sdlmame, Xmame
	* Mattel Intellivision:
		Sdlmess, Xmess, jzIntv
	* Nec PcEngine/TurboGrafx:
		Hu-go!, Mednafen, Xe, Sdlmess, Xmess
	* Nec Super Grafx:
		Mednafen, Sdlmess
	* Nintendo Famicom (Disk system):
	 	Fceux, Fceu, Mednafen, Xe, Sdlmess
	* Nintendo Game Boy:
	 	Gambatte SDL, VisualBoyAdvance, Mednafen, Xe, Sdlmess, Xmess
	* Nintendo Game Boy Color:
	 	Gambatte SDL, VisualBoyAdvance, Mednafen, Xe, Sdlmess, Xmess
	* Nintendo Game Boy Advance:
	 	VisualBoyAdvance, Mednafen, Xe
	* Nintendo Nes:
	 	Fceux, Fceu, Mednafen, Xe, Sdlmess, Xmess
	* Nintendo SNes:
	 	Zsnes, Snes9x, Xe, Sdlmess, Xmess
	* Nintendo 64:
	 	Mupen64Plus, Sdlmess
	* Raine:
		Raine, Sdlmame, XMame
	* RCA Studio II:
		Xmess, Sdlmess
	* Sega Game Gear:
	 	Osmose, Mednafen, Xe, Sdlmess
	* Sega Master System:
	 	Osmose, Mednafen, Xe, Sdlmess, Xmess
	* Sega SG-1000:
	 	Mednafen, Xe, Sdlmess
	* Sega Mega Drive:
	 	Gens/GS, Regen, Xe, Generator (Pal), Generator (NTSC), dgen/SDL,
	 	Sdlmess, Xmess
	* SNK Neo Geo:
		Sdlmame, XMame, GnGeo
	* ZiNc:
		ZiNc, Sdlmame, XMame
	 	
	He incluido el documento "Sistemas y Emuladores 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.sourceforge.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

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 <gelide.prj@gmail.com> para que la pueda añadir a la siguiente versión
de Gelide.

	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
<gelide.prj@gmail.com>.


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

	Además de Gtkmm (libgtkmm), Gelide depende de las librerías	libgconfmm y
libxml2 y son esenciales para el funcionamiento del programa.


6. Acerca de las Roms

	Gelide está desarrollado sin ningún animo 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 CMPro 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 CMPro dat, RomCenter 1, 
RomCenter 2, etc. aunque tanto la versión actual del CMPro como del RomCenter
parecen estar dando soporte a un nuevo formato basado en XML de dat 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 CMPro, 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, JesusDa y Vimatoga por sus ideas y ayuda.
	A Tom G.P. por ponerme en la pista de los emuladores Regen y Gambatte.
	A Loris Cuoghi por su traducción de Gelide al Italiano.
	A Emeric Grange por su traducción de Gelide al Francés
	A Niklas Grahn por su traducción de Gelide al Sueco
	A Manuel Wächter por su traducción de Gelide al Alemán

	
10. Licencia

Gelide
Copyright (C) 2008 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
-------------------------------------------------------------------------------

