View source for RPM Packaging and support for OpenMAX

=GStreamer with GST-OpenMax=
==Introduction==
This how-to will describe how to setup and use [http://freedesktop.org/wiki/GstOpenMAX gst-openmax] a GStreamer plug-in that allows communication with OpenMAX IL components. OpenMAX IL is an industry standard that provides an abstraction layer for computer graphics, video, and sound routines.

==Requirements==
===Tested Platforms===
* [http://fedoraproject.org/get-fedora Fedora 17]
* [http://fedoraproject.org/wiki/Architectures/ARM/Pandaboard Fedora 17 ARM Pandaboard]

===Supported Architectures===
* x86_64
* ARM devices with a OMAP processor (Tested on Pandaboard with OMAP 4430)
===Required Software===
* gstreamer (Included in every Fedora installation)

==Downloads==

==Functional Codecs==
*omx_mp3dec

==Building OpenMAX IL==
*Download the source code to a temporary directory
<pre>
mkdir -p /tmp/omx
cd /tmp/omx
wget http://downloads.sourceforge.net/omxil/libomxil-bellagio-0.9.0.tar.gz
</pre>

*Extract the tarball
<pre>
tar -xvf libomxil-bellagio-0.9.0.tar.gz
cd liboxmil-bellagio-0.9.0
</pre>

*Configure the package setting the location to our home directory
<pre>
./configure --prefix=$HOME/omx
</pre>

*Build and install
**NOTE: Run make as a normal user and make install as root (sudo)
<pre>
make
make install
</pre>

==Installing GST-OpenMAX==
* Download the latest RPM from the download section.
* Install the RPM using the command below:
<pre>
rpm -i gst-openmax-0.2-1.fc17.x86_64.rpm
</pre>

==Using GST-OpenMAX==
===Setting the environment===
* Set the location to our libraries
<pre>
export GST_PLUGIN_PATH="$HOME/omx/lib/gstreamer-0.10"
export LD_LIBRARY_PATH="$HOME/omx/lib"
</pre>

*Register omx codecs
**NOTE: This command must be run by the user who complied the package
<pre>
~/omx/bin/omxregister-bellagio -v
</pre>


*Check if the codecs have been successfully loaded
<pre>
gst-inspect | grep omx
</pre>

===Playing a song===
*Playing a mp3 file "test.mp3"
<pre>
gst-launch-0.10 filesrc location="test.mp3" ! omx_mp3dec use-timestamps=false ! audioconvert ! alsasink
</pre>

==FAQs==
* Will there be support for Fedora 18?
** We are currently attempting to build our package on the F18 platform but have run into some issues getting our testing environment setup.

===Errors===
* (gst-launch-0.10:18996): WARNING **: libomxil-bellagio.so.0: cannot open shared object file: No such file or directory
** You did not set the location to the libraries, refer to [http://zenit.senecac.on.ca/wiki/index.php?title=RPM_Packaging_and_support_for_OpenMAX&action=submit#Setting_the_environment Setting the environment]


* (gst-plugin-scanner:18985): WARNING **: could not find config file '/home/ryan/.config/gst-openmax.conf'.. using defaults!
** You did not install OpenMAX IL, refer to [http://zenit.senecac.on.ca/wiki/index.php?title=RPM_Packaging_and_support_for_OpenMAX&action=submit#Building_OpenMAX_IL Building OpenMAX IL]