*** 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 1 songs which are released
under creative commons licenses. This is Space Invaders from a german band
called Pornophonique.


2. IMPORTANT NOTE
=================
I've only one Caanoo, thus i can only test one firmware version thoroughly.
At the time of writing, it is Firmware 1.5. If you have problems check your
firmware! 
Firmwares are always available at http://dl.openhandhelds.org/cgi-bin/caanoo.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!!! 

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.
Joystick-Left/A Joystick-Right/B move the ship to the left or to the right.
Get the blue capsules and avoid the red ones.

If your joystick is a bit wonky, you can change the deadzones in the file
Data/AudioRace/config.ini. 


5. THIRDPARTY STUFF USED
========================
* kissfft: http://sourceforge.net/projects/kissfft/
* SDL, SDL_mixer
* libpng
* libz
* ogg/vorbis
* mersenne twister: http://www.math.sci.hiroshima-u.ac.jp/~m-mat/MT/emt.html
* EASTL (see LICENSE.EASTL)
* iniparser (Copyright (c) 2000-2011 by Nicolas Devillard. MIT License)

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


6. LICENSES
===========
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! :)

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


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