mirror of
https://gitlab.freedesktop.org/gstreamer/gstreamer.git
synced 2024-09-08 13:18:52 +00:00
Original commit message from CVS: * docs/manual/advanced-dataaccess.xml: Add section on how to use fakesrc/fakesink/identity in your application, plus section on how to embed plugins. Also mention probes. * docs/manual/appendix-checklist.xml: * docs/manual/appendix-debugging.xml: * docs/manual/appendix-gnome.xml: * docs/manual/appendix-integration.xml: Debug -> checklist, GNOME -> integration, add sections on Linux, KDE integration and add other things useful for application development. * docs/manual/manual.xml: Remove some fixmes, update some file pointers. * docs/pwg/appendix-checklist.xml: Fix typo. * docs/pwg/building-boiler.xml: Remove ugly header and add commented fixme. * docs/pwg/pwg.xml: Add fixme. * examples/manual/Makefile.am: Add example for added docs.
161 lines
6.1 KiB
XML
161 lines
6.1 KiB
XML
<chapter id="chapter-intgration">
|
|
<title>Integration</title>
|
|
<para>
|
|
&GStreamer; tries to integrate closely with operating systems (such
|
|
as Linux and UNIX-like operating systems, OS X or Windows) and desktop
|
|
environments (such as GNOME or KDE). In this chapter, we'll mention
|
|
some specific techniques to integrate your application with your
|
|
operating system or desktop environment of choice.
|
|
</para>
|
|
|
|
<sect1 id="section-integration-nix">
|
|
<title>Linux and UNIX-like operating systems</title>
|
|
<para>
|
|
&GStreamer; provides a basic set of elements that are useful when
|
|
integrating with Linux or a UNIX-like operating system.
|
|
</para>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>
|
|
For audio input and output, &GStreamer; provides input and
|
|
output elements for several audio subsystems. Amongst others,
|
|
&GStreamer; includes elements for ALSA (alsasrc, alsamixer,
|
|
alsasink), OSS (osssrc, ossmixer, osssink) and Sun audio
|
|
(sunaudiosrc, sunaudiomixer, sunaudiosink).
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
For video input, &GStreamer; contains source elements for
|
|
Video4linux (v4lsrc, v4lmjpegsrc, v4lelement and v4lmjpegisnk)
|
|
and Video4linux2 (v4l2src, v4l2element).
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
For video output, &GStreamer; provides elements for output
|
|
to X-windows (ximagesink), Xv-windows (xvimagesink; for
|
|
hardware-accelerated video), direct-framebuffer (dfbimagesink)
|
|
and openGL image contexts (glsink).
|
|
</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</sect1>
|
|
|
|
<sect1 id="section-integration-gnome">
|
|
<title>GNOME desktop</title>
|
|
<para>
|
|
&GStreamer; has been the media backend of the <ulink type="http"
|
|
url="http://www.gnome.org/">GNOME</ulink> desktop since GNOME-2.2
|
|
onwards. Nowadays, a whole bunch of GNOME applications make use of
|
|
&GStreamer; for media-processing, including (but not limited to)
|
|
<ulink type="http" url="http://www.rhythmbox.org/">Rhythmbox</ulink>,
|
|
<ulink type="http" url="http://www.hadess.net/totem.php3">Totem</ulink>
|
|
and <ulink type="http"
|
|
url="http://www.burtonini.com/blog/computers/sound-juicer">Sound
|
|
Juicer</ulink>.
|
|
</para>
|
|
<para>
|
|
Most of these GNOME applications make use of some specific techniques
|
|
to integrate as closely as possible with the GNOME desktop:
|
|
</para>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>
|
|
GNOME applications call <function>gnome_program_init ()</function>
|
|
to parse command-line options and initialize the necessary gnome
|
|
modules. &GStreamer; applications would normally call
|
|
<function>gst_init ()</function> to do the same for GStreamer.
|
|
This would mean that only one of the two can parse command-line
|
|
options. To work around this issue, &GStreamer; can provide a
|
|
<classname>poptOption</classname> array which can be passed to
|
|
<function>gnome_program_init ()</function>.
|
|
</para>
|
|
<programlisting><!-- example-begin gnome.c a -->
|
|
#include <gnome.h>
|
|
#include <gst/gst.h>
|
|
|
|
gint
|
|
main (gint argc,
|
|
gchar *argv[])
|
|
{
|
|
struct poptOption options[] = {
|
|
{NULL, '\0', POPT_ARG_INCLUDE_TABLE, NULL, 0, "GStreamer", NULL},
|
|
POPT_TABLEEND
|
|
};
|
|
|
|
/* init GStreamer and GNOME using the GStreamer popt tables */
|
|
options[0].arg = (void *) gst_init_get_popt_table ();
|
|
gnome_program_init ("my-application", "0.0.1", LIBGNOMEUI_MODULE, argc, argv,
|
|
GNOME_PARAM_POPT_TABLE, options,
|
|
NULL);
|
|
<!-- example-end gnome.c a -->
|
|
[..]<!-- example-begin gnome.c b --><!--
|
|
return 0;
|
|
--><!-- example-end gnome.c b -->
|
|
<!-- example-begin gnome.c c -->
|
|
}
|
|
<!-- example-end gnome.c c --></programlisting>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
GNOME stores the default video and audio sources and sinks in GConf.
|
|
&GStreamer; provides a small utility library that can be used to
|
|
get the elements from the registry using functions such as
|
|
<function>gst_gconf_get_default_video_sink ()</function>. See the
|
|
header file (<filename>gst/gconf/gconf.h</filename>) for details.
|
|
All GNOME applications are recommended to use those variables.
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
&GStreamer; provides data input/output elements for use with the
|
|
GNOME-VFS system. These elements are called <quote>gnomevfssrc</quote>
|
|
and <quote>gnomevfssink</quote>.
|
|
</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</sect1>
|
|
|
|
<sect1 id="section-integration-kde">
|
|
<title>KDE desktop</title>
|
|
<para>
|
|
&GStreamer; has been proposed for inclusion in KDE-4.0. Currently,
|
|
&GStreamer; is included as an optional component, and it's used by
|
|
several KDE applications, including <ulink type="http"
|
|
url="http://amarok.kde.org/">AmaroK</ulink> and <ulink type="http"
|
|
url="http://developer.kde.org/~wheeler/juk.html">JuK</ulink>. A
|
|
backend for <ulink type="http"
|
|
url="http://www.xs4all.nl/~jjvrieze/kmplayer.html">KMPlayer</ulink>
|
|
is currently under development.
|
|
</para>
|
|
<para>
|
|
Although not yet as complete as the GNOME integration bits, there
|
|
are already some KDE integration specifics available. This list will
|
|
probably grow as &GStreamer; starts to be used in KDE-4.0:
|
|
</para>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>
|
|
AmaroK contains a kiosrc element, which is a source element that
|
|
integrates with the KDE VFS subsystem KIO.
|
|
</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</sect1>
|
|
|
|
<sect1 id="section-integration-osx">
|
|
<title>OS X</title>
|
|
<para>
|
|
&GStreamer; provides native video and audio output elements for OS X.
|
|
It builds using the standard development tools for OS X.
|
|
</para>
|
|
</sect1>
|
|
|
|
<sect1 id="section-integration-win32">
|
|
<title>Windows</title>
|
|
<para>
|
|
&GStreamer; builds using Microsoft Visual C .NET 2003 and using Cygwin.
|
|
</para>
|
|
</sect1>
|
|
</chapter>
|