This file is indexed.

/usr/share/doc/gstreamer1.0-doc/manual/html/chapter-gstreamer.html is in gstreamer1.0-doc 1.10.4-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
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Chapter 1. What is GStreamer?</title><meta name="generator" content="DocBook XSL Stylesheets V1.79.1"><link rel="home" href="index.html" title="GStreamer Application Development Manual (1.10.4)"><link rel="up" href="part-introduction.html" title="Part I. About GStreamer"><link rel="prev" href="part-introduction.html" title="Part I. About GStreamer"><link rel="next" href="chapter-motivation.html" title="Chapter 2. Design principles"></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 1. What is <span class="application">GStreamer</span>?</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="part-introduction.html">Prev</a> </td><th width="60%" align="center">Part I. About GStreamer</th><td width="20%" align="right"> <a accesskey="n" href="chapter-motivation.html">Next</a></td></tr></table><hr></div><div class="chapter"><div class="titlepage"><div><div><h2 class="title"><a name="chapter-gstreamer"></a>Chapter 1. What is <span class="application">GStreamer</span>?</h2></div></div></div><p> 
      <span class="application">GStreamer</span> is a framework for creating streaming media applications.
      The fundamental design comes from the video pipeline at Oregon Graduate
      Institute, as well as some ideas from DirectShow.  
    </p><p>
      <span class="application">GStreamer</span>'s development framework makes it possible to write any
      type of streaming multimedia application. The <span class="application">GStreamer</span> framework
      is designed to make it easy to write applications that handle audio
      or video or both. It isn't restricted to audio and video, and can
      process any kind of data flow.
      The pipeline design is made to have little overhead above what the
      applied filters induce. This makes <span class="application">GStreamer</span> a good framework for
      designing even high-end audio applications which put high demands on
      latency. 
    </p><p>
      One of the most obvious uses of <span class="application">GStreamer</span> is using it to build
      a media player. <span class="application">GStreamer</span> already includes components for building a
      media player that can support a very wide variety of formats, including
      MP3, Ogg/Vorbis, MPEG-1/2, AVI, Quicktime, mod, and more. <span class="application">GStreamer</span>,
      however, is much more than just another media player. Its main advantages
      are that the pluggable components can be mixed and matched into arbitrary
      pipelines so that it's possible to write a full-fledged video or audio
      editing application.
    </p><p>
      The framework is based on plugins that will provide the various codec 
      and other functionality. The plugins can be linked and arranged in
      a pipeline. This pipeline defines the flow of the data. Pipelines can 
      also be edited with a GUI editor and saved as XML so that pipeline
      libraries can be made with a minimum of effort.
    </p><p>
      The <span class="application">GStreamer</span> core function is to provide a framework for plugins,
      data flow and media type handling/negotiation. It also provides an
      API to write applications using the various plugins.
    </p><p>
      Specifically, <span class="application">GStreamer</span> provides
      </p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>an API for multimedia applications</p></li><li class="listitem"><p>a plugin architecture</p></li><li class="listitem"><p>a pipeline architecture</p></li><li class="listitem"><p>a mechanism for media type handling/negotiation</p></li><li class="listitem"><p>a mechanism for synchronization</p></li><li class="listitem"><p>over 250 plug-ins providing more than 1000 elements</p></li><li class="listitem"><p>a set of tools</p></li></ul></div><p>
    </p><p>
      <span class="application">GStreamer</span> plug-ins could be classified into
      </p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>protocols handling</p></li><li class="listitem"><p>sources: for audio and video (involves protocol plugins)</p></li><li class="listitem"><p>formats: parsers, formaters, muxers, demuxers, metadata, subtitles</p></li><li class="listitem"><p>codecs: coders and decoders</p></li><li class="listitem"><p>filters: converters, mixers, effects, ...</p></li><li class="listitem"><p>sinks: for audio and video (involves protocol plugins)</p></li></ul></div><p>
    </p><div class="figure-float" style="float: left;"><div class="figure"><a name="section-gstreamer-img"></a><p class="title"><b>Figure 1.1. Gstreamer overview</b></p><div class="figure-contents"><div class="mediaobject"><img src="images/gstreamer-overview.png" width="405" alt="Gstreamer overview"></div></div></div><br class="figure-break"></div><p>
      <span class="application">GStreamer</span> is packaged into
      </p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>gstreamer: the core package</p></li><li class="listitem"><p>gst-plugins-base: an essential exemplary set of elements</p></li><li class="listitem"><p>gst-plugins-good: a set of good-quality plug-ins under LGPL</p></li><li class="listitem"><p>gst-plugins-ugly: a set of good-quality plug-ins that might pose distribution problems</p></li><li class="listitem"><p>gst-plugins-bad: a set of plug-ins that need more quality</p></li><li class="listitem"><p>gst-libav: a set of plug-ins that wrap libav for decoding and encoding</p></li><li class="listitem"><p>a few others packages</p></li></ul></div><p>
    </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="part-introduction.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="part-introduction.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="chapter-motivation.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Part I. About GStreamer </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 2. Design principles</td></tr></table></div></body></html>