*** AUDIORACE ***   

1. DESCRIPTION
==============
Audiorace is a music based game similar to the popular Audiosurf.
It analyzes the songs of your choice and creates a unique track to ride on.
The goal of the game is simple but encouraging: choose your song and beat your
own hiscore!

That you're able to start immediately, I've added 3 songs which are released
under creative commons licenses. These are 2 from Nine Inch Nails (1000000 
and Discipline) and 1 from a german band called Pornophonique (Space Invaders).


2. IMPORTANT NOTE
=================
I've only one Wiz, thus i can only test one firmware version thoroughly.
At the time of writing, it is Firmware 1.2.1. If you have problems 
with audiorace (rotated screen especially) with any other firmware version,
i recommend to upgrade.
Firmwares are always available at http://dl.openhandhelds.org/cgi-bin/wiz.cgi.


3. HOW TO ADD SONGS
===================
If you're not happy with my song selection, you can of course add songs of your
choice! It's simple: just copy some music into the Music/ subdirectory (or any
other folder, a browser is included).
Audiorace will analyze the song the first time it is played (sorry, this may 
take some time,  FFT is used!) and saves the result for later reuse.

At the moment only OGG files are supported!!! Don't want to get in the hell
with all that MP3 licensing issues...

I recommend 44khz encoded files. I've tried different songs with lengths from 3
up to 5 minutes and they worked fine for me. But you never know... 

It seems some OGG convertes create files that are *not* playable using
SDL_mixer. I converted all my sounds using http://winlame.sourceforge.net/
on windows and they work fine. So, if you get kicked back to the main screen
for a new file, try reconverting the file using a different encoder/transcoder.
          
                                                                 
4. CONTROLS/GAME
================
The controls are explained within the game. Each part of the game has it's own
help screen which can be shown (and hidden again) by pressing the left shoulder
button.
Left/A Right/B move the ship to the left or to the right. Get the blue capsules
and avoid the red ones.
Volume buttons control the volume.


5. THIRDPARTY STUFF USED
========================
* kissfft: http://sourceforge.net/projects/kissfft/
* SDL_mixer
* libpng
* libz
* ogg/vorbis
* mersenne twister: http://www.math.sci.hiroshima-u.ac.jp/~m-mat/MT/emt.html

Hope i didn't forget any important. If i missed something to list, contact me
just contact me please.


6. LICENSES
===========
Nine Inch Nails Songs (http://www.nin.com/)
http://creativecommons.org/licenses/by-nc-sa/3.0/us/legalcode

Pornophonique Song (http://www.pornophonique.de/)
http://creativecommons.org/licenses/by-nc-nd/2.0/de/

                            
7. CONTACT
==========
If you want to contact me, send PM to crow_riot on the gp32x.com forums
(http://gp32x.com/)


8. THANKS
=========
Thanks fly out to everyone at the gp32x.com forum, notably Iorgy77 for
organizing PACC - without the compo this game wouldn't exist.

I'd also like to thank acegraph for creating the oustanding graphics.
Without him it would look like a piece of sh*t (i mean, "programmer's art" ;))

And last but not least, thanks to my GF, who had some tough time with me while I
was making this, but has 'survived' it! :)

Senor Quack for his working libWIZGLES on FW 1.2.1. Thanks a ton!

9. TROUBLESHOOT
===============
On rare occasions the game doesnt start if you first upload it to your SD card,
i recommend to reboot your wiz and try again :)


10. DONATE?
===========
You want to donate? My paypal email is: s16-paypal@riot.org :-)
