changeset 10869:364d43cee33e

sync with HTML
author diego
date Mon, 15 Sep 2003 01:21:04 +0000
parents 74fde9d0cab6
children 88e23562bfba
files DOCS/xml/en/codecs.xml DOCS/xml/en/mencoder.xml DOCS/xml/en/video.xml
diffstat 3 files changed, 104 insertions(+), 24 deletions(-) [+]
line wrap: on
line diff
--- a/DOCS/xml/en/codecs.xml	Sun Sep 14 19:10:55 2003 +0000
+++ b/DOCS/xml/en/codecs.xml	Mon Sep 15 01:21:04 2003 +0000
@@ -188,13 +188,14 @@
 </sect3>
 
 
-<sect3 id="ffmpeg" xreflabel="FFmpeg DivX/libavcodec">
+<sect3 id="ffmpeg" xreflabel="FFmpeg/libavcodec">
 <title>FFmpeg DivX/libavcodec</title>
 
 <para>
 <ulink url="http://ffmpeg.sourceforge.net">FFmpeg</ulink> contains an
 <emphasis role="bold">open source</emphasis> codec package, which is capable
-of decoding streams encoded with H263/MJPEG/RV10/DivX3/DivX4/DivX5/MP41/MP42/WMV1/WMV2/HuffYUV/SVQ1/SVQ3
+of decoding streams encoded with H263/MJPEG/LJPEG/RV10/DivX3/DivX4/DivX5/MP41/
+MP42/WMV1/WMV2/HuffYUV/SVQ1/SVQ3/MPEG1/MPEG2/VCR1/VCR2/ASV1/ASV2/CLJR
 video, or WMA (Windows Media Audio) audio codecs. Not only some of them can be
 encoded with, but it also offers higher speed than the Win32 codecs or the
 DivX.com DivX4/5 library!
--- a/DOCS/xml/en/mencoder.xml	Sun Sep 14 19:10:55 2003 +0000
+++ b/DOCS/xml/en/mencoder.xml	Mon Sep 15 01:21:04 2003 +0000
@@ -109,9 +109,10 @@
 <title>Encoding to MPEG format</title>
 <para>
 <application>MEncoder</application> can create MPEG (MPEG-PS) format output
-files. It's probably useful only with libavcodec's <emphasis>mpeg1video</emphasis>
-codec, because players - except <application>MPlayer</application> - expect MPEG1
-video, and MPEG1 layer 2 (MP2) audio streams in MPEG files.
+files. It's probably useful only with <link linkend="ffmpeg">libavcodec</link>'s
+<emphasis>mpeg1video</emphasis> codec, because players - except
+<application>MPlayer</application> - expect MPEG1 video, and MPEG1 layer 2 (MP2)
+audio streams in MPEG files.
 </para>
 
 <para>
@@ -237,7 +238,7 @@
 <para>
 <link linkend="ffmpeg">libavcodec</link> provides simple encoding to a lot
 of interesting video and audio formats (currently its audio codecs are
-unsupported). You can encode to the following codecs:
+unsupported). You can encode to the following codecs (more or less up to date):
 
 <informaltable frame="all">
 <tgroup cols="2">
@@ -248,6 +249,9 @@
 <row><entry>mjpeg</entry><entry>
    Motion JPEG
   </entry></row>
+<row><entry>ljpeg</entry><entry>
+   Lossless JPEG
+  </entry></row>
 <row><entry>h263</entry><entry>
   H263
   </entry></row>
@@ -263,18 +267,33 @@
 <row><entry>msmpeg4v2</entry><entry>
   pre-standard MPEG-4 by MS, v2 (used in old asf files)
   </entry></row>
-  <row><entry>wmv1</entry><entry>
+<row><entry>wmv1</entry><entry>
   Windows Media Video, version 1 (aka WMV7)
   </entry></row>
+<row><entry>wmv2</entry><entry>
+  Windows Media Video, version 2 (aka WMV8)
+  </entry></row>
 <row><entry>rv10</entry><entry>
   an old RealVideo codec
   </entry></row>
 <row><entry>mpeg1video</entry><entry>
-  MPEG1 video :)
+  MPEG1 video
+  </entry></row>
+<row><entry>mpeg2video</entry><entry>
+  MPEG2 video
   </entry></row>
 <row><entry>huffyuv</entry><entry>
   lossless compression
   </entry></row>
+<row><entry>asv1</entry><entry>
+  ASUS Video v1
+  </entry></row>
+<row><entry>asv2</entry><entry>
+  ASUS Video v2
+  </entry></row>
+<row><entry>ffv1</entry><entry>
+  FFmpeg's lossless video codec
+  </entry></row>
 </tbody>
 </tgroup>
 </informaltable>
@@ -459,16 +478,16 @@
 
 <para>
 MPEG4 has an unique feature: the video stream can contain its needed aspect
-ratio. Yes, just like MPEG1/2 files (DVD, SVCD). Regretfully, there are
+ratio. Yes, just like MPEG1/2 (DVD, SVCD) and H263 files. Regretfully, there are
 <emphasis role="bold">no</emphasis> video players outside which support this
-attribute. Except <application>MPlayer</application>.
+attribute of MPEG4, except <application>MPlayer</application>.
 </para>
 
 <para>
-This feature can be used only with <emphasis role="bold">libavcodec</emphasis>'s
-<systemitem>mpeg4</systemitem> codec. Keep in mind: although <application>MPlayer</application>
-will correctly play the created file, other players will use the wrong aspect
-ratio.
+This feature can be used only with <link linkend="ffmpeg">libavcodec</link>'s
+<systemitem>mpeg4</systemitem> codec. Keep in mind: although
+<application>MPlayer</application> will correctly play the created file,
+other players will use the wrong aspect ratio.
 </para>
 
 <para>
@@ -477,12 +496,75 @@
 <systemitem>crop</systemitem> filters.
 </para>
 
-<formalpara>
-<title>Usage</title>
 <para>
+Usage
 <screen>mencoder sample-svcd.mpg -ovc lavc -lavcopts vcodec=mpeg4:autoaspect -vf crop=714:548:0:14 -oac copy -o output.avi</screen>
 </para>
-</formalpara>
+</sect1>
+
+<sect1 id="custommatrices"><title>Custom inter/intra matrices</title>
+
+<para>
+With this feature of <link linkend="ffmpeg">libavcodec</link> you are
+able to set custom inter (I-frames/key frames) and intra (P-frames/predicted
+frames) matrices. It is supported by many of the codecs:
+<systemitem>mpeg1video</systemitem> and <systemitem>mpeg2video</systemitem>
+are reported as working.
+</para>
+
+<para>
+A typical usage of this feature is to set the matrices preferred by the 
+<ulink url="http://www.kvcd.net/">KVCD</ulink> specifications.
+</para>
+
+<para>
+The <emphasis role="bold">KVCD &quot;Notch&quot; Quantization Matrix:</emphasis>
+</para>
+
+<para>
+Intra:
+<screen>
+ 8  9 12 22 26 27 29 34
+ 9 10 14 26 27 29 34 37
+12 14 18 27 29 34 37 38
+22 26 27 31 36 37 38 40
+26 27 29 36 39 38 40 48
+27 29 34 37 38 40 48 58
+29 34 37 38 40 48 58 69
+34 37 38 40 48 58 69 79
+</screen>
+
+Inter:
+<screen>
+16 18 20 22 24 26 28 30
+18 20 22 24 26 28 30 32
+20 22 24 26 28 30 32 34
+22 24 26 30 32 32 34 36
+24 26 28 32 34 34 36 38
+26 28 30 32 34 36 38 40
+28 30 32 34 36 38 42 42
+30 32 34 36 38 40 42 44
+</screen>
+</para>
+
+<para>
+Usage:
+<screen>
+$ mencoder input.avi -o output.avi -oac copy -ovc lavc -lavcopts inter_matrix=...:intra_matrix=...
+</screen>
+</para>
+
+<para>
+<screen>
+$ mencoder input.avi -ovc lavc -lavcopts
+vcodec=mpeg2video:intra_matrix=8,9,12,22,26,27,29,34,9,10,14,26,27,29,34,37,
+12,14,18,27,29,34,37,38,22,26,27,31,36,37,38,40,26,27,29,36,39,38,40,48,27,
+29,34,37,38,40,48,58,29,34,37,38,40,48,58,69,34,37,38,40,48,58,69,79
+:inter_matrix=16,18,20,22,24,26,28,30,18,20,22,24,26,28,30,32,20,22,24,26,
+28,30,32,34,22,24,26,30,32,32,34,36,24,26,28,32,34,34,36,38,26,28,30,32,34,
+36,38,40,28,30,32,34,36,38,42,42,30,32,34,36,38,40,42,44 -oac copy -o svcd.mpg
+</screen>
+</para>
 </sect1>
 
 </chapter>
--- a/DOCS/xml/en/video.xml	Sun Sep 14 19:10:55 2003 +0000
+++ b/DOCS/xml/en/video.xml	Mon Sep 15 01:21:04 2003 +0000
@@ -642,20 +642,17 @@
 </variablelist>
 
 <table>
-<title>SDL keys</title>
+<title>SDL only keys</title>
 <tgroup cols="2">
 <thead>
 <row><entry>Key</entry><entry>Action</entry></row>
 </thead>
 <tbody>
-<row><entry><keycap>F</keycap></entry><entry>
-    toggles fullscreen/windowed mode
-    </entry></row>
-<row><entry><keycap>C</keycap></entry><entry>
+<row><entry><keycap>c</keycap></entry><entry>
     cycles available fullscreen modes
     </entry></row>
-<row><entry><keycap>W</keycap>/<keycap>S</keycap></entry><entry>
-    mappings for <keycap>*</keycap> and <keycap>/</keycap> (mixer control)
+<row><entry><keycap>n</keycap></entry><entry>
+    changes back to normal mode
     </entry></row>
 </tbody>
 </tgroup>