gstreamer/subprojects/gst-docs/markdown/tutorials/index.md

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

91 lines
3.4 KiB
Markdown
Raw Permalink Normal View History

---
2016-06-17 22:21:42 +00:00
short-description: Learn how to use GStreamer
...
# Tutorials
2016-05-16 14:30:34 +00:00
2016-06-17 22:21:42 +00:00
## Welcome to the GStreamer Tutorials!
2016-05-16 14:30:34 +00:00
The following sections introduce a series of tutorials designed to help
you learn how to use GStreamer, the multi-platform, modular,
open-source, media streaming framework.
### Prerequisites
Before following these tutorials, you need to set up your development
2016-05-27 03:34:45 +00:00
environment according to your platform. If you have not done so yet, go
2016-06-17 22:21:42 +00:00
to the [installing GStreamer] page and come back here afterwards.
2016-05-16 14:30:34 +00:00
The tutorials are currently written only in the C programming language,
so you need to be comfortable with it. Even though C is not an
Object-Oriented (OO) language per se, the GStreamer framework uses
`GObject`s, so some knowledge of OO concepts will come in handy.
2016-05-17 14:52:21 +00:00
Knowledge of the `GObject` and `GLib` libraries is not mandatory, but
2016-05-16 14:30:34 +00:00
will make the trip easier.
### Source code
Every tutorial represents a self-contained project, with full source
2016-06-17 22:21:42 +00:00
code in C (and eventually in other languages too). Source code
snippets are introduced alongside the text, and the full code (with
any other required files like makefiles or project files) is
distributed with GStreamer, as explained in the installation
instructions.
2016-05-16 14:30:34 +00:00
Source code for tutorials in Rust are available [here](https://gitlab.freedesktop.org/gstreamer/gstreamer-rs/-/tree/master/tutorials/src/bin)
2016-05-16 14:30:34 +00:00
### A short note on GObject and GLib
2016-05-17 14:52:21 +00:00
GStreamer is built on top of the `GObject` (for object orientation) and
`GLib` (for common algorithms) libraries, which means that every now and
2016-05-16 14:30:34 +00:00
then you will have to call functions of these libraries. Even though the
tutorials will make sure that deep knowledge of these libraries is not
required, familiarity with them will certainly ease the process of
learning GStreamer.
You can always tell which library you are calling because all GStreamer
2016-05-17 14:52:21 +00:00
functions, structures and types have the `gst_` prefix, whereas GLib and
2016-05-16 14:30:34 +00:00
GObject use `g_`.
### Sources of documentation
2016-05-17 14:52:21 +00:00
You have the `GObject` and `GLib` reference guides, and, of course the
2016-05-27 03:34:45 +00:00
upstream [GStreamer documentation].
2016-05-16 14:30:34 +00:00
### Structure
The tutorials are organized in sections, revolving about a common theme:
2016-05-27 03:34:45 +00:00
- [Basic tutorials]: Describe general topics required to understand
2016-06-17 22:21:42 +00:00
the rest of tutorials in GStreamer.
2016-05-27 03:34:45 +00:00
- [Playback tutorials]: Explain everything you need to know to produce
a media playback application using GStreamer.
- [Android tutorials]: Tutorials dealing with the few Android-specific
topics you need to know.
- [iOS tutorials]: Tutorials dealing with the few iOS-specific topics
you need to know.
2016-05-16 14:30:34 +00:00
If you cannot remember in which tutorial a certain GStreamer concept is
explained, use the following:
2016-05-27 03:34:45 +00:00
- [Table of Concepts]
2016-05-16 14:30:34 +00:00
### Sample media
The audio and video clips used throughout these tutorials are all
publicly available and the copyright remains with their respective
authors. In some cases they have been re-encoded for demonstration
2016-05-17 14:52:21 +00:00
purposes.
2016-05-16 14:30:34 +00:00
2016-05-27 03:34:45 +00:00
- [Sintel, the Durian Open Movie Project]
[installing GStreamer]: installing/index.md
2016-05-27 03:34:45 +00:00
[GStreamer documentation]: http://gstreamer.freedesktop.org/documentation/
[Basic tutorials]: tutorials/basic/index.md
[Playback tutorials]: tutorials/playback/index.md
[Android tutorials]: tutorials/android/index.md
[iOS tutorials]: tutorials/ios/index.md
[Table of Concepts]: tutorials/table-of-concepts.md
2016-05-27 03:34:45 +00:00
[Sintel, the Durian Open Movie Project]: http://www.sintel.org/