
SvOrbis V0.9: OggVorbis Player for GP32 based on Tremor

BASICS:
=======
What is OggVorbis?
From http://www.xiph.org/ogg/vorbis/: Ogg Vorbis is a fully open,
non-proprietary, patent-and-royalty-free, general-purpose compressed
audio format for mid to high quality (8kHz-48.0kHz, 16+ bit, polyphonic)
audio and music at fixed and variable bitrates from 16 to 128 kbps/channel.
This places Vorbis in the same competitive class as audio representations
such as MPEG-4 (AAC), and similar to, but higher performance than MPEG-1/2
audio layer 3, MPEG-4 audio (TwinVQ), WMA and PAC.

What is GP32?
The GP32 is a handheld console made in Korea that can be compared to the
GameBoy Advance, though it's not compatible. If you want to know more go
to http://www.gp32eu.com/ or http://www.gp32x.com/.

What is Tremor?
Tremor is an integer-only implementation of an Ogg Vorbis decode library,
which fits the GP32 much better than the floating point variant would.

INSTALLATION:
=============
To install just copy svorbis.fxe to the "gpmm" directory of your GP32 SMC,
create a directory called "ogg" in the root of that card and drop your
Oggs in there and launch svorbis via FreeLauncher, EuroFirmware or any
other way you usually start your fxe's.

CONFIGURATION:
==============
In this distribution there's a file called "SVORBIS.INI". Edit it with a
text editor to fit your needs and copy it to the "gpetc" directory on your
GP32. I suggest, once you've found your configuration, that you throw out
the comments to save up to three blocks on your SMC.

FURTHER INFOMATION:
===================
More information on the project can be found on the homepage:
http://svolli.de/gp32/SvOrbis/ . There's also an official mailing list.
To subscribe write an email with the subject "subscribe svorbis" to
minimalist@svolli.dynxs.de. All kind of questions will be answered there.
If you don't like mailing lists, check out the discussion boards of
GP32 Xtreme: http://www.gp32x.com/board/

SPECIAL THANKS:
===============
- John Willis (for the working SDK) (available at http://www.devkit.tk/)
- Yoyo (for idea and example code) (http://yoyofr92.free.fr/)
- Steffen Bhme (for logo and icon) (http://www.pixeljuice.de/)
- the GP32Xtreme community (http://www.gp32x.com/board/)


Have fun,
SvOlli
