RAGE2X frontend by JYCET
for GNGEO2X emulator by PEPONE



Q: What is RAGE2X ?
A: It's a dedicated frontend for GNGEO2X emulator for GP2X.

Q: How install it?
A: Unpack rage2x.gpe, rage2x.lng and rage2x.dat in your gngeo2x emulator folder (rage2x.cfg is automatically generated when it doesnt exist).

Q: What is RAGE2X.DAT file ?
A: It's the database file, which content all NEO-GEO ROM information for RAGE2X.

Q: How to use it?
A: Use:
	-UP | DOWN to choose a game or an option
	-LEFT | RIGHT to change some numerique option (cpu frequency)
	-A or B to go to launching window (run gngeo or quit rage2x)
	-SELECT to go to setting window
	-START to quick exit (double)
	-RIGHT & LEFT SHOULDER to go on the bottom/top of game list

Q: Why RAGE2X is not launched when I quit GNGEO2X emulator?
A: Check if you have enable "AUTO RELOAD GUI" option and dont rename RAGE2X.GPE in another name.

Q: Why I didnt see all my roms in green?
A: Verify your folder romspath1 & romspath2 in RAGE2X.CFG (you can change "roms/" & "/mnt/sd/roms/neogeomvs/")
   Check if your zipped roms have the correct MAME name.

Q: What are gngeo2x options supported by RAGE2X ?
A:	--showfps (and --no-showfps)
	--sound (and --no-sound)
	--samplerate=11025 (--samplerate=22050 or --samplerate=44100)
	--cpu_speed=xxx
	--frontend=name
	--raster (and --no-raster)
	--system=name
	--country=name
	--screen320 (and --no-screen320)
	--68kclock=xx
	--z80clock=xx
	--ramhack (and --no-ramhack)
	--vsync (and --no-vsync)
	--tvout (and --no-tvout)
	--tv_offset=x,y
	--dumpsprite
	and finally 2 roms folder path

Q: Where are all preview ?
A: 	You can download all antidark preview here: http://jycet.perso.cegetel.net/programmes/antidark_preview.rar (2795Ko)
	or from Eso Rimmer here: http://archive.gp2x.de/cgi-bin/cfiles.cgi?0,0,0,0,50,1531

Q: How to return rage2x with a preselected rom?
A:	use rom=zipname command line, example: "./rage2x.gpe rom=viewpoin"

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

v1.1
-beta test finished, update version and public release

V1.0.1 (beta11) (no public release yet)
-fix TV-OUT scaling (I'm very happy now :) )
-fix TV-OUT flickering
-fix TV-OUT synchro (thanks to Pepone's frame_skip source ;) )
-chg all options code
-add --ramhack and --no-ramhack option
-add --vsync and --no-vsync option
-add --tvout and --no-tvout option
-add --tv_offset=x,y option
-add --dumpsprite
-add unsupported options (16 max) in rage2x.cmd
-add activation or not of all command line from rage2x.cmd (request Pepone)
-add save for these command line states (request me)
-add background scrolling options (if no scrolling you can down rage2x clock to 66MHz)
-add exit_program line in cfg if you want to launch another prog than default menu
-chg preview reading to reduce sd access
-add rom=ZIPNAME rage2x command line to return on launched rom (need more test when gngeo2x'll support it :) )
-add edit roms path 1 option
-add edit roms path 2 option
-add edit exit program option
-use gngeo2x craigix's ram tweak option for rage2x
-use gngeo2x --tv_offset=x,y option parameters to realtime center of rage2x in tvout mode
-add B button to launch a game
-add gngeo2x files checking (and "nochecking" cmd line for rage2x reboot)

V1.0 (no public release)
-fix no preview display speed (forgot to convert the picture to 16b)
-fix all over-range & missing settings in rage2x.cfg
-add -funroll-loops flag for compilation
-add rage2xclock option (you can change rage2x frequency from 66MHz to 133MHz)
-add credit screen with lot of name :)
-add memory cleaning at exit or gngeo launching
-add synch() for all save.
-chg to the last HW SDL lib by paeryn
-chg surface setting for hardware with double buffer (smooth now)
-chg default rage2x speed from 133MHz to 100MHz (by default)
-chg no preview picture (I prefere this one)
-chg NEO-GEO background logo (I prefere this one too :))
-chg selector picture
-chg rage2x boot speed (already fast but faster now :))
-chg the quick exit for a double START
-add missing screenshot and chg some.
-big update of database!

v0.9
-add 44100Hz sample rate option
-add gp2x underclock option (start at 100MHz)
-chg gp2x max overclock to 310MHz
-rage2x.gpe compressed with gpecomp v0.4 of rlyeh

v0.8.8 (debug release)
-fix save error for system arcade || system console for CF file
-fix selector move bug beetween 11 to 19 roms in a list
-fix selector display when you have 0 rom in available list
-fix black screen lock when rage2x.dat or rage2x.lng is missing and display error message
-fix bug with --68kclock=0 in global config when another value exist in CF file
-fix bug with --z80clock=0 in global config when another value exist in CF file
-fix bug in windows slide when you press quickly SELECT or A
-fix bug display for CF info when a CF file exist but when one (or more) option line doesnt exist in this CF
-cleaning sources


v0.8.7 (ConFig file release)
-export language package to rage2x.lng file, now everybody can add one language. It's automatically loaded by rage2x. Language limitation are no accents no space (replace it by "_" ) and no more 25 caracteres
-add Norwegian language (thanks to cowai)
-add 68k clock option to over/under clock cpu 68000 (-50% to +50%)
-add z80 clock option to over/under clock cpu z80 (-50% to +50%)
-add full *.cf information view if exist in options menu (pepone suggestion and he have right it's easier to manage your different roms setting :))
-fix the display of general config when a CF file is saved (bug introduce in v0.7.7)
-chg some gfx design and font color (more brightness)
-fix bug when gngeo is launch at 200MHz (thanks to pepone for his help !)
-add launching window by A button (delete B button function)
-add invert run choice option (I prefere without cf in first but pepone prefere with cf in first so ... new option :))


v0.7.7 (language release)
-add polish language (thanks to kardasan)
-add spanish language (thanks to iignotus)
-add dutch language (thanks to Inopia)
-add turkish language (thanks to techFreak)
-add portuguese language (thanks to Paulo Becker)
-add --no-screen320 option (and saved) (not translated yet)
-add finnish language (thanks to Jarska333)
-add swedish language (thanks to Megamannen)
-fix bug to diplay NO PREVIEW picture
-fix bug with arcade/console system option
-add option to generate dedicated CF file for each roms (very beta phase)
-add view if config file exist or not
-add B button to use CF file to launch a rom instead of A for general config (very beta phase)
	(problem know : cf file have always the priority on cmd line)
-add --no-raster --no-sound --no-showfps for genreral options cmd line

v0.6.4
-little FAQ here :)
-add deutch language (thanks to EvilDragon)
-add french language
-reduce cpu speed to 133MHz
-add some game info in rage2x.dat (thanks to Fagemul)
-add right & left shoulder to go on the bottom/top of game list (thanks to Nickmon for the idea ;))
-add full rom name diplay
-chg options position for more space (to add more options)
-add little visual effect GAME LIST<>OPTIONS
-add language frontend options (and saved)
-del game info options (always displayed now)
-add view all/available/missing roms set option (and saved)
-add little rage2x icon (thanks to Fagemul)

v0.5.1
-fix stupid raster option bug
-reduce cpu speed to 150MHz

v0.5
-change video synch by my own little function (now ~54fps for each lcd setting)
-add system option (for unibios ;))
-add country options (not used with unibios)
-change a little the design.
-add mame zip name in game information
-add all small alphabet letter (abcdefg...) in font
-cleaning of source (win lot of space)
-automatic generation of RAGE2X.CFG if it doesnt exist (/!\ THE FIRST TIME ERASE RAGE2X.CFG FROM BETA4 /!\)
-save all setting (thanks to gfoot for his recommendation)


beta4
-fix little bug to display the first preview at rage2x launch
-big optimisation of font display
-add option to choose a GUI speed (LEFT || RIGHT)
-change key to swap windows to SELECT
-change gfx mode to 16bits for a better preview diplay (thk to paeryn for his SDL lib)
-fix LIST.DAT by antidark (thk to him)
-add all preview by antidark (thk to him too :)) (around of 3.6MB ;))
-add external configuration file (rage2x.cfg) you can look inside ;)
-add option auto reload of GUI (/!\ ONLY FOR THE NEXT NEW GNGEO /!\)
-add option CPU speed (/!\ ONLY FOR THE NEXT NEW GNGEO /!\) 
-you can change the roms folder in rage2x.cfg
-add a second roms folder (priority is romspath1>romspath2)
-add raster option (use for super side kick game scrolling)
-rename file LIST.DAT to RAGE2X.DAT
-started to enter additional information in DAT file (you're welcome to complete it and share you're work :))
-correct (i hope) the uncompatibility with gp2x-cramfs (but gpe size is bigger now)
-add option to see or not additional game information
-remove FPS count in upper left
...


beta3 (private)
-import external database of game information (NAME_OF_GAME file)
-see preview (152*112*8bits)
-quick scan of available roms in ./gngeo/roms/ (keep the mame zip name)
-options fps, sound, samplerate selectable

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

TODO
Correct some bugs ?
...

Thanks to everybody on #gp2xdev for their help :)
Thanks to pepone for his great neogeo emulator !
