
fGB32 v01/10/03 first release (public), by rlyeh


1. What's fGB32 ?
2. History
3. Features
4. Screenshots
5. Installing fGB32
6. Using fGB32
7. FAQ
8. Resources
9. Credits
A. Greetings


------------------
1. What's fGB32 ?
------------------

 fGB32 is a portable Gameboy and Gameboy Color emulator for GP32, and based on sources
 from GNUBoy by Laguna & Co.

 You can download the latest fGB32 binary from http://www.retrodev.info


----------
2. History   
----------

 01/10/03: fGB32 first release (public)

    - full GB support,
    - full GBC support,
    - full ROM/GB/GBC/ZIP/GZ loading, (packed files using ZLib)
    - full sound support,  
    - full SRAM saving support,
    - five stretching modes,
    - five custom palettes for GB mono,
    - most mappers supported,
    - crystal sound rendering output, using CHN's library,
    - file manager with CRC32 ROM naming detection using GoodGBX by Cowering,
    - file manager supports up 10,000 games per SMC,
    - saving screenshots to PNG format, using my own library,
    - featuring extras: preliminary GUI, built-in menus. 

   What's lacking:

   - movie loading/recoding
   - double buffering
   - auto frameskip
   - fixing known bugs as usual :-)


 30/09/03: 6th beta (private)
 Load/Save states. PNG screenshots. Preliminary frame limiter.
 RTC enabled (real-time clock).

 27/09/03: 5th beta (private)
 Optimizations done. 4mb zipped rom support. Screen Stretching.

 25/09/03: 4th beta (private)
 Compatibility improved. Crystal sound. Preliminary optimizations. 

 20/09/03: 3rd alpha (private)
 Full GBC support. Improved compatiblity. Preliminary sound.

 14/09/03: 2nd alpha (private)
 Full GB support. Pad mapped. Preliminary GBC support.

 11/09/03: 1st alpha (private)
 Preliminary GB support. No pad mapped.


-----------
3. Features
-----------

    - full GB support,
    - full GBC support,
    - full ROM/GB/GBC/ZIP/GZ loading, (packed files using ZLib)
    - full sound support,  
    - full SRAM saving support,
    - five stretching modes,
    - five custom palettes for GB mono,
    - most mappers supported,
    - crystal sound rendering output, using CHN's library,
    - file manager with CRC32 ROM naming detection using GoodGBX by Cowering,
    - file manager supports up 10,000 games per SMC,
    - saving screenshots to PNG format, using my own library,
    - featuring extras: preliminary GUI, built-in menus. 


--------------
4. Screenshots
--------------

   Not available in txt file.


-------------------
5. Installing fGB32
-------------------

   Put your fGB32.FXE into GPMM\
   Put your ROM files uncompressed,gzipped or zipped into GPMM\GB
  
   Note: Only first file from ZIP will be used at the moment. It will be fixed soon.
   Note: Zip files are much faster at loading and scanning than non zipped ones.
         So I recommend you to use zipped files!


--------------
6. Using fGB32
--------------

   PAD is mapped for the joystick.
   A and B fire each joystick button.
   SELECT and START work also the same way.

   During the game press L/R to choose ingame options.
 

------
7. FAQ
------

   Q. Sometimes the gameplay is slow, why?
   A. I have to optimize the sources yet. Please wait for a next release.

   Q. Sometimes the frame limit option slows everything, why?
   A. That's a bug to fix. Please wait for a next release.

   Q. Some options are missing, why?
   A. No time enough. Please wait for a next release.

   Q. I have some ROM games not working, why?
   A. Probably due to an incompatiblity issue with GNUBoy sources.
      Try GNUBoy for windows/linux, if it works there then send me a report.
      Send it to my mailing list: shadow.skeleton.org/mailman/listinfo/retrodev

   Q. Double buffering option is not available, why?
   A. I'm tired of answering to '4screens bug splitting bug' questions.
      I'll enable it once someone fix this gp32 low level bug.

   Q. I've installed new games and the list does not refresh, why?
   A. Force a rescan of your games. Press SELECT-SELECT for example.

   Q. I got some errors at loading/saving and it's not working anymore, any solution?
   A. Scandisk your SMC with a SMC reader, or fix your SMC with pacrom, or fix your 
      SMC with original firmware. Try again, if not, then delete GPMM\GB\FGB32.INI


------------
8. Resources
------------

GNUboy sources    at official homepage - [ http://gnuboy.unix-fu.org  ]
GB Dev info       at Jeff's site       - [ http://www.devrs.com/gb    ]
300 GB/C PD ROMs  at Kojote's site     - [ http://www.pdroms.com      ]


----------
9. Credits
----------

  A big thanks to...

  Damian M. Gryski,Ralf Hoffmann,David Lau,Mattias Wadman,Matthew Conte,
  Markus F.X.J. Oberhumer,Dave Kiddell,Magnus Damm,Gerd Knorr,David Madore,
  Lord Nightmare,Neil Stevens,Hii, and specially Gilgamesh & Laguna for GNUBoy.

  Christian Nowak, for the GP32 soundring buffer library.

  Jean-loup Gailly and Mark Adler, for the ZLIB library.

  Cowering, for the GoodGBX DAT file.

  Mr_Spiv, for the B2FXEC tool.

  Karthur, for the Arial font (Wind-ups).


------------
A. Greetings
------------

  all the gp32 scene staff, for keeping GP32 spirit alive. 

  zardozj,spiv,Toris,DJWillis,RobBrown,Skeezix and black--, for cool dev chats :-)

  mr_spiv,darkfader,pacman,for some dev tools. Good work! :)

  all the ppl who sent irc/mails msgs encouraging the emulator! ^__^

  A600,_Anarchy_,APL-3,AR3NA,atrkid,Badxil,betisweb,black--,CHN,Costis,_cr4sh_,craigix,
  DarkFader,DarkWolf9,Desther_1,dev,DICEASE,DJ_Syto,DrWh0,Ecthegion,esoteric_,eXcess,
  FagEmul,[FireFly],Flavor,FoxRage,fx-man,galaDky,giffel,groepaz,Guyfawkes,hando,HaunteR,
  Hokutoy,_Hybrid,IcemanGP,Intelecto,Intruder,JyCet,karter,karthur,Kojote,krb_,Linkeado,
  MikeDX,MikeHunt,mr_spiv,_Mystic_,Nebur2k3,Neo-Gaka,NhuNhu,Nuria[],Pekele,ph0x,prophet,
  rattboi,reliant77,|Rico,rino,Sanosuke,skeezix,tethor,Tetsu,tfc,TheWub,ThunderZ,_Toris,              TRaNS,Tyke|,_tyrell_,Whitesnake,Xtherm,Yenaphe,ZardozJ, etc! ...
  c==3 4 all,thx for complaining all time about my emus :-)

  And to my lovely girlfriend cariii who's dedicated this emulator to :-)

              ______  ______    _____     _______  _____
             / ____/\/ ____/\  / __ /\   /____  /\/____ \
            / /____\/ /____\/ / /_//_/  _\___/ / /\___/ /\
           / ___/\ / //_  /\ / ___  /\ /____  / // ____/ /
          / /\__\// /_\/ / // /__/ / /_\___/ / // /____\/
         /_/ /   /______/ //______/ //_____ / //______/\ 
         \_\/    \______\/ \______\/ \______\/ \______\/ !rlyeh


----
 God bless bits.
  ----




