fMSX32 17/03/03 "GBAX.COM 2003 contest" release (public), (c) 2002-2003 rlyeh


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


------------------
1. What's fMSX32 ?
------------------

 fMSX is a portable MSX computer emulator coded by Marat Fayzullin and others.
 fMSX32 is a MSX computer emulator for GP32 handheld console ported by rlyeh.

 It was ported and modified from the original fMSX emulator for UNIX.

 You can download the original fMSX UNIX source code from http://fms.komkon.org/fMSX

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


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

 17/03/03: fMSX32 "GBAX.COM 2003 contest" release (public)

    - full MSX1 and MSX2 support, partial MSX2+ support,
    - full ROM/DSK/DDI/IMG/ZIP/GZ loading, (packed files using ZLib)
    - full AY/SCC/SCC+/YM sound support,   
    - full cursor/joystick/mouse support,
    - preliminary RF multiplayer gaming (slow),
    - crystal sound rendering output, using CHN's library,
    - 99% of compatibility,
    - saving screenshots to PNG format, using my own library,
    - CRC32 ROM naming detection using GoodMSX by Cowering,
    - featuring extras: preliminary GUI, built-in menus. 

   What's lacking:

   - adding more missing options
   - fixing known bugs as usual :-)



 18/06/02: fMSX32 "first" release (private)

    - preliminary MSX1/MSX2 support,
    - preliminary ROM loading,
    - preliminary AY sound,
    - preliminary joystick/keyboard support,
    - preliminary sound rendering output, using Groepaz's library,
    - 30% of compatibility.


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

   Check (2)


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

   Not available in txt file.


--------------------
5. Installing fMSX32
--------------------

   Put your fMSX32.FXE into GPMM\
   Put your ROM/DSK/IMG/DDI files uncompressed, gzipped or zipped where you like

   Note: Only first file from ZIP will be used at the moment. It will be fixed soon.


---------------
6. Using fMSX32
---------------

   PAD is mapped for the MSX joystick and cursor.
   A fires the joystick button 1 (Space key too).
   B fires the joystick button 2 (M key too).

   START shows an in-built menu to change some options.
   Please note some of them are not yet implemented. I'm sorry.

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

   Current ingame options are:

    - Virtual Keyboard : SELECT+U,D,L,R,SELECT = F1/1,F2/2,F3/3,F4/4,F5/5 keys.
    - Autofire : selectable speed.
    - Speed Trottle : fast forwarding.
    - Save Snapshot : save PNG file into GPMM\MSX\SNAP.
    - States/Movies are not yet implemented.

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

   Q. Lots of options are not yet implemented, why?
   A. No time enough. Please wait for a next release.
      

   Q. I have some ROM/DSK games not working, why?
   A. MSX games have been extensively hacked for years.
      It could be a variant or a hacked version. Please use another one.

   Q. I know my ROM game is not hacked but it's not working, why?
   A. Please force the emulator to use another ROM mapper in the options.
      Autodetection does not always work, but it should in most cases.


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

MSX standard at www.old-computers.com - [ http://www.old-computers.com/museum/company.asp?st=1&m=86 ]
MSX news     at www.msx.org           - [ http://www.msx.org                                        ]
MSX stuff    at ftp.funet.fi          - [ ftp://ftp.funet.fi/pub/msx/                               ]


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

  Marat Fayzullin and others, for the fMSX Unix emulator.

  Mitsutaka Okazaki, for the YM2413 library.
  Tatsuyuki Satoh, for the FM-OPL library.

  Christian Nowak, for the GP32 soundbuffer library.

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

  Cowering, for the GoodMSX DAT file.

  Mr_Spiv, for the B2FXEC tool.


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

  First of all, many c==3 to Costis :-) for being so hot

  and a big c=========================================3 to GP.


  I'd like to thank personally to...


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

  zardozj, spivie girl and black--, for cool dev chats :-)

  rattboi, yenaphe, hando, pekele, karthur, reliant77 and drwh0, for betatesting ;)

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

  aj0, groepaz, don_miguel, for some help/libraries in previous stages of emulator.

  ar3na, xtreme, x_killer, excess, neo-gaka, reliant, linkeado, ignorante, nuria, galadky...
  from irc hispano network : c==3 4 all, thx for complaining all time about my emus :-)
  
  esoteric, rino, and all the ppl who sent irc/mails msgs encouraging the emulator! ^__^


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








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

