mplayer.hg: DOCS/xml/en/mencoder.xml comparison

comparison DOCS/xml/en/mencoder.xml @ 21521:b210a229fbcb

General reformatting round: - fix some " -> " - reindent with more consistency - visual markup of <sect?> tags - break overly long lines - add missing <replaceable> tags in examples - cola truck standing by

author	torinthiel
date	Fri, 08 Dec 2006 11:38:06 +0000
parents	275446fef914
children	f551403d82a9

comparison

equal deleted inserted replaced

-:0977cf2eb136
+:b210a229fbcb
 <tgroup cols="2">
 <thead>
 <row><entry>Audio codec name</entry><entry>Description</entry></row>
 </thead>
 <tbody>
 <row>
 <entry>mp3lame</entry>
 <entry>encode to VBR, ABR or CBR MP3 with LAME</entry>
 </row>
 <row>
 <entry>lavc</entry>
 <entry>use one of <link linkend="menc-feat-enc-libavcodec-audio-codecs"><systemitem class="library">libavcodec</systemitem>'s audio codecs</link>
 </entry>
 </row>
 <row>
 <entry>faac</entry>
 <entry>FAAC AAC audio encoder</entry>
 </row>
 <row>
 <entry>toolame</entry>
 <entry>MPEG Audio Layer 2 encoder</entry>
 </row>
 <row>
 <entry>twolame</entry>
 <entry>MPEG Audio Layer 2 encoder based on tooLAME</entry>
 </row>
 <row>
 <entry>pcm</entry>
 <entry>uncompressed PCM audio</entry>
 </row>
 <row>
 <entry>copy</entry>
 <entry>do not reencode, just copy compressed frames</entry>
 </row>
 </tbody>
 </tgroup>
 </informaltable>
 </para>
 <tgroup cols="2">
 <thead>
 <row><entry>Video codec name</entry><entry>Description</entry></row>
 </thead>
 <tbody>
 <row>
 <entry>lavc</entry>
 <entry>use one of <link linkend="menc-feat-enc-libavcodec-video-codecs"><systemitem class="library">libavcodec</systemitem>'s video codecs</link>
 </entry>
 </row>
 <row>
 <entry>xvid</entry>
 <entry>Xvid, MPEG-4 Advanced Simple Profile (ASP) codec</entry>
 </row>
 <row>
 <entry>x264</entry>
 <entry>x264, MPEG-4 Advanced Video Coding (AVC), AKA H.264 codec</entry>
 </row>
 <row>
 <entry>nuv</entry>
 <entry>nuppel video, used by some realtime applications</entry>
 </row>
 <row>
 <entry>raw</entry>
 <entry>uncompressed video frames</entry>
 </row>
 <row>
 <entry>copy</entry>
 <entry>do not reencode, just copy compressed frames</entry>
 </row>
 <row>
 <entry>frameno</entry>
 <entry>used for 3-pass encoding (not recommended)</entry>
 </row>
 </tbody>
 </tgroup>
 </informaltable>
 </para>
 <tgroup cols="2">
 <thead>
 <row><entry>Container format name</entry><entry>Description</entry></row>
 </thead>
 <tbody>
 <row>
 <entry>lavf</entry>
 <entry>one of the containers supported by
 <systemitem class="library">libavformat</systemitem></entry>
 </row>
 <row>
 <entry>avi</entry>
 <entry>Audio-Video Interleaved</entry>
 </row>
 <row>
 <entry>mpeg</entry>
 <entry>MPEG-1 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>
 The AVI container is the native container format for
 <application>MEncoder</application>, which means that it's the one that
 <thead><row>
 <entry><systemitem class="library">libavformat</systemitem> container name</entry>
 <entry>Description</entry>
 </row></thead>
 <tbody>
 <row>
 <entry>mpg</entry>
 <entry>MPEG-1 and MPEG-2 PS</entry>
 </row>
 <row>
 <entry>asf</entry>
 <entry>Advanced Streaming Format</entry>
 </row>
 <row>
 <entry>avi</entry>
 <entry>Audio-Video Interleaved</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</entry>
 </row>
 <row>
 <entry>rm</entry>
 <entry>RealMedia</entry>
 </row>
 <row>
 <entry>au</entry>
 <entry>SUN AU</entry>
 </row>
 <row>
 <entry>nut</entry>
 <entry>NUT open container (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 into a considerable
 Please check to be sure that the audio/video synchronization is OK
 and that the file can be played correctly by players other than
 <application>MPlayer</application>.
 </para>
-<informalexample>
+<example>
-<para>Example:</para>
+<title>encode to Macromedia Flash format</title>
 <para>
 Creating a Macromedia Flash video suitable for playback in a web browser
 with the Macromedia Flash plugin:
 <screen>
 mencoder <replaceable>input.avi</replaceable> -o <replaceable>output.flv</replaceable> -of lavf \
 -oac mp3lame -lameopts abr:br=56 -srate 22050 -ovc lavc \
 -lavcopts vcodec=flv:vbitrate=500:mbd=2:mv0:trell:v4mv:cbp:last_pred=3
 </screen>
 </para>
-</informalexample>
+</example>
 </sect1>
 <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
 <sect1 id="menc-feat-mpeg4">
 <title>Encoding two pass MPEG-4 (&quot;DivX&quot;)</title>
 <para>
-The name comes from the fact that this method encodes the file <emphasis>twice</emphasis>.
+The name comes from the fact that this method encodes the file
-The first encoding (dubbed pass) creates some temporary files
+<emphasis>twice</emphasis>.  The first encoding (dubbed pass) creates some
-(<filename>*.log</filename>) with a size of few megabytes, do not delete
+temporary files (<filename>*.log</filename>) with a size of few megabytes, do
-them yet (you can delete the AVI or rather just not create any video by
+not delete them yet (you can delete the AVI or rather just not create any video
-redirecting it into <filename>/dev/null</filename>).
+by redirecting it into <filename>/dev/null</filename>).
 In the second pass, the two pass output
 file is created, using the bitrate data from the temporary files. The
 resulting file will have much better image quality. If this is the first
 time you heard about this, you should consult some guides available on the
 net.
 <sect1 id="menc-feat-enc-images">
 <title>Encoding from multiple input image files (JPEG, PNG, TGA, etc.)</title>
 <para>
 <application>MEncoder</application> is capable of creating movies from one
-or more JPEG, PNG, TGA, or other image files. With simple framecopy it can create MJPEG
+or more JPEG, PNG, TGA, or other image files. With simple framecopy it can
-(Motion JPEG), MPNG (Motion PNG) or MTGA (Motion TGA) files.
+create MJPEG (Motion JPEG), MPNG (Motion PNG) or MTGA (Motion TGA) files.
 </para>
 <orderedlist>
 <title>Explanation of the process:</title>
 <listitem><para>
-<application>MEncoder</application> <emphasis>decodes</emphasis> the input image(s) with
+<application>MEncoder</application> <emphasis>decodes</emphasis> the input
-<systemitem class="library">libjpeg</systemitem> (when decoding PNGs, it
+image(s) with <systemitem class="library">libjpeg</systemitem> (when decoding
-will use <systemitem class="library">libpng</systemitem>).
+PNGs, it will use <systemitem class="library">libpng</systemitem>).
 </para></listitem>
 <listitem><para>
 <application>MEncoder</application> then feeds the decoded image to the
 chosen video compressor (DivX4, Xvid, FFmpeg msmpeg4, etc.).
 </para></listitem>
 </para>
 </informalexample>
 <informalexample>
 <para>
-Creating an MPEG-4 file from explicit list of JPEG files (list.txt in current directory
+Creating an MPEG-4 file from explicit list of JPEG files (list.txt in current
-contains the list of files to use as source, one per line):
+directory contains the list of files to use as source, one per line):
 <screen>
 mencoder mf://<replaceable>@list.txt</replaceable> -mf w=800:h=600:fps=25:type=jpg \
 -ovc lavc -lavcopts vcodec=mpeg4:mbd=2:trell -oac copy -o <replaceable>output.avi</replaceable>
 </screen>
 </para>
 </screen>
 </para>
 </informalexample>
 <note><para>
-Width must be integer multiple of 4, it is a limitation of the RAW RGB AVI format.
+Width must be integer multiple of 4, it is a limitation of the RAW RGB AVI
+format.
 </para></note>
 <informalexample>
 <para>
 Creating a Motion PNG (MPNG) file from all the PNG files in the current
 <para>There is</para>
 <para>
 MPEG-4 has a unique feature: the video stream can contain its needed aspect
-ratio. Yes, just like MPEG-1/2 (DVD, SVCD) and H.263 files. Regretfully, there are
+ratio. Yes, just like MPEG-1/2 (DVD, SVCD) and H.263 files. Regretfully, there
-few video players apart from <application>MPlayer</application> that support this
+are few video players apart from <application>MPlayer</application> that
-MPEG-4 attribute.
+support this MPEG-4 attribute.
 </para>
 <para>
 This feature can be used only with
 <link linkend="ffmpeg"><systemitem class="library">libavcodec</systemitem></link>'s

Mercurial > mplayer.hg

comparison DOCS/xml/en/mencoder.xml @ 21521:b210a229fbcb