[MPlayer-DOCS] [PATCH] List container formats and add an example

[Guillaume POIRIER]

Hi there,
The attached patch documents the different containers supported by
MEncoder, as well as a nice example.
Please review as I'm keyboard disabled :-).

Guillaume
--
Reading doesn't hurt, really!
  -- Dominik 'Rathann' Mierzejewski
-------------- next part --------------
Index: en/mencoder.xml
===================================================================
RCS file: /cvsroot/mplayer/main/DOCS/xml/en/mencoder.xml,v
retrieving revision 1.94
diff -u -r1.94 mencoder.xml
--- en/mencoder.xml	23 Sep 2005 07:30:25 -0000	1.94
+++ en/mencoder.xml	12 Oct 2005 14:10:05 -0000
@@ -107,6 +107,134 @@
 </tgroup>
 </informaltable>
 </para>
+<para>
+  Output container formats are selected with the <option>-of</option>
+  option.
+  The following choices are available, although some may not have been
+  enabled at compiletime:
+</para>
+<para>
+Container formats:
+<informaltable frame="all">
+<tgroup cols="2">
+<thead>
+<row><entry>Container format name</entry><entry>Description</entry></row>
+</thead>
+<tbody>
+  <row>
+    <entry>lavf</entry>
+    <entry>Use one of <systemitem class="library">libavformat</systemitem>'s
+    containers</entry>
+  </row>
+  <row>
+    <entry>avi</entry>
+    <entry>Audio Video Interleave file</entry>
+  </row>
+  <row>
+    <entry>mpeg</entry>
+    <entry>MPEG-1 systems and MPEG-2 PS</entry>
+  </row>
+  <row>
+    <entry>rawvideo</entry>
+    <entry>raw video stream (no muxing - one video stream only)</entry>
+  </row>
+  <row>
+    <entry>rawaudio</entry>
+    <entry>raw audio stream (no muxing - one audio stream only)</entry>
+  </row>
+</tbody>
+</tgroup>
+</informaltable>
+  AVI container is the native container format for
+  <application>MEncoder</application>, which means that it's the one that
+  is best handled, and for which <application>MEncoder</application> was
+  designed.
+  As you saw earlier, other container formats are usable, but you may
+  experience some problems while using them.
+</para>
+
+<para>
+<systemitem class="library">libavformat</systemitem> containers:
+<informaltable frame="all">
+<tgroup cols="2">
+<thead>
+<row><entry><systemitem class="library">libavformat</systemitem> container name</entry><entry>Description</entry></row>
+</thead>
+<tbody>
+  <row>
+    <entry>mpg</entry>
+    <entry>MPEG-1 systems and MPEG-2 PS</entry>
+  </row>
+  <row>
+    <entry>asf</entry>
+    <entry>Advanced Streaming Format</entry>
+  </row>
+  <row>
+    <entry>avi</entry>
+    <entry>Audio Video Interleave file</entry>
+  </row>
+  <row>
+    <entry>wav</entry>
+    <entry>Waveform Audio</entry>
+  </row>
+  <row>
+    <entry>swf</entry>
+    <entry>Macromedia Flash</entry>
+  </row>
+  <row>
+    <entry>flv</entry>
+    <entry>Macromedia Flash video files</entry>
+  </row>
+  <row>
+    <entry>rm</entry>
+    <entry>RealAudio and RealVideo</entry>
+  </row>
+  <row>
+    <entry>au</entry>
+    <entry>SUN AU format</entry>
+  </row>
+  <row>
+    <entry>nut</entry>
+    <entry>NUT open container format (experimental and not yet spec-compliant)</entry>
+  </row>
+  <row>
+    <entry>mov</entry>
+    <entry>QuickTime</entry>
+  </row>
+  <row>
+    <entry>mp4</entry>
+    <entry>MPEG-4 format</entry>
+  </row>
+  <row>
+    <entry>dv</entry>
+    <entry>Sony Digital Video container</entry>
+  </row>
+</tbody>
+</tgroup>
+</informaltable>
+  As you can see, <systemitem class="library">libavformat</systemitem>
+  allows <application>MEncoder</application> to mux info a fair deal of
+  containers.
+  Unfortunately, as <application>MEncoder</application> was not designed
+  from the beginning to support other container formats other than AVI,
+  your should really be paranoid about the encoding file you will obtain.
+  Please check if the Audio/Video synchronization is Okay and if it plays
+  nicely in other players.
+</para>
+
+<informalexample>
+<para>Example:</para>
+<para>
+Creating an Macromedia Flash video suitable to be played on web browser
+featuring Macromedia Flash plugin:
+<screen>
+mencoder <replaceable>input.avi</replaceable> -o <replaceable>ouput.flv</replaceable> -of lavf -oac mp3lame -lameopts abr:br=56:q=1 -ovc lavc \
+-lavcopts vcodec=flv:vbitrate=250:autoaspect:mbd=2:mv0:trell:v4mv:cbp:last_pred=3:predia=2:dia=2:precmp=2:cmp=2:subcmp=2:preme=2 \
+-vf scale=320:240 -srate 22050 -af lavcresample=22050
+</screen>
+</para>
+</informalexample>
+
 </sect1>