operating system or desktop environment of choice.
</para>
+<!-- ####################################################################### -->
+<!-- ####################################################################### -->
+<!-- ####################################################################### -->
+
<sect1 id="section-integration-nix">
<title>Linux and UNIX-like operating systems</title>
<para>
<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).
+ &GStreamer; includes elements for ALSA (alsasrc,
+ alsasink), OSS (osssrc, osssink) Pulesaudio (pulsesrc, pulsesink)
+ 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).
+ Video4linux2 (v4l2src, v4l2element, v4l2sink).
</para>
</listitem>
<listitem>
</itemizedlist>
</sect1>
+<!-- ####################################################################### -->
+<!-- ####################################################################### -->
+<!-- ####################################################################### -->
+
<sect1 id="section-integration-gnome">
<title>GNOME desktop</title>
<para>
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>
+ <ulink type="http" url="https://wiki.gnome.org/Apps/Videos">Videos</ulink>
and <ulink type="http"
- url="http://www.burtonini.com/blog/computers/sound-juicer">Sound
+ url="https://wiki.gnome.org/Apps/SoundJuicer">Sound
Juicer</ulink>.
</para>
<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.
+ GNOME applications usually call <function>gtk_init ()</function>
+ to parse command-line options and initialize GTK. &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>.
+ GLib <classname>GOptionGroup</classname> which can be passed to
+ <function>gnome_program_init ()</function>. The following
+ example requires GTK 2.6 or newer (previous GTK versions
+ do not support command line parsing via GOption yet)
</para>
<programlisting><!-- example-begin gnome.c a -->
-#include <gnome.h>
+#include <gtk/gtk.h>
#include <gst/gst.h>
+static gchar **cmd_filenames = NULL;
+
+static GOptionEntries cmd_options[] = {
+ /* here you can add command line options for your application. Check
+ * the GOption section in the GLib API reference for a more elaborate
+ * example of how to add your own command line options here */
+
+ /* at the end we have a special option that collects all remaining
+ * command line arguments (like filenames) for us. If you don't
+ * need this, you can safely remove it */
+ { G_OPTION_REMAINING, 0, 0, G_OPTION_ARG_FILENAME_ARRAY, &cmd_filenames,
+ "Special option that collects any remaining arguments for us" },
+
+ /* mark the end of the options array with a NULL option */
+ { NULL, }
+};
+
+/* this should usually be defined in your config.h */
+#define VERSION "0.0.1"
+
gint
-main (gint argc,
- gchar *argv[])
+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);
+ GOptionContext *context;
+ GOptionGroup *gstreamer_group, *gtk_group;
+ GError *err = NULL;
+
+ context = g_option_context_new ("gtk-demo-app");
+
+ /* get command line options from GStreamer and add them to the group */
+ gstreamer_group = gst_init_get_option_group ();
+ g_option_context_add_group (context, gstreamer_group);
+ gtk_group = gtk_get_option_group (TRUE);
+ g_option_context_add_group (context, gtk_group);
+
+ /* add our own options. If you are using gettext for translation of your
+ * strings, use GETTEXT_PACKAGE here instead of NULL */
+ g_option_context_add_main_entries (context, cmd_options, NULL);
+
+ /* now parse the commandline options, note that this already
+ * calls gtk_init() and gst_init() */
+ if (!g_option_context_parse (ctx, &argc, &argv, &err)) {
+ g_print ("Error initializing: %s\n", err->message);
+ g_clear_error (&err);
+ g_option_context_free (ctx);
+ exit (1);
+ }
+ g_option_context_free (ctx);
+
+ /* any filenames we got passed on the command line? parse them! */
+ if (cmd_filenames != NULL) {
+ guint i, num;
+
+ num = g_strv_length (cmd_filenames);
+ for (i = 0; i < num; ++i) {
+ /* do something with the filename ... */
+ g_print ("Adding to play queue: %s\n", cmd_filenames[i]);
+ }
+
+ g_strfreev (cmd_filenames);
+ cmd_filenames = NULL;
+ }
<!-- example-end gnome.c a -->
[..]<!-- example-begin gnome.c b --><!--
return 0;
</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.
+ GNOME uses Pulseaudio for audio, use the pulsesrc and
+ pulsesink elements to have access to all the features.
</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>.
+ GIO VFS system. These elements are called <quote>giosrc</quote>
+ and <quote>giosink</quote>.
+ The deprecated GNOME-VFS system is supported too but shouldn't be
+ used for any new applications.
</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.
+ url="http://amarok.kde.org/">AmaroK</ulink>, <ulink type="http"
+ url="http://developer.kde.org/~wheeler/juk.html">JuK</ulink>,
+ <ulink type="http"
+ url="http://www.xs4all.nl/~jjvrieze/kmplayer.html">KMPlayer</ulink> and
+ <ulink type="http"
+ url="http://kaffeine.sourceforge.net/">Kaffeine</ulink>.
</para>
<para>
Although not yet as complete as the GNOME integration bits, there
</itemizedlist>
</sect1>
+<!-- ####################################################################### -->
+<!-- ####################################################################### -->
+<!-- ####################################################################### -->
+
<sect1 id="section-integration-osx">
<title>OS X</title>
<para>
</para>
</sect1>
+<!-- ####################################################################### -->
+<!-- ####################################################################### -->
+<!-- ####################################################################### -->
+
<sect1 id="section-integration-win32">
<title>Windows</title>
+
+ <warning>
+<para>
+Note: this section is out of date. GStreamer-1.0 has much better
+support for win32 than previous versions though and should usually compile
+and work out-of-the-box both using MSYS/MinGW or Microsoft compilers. The
+<ulink url="http://gstreamer.freedesktop.org">GStreamer web site</ulink> and the
+<ulink url="http://news.gmane.org/gmane.comp.video.gstreamer.devel">mailing list
+archives</ulink> are a good place to check the latest win32-related news.
+</para>
+ </warning>
+
+
<para>
&GStreamer; builds using Microsoft Visual C .NET 2003 and using Cygwin.
</para>
+
+ <sect2 id="section-win32-build">
+ <title>Building <application>GStreamer</application> under Win32</title>
+
+<para>There are different makefiles that can be used to build GStreamer with the usual Microsoft
+compiling tools.</para>
+
+<para>The Makefile is meant to be used with the GNU make program and the free
+version of the Microsoft compiler (<ulink url="http://msdn.microsoft.com/visualc/vctoolkit2003/">http://msdn.microsoft.com/visualc/vctoolkit2003/</ulink>). You also
+have to modify your system environment variables to use it from the command-line. You will also
+need a working Platform SDK for Windows that is available for free from Microsoft.</para>
+
+<para>The projects/makefiles will generate automatically some source files needed to compile
+GStreamer. That requires that you have installed on your system some GNU tools and that they are
+available in your system PATH.</para>
+
+<para>The GStreamer project depends on other libraries, namely :</para>
+<itemizedlist>
+<listitem><para>GLib</para></listitem>
+<listitem><para>libxml2</para></listitem>
+<listitem><para>libintl</para></listitem>
+<listitem><para>libiconv</para></listitem>
+</itemizedlist>
+
+<para>Work is being done to provide pre-compiled GStreamer-1.0 libraries as
+a packages for win32. Check the <ulink url="http://gstreamer.freedesktop.org">
+GStreamer web site</ulink> and check our
+<ulink url="http://news.gmane.org/gmane.comp.video.gstreamer.devel">mailing list
+</ulink> for the latest developments in this respect.</para>
+
+<note>
+<title>Notes</title>
+
+<para>GNU tools needed that you can find on <ulink url="http://gnuwin32.sourceforge.net/">http://gnuwin32.sourceforge.net/</ulink></para>
+<itemizedlist>
+<listitem><para>GNU flex (tested with 2.5.4)</para></listitem>
+<listitem><para>GNU bison (tested with 1.35)</para></listitem>
+</itemizedlist>
+
+<para>and <ulink url="http://www.mingw.org/">http://www.mingw.org/</ulink></para>
+<itemizedlist>
+<listitem><para>GNU make (tested with 3.80)</para></listitem>
+</itemizedlist>
+
+<para>the generated files from the -auto makefiles will be available soon separately on the net
+for convenience (people who don't want to install GNU tools).</para>
+</note>
+</sect2>
+
+ <sect2 id="section-win32-install">
+<title>Installation on the system</title>
+
+<para>FIXME: This section needs be updated for GStreamer-1.0.</para>
+
+<!--
+<para>By default, GStreamer needs a registry. You have to generate it using "gst-register.exe". It will create
+the file in c:\gstreamer\registry.xml that will hold all the plugins you can use.</para>
+
+<para>You should install the GStreamer core in c:\gstreamer\bin and the plugins in c:\gstreamer\plugins. Both
+directories should be added to your system PATH. The library dependencies should be installed in c:\usr</para>
+
+<para>For example, my current setup is :</para>
+
+<itemizedlist>
+<listitem><para><filename>c:\gstreamer\registry.xml</filename></para></listitem>
+<listitem><para><filename>c:\gstreamer\bin\gst-inspect.exe</filename></para></listitem>
+<listitem><para><filename>c:\gstreamer\bin\gst-launch.exe</filename></para></listitem>
+<listitem><para><filename>c:\gstreamer\bin\gst-register.exe</filename></para></listitem>
+<listitem><para><filename>c:\gstreamer\bin\gstbytestream.dll</filename></para></listitem>
+<listitem><para><filename>c:\gstreamer\bin\gstelements.dll</filename></para></listitem>
+<listitem><para><filename>c:\gstreamer\bin\gstoptimalscheduler.dll</filename></para></listitem>
+<listitem><para><filename>c:\gstreamer\bin\gstspider.dll</filename></para></listitem>
+<listitem><para><filename>c:\gstreamer\bin\libgtreamer-0.8.dll</filename></para></listitem>
+<listitem><para><filename>c:\gstreamer\plugins\gst-libs.dll</filename></para></listitem>
+<listitem><para><filename>c:\gstreamer\plugins\gstmatroska.dll</filename></para></listitem>
+<listitem><para><filename>c:\usr\bin\iconv.dll</filename></para></listitem>
+<listitem><para><filename>c:\usr\bin\intl.dll</filename></para></listitem>
+<listitem><para><filename>c:\usr\bin\libglib-2.0-0.dll</filename></para></listitem>
+<listitem><para><filename>c:\usr\bin\libgmodule-2.0-0.dll</filename></para></listitem>
+<listitem><para><filename>c:\usr\bin\libgobject-2.0-0.dll</filename></para></listitem>
+<listitem><para><filename>c:\usr\bin\libgthread-2.0-0.dll</filename></para></listitem>
+<listitem><para><filename>c:\usr\bin\libxml2.dll</filename></para></listitem>
+</itemizedlist>
+-->
+
+ </sect2>
+
</sect1>
+
</chapter>