mirror of
https://gitlab.freedesktop.org/gstreamer/gstreamer.git
synced 2024-12-04 23:46:43 +00:00
86bef7fdb8
Original commit message from CVS: Added docs on library init.
213 lines
5.5 KiB
Text
213 lines
5.5 KiB
Text
<!DOCTYPE book PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.0//EN" "" [
|
|
<!ENTITY INTRO SYSTEM "intro.sgml">
|
|
<!ENTITY MOTIVATION SYSTEM "motivation.sgml">
|
|
<!ENTITY GOALS SYSTEM "goals.sgml">
|
|
|
|
<!ENTITY INIT SYSTEM "init.sgml">
|
|
<!ENTITY ELEMENTS SYSTEM "elements.sgml">
|
|
<!ENTITY PADS SYSTEM "pads.sgml">
|
|
<!ENTITY CONNECTIONS SYSTEM "connections.sgml">
|
|
<!ENTITY BINS SYSTEM "bins.sgml">
|
|
<!ENTITY BUFFERS SYSTEM "buffers.sgml">
|
|
<!ENTITY STATES SYSTEM "states.sgml">
|
|
|
|
<!ENTITY HELLOWORLD SYSTEM "helloworld.sgml">
|
|
<!ENTITY FACTORIES SYSTEM "factories.sgml">
|
|
<!ENTITY AUTOPLUGGING SYSTEM "autoplugging.sgml">
|
|
<!ENTITY HELLOWORLD2 SYSTEM "helloworld2.sgml">
|
|
|
|
<!ENTITY THREADS SYSTEM "threads.sgml">
|
|
<!ENTITY QUEUES SYSTEM "queues.sgml">
|
|
<!ENTITY COTHREADS SYSTEM "cothreads.sgml">
|
|
<!ENTITY DYNAMIC SYSTEM "dynamic.sgml">
|
|
<!ENTITY TYPEDETECTION SYSTEM "typedetection.sgml">
|
|
<!ENTITY UTILITY SYSTEM "utility.sgml">
|
|
|
|
<!ENTITY XML SYSTEM "xml.sgml">
|
|
<!ENTITY PLUGINS SYSTEM "plugins.sgml">
|
|
<!ENTITY DEBUGGING SYSTEM "debugging.sgml">
|
|
<!ENTITY PROGRAMS SYSTEM "programs.sgml">
|
|
<!ENTITY COMPONENTS SYSTEM "components.sgml">
|
|
<!ENTITY QUOTES SYSTEM "quotes.sgml">
|
|
]>
|
|
|
|
<book id="index">
|
|
<bookinfo>
|
|
|
|
<authorgroup>
|
|
<author>
|
|
<firstname>Wim</firstname>
|
|
<surname>Taymans</surname>
|
|
<authorblurb>
|
|
<para>
|
|
<email>wim.taymans@chello.be</email>
|
|
</para>
|
|
</authorblurb>
|
|
</author>
|
|
</authorgroup>
|
|
|
|
<legalnotice id="legalnotice">
|
|
<para>
|
|
This material may be distributed only subject to the terms and
|
|
conditions set forth in the Open Publication License, v1.0 or later (the
|
|
latest version is presently available at <ulink url="
|
|
http://www.opencontent.org/openpub/"
|
|
type="http">http://www.opencontent.org/openpub/</ulink> )
|
|
</para>
|
|
</legalnotice>
|
|
|
|
<title><application>GStreamer</application> Application Development Manual</title>
|
|
|
|
</bookinfo>
|
|
|
|
<!-- ############# Overview - part ############### -->
|
|
|
|
<part id="overview"><title>Overview</title>
|
|
<partintro>
|
|
<para>
|
|
The first chapter of the book gives you an overview of <application>GStreamer</application>
|
|
design goals. Chapter 2 rapidly covers the basics of <application>GStreamer</application>
|
|
programming. In chapter 3 we will move on to the examples.
|
|
Since <application>GStreamer</application> adheres to the GTK+/glib2 programming model, the reader is
|
|
assumed to understand the basics of GTK+ and the glib2.0 object model.
|
|
For a gentle introduction to GTK+, you may wish to read the <emphasis>GTK+
|
|
Tutorial</emphasis> or Eric Harlow's book <emphasis>Developing Linux
|
|
Applications with GTK+ and GDK</emphasis>.
|
|
</para>
|
|
</partintro>
|
|
|
|
<!-- ############ Introduction - chapter ############# -->
|
|
&INTRO;
|
|
|
|
&MOTIVATION;
|
|
|
|
&GOALS;
|
|
</part>
|
|
|
|
<!-- ############ Basic concepts - part ############# -->
|
|
|
|
<part id="basic-concepts"><title>Basic concepts</title>
|
|
<partintro>
|
|
<para>
|
|
We will first describe the basics of the <application>GStreamer</application> programming by
|
|
introducing the different objects needed to create a media pipeline.
|
|
</para>
|
|
<para>
|
|
We will use a visual representation of these objects so that we can
|
|
visualize the more complex pipelines you will learn to build later on.
|
|
</para>
|
|
</partintro>
|
|
|
|
<!-- ############ Basic concepts - chapter ############# -->
|
|
&INIT;
|
|
|
|
&ELEMENTS;
|
|
|
|
&PLUGINS;
|
|
|
|
&PADS;
|
|
|
|
&CONNECTIONS;
|
|
|
|
&BINS;
|
|
|
|
&BUFFERS;
|
|
|
|
&STATES;
|
|
|
|
</part>
|
|
<!-- ############ Building Apps - part ############# -->
|
|
|
|
<part id="build-app"><title>Building an application</title>
|
|
|
|
<partintro>
|
|
<para>
|
|
With the basic concepts out of the way, you're ready to start building a
|
|
full-scale <application>GStreamer</application> application.
|
|
</para>
|
|
<para>
|
|
We assume the reader is familiar with GTK+/GNOME programming.
|
|
</para>
|
|
</partintro>
|
|
|
|
&HELLOWORLD;
|
|
|
|
&FACTORIES;
|
|
|
|
</part>
|
|
|
|
<!-- ############ Advanced GStreamer - part ############# -->
|
|
|
|
<part id="advanced"><title>Advanced <application>GStreamer</application> concepts</title>
|
|
|
|
<partintro>
|
|
<para>
|
|
In this part we will cover the more advanced features of <application>GStreamer</application>.
|
|
With the basics you learned in the prevous part you should be
|
|
able to create a 'simple' pipeline. If you want more control over
|
|
the media types and the pipeline you should use the more
|
|
low-level features of <application>GStreamer</application>.
|
|
</para>
|
|
</partintro>
|
|
|
|
&THREADS;
|
|
|
|
&QUEUES;
|
|
|
|
&COTHREADS;
|
|
|
|
&DYNAMIC;
|
|
|
|
&TYPEDETECTION;
|
|
|
|
&AUTOPLUGGING;
|
|
|
|
&HELLOWORLD2;
|
|
|
|
&UTILITY;
|
|
</part>
|
|
|
|
<!-- ############ XML in GStreamer - part ############# -->
|
|
|
|
<part id="xml-gstreamer"><title>XML in <application>GStreamer</application></title>
|
|
|
|
<partintro>
|
|
<para>
|
|
<application>GStreamer</application> has the posibility to externalize the pipelines
|
|
you create using an XML format. You can load a previously
|
|
created pipeline by loading the XML file.
|
|
</para>
|
|
</partintro>
|
|
|
|
&XML;
|
|
</part>
|
|
|
|
|
|
<!-- ############ Appendices - part ############# -->
|
|
|
|
<part id="appendices">
|
|
<title>Appendices</title>
|
|
|
|
<partintro>
|
|
<para>
|
|
<application>GStreamer</application> comes prepackaged with a few programs.
|
|
and some usefull debugging options.
|
|
</para>
|
|
</partintro>
|
|
|
|
&DEBUGGING;
|
|
|
|
&PROGRAMS;
|
|
|
|
&COMPONENTS;
|
|
|
|
"ES;
|
|
|
|
</part>
|
|
</book>
|
|
|
|
|
|
|
|
|
|
|
|
|