2016-06-04 06:55:52 +00:00
|
|
|
---
|
2016-06-04 07:00:52 +00:00
|
|
|
title: Application Development Manual
|
2016-06-04 06:55:52 +00:00
|
|
|
short-description: Complete walkthrough for building an application using GStreamer
|
|
|
|
...
|
|
|
|
|
2016-06-04 07:00:52 +00:00
|
|
|
# Application Development Manual
|
2016-06-04 06:55:52 +00:00
|
|
|
|
2016-06-17 22:41:07 +00:00
|
|
|
## Foreword
|
2016-06-04 06:55:52 +00:00
|
|
|
|
|
|
|
GStreamer is an extremely powerful and versatile framework for creating
|
|
|
|
streaming media applications. Many of the virtues of the GStreamer
|
|
|
|
framework come from its modularity: GStreamer can seamlessly incorporate
|
|
|
|
new plugin modules. But because modularity and power often come at a
|
|
|
|
cost of greater complexity, writing new applications is not always easy.
|
|
|
|
|
|
|
|
This guide is intended to help you understand the GStreamer framework
|
2016-10-06 20:32:28 +00:00
|
|
|
so you can develop applications based on it. The first
|
2016-06-04 06:55:52 +00:00
|
|
|
chapters will focus on development of a simple audio player, with much
|
|
|
|
effort going into helping you understand GStreamer concepts. Later
|
2019-01-28 16:10:30 +00:00
|
|
|
chapters will go into more advanced topics related to media playback and
|
|
|
|
other forms of media processing (capture, editing, etc.).
|
2016-06-04 06:55:52 +00:00
|
|
|
|
2016-06-17 22:41:07 +00:00
|
|
|
## Introduction
|
2016-06-04 06:55:52 +00:00
|
|
|
|
2016-06-17 22:41:07 +00:00
|
|
|
### Who should read this manual?
|
2016-06-04 06:55:52 +00:00
|
|
|
|
|
|
|
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,
|
2016-11-15 13:14:26 +00:00
|
|
|
we suggest the [Plugin Writer's Guide](plugin-development/index.md).
|
2016-06-04 06:55:52 +00:00
|
|
|
|
2016-06-17 22:41:07 +00:00
|
|
|
### Preliminary reading
|
2016-06-04 06:55:52 +00:00
|
|
|
|
|
|
|
In order to understand this manual, you 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
|
|
|
|
[GObject](http://library.gnome.org/devel/gobject/stable/) and
|
|
|
|
[glib](http://library.gnome.org/devel/glib/stable/) programming.
|
|
|
|
Especially,
|
|
|
|
|
|
|
|
- GObject instantiation
|
|
|
|
|
|
|
|
- GObject properties (set/get)
|
|
|
|
|
|
|
|
- GObject casting
|
|
|
|
|
2019-01-28 16:10:30 +00:00
|
|
|
- GObject referencing/dereferencing
|
2016-06-04 06:55:52 +00:00
|
|
|
|
|
|
|
- glib memory management
|
|
|
|
|
|
|
|
- glib signals and callbacks
|
|
|
|
|
|
|
|
- glib main loop
|
|
|
|
|
2016-06-17 22:41:07 +00:00
|
|
|
### Structure of this manual
|
2016-06-04 06:55:52 +00:00
|
|
|
|
|
|
|
To help you navigate through this guide, it is divided into several
|
|
|
|
large parts. Each part addresses a particular broad topic concerning
|
2019-03-11 04:29:11 +00:00
|
|
|
GStreamer application development. The parts of this guide are laid out
|
2016-06-04 06:55:52 +00:00
|
|
|
in the following order:
|
|
|
|
|
2016-11-14 16:29:47 +00:00
|
|
|
[About GStreamer][about] gives you an overview of GStreamer, its design
|
|
|
|
principles and foundations.
|
|
|
|
|
|
|
|
[Building an Application][app-building] covers the basics of GStreamer
|
|
|
|
application programming. At the end of this part, you should be able to
|
|
|
|
build your own audio player using GStreamer
|
|
|
|
|
|
|
|
In [Advanced GStreamer concepts][advanced], we will move on to advanced
|
2019-01-28 16:10:30 +00:00
|
|
|
subjects which make GStreamer stand out from its competitors. We will discuss
|
2016-11-14 16:29:47 +00:00
|
|
|
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
|
2019-01-28 16:10:30 +00:00
|
|
|
their API, but primarily to give a deeper insight into solving application
|
2016-11-14 16:29:47 +00:00
|
|
|
programming problems with GStreamer and understanding their concepts.
|
|
|
|
|
|
|
|
Next, in [Higher-level interfaces for GStreamer applications][highlevel], we
|
2019-01-28 16:10:30 +00:00
|
|
|
will go into higher-level programming APIs for GStreamer. You don't
|
2016-11-14 16:29:47 +00:00
|
|
|
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 playbin and autopluggers.
|
|
|
|
|
|
|
|
Finally in [Appendices][appendix], you will find some random
|
2016-06-04 06:55:52 +00:00
|
|
|
information on integrating with GNOME, KDE, OS X or Windows, some
|
|
|
|
debugging help and general tips to improve and simplify GStreamer
|
|
|
|
programming.
|
2016-11-14 16:29:47 +00:00
|
|
|
|
|
|
|
[about]: application-development/introduction/index.md
|
2016-11-14 16:50:57 +00:00
|
|
|
[app-building]: application-development/basics/index.md
|
2016-11-14 16:29:47 +00:00
|
|
|
[advanced]: application-development/advanced/index.md
|
|
|
|
[highlevel]: application-development/highlevel/index.md
|
|
|
|
[appendix]: application-development/appendix/index.md
|