new proggy I never checked in
[platform/upstream/gstreamer.git] / docs / manual / intro-preface.xml
1 <chapter id="cha-intro">
2   <title>Introduction</title>
3   <para> 
4     This chapter gives you an overview of the technologies described in this
5     book.  
6   </para>
7
8   <sect1 id="sec-intro-what">
9     <title>What is GStreamer?</title>
10     <para> 
11       GStreamer is a framework for creating streaming media applications.
12       The fundamental design comes from the video pipeline at Oregon Graduate
13       Institute, as well as some ideas from DirectShow.  
14     </para>
15  
16     <para>
17       GStreamer's development framework makes it possible to write any type of
18       streaming multimedia application. The GStreamer framework is designed to make it easy to
19       write applications that handle either audio or video or both. The pipeline design is made to have 
20       no extra overhead above what the applied filters induce. This makes GStreamer a good framework for designing
21       even high-end audio applications which puts high demands on latency. 
22     </para> 
23
24     <para>
25       One of the the most obvious uses of GStreamer is using it to build
26       a media player.  GStreamer already includes components for building a
27       media player that can support a very wide variety of formats, including
28       MP3, Ogg Vorbis, MPEG1, MPEG2, AVI, Quicktime, mod and so on.  GStreamer,
29       however, is much more than just another media player. Its main advantages
30       are that the pluggable components can be mixed and matched into arbitrary
31       pipelines so that it's possible to write a full-fledged video or audio
32       editing application.
33     </para> 
34
35     <para>
36       The framework is based on plugins that will provide the various codec 
37       and other functionality. The plugins can be linked and arranged in
38       a pipeline. This pipeline defines the flow of the data. Pipelines can 
39       also be edited with a GUI editor and saved as XML so that pipeline
40       libraries can be made with a minimum of effort.
41     </para> 
42
43     <para>
44       The GStreamer core function is to provide a framework for plugins, data flow 
45       and media type handling/negotiation. 
46       It also provides an API to write applications using the various plugins.
47     </para> 
48
49     <para>
50       This book is about GStreamer from a developer's point of view; it describes
51       how to write a GStreamer application using the GStreamer libraries and tools.
52       For an explanation about writing plugins, we suggest the Plugin Writers Guide.
53     </para> 
54
55   </sect1>
56 </chapter>