Ogg Vorbis Controller
Author: Mathew Inwood, Multimedia Porting Group, Licensee Product Development, Symbian
Introduction
The Ogg Vorbis Controller is a plugin for Symbian's Multimedia Framework that allows decoding and playback of Ogg Vorbis compressed audio files. It allows any application which uses the multimedia framework to play back these files.
Symbian OS v9
This version has been developed on version 9.1 of Symbian OS, and should work on any later release. It has been tested on a Sony Ericsson P1i, but should work on any device that uses Symbian OS v9 (or higher). It was written as an example of how to write an MMF controller plugin implementing a non-trivial codec. It uses the Tremor Ogg Vorbis integer decoding library produced by the Xiph.Org Foundation. OggVorbisController (20KB) Tremor (189KB)Symbian OS v8
This version has been tested on a Nokia 6600, but should work on any device that uses version 2.0 (or higher) of the Series 60 platform. It also works on the Series 60 v 2.0 emulator. It was written as an example of how to write an MMF controller plugin implementing a non-trivial codec. It uses the Tremor Ogg Vorbis integer decoding library produced by the Xiph.Org Foundation.
Installing the plugin
A SIS file is provided here for ease of installation. This has been tested on a Nokia 6600, and contains a small modification which allows Ogg Vorbis files to be recognized by the existing recorder application on the phone, as well as the ring tone picker. This allows you to use Ogg Vorbis files as ringtones on a Nokia 6600. I have read and agreed to the terms in the license agreement. Installation file (38KB)
Building the plugin
To build the plugin, two separate downloads are required: the main zip file ("OggVorbisController") containing source code for the controller itself, a C++ wrapper around the Tremor library, and a very simple test application. A separate zip file ("Tremor") contains a modified version of the Tremor Ogg Vorbis integer decode library. Unpack the second into the root "OggVorbisController" folder created by unzipping the first. I have read and agreed to the terms in the license agreement. OggVorbisController (20KB) Tremor (189KB)
When building for the emulator, note that the tremor library will not compile for the WINS target. You must compile it for the WINSCW target, which requires downloading the correct SDK from Nokia which supports this target and using the MetroWerks CodeWarrior compiler.
From the group directory, typing the following will build the plugin for the emulator and target:
bldmake bldfiles
abld build winscw udeb
abld build thumb urel
And to build the test application, you should type:
abld test build winscw udeb
abld test build thumb urel
Please see the readme file in the delivery zip for more information.
Testing the plugin
Once the plugin is installed, any application which uses the MMF should be able to play back Ogg Vorbis files simple by giving their names using the appropriate MMF API. A very simple test program is provided which, when run, will play back the file c:\vorbis.ogg. This application has no user interface whatsoever, so will not report any errors if one occurs. Once the playback completes, the program will exit.
See the readme in the delivery zip for more information.