+- MikPlay32 v0.4 -+
based on libmikmod 3.1.10 by Aj0


+- Welcome -+
How long has it been since the previous release? A little over a year by now, so it's about time for an update! And hopefully it's a welcome one.

MikPlay32 is a module-player for the GP32 handheld from GamePark Inc. based on the MikMod-library. It supports the playback of various popular module formats, such as MOD, S3M, XM, IT, 669, ULT and MTM just to name a few. The replay in general is quite accurate, though the MikMod-library has its own quirks and handles panning/seperation rather crude. But at least it works! :)


+- Install -+
* Unzip the fxe-file to "GP:\\GPMM\\"
* It's recommended to place your modules under "GP:\\GPMM\\MODS\\"
* MikPlay32 is now installed, fire up your FreeLauncher and select "MikPlay32"!


+- Keys -+
START - menu
SELECT - nothing
A - previous
B - next
L + R - keylock (press in that order)
PAD - nothing


+- Known bugs -+
* Slow directory reading - seems to be the physical access that's slowing it down. I've seen faster routines, anyone care to share them with me? :)
* No support for more than 1024 entries per directory - this has been hardcoded for optimized memory usage. But why would you want to have 1024+ entries in one directory anyway, especially now that you can use subdirectories? :)
* Random noise/clicks - not sure what's causing this. Might be SDK-related, but I'll check in on it.
* Chokes at around 32 channels (real/virtual) - would have to up the clock speed to resolve this, but can't because this would also increase the pitch and tempo of the song. :(
* Strange behavior when jumping to the next/previous file - not sure what's causing this. I'm assuming it has something to do with my shoddy next/previous file routines. Looking into it!


+- FAQ -+
Q. Where do I report bugs?
A. Bug reports and general feedback is always welcome at <cvwalta@cs.vu.nl> or visit <http://www.cs.vu.nl/~cvwalta/>. Be aware that, if the bug is file-related, I may ask for a copy of the module you've been using. But please, only send modules AFTER I've asked you to do so. ;)

Q. Where can I find modules?
A. All over the internet, just search with Google or so. :P But just to get you started, here are some of my favorite places:

<http://www.scene.org/>
<http://www.chiptune.com/>
<http://www.modplug.com/>
<http://www.united-trackers.org/>
<http://www.modarchive.com/>

Q. Will you add MP3/OGG/WAV support?
A. Erm, this is a MODULE player.

Q. So, will you add MP3 support?
A. No...

Q. Will you add MO3 support?
A. Finally, a more intelligent question. Alas, I won't implement MO3 support, as I won't implement MP3 or OGG support. And as you know MO3 is just a regular module file with its samples packed using MP3/OGG.
If you still want to play your MO3 files with your GP32, you may consider using the UNMO3 utility available at <http://www.un4seen.com/> where you can also find the latest info on the MO3 module format.

Q. Will you add support for <format>?
A. Most likely not, that is unless someone suddenly decides to update libmikmod once again. ;) But that's highly unlikely, the MikMod-library has been "dead" for well over a year now.


+- History -+
v0.4 October/2003
* optimized next/previous-file routines
* changed all references to "MIKPlayer" into "MikPlay32"

v0.4b October/2003 Private release
* hacked in the button fixes with some crude global array and "if...then..."-loops
* using b2fxec v0.5 dramatically reduced the filesize :)

v0.4a September/2003 Private release
* haze has taken over the project as Aj0 no longer has his GP32 :(
* now running at (experimental) 57,75MHz for more accurate pitch
* changed colors
* added CHN's fileselector
* added subdirectory support
* added keylock (L+R)
* cleaned up code

v0.3c May/22/2002 Second (public) release
* memory leaks fixed (small bugfix to libmikmod) ;)
* no nasty clicks while loading a new module
* 4 blocks 8KB cache for module reading implemented, now it reads muuuch faster
* repeat ON/OFF
* interpolation & surround on the menu... but not sure if it's working...
* keys:
	START -> go to menu
	B -> skip to next song
* I'm thinking of adding omsk's GpTetris for playing while listening to music :)

v0.x 2002 First release
* it plays most module formats,
* put the modules on GP:\GPMM\MODS, the extension doesn't matter (.MOD, .XM, .IT, .S3M ... etc etc etc..)
* module unloading has memory leaks (don't know still why...), so you will get "Out of memory" after loading some modules ... ;)


+- Credits -+
Original port and additional code by Aj0 <http://ajo.thinknerd.com/gp32/ - ajo@godsmaze.org>
Additional code and bugfixes by haze <http://www.cs.vu.nl/~cvwalta/ - cvwalta@cs.vu.nl>
Original file loader by ZardozJones
GUI elements by Don_Miguel
File selector by Christian 'CHN' Nowak <chnowak@web.de>
b2fxec by Jouni 'Mr.Spiv' Korhonen <mouho@iki.fi>


+- Thanks -+
A major thanks to Aj0 for the original port of the library and for coding the original MikPlay32
A big thanks to ZardozJones, Don_Miguel, Mr.Spiv and CHN for the file selector, dialog code and wise-words ;)
Thanks fly out to DrJones for alpha- and betatesting, allround support and being a module-lover ^-^
Greetings to everyone at #gp32dev @ EFNET