mirror of
https://gitlab.freedesktop.org/gstreamer/gstreamer.git
synced 2024-10-04 01:32:42 +00:00
498cda94b5
Original commit message from CVS: patch by: Luc Pionchon <luc.pionchon@nokia.com> * docs/manual/manual.xml: - Reorganised the previous "introduction" bundle into Foreword, Introduction, and About GStreamer. The two first are <preface> docbook elements. The later is the first part of the book. - added intro-gstreamer.xml (content partially from intro-preface.xml) - moved appendix-win32.xml into appendix-integration.xml * docs/manual/intro-preface.xml: gstreamer section moved... * docs/manual/intro-gstreamer.xml: ...here. new file. * docs/manual/appendix-win32.xml: removed file. Content moved... * docs/manual/appendix-integration.xml: ...here. * docs/manual/highlevel-components.xml: section about GstEditor moved... * docs/manual/appendix-checklist.xml: ...here.
84 lines
3.5 KiB
XML
84 lines
3.5 KiB
XML
<!-- ############ sect1 ############# -->
|
|
|
|
<sect1 id="section-intro-who" xreflabel="Who Should Read This Manual?">
|
|
<title>Who should read this manual?</title>
|
|
<para>
|
|
This book is about &GStreamer; from an application developer's point of view; it
|
|
describes how to write a &GStreamer; application using the &GStreamer;
|
|
libraries and tools. For an explanation about writing plugins, we
|
|
suggest the <ulink type="http"
|
|
url="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/pwg/html/index.html">Plugin
|
|
Writers Guide</ulink>.
|
|
</para>
|
|
</sect1>
|
|
|
|
<!-- ############ sect1 ############# -->
|
|
|
|
<sect1 id="section-intro-reading" xreflabel="Preliminary Reading">
|
|
<title>Preliminary reading</title>
|
|
<para><!-- synchronize with PWG -->
|
|
In order to understand this manual, you will need to have a basic
|
|
understanding of the C language.
|
|
Since &GStreamer; adheres to the GObject programming model, this guide
|
|
also assumes that you understand the basics of <ulink type="http"
|
|
url="http://developer.gnome.org/doc/API/2.0/gobject/index.html">GObject</ulink>
|
|
programming.
|
|
You may also want to have a look
|
|
at Eric Harlow's book <emphasis>Developing Linux Applications with
|
|
GTK+ and GDK</emphasis>.
|
|
</para>
|
|
<para>
|
|
In addition you might want to read the &GstPWG; after this manual.
|
|
Also check out the other documentation available on the <ulink type="http"
|
|
url="http://gstreamer.freedesktop.org/documentation/">&GStreamer; web site</ulink>.
|
|
</para>
|
|
</sect1>
|
|
|
|
<!-- ############ sect1 ############# -->
|
|
|
|
<sect1 id="section-intro-structure">
|
|
<title>Structure of this manual</title>
|
|
<para>
|
|
To help you navigate through this guide, it is divided into several large
|
|
parts. Each part addresses a particular broad topic concerning &GStreamer;
|
|
appliction development. The parts of this guide are laid out in the following
|
|
order:
|
|
</para>
|
|
|
|
<para>
|
|
<xref linkend="part-introduction"/> gives you an overview of &GStreamer;'s
|
|
motivation design goals.
|
|
</para>
|
|
|
|
<para>
|
|
<xref linkend="part-building"/> rapidly covers the basics of &GStreamer;
|
|
application programming. At the end of that chapter, you should be
|
|
able to build your own audio player using &GStreamer;
|
|
</para>
|
|
|
|
<para>
|
|
In <xref linkend="part-advanced"/>, we will move on to advanced
|
|
subjects which make &GStreamer; stand out of its competitors. We
|
|
will discuss application-pipeline interaction using dynamic parameters
|
|
and interfaces, we will discuss threading and threaded pipelines,
|
|
scheduling and clocks (and synchronization). Most of those topics are
|
|
not just there to introduce you to their API, but primarily to give
|
|
a deeper insight in solving application programming problems with
|
|
&GStreamer; and understanding their concepts.
|
|
</para>
|
|
|
|
<para>
|
|
Next, in <xref linkend="part-highlevel"/>, we will go into higher-level
|
|
programming APIs for &GStreamer;. You don't exactly need to know all
|
|
the details from the previous parts to understand this, but you will
|
|
need to understand basic &GStreamer; concepts nevertheless. We will,
|
|
amongst others, discuss XML, playbin and autopluggers.
|
|
</para>
|
|
|
|
<para>
|
|
In <xref linkend="part-appendices"/>, you will find some random
|
|
information on integrating with GNOME, KDE, OS X or Windows, some
|
|
debugging help and general tips to improve and simplify &GStreamer;
|
|
programming.
|
|
</para>
|
|
</sect1>
|