[pitivi: 29/94] manual: explain codecs vs containers

[Thibault Saunier <tsaunier src gnome org>]

commit e55da80dac4d1554e0226403e19675dd9716f9d8
Author: Jean-FranÃois Fortin Tam <nekohayo gmail com>
Date:   Sun Aug 28 18:40:49 2011 -0400

    manual: explain codecs vs containers

 help/C/codecscontainers.page        |   28 ++++++++++++++++++++++++++++
 help/C/figures/codecscontainers.jpg |  Bin 0 -> 63763 bytes
 help/Makefile.am                    |    2 ++
 3 files changed, 30 insertions(+), 0 deletions(-)
---
diff --git a/help/C/codecscontainers.page b/help/C/codecscontainers.page
new file mode 100644
index 0000000..6a9d36d
--- /dev/null
+++ b/help/C/codecscontainers.page
@@ -0,0 +1,28 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      xmlns:e="http://projectmallard.org/experimental/";
+      type="topic"
+      id="codecscontainers">
+
+  <info>
+    <link type="guide" xref="index#rendering"/>
+    <revision pkgversion="0.15" version="0.1" date="2011-08-28" status="complete"/>
+    <credit type="author">
+      <name>Jean-FranÃois Fortin Tam</name>
+      <email>nekohayo gmail com</email>
+    </credit>
+    <license>
+      <p>Creative Commons Share Alike 3.0</p>
+    </license>
+    <desc>What is the difference between OGG and Vorbis? AVI and DivX? x264 and H.264? Learn about codecs and container formats here.</desc>
+  </info>
+
+    <title>Understanding codecs and containers</title>    
+    <p>The following is one of the most complex topics of video editing. Many people do not know the distinction between codecs and container file formats, thanks in part to the general lack of standardization, confusing marketing terms and filename extensions.</p>
+    <p>This guide is an attempt at clarifying this distinction without going into technical details. If you want to learn more about containers and codecs, you should probably look at Wikipedia's page on <link href="http://en.wikipedia.org/wiki/Container_format_(digital)">containers</link> and <link href="http://en.wikipedia.org/wiki/Codec";>codecs</link>.</p>
+    <p>Basically, a container is what we typically associate with the file format. Containers "contain" the various components of a video: the stream of images, the sound, and anything else. For example, you could have multiple soundtracks and subtitles included in a video file, if the container format allows it. Example of popular containers are OGG, Matroska, AVI, MPEG.</p>
+    <p>Codecs are ways of "coding" and "decoding" streams. Their job is typically to compress data (and decompress it when playing it back) so that you can store and transmit files with a smaller filesize. There are many codecs available out there, each with their strengths, weaknesses and peculiarities, and choosing the right codec with the right settings for the right situation is a form of art.</p>
+    <p>The following figure should make things clearer:</p>
+    <figure>
+        <media type="image" mime="image/jpg" src="figures/codecscontainers.jpg"/>
+    </figure>
+</page>
diff --git a/help/C/figures/codecscontainers.jpg b/help/C/figures/codecscontainers.jpg
new file mode 100644
index 0000000..15778d7
Binary files /dev/null and b/help/C/figures/codecscontainers.jpg differ
diff --git a/help/Makefile.am b/help/Makefile.am
index 6db1512..12f1941 100644
--- a/help/Makefile.am
+++ b/help/Makefile.am
@@ -4,6 +4,7 @@ dist-hook: doc-dist-hook
 
 DOC_ID = pitivi
 DOC_FIGURES = \
+    figures/codecscontainers.jpgÂ\
     figures/fadestep1.png \
     figures/fadestep2.png \
     figures/fadestep3.png \
@@ -23,6 +24,7 @@ DOC_FIGURES = \
 
 DOC_PAGES = \
     about.page \
+    codecscontainers.page \
     crossfading.page \
     effects.page \
     effectsanimation.page \