DINGUX GNUBOY
-------------
dingux gnuboy is a port of gnuboy for dingoo dingux with some extra options.
It has been ported by joyrider aka willems davy. The dingux version is a backport
of the native os version.

how to install ?
----------------
copy sdlgnuboy anywhere you like on your sd card. The home directory should be exported
before running dingux gnuboy (although i also set it in the code to /boot/local/home)

how to play ?
-------------
Once you copied your games and the binarie file just start sdlgnuboy from a terminal with as parameter
the rom you want to play. You could also add it to dmenu to use it with the selector option.

The default keys are the same as on the gameboy being:
A	: A
B	: B
Select	: Select
Start	: Start
L	: QuickSave to selected saveslot
R	: QuickLoad from selected saveslot

Y and X does nothing !


The menu?
---------
Holding select+start will bring you to the menu where you can change diffrent options.
like showing the showing fps counter, the screen mode, sound volume, frameskip or save load a state as well as
quiting the emulator.

option notes:
	- the frameskip option will skip one out of 2 frames so instead of rendering 60 frames per second it will
	  only render 30 frames per second, this will speed up certain games at the cost of loosing frames. Experiment with it

	- there are 3 screen modes : Aspect FS which stretches the screen but keeping aspect ratio, Stretched full screen
	  and native. During native mode you will see a frame around the screen this frame can be customized !
          by default the emulator will first look for game sepecific frames being <romename>.tga if it doesn't find it it will
	  look for the file name gnuboy.tga in the folder where you loaded the rom from, if it doesn't find that one it will do 
	  a final check for a gnuboy.tga in the folder where you placed the binarie and load that one. If they all fail the default
	  frame will be loaded.

	- about frames : The frames have to be a 320x240 uncompressed tga image ! do not try to use another format or another resolution.

	- Save State and load state will display a number besides them this is the saveslot which is a number between 1 and 9 so you
	  can have up to 9 savestates per game (rom).

	the rest of the options should be obvious.

FAQ
---
A game doesn't work / load will this game ever work ?
	 - if the problem is emulation related it won't because i don't know much about emulator programming

I want to have a seperate frame for the original gameboy and color gameboy, is this possible ?
	 - YES, just put your GBC and GB roms in a seperate directory and place a gnuboy.tga image in each rom dir, 
	   one for gbc games and one for gb games.

Are save the settings from the menu saved ?
	- yes they are saved but not per game.

will a save state in Game X work on emulator Y on another machine ?
	- i have no clue, just test it although i doubt they'll work.

I want to request a feature, have something added to the emulator, where can i contact you ?
	- using my website http://www.willemssoft.be or on the a320.freeforums.org or on irc.freenet.org channel #dingoo-a320	


Notes
-----
        - The binarie has been optimized using the advanced profiling options, which is all explained on in the link below :
	  http://www.gp32x.com/board/index.php?/topic/28490-advanced-optimization-via-profiling-with-gcc4/page__st__15
          It helped gaining a few extra fps !

Credits
-------
GnuBoy has been ported by joyrider - willems davy - http://www.willemssoft.be

Thanks to the original author(s) of gnuboy without them this wouldn't have been possible,
flatmush for his excellent minimal lib, Alekmaul for the scaler code and sound threading example,
harteex (and zear) for the testing and Alf for creating the frame(s).

Thanks to the guys on #dingoo-a320 irc channel for giving a few tips, pointers and testing.
