/usr/share/doc/gstreamer1.0-doc/manual/html/chapter-bins.html is in gstreamer1.0-doc 1.8.0-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 | <html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Chapter 6. Bins</title><meta name="generator" content="DocBook XSL Stylesheets V1.79.1"><link rel="home" href="index.html" title="GStreamer Application Development Manual (1.8.0)"><link rel="up" href="part-building.html" title="Part II. Building an Application"><link rel="prev" href="section-elements-states.html" title="Element States"><link rel="next" href="section-bin-create.html" title="Creating a bin"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 6. Bins</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="section-elements-states.html">Prev</a> </td><th width="60%" align="center">Part II. Building an Application</th><td width="20%" align="right"> <a accesskey="n" href="section-bin-create.html">Next</a></td></tr></table><hr></div><div class="chapter"><div class="titlepage"><div><div><h2 class="title"><a name="chapter-bins"></a>Chapter 6. Bins</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl class="toc"><dt><span class="sect1"><a href="chapter-bins.html#section-bins">What are bins</a></span></dt><dt><span class="sect1"><a href="section-bin-create.html">Creating a bin</a></span></dt><dt><span class="sect1"><a href="section-bin-custom.html">Custom bins</a></span></dt><dt><span class="sect1"><a href="section-bin-state-change-handling.html">Bins manage states of their children</a></span></dt></dl></div><p>
A bin is a container element. You can add elements to a bin. Since a
bin is an element itself, a bin can be handled in the same way as any
other element. Therefore, the whole previous chapter (<a class="xref" href="chapter-elements.html" title="Chapter 5. Elements">Elements</a>) applies to bins as well.
</p><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="section-bins"></a>What are bins</h2></div></div></div><p>
Bins allow you to combine a group of linked elements into one
logical element. You do not deal with the individual elements
anymore but with just one element, the bin. We will see that
this is extremely powerful when you are going to construct
complex pipelines since it allows you to break up the pipeline
in smaller chunks.
</p><p>
The bin will also manage the elements contained in it. It will
perform state changes on the elements as well as collect and
forward bus messages.
</p><div class="figure-float" style="float: left;"><div class="figure"><a name="section-bin-img"></a><p class="title"><b>Figure 6.1. Visualisation of a bin with some elements in it</b></p><div class="figure-contents"><div class="mediaobject"><img src="images/bin-element.png" width="405" alt="Visualisation of a bin with some elements in it"></div></div></div><br class="figure-break"></div><p>
There is one specialized type of bin available to the
<span class="application">GStreamer</span> programmer:
</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>
A pipeline: a generic container that manages the synchronization
and bus messages of the contained elements. The toplevel bin has
to be a pipeline, every application thus needs at least one of
these.
</p></li></ul></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="section-elements-states.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="part-building.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="section-bin-create.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Element States </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Creating a bin</td></tr></table></div></body></html>
|