Editing Documentation/Maemo 5 Developer Guide/Using Multimedia Components/Getting Started with Multimedia

Warning: You are not logged in. Your IP address will be recorded in this page's edit history.

The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.

Learn more about Contributing to the wiki.

__FORCETOC__

= Getting Started with Multimedia =
This section explains how to get started developing multimedia applications and plug-ins in the maemo SDK. It is recommended to read also [http://gstreamer.freedesktop.org/documentation/ GStreamer's documentation].

Below is an overview diagram about the multimedia apis from application perspective. Please note, thatapplication can always use lower APIs directly where appropriate.

[[Image:multimedia_overview.png|400px]]

== Simple GStreamer Example ==
This example demonstrates how to use GStreamer's API to play PCM audio.

First, get the [https://garage.maemo.org/svn/maemoexamples/tags/maemo_4.1/maemo-examples/ sample applications](including build scripts), for instance with the following command:

svn checkout https://garage.maemo.org/svn/maemoexamples/tags/maemo_4.1/maemo-examples/

To compile and run, start Xephyr and execute the following commands:
 
 cd maemo-examples
 make
 af-sb-init.sh start
 run-standalone.sh ./example_wavlaunch

To use, simply:

* Click Open to open the File Chooser.
* Browse to a wav file and select Open.
* Select Play to start playing.

[[Image:wavlaunch.png]]

Many aspects of GStreamer's application development are described in the [http://gstreamer.freedesktop.org/data/doc/gstreamer/head/manual/html/index.html GStreamer Application Development Manual].

For more information on how to use GStreamer's API, see the [http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/ Core API Reference].

== Plug-in Development ==
In order to have support for a new media format in the maemo SDK, it is necessary to compile a codec for the format, and compile the GStreamer plug-in supporting that codec.

Codecs are libraries that enable the use of compression for digital audio and video. GStreamer plug-ins are loadable libraries, which provide GStreamer elements that process video and audio streams.

Some plug-ins have the codec embedded, and therefore do not need an additional library. To play some unusual formats, a demuxer GStreamer plug-in is needed as well. More information about the internals of GStreamer plug-ins can be found in the [http://gstreamer.freedesktop.org/data/doc/gstreamer/head/pwg/html/index.html Plugin Writers Guide].

The list of plug-ins for GStreamer is available [http://gstreamer.freedesktop.org/documentation/plugins.html here].

To add support for a new media format:

* Get the codec from the codec's manufacturer.
* Get the GStreamer plug-ins from the [http://gstreamer.freedesktop.org/src/ GStreamer website].
* Extract packages to the Scratchbox environment and follow the compiling instructions for the codec and the GStreamer plug-ins package

Please note that all contributions to maemo.org wiki may be edited, altered, or removed by other contributors. If you do not want your writing to be edited mercilessly, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource (see maemo.org wiki:Copyrights for details). Do not submit copyrighted work without permission!

Summary:

Cancel | Editing help (opens in new window)

Retrieved from "https://wiki.maemo.org/Documentation/Maemo_5_Developer_Guide/Using_Multimedia_Components/Getting_Started_with_Multimedia"

Personal tools

Navigation

Views

Editing Documentation/Maemo 5 Developer Guide/Using Multimedia Components/Getting Started with Multimedia

@@ Line 1: / Line 1: @@
-This section explains how to get started with developing multimedia applications and plug-ins in the Maemo SDK. It is recommended to read also [http://gstreamer.freedesktop.org/documentation/ GStreamer's documentation].
+__FORCETOC__
+= Getting Started with Multimedia =
+This section explains how to get started developing multimedia applications and plug-ins in the maemo SDK. It is recommended to read also [http://gstreamer.freedesktop.org/documentation/ GStreamer's documentation].
-Below is an overview diagram about the multimedia APIs from an application perspective. Please note that applications can always use lower APIs directly when appropriate.
+Below is an overview diagram about the multimedia apis from application perspective. Please note, thatapplication can always use lower APIs directly where appropriate.
 [[Image:multimedia_overview.png|400px]]
@@ Line 7: / Line 10: @@
 == Simple GStreamer Example ==
 This example demonstrates how to use GStreamer's API to play PCM audio.
-First, get the [https://vcs.maemo.org/svn/maemoexamples/tags/maemo_5.0/maemo-examples/ sample applications] (including build scripts), for instance with the following command:
+First, get the [https://garage.maemo.org/svn/maemoexamples/tags/maemo_4.1/maemo-examples/ sample applications](including build scripts), for instance with the following command:
+ svn checkout https://garage.maemo.org/svn/maemoexamples/tags/maemo_4.1/maemo-examples/
- svn checkout https://vcs.maemo.org/svn/maemoexamples/tags/maemo_5.0/maemo-examples/
 To compile and run, start Xephyr and execute the following commands:
@@ Line 20: / Line 23: @@
   af-sb-init.sh start
   run-standalone.sh ./example_wavlaunch
 To use, simply:
 * Click Open to open the File Chooser.
-* Browse to a .wav file and select Open.
+* Browse to a wav file and select Open.
 * Select Play to start playing.
-[[Image:wavlaunch.png|400px]]
+[[Image:wavlaunch.png]]
@@ Line 33: / Line 37: @@
 For more information on how to use GStreamer's API, see the [http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/ Core API Reference].
-__FORCETOC__
 == Plug-in Development ==
+In order to have support for a new media format in the maemo SDK, it is necessary to compile a codec for the format, and compile the GStreamer plug-in supporting that codec.
-In order to have support for a new media format in the [[Documentation/Maemo 5 Developer Guide/Development Environment/Maemo SDK|Maemo SDK]], it is necessary to compile a codec for the format, and compile the GStreamer plug-in supporting that codec.
 Codecs are libraries that enable the use of compression for digital audio and video. GStreamer plug-ins are loadable libraries, which provide GStreamer elements that process video and audio streams.
-Some plug-ins have the codec embedded and therefore do not need an additional library. To play some unusual formats, a demuxer GStreamer plug-in is needed as well. More information about the internals of GStreamer plug-ins can be found in the [http://gstreamer.freedesktop.org/data/doc/gstreamer/head/pwg/html/index.html Plugin Writers Guide].
+Some plug-ins have the codec embedded, and therefore do not need an additional library. To play some unusual formats, a demuxer GStreamer plug-in is needed as well. More information about the internals of GStreamer plug-ins can be found in the [http://gstreamer.freedesktop.org/data/doc/gstreamer/head/pwg/html/index.html Plugin Writers Guide].
 The list of plug-ins for GStreamer is available [http://gstreamer.freedesktop.org/documentation/plugins.html here].
@@ Line 50: / Line 51: @@
 * Get the codec from the codec's manufacturer.
 * Get the GStreamer plug-ins from the [http://gstreamer.freedesktop.org/src/ GStreamer website].
-* Extract packages to the Scratchbox environment and follow the compiling instructions for the codec and the GStreamer plug-ins package.
+* Extract packages to the Scratchbox environment and follow the compiling instructions for the codec and the GStreamer plug-ins package
-[[Category:Development]]
-[[Category:Documentation]]
-[[Category:Fremantle]]