annotate DOCS/encoding.html @ 8816:341d8083491a

fix lots of stuff that was outdated, unclear, inaccurate, or misleading. hopefully no one objects to any of these changes.
author rfelker
date Mon, 06 Jan 2003 04:58:20 +0000
parents 27bc01774674
children 636c1e894a27
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
6427
41b149822666 Background now set by CSS, added doctype and charset.
diego
parents: 6393
diff changeset
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2674
aadcae54d45c started mencoder documentation
gabucino
parents:
diff changeset
2 <HTML>
4982
6cb9d9a1716d HTML: different font handling - idea from new hp dezign
gabucino
parents: 4919
diff changeset
3
6cb9d9a1716d HTML: different font handling - idea from new hp dezign
gabucino
parents: 4919
diff changeset
4 <HEAD>
6882
f3f87f6bf5cf Added a uniform title: something - MPlayer - The Movie Player for Linux.
diego
parents: 6724
diff changeset
5 <TITLE>Encoding - MEncoder - The Movie Encoder for Linux</TITLE>
6391
4e5c236ade69 small updates
gabucino
parents: 6201
diff changeset
6 <LINK REL="stylesheet" TYPE="text/css" HREF="default.css">
6427
41b149822666 Background now set by CSS, added doctype and charset.
diego
parents: 6393
diff changeset
7 <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
4982
6cb9d9a1716d HTML: different font handling - idea from new hp dezign
gabucino
parents: 4919
diff changeset
8 </HEAD>
6cb9d9a1716d HTML: different font handling - idea from new hp dezign
gabucino
parents: 4919
diff changeset
9
6427
41b149822666 Background now set by CSS, added doctype and charset.
diego
parents: 6393
diff changeset
10 <BODY>
2674
aadcae54d45c started mencoder documentation
gabucino
parents:
diff changeset
11
aadcae54d45c started mencoder documentation
gabucino
parents:
diff changeset
12
7699
5d4b0446a557 Cosmetics: Converted 2 spaces to one in section titles, changed some ugly
diego
parents: 7640
diff changeset
13 <H2><A NAME="encoding">2.4 Encoding with MEncoder</A></H2>
6974
916f62dd0910 Another big batch of cosmetics *only*.
diego
parents: 6960
diff changeset
14
8133
630360b15089 Redundant compilation section removed, MEncoder features section moved to
diego
parents: 8035
diff changeset
15 <P>For the complete list of available MEncoder options and examples, please see
630360b15089 Redundant compilation section removed, MEncoder features section moved to
diego
parents: 8035
diff changeset
16 the man page.</P>
3721
66da035c4ee2 some quick updates for the prerelease
gabucino
parents: 3620
diff changeset
17
8816
341d8083491a fix lots of stuff that was outdated, unclear, inaccurate, or
rfelker
parents: 8497
diff changeset
18 <H3><A NAME="2pass">2.4.1 Encoding 2 or 3-pass MPEG-4 ("DIVX")</A></H3>
2848
33c32f3d9f1f many small updates, fixes (some/more to be completed soon)
gabucino
parents: 2745
diff changeset
19
6960
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6906
diff changeset
20 <P><U><B>2-pass encoding:</B></U> the name comes from the fact that this method
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6906
diff changeset
21 encodes the file <I>twice</I>. The first encoding (dubbed <I>pass</I>)
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6906
diff changeset
22 creates some temporary files (*.log) with a size of few megabytes, do not
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6906
diff changeset
23 delete them yet (you can delete the AVI). In the second pass, the 2-pass
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6906
diff changeset
24 output file is created, using the bitrate data from the temporary files. The
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6906
diff changeset
25 resulting file will have much better image quality. If this is the first time
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6906
diff changeset
26 you heard about this, you should consult some guides available on the
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6906
diff changeset
27 Net.</P>
2848
33c32f3d9f1f many small updates, fixes (some/more to be completed soon)
gabucino
parents: 2745
diff changeset
28
8816
341d8083491a fix lots of stuff that was outdated, unclear, inaccurate, or
rfelker
parents: 8497
diff changeset
29 <P>This example shows how to encode a DVD to a 2-pass MPEG-4 ("DIVX") AVI. Just
341d8083491a fix lots of stuff that was outdated, unclear, inaccurate, or
rfelker
parents: 8497
diff changeset
30 two commands are needed:<BR>
6960
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6906
diff changeset
31 <CODE>&nbsp;&nbsp;&nbsp;&nbsp;rm frameno.avi</CODE> - remove this file, which
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6906
diff changeset
32 can come from a previous 3-pass encoding (it interferes with current
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6906
diff changeset
33 one)<BR>
7640
427935644581 updates, fixes
gabucino
parents: 7366
diff changeset
34 <CODE>&nbsp;&nbsp;&nbsp;&nbsp;mencoder -dvd 2 -ovc lavc -lavcopts
8497
27bc01774674 more_options removed
gabucino
parents: 8454
diff changeset
35 vcodec=mpeg4:vpass=1 -oac copy -o movie.avi<BR>
7699
5d4b0446a557 Cosmetics: Converted 2 spaces to one in section titles, changed some ugly
diego
parents: 7640
diff changeset
36 &nbsp;&nbsp;&nbsp;&nbsp;mencoder -dvd 2 -ovc lavc -lavcopts
8497
27bc01774674 more_options removed
gabucino
parents: 8454
diff changeset
37 vcodec=mpeg4:vpass=2 -oac copy -o movie.avi</CODE></P>
4397
970a09005860 3-pass encoding dox
gabucino
parents: 4177
diff changeset
38
6427
41b149822666 Background now set by CSS, added doctype and charset.
diego
parents: 6393
diff changeset
39 <P><U><B>3-pass encoding:</B></U> this is an extension of 2-pass encoding,
4397
970a09005860 3-pass encoding dox
gabucino
parents: 4177
diff changeset
40 where the audio encoding takes place in a separate pass. This method enables
970a09005860 3-pass encoding dox
gabucino
parents: 4177
diff changeset
41 estimation of recommended video bitrate in order to fit on a CD. Also, the
6427
41b149822666 Background now set by CSS, added doctype and charset.
diego
parents: 6393
diff changeset
42 audio is encoded only once, unlike in 2-pass mode. The schematics:</P>
4397
970a09005860 3-pass encoding dox
gabucino
parents: 4177
diff changeset
43
7099
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some
diego
parents: 7061
diff changeset
44 <OL>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some
diego
parents: 7061
diff changeset
45 <LI>Remove conflicting temporary file:
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some
diego
parents: 7061
diff changeset
46 <P><CODE>rm frameno.avi</CODE></P></LI>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some
diego
parents: 7061
diff changeset
47 <LI>First pass:
8497
27bc01774674 more_options removed
gabucino
parents: 8454
diff changeset
48 <P><CODE>mencoder &lt;file/DVD&gt; -ovc frameno -oac mp3lame -lameopts vbr=3 -o frameno.avi</CODE></P>
7099
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some
diego
parents: 7061
diff changeset
49 <P>An audio-only avi file will be created, containing
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some
diego
parents: 7061
diff changeset
50 <B>only</B> the requested audio stream. Don't forget <CODE>-lameopts</CODE>,
7814
988498df1996 <B>MPlayer</B> ---> MPlayer
diego
parents: 7699
diff changeset
51 if you need to set it. If you were encoding a long movie, MEncoder
7099
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some
diego
parents: 7061
diff changeset
52 prints the recommended bitrate values for 650Mb, 700Mb, and 800Mb
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some
diego
parents: 7061
diff changeset
53 destination sizes, after this pass finishes.</P></LI>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some
diego
parents: 7061
diff changeset
54 <LI>Second pass:
8035
533e212cd282 document new 2pass syntax, remove/fix lots of obsolete junk in docs
rfelker
parents: 7814
diff changeset
55 <P><CODE>mencoder &lt;file/DVD&gt; -oac copy
533e212cd282 document new 2pass syntax, remove/fix lots of obsolete junk in docs
rfelker
parents: 7814
diff changeset
56 -ovc lavc -lavcopts vcodec=mpeg4:vpass=1:vbitrate=&lt;bitrate&gt;</CODE></P>
8816
341d8083491a fix lots of stuff that was outdated, unclear, inaccurate, or
rfelker
parents: 8497
diff changeset
57 <P>This is the first pass of video encoding.
7814
988498df1996 <B>MPlayer</B> ---> MPlayer
diego
parents: 7699
diff changeset
58 Optionally specify the video bitrate MEncoder printed at the end of
7099
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some
diego
parents: 7061
diff changeset
59 the previous pass.</P></LI>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some
diego
parents: 7061
diff changeset
60 <LI>Third pass:
8035
533e212cd282 document new 2pass syntax, remove/fix lots of obsolete junk in docs
rfelker
parents: 7814
diff changeset
61 <P><CODE>mencoder &lt;file/DVD&gt; -oac copy
533e212cd282 document new 2pass syntax, remove/fix lots of obsolete junk in docs
rfelker
parents: 7814
diff changeset
62 -ovc lavc -lavcopts vcodec=mpeg4:vpass=2:vbitrate=&lt;bitrate&gt;</CODE></P>
8816
341d8083491a fix lots of stuff that was outdated, unclear, inaccurate, or
rfelker
parents: 8497
diff changeset
63 <P>This is the second pass of video encoding.
341d8083491a fix lots of stuff that was outdated, unclear, inaccurate, or
rfelker
parents: 8497
diff changeset
64 Specify the same bitrate as in the previous pass unless you really know
341d8083491a fix lots of stuff that was outdated, unclear, inaccurate, or
rfelker
parents: 8497
diff changeset
65 what you are doing. In this pass, audio from <CODE>frameno.avi</CODE>
341d8083491a fix lots of stuff that was outdated, unclear, inaccurate, or
rfelker
parents: 8497
diff changeset
66 will be inserted into the destination file.. and it's all ready!</P></LI>
7099
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some
diego
parents: 7061
diff changeset
67 </OL>
4397
970a09005860 3-pass encoding dox
gabucino
parents: 4177
diff changeset
68
7047
4f87cd0f642f Converted the docs to use proper headings tags.
diego
parents: 7043
diff changeset
69 <H4>Example for 3-pass encoding:</H4>
4397
970a09005860 3-pass encoding dox
gabucino
parents: 4177
diff changeset
70
970a09005860 3-pass encoding dox
gabucino
parents: 4177
diff changeset
71 <P><CODE>&nbsp;&nbsp;&nbsp;&nbsp;rm frameno.avi</CODE> - remove this file,
970a09005860 3-pass encoding dox
gabucino
parents: 4177
diff changeset
72 which can come from a previous 3-pass encoding (it interferes with current
970a09005860 3-pass encoding dox
gabucino
parents: 4177
diff changeset
73 one)<BR>
6960
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6906
diff changeset
74 <CODE>&nbsp;&nbsp;&nbsp;&nbsp;mencoder -dvd 2 -ovc frameno
8497
27bc01774674 more_options removed
gabucino
parents: 8454
diff changeset
75 -o frameno.avi -oac mp3lame -lameopts vbr=3<BR>
7640
427935644581 updates, fixes
gabucino
parents: 7366
diff changeset
76 &nbsp;&nbsp;&nbsp;&nbsp;mencoder -dvd 2 -ovc lavc
8497
27bc01774674 more_options removed
gabucino
parents: 8454
diff changeset
77 -lavcopts vcodec=mpeg4:vpass=1 -oac copy -o movie.avi<BR>
7640
427935644581 updates, fixes
gabucino
parents: 7366
diff changeset
78 &nbsp;&nbsp;&nbsp;&nbsp;mencoder -dvd 2 -ovc lavc
8497
27bc01774674 more_options removed
gabucino
parents: 8454
diff changeset
79 -lavcopts vcodec=mpeg4:vpass=2 -oac copy -o movie.avi</CODE></P>
4397
970a09005860 3-pass encoding dox
gabucino
parents: 4177
diff changeset
80
8133
630360b15089 Redundant compilation section removed, MEncoder features section moved to
diego
parents: 8035
diff changeset
81 <H3><A NAME="rescaling">2.4.2 Rescaling movies</A></H3>
3438
963b39283f48 fixes, and some new stuff. sorry forgot :)
gabucino
parents: 3382
diff changeset
82
8260
352b654c7787 updates
gabucino
parents: 8133
diff changeset
83 <P>Often the need to resize movie images' size emerges. Its reasons can be
352b654c7787 updates
gabucino
parents: 8133
diff changeset
84 many: decreasing file size, network bandwidth, etc. Most people
352b654c7787 updates
gabucino
parents: 8133
diff changeset
85 even do rescaling when converting DVDs or SVCDs to DivX AVI. <B>This is bad.</B>
352b654c7787 updates
gabucino
parents: 8133
diff changeset
86 Instead of even you doing so, read the <A HREF="#aspect">Preserving
352b654c7787 updates
gabucino
parents: 8133
diff changeset
87 aspect ratio</A> section.</P>
3438
963b39283f48 fixes, and some new stuff. sorry forgot :)
gabucino
parents: 3382
diff changeset
88
5968
5bb339c33131 small update
gabucino
parents: 5860
diff changeset
89 <P>The scaling process is handled by the <I>'scale'</I> video filter:
8260
352b654c7787 updates
gabucino
parents: 8133
diff changeset
90 <CODE>-vop scale=widht:height</CODE>. Its quality can be set with the
7814
988498df1996 <B>MPlayer</B> ---> MPlayer
diego
parents: 7699
diff changeset
91 <CODE>-sws</CODE> option. If it's not specified, MEncoder will use 0:
5968
5bb339c33131 small update
gabucino
parents: 5860
diff changeset
92 fast bilinear.</P>
3438
963b39283f48 fixes, and some new stuff. sorry forgot :)
gabucino
parents: 3382
diff changeset
93
8260
352b654c7787 updates
gabucino
parents: 8133
diff changeset
94 <H5>Usage:</H5>
352b654c7787 updates
gabucino
parents: 8133
diff changeset
95
352b654c7787 updates
gabucino
parents: 8133
diff changeset
96 <P><CODE>&nbsp;&nbsp;&nbsp;&nbsp;mencoder input.mpg -ovc lavc -lavcopts
8497
27bc01774674 more_options removed
gabucino
parents: 8454
diff changeset
97 vcodec=mpeg4 -vop scale=640:480 -oac copy -o
8260
352b654c7787 updates
gabucino
parents: 8133
diff changeset
98 output.avi</CODE></P>
3438
963b39283f48 fixes, and some new stuff. sorry forgot :)
gabucino
parents: 3382
diff changeset
99
4680
b5d956f0b6ea sok ize, mutyur, bizbasz.
gabucino
parents: 4585
diff changeset
100
8133
630360b15089 Redundant compilation section removed, MEncoder features section moved to
diego
parents: 8035
diff changeset
101 <H3><A NAME="copying">2.4.3 Stream copying</A></H3>
2868
4a1802c5bbee *** empty log message ***
gabucino
parents: 2848
diff changeset
102
7814
988498df1996 <B>MPlayer</B> ---> MPlayer
diego
parents: 7699
diff changeset
103 <P>MEncoder can handle input streams in two ways: <B>encode</B> or
3438
963b39283f48 fixes, and some new stuff. sorry forgot :)
gabucino
parents: 3382
diff changeset
104 <B>copy</B> them. This section is about <B>copying</B>.</P>
2868
4a1802c5bbee *** empty log message ***
gabucino
parents: 2848
diff changeset
105
3438
963b39283f48 fixes, and some new stuff. sorry forgot :)
gabucino
parents: 3382
diff changeset
106 <UL>
6960
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6906
diff changeset
107 <LI><B>Video stream</B> (option <CODE>-ovc copy</CODE>): nice stuff can be
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6906
diff changeset
108 done :)<BR>
6998
83a386e88f9e Applied patch by Andras Mohari <mayday at varoshaza . nagyatad . hu>
diego
parents: 6974
diff changeset
109 Like, putting (not converting) FLI or VIVO or MPEG1 video into
7814
988498df1996 <B>MPlayer</B> ---> MPlayer
diego
parents: 7699
diff changeset
110 an AVI file. Of course only MPlayer can play such files :) And it
6960
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6906
diff changeset
111 probably has no real life value at all. Rationally: video stream copying
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6906
diff changeset
112 can be useful for example when only the audio stream has to be encoded
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6906
diff changeset
113 (like, uncompressed PCM to MP3).</LI>
3438
963b39283f48 fixes, and some new stuff. sorry forgot :)
gabucino
parents: 3382
diff changeset
114
6427
41b149822666 Background now set by CSS, added doctype and charset.
diego
parents: 6393
diff changeset
115 <LI><B>Audio stream</B> (option <CODE>-oac copy</CODE>): straightforward.
6960
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6906
diff changeset
116 It is possible to take an external audio file (MP3, Vorbis) and mux it
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6906
diff changeset
117 into the output stream. Use the <CODE>-audiofile &lt;filename&gt;</CODE>
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6906
diff changeset
118 option for this.</LI>
3438
963b39283f48 fixes, and some new stuff. sorry forgot :)
gabucino
parents: 3382
diff changeset
119 </UL>
963b39283f48 fixes, and some new stuff. sorry forgot :)
gabucino
parents: 3382
diff changeset
120
4680
b5d956f0b6ea sok ize, mutyur, bizbasz.
gabucino
parents: 4585
diff changeset
121
8133
630360b15089 Redundant compilation section removed, MEncoder features section moved to
diego
parents: 8035
diff changeset
122 <H3><A NAME="fixing">2.4.4 Fixing AVIs with broken index or interleaving</A></H3>
3583
66e418645b67 hm. stuff.
gabucino
parents: 3438
diff changeset
123
66e418645b67 hm. stuff.
gabucino
parents: 3438
diff changeset
124 <P>Easiest thing. We simply copy the video and audio streams, and
7814
988498df1996 <B>MPlayer</B> ---> MPlayer
diego
parents: 7699
diff changeset
125 MEncoder generates the index. Of course this cannot fix possible bugs
6960
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6906
diff changeset
126 in the video and/or audio streams. It also fixes files with broken
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6906
diff changeset
127 interleaving, thus the <CODE>-ni</CODE> option won't be needed for them
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6906
diff changeset
128 anymore.</P>
3583
66e418645b67 hm. stuff.
gabucino
parents: 3438
diff changeset
129
6427
41b149822666 Background now set by CSS, added doctype and charset.
diego
parents: 6393
diff changeset
130 <P>Command: <CODE>mencoder -idx input.avi -ovc copy -oac copy -o output.avi</CODE></P>
3583
66e418645b67 hm. stuff.
gabucino
parents: 3438
diff changeset
131
3721
66da035c4ee2 some quick updates for the prerelease
gabucino
parents: 3620
diff changeset
132
8133
630360b15089 Redundant compilation section removed, MEncoder features section moved to
diego
parents: 8035
diff changeset
133 <H3><A NAME="libavcodec">2.4.5 Encoding with the libavcodec codec family</A></H3>
3721
66da035c4ee2 some quick updates for the prerelease
gabucino
parents: 3620
diff changeset
134
6906
3274d0725fde Changed all link names from the section number to a sensible label.
diego
parents: 6882
diff changeset
135 <P><A HREF="codecs.html#libavcodec">libavcodec</A> provides simple encoding to a
6960
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6906
diff changeset
136 lot of interesting video and audio formats (currently its audio codecs are
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6906
diff changeset
137 unsupported). You can encode to the following codecs:</P>
3721
66da035c4ee2 some quick updates for the prerelease
gabucino
parents: 3620
diff changeset
138
66da035c4ee2 some quick updates for the prerelease
gabucino
parents: 3620
diff changeset
139 <UL>
66da035c4ee2 some quick updates for the prerelease
gabucino
parents: 3620
diff changeset
140 <LI>mjpeg - Motion JPEG</LI>
3774
68dae60dd470 numerous small fixes/updates
gabucino
parents: 3721
diff changeset
141 <LI>h263 - H263</LI>
3721
66da035c4ee2 some quick updates for the prerelease
gabucino
parents: 3620
diff changeset
142 <LI>h263p - H263 Plus</LI>
8816
341d8083491a fix lots of stuff that was outdated, unclear, inaccurate, or
rfelker
parents: 8497
diff changeset
143 <LI>mpeg4 - ISO standard MPEG-4 (DivX 4/5, OpenDivX, XVID compatible)</LI>
341d8083491a fix lots of stuff that was outdated, unclear, inaccurate, or
rfelker
parents: 8497
diff changeset
144 <LI>msmpeg4 - pre-standard MPEG-4 variant by MS, v3 (aka DivX3)</LI>
341d8083491a fix lots of stuff that was outdated, unclear, inaccurate, or
rfelker
parents: 8497
diff changeset
145 <LI>msmpeg4v2 - pre-standard MPEG-4 by MS, v2 (used in old asf files)</LI>
341d8083491a fix lots of stuff that was outdated, unclear, inaccurate, or
rfelker
parents: 8497
diff changeset
146 <LI>wmv1 - Windows Media Video, version 1 (aka WMV7)</LI>
3721
66da035c4ee2 some quick updates for the prerelease
gabucino
parents: 3620
diff changeset
147 <LI>rv10 - an old RealVideo codec</LI>
66da035c4ee2 some quick updates for the prerelease
gabucino
parents: 3620
diff changeset
148 <LI>mpeg1video - MPEG1 video :)</LI>
8816
341d8083491a fix lots of stuff that was outdated, unclear, inaccurate, or
rfelker
parents: 8497
diff changeset
149 <LI>huffyuv - lossless compression</LI>
3721
66da035c4ee2 some quick updates for the prerelease
gabucino
parents: 3620
diff changeset
150 </UL>
66da035c4ee2 some quick updates for the prerelease
gabucino
parents: 3620
diff changeset
151
66da035c4ee2 some quick updates for the prerelease
gabucino
parents: 3620
diff changeset
152 <P>The first column contains the codec names that should be passed after the
6427
41b149822666 Background now set by CSS, added doctype and charset.
diego
parents: 6393
diff changeset
153 <CODE>vcodec</CODE> config, like: <CODE>-lavcopts vcodec=msmpeg4</CODE></P>
3721
66da035c4ee2 some quick updates for the prerelease
gabucino
parents: 3620
diff changeset
154
6427
41b149822666 Background now set by CSS, added doctype and charset.
diego
parents: 6393
diff changeset
155 <P>An example, with MJPEG compression:<BR>
6960
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6906
diff changeset
156 <CODE>&nbsp;&nbsp;&nbsp;&nbsp;mencoder -dvd 2 -o title2.avi -ovc lavc
7640
427935644581 updates, fixes
gabucino
parents: 7366
diff changeset
157 -lavcopts vcodec=mjpeg -oac copy</CODE></P>
3912
gabucino
parents: 3859
diff changeset
158
4680
b5d956f0b6ea sok ize, mutyur, bizbasz.
gabucino
parents: 4585
diff changeset
159
8133
630360b15089 Redundant compilation section removed, MEncoder features section moved to
diego
parents: 8035
diff changeset
160 <H3><A NAME="image_files">2.4.6 Encoding from multiple input image files (JPEGs, PNGs or TGAs)</A></H3>
4919
40b48a0a780e documented Multifile JPEG/PNG input (-mf)
gabucino
parents: 4908
diff changeset
161
7814
988498df1996 <B>MPlayer</B> ---> MPlayer
diego
parents: 7699
diff changeset
162 <P>MEncoder is capable of creating movies from one or more JPEG, PNG or TGA
7366
892ebabb04e2 tga support
jonas
parents: 7099
diff changeset
163 files. With simple framecopy it can create MJPEG (Motion JPEG), MPNG
892ebabb04e2 tga support
jonas
parents: 7099
diff changeset
164 (Motion PNG) or MTGA (Motion TGA) files.</P>
4919
40b48a0a780e documented Multifile JPEG/PNG input (-mf)
gabucino
parents: 4908
diff changeset
165
7099
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some
diego
parents: 7061
diff changeset
166 Explanation of the process:
4919
40b48a0a780e documented Multifile JPEG/PNG input (-mf)
gabucino
parents: 4908
diff changeset
167
7099
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some
diego
parents: 7061
diff changeset
168 <OL>
7814
988498df1996 <B>MPlayer</B> ---> MPlayer
diego
parents: 7699
diff changeset
169 <LI>MEncoder <I>decodes</I> the input image(s) with
7699
5d4b0446a557 Cosmetics: Converted 2 spaces to one in section titles, changed some ugly
diego
parents: 7640
diff changeset
170 <CODE>libjpeg</CODE> (when decoding PNGs, it will use <B>libpng</B>).</LI>
4919
40b48a0a780e documented Multifile JPEG/PNG input (-mf)
gabucino
parents: 4908
diff changeset
171
7814
988498df1996 <B>MPlayer</B> ---> MPlayer
diego
parents: 7699
diff changeset
172 <LI>MEncoder then feeds the decoded image to the chosen video compressor
8816
341d8083491a fix lots of stuff that was outdated, unclear, inaccurate, or
rfelker
parents: 8497
diff changeset
173 (DivX4, Xvid, ffmpeg msmpeg4, etc...).</LI>
7099
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some
diego
parents: 7061
diff changeset
174 </OL>
4919
40b48a0a780e documented Multifile JPEG/PNG input (-mf)
gabucino
parents: 4908
diff changeset
175
7047
4f87cd0f642f Converted the docs to use proper headings tags.
diego
parents: 7043
diff changeset
176 <H4>Examples</H4>
4919
40b48a0a780e documented Multifile JPEG/PNG input (-mf)
gabucino
parents: 4908
diff changeset
177
40b48a0a780e documented Multifile JPEG/PNG input (-mf)
gabucino
parents: 4908
diff changeset
178 <P>The explanation of the <CODE>-mf</CODE> option can be found below in the
6906
3274d0725fde Changed all link names from the section number to a sensible label.
diego
parents: 6882
diff changeset
179 global <A HREF="#options">Options</A> section and in the man page.</P>
4919
40b48a0a780e documented Multifile JPEG/PNG input (-mf)
gabucino
parents: 4908
diff changeset
180
6427
41b149822666 Background now set by CSS, added doctype and charset.
diego
parents: 6393
diff changeset
181 <P><I>Creating a DivX4 file from all the JPEG files in the current dir:</I><BR>
7699
5d4b0446a557 Cosmetics: Converted 2 spaces to one in section titles, changed some ugly
diego
parents: 7640
diff changeset
182 &nbsp;&nbsp;<CODE>mencoder \*.jpg -mf on:w=800:h=600:fps=25 -ovc divx4
8454
1a558102e0d4 bunkus: Removed "-oac copy" from the mf examples. Removed the paragraph about the "internal lavc controller": the examples right above that paragraph already use this syntax.
mosu
parents: 8402
diff changeset
183 -o output.avi</CODE></P>
4919
40b48a0a780e documented Multifile JPEG/PNG input (-mf)
gabucino
parents: 4908
diff changeset
184
6427
41b149822666 Background now set by CSS, added doctype and charset.
diego
parents: 6393
diff changeset
185 <P><I>Creating a DivX4 file from some JPEG files in the current dir:</I><BR>
7699
5d4b0446a557 Cosmetics: Converted 2 spaces to one in section titles, changed some ugly
diego
parents: 7640
diff changeset
186 &nbsp;&nbsp;<CODE>mencoder frame001.jpg,frame002.jpg -mf on:w=800:h=600:fps=25
8454
1a558102e0d4 bunkus: Removed "-oac copy" from the mf examples. Removed the paragraph about the "internal lavc controller": the examples right above that paragraph already use this syntax.
mosu
parents: 8402
diff changeset
187 -ovc divx4 -o output.avi</CODE></P>
5378
1a7fd8f13ac0 small update
gabucino
parents: 5066
diff changeset
188
6427
41b149822666 Background now set by CSS, added doctype and charset.
diego
parents: 6393
diff changeset
189 <P><I>Creating a Motion JPEG (MJPEG) file from all the JPEG files in the current dir:</I><BR>
4919
40b48a0a780e documented Multifile JPEG/PNG input (-mf)
gabucino
parents: 4908
diff changeset
190 &nbsp;&nbsp;<CODE>mencoder \*.jpg -mf on:w=800:h=600:fps=25 -ovc copy
8454
1a558102e0d4 bunkus: Removed "-oac copy" from the mf examples. Removed the paragraph about the "internal lavc controller": the examples right above that paragraph already use this syntax.
mosu
parents: 8402
diff changeset
191 -o output.avi</CODE></P>
4919
40b48a0a780e documented Multifile JPEG/PNG input (-mf)
gabucino
parents: 4908
diff changeset
192
6427
41b149822666 Background now set by CSS, added doctype and charset.
diego
parents: 6393
diff changeset
193 <P><I>Creating an uncompressed file from all the PNG files in the current dir:</I><BR>
7699
5d4b0446a557 Cosmetics: Converted 2 spaces to one in section titles, changed some ugly
diego
parents: 7640
diff changeset
194 &nbsp;&nbsp;<CODE>mencoder \*.png -mf on:w=800:h=600:fps=25:type=png -ovc raw
8454
1a558102e0d4 bunkus: Removed "-oac copy" from the mf examples. Removed the paragraph about the "internal lavc controller": the examples right above that paragraph already use this syntax.
mosu
parents: 8402
diff changeset
195 -o output.avi</CODE></P>
4919
40b48a0a780e documented Multifile JPEG/PNG input (-mf)
gabucino
parents: 4908
diff changeset
196
6427
41b149822666 Background now set by CSS, added doctype and charset.
diego
parents: 6393
diff changeset
197 <P><I>Creating a Motion PNG (MPNG) file from all the PNG files in the current dir:</I><BR>
7699
5d4b0446a557 Cosmetics: Converted 2 spaces to one in section titles, changed some ugly
diego
parents: 7640
diff changeset
198 &nbsp;&nbsp;<CODE>mencoder \*.png -mf on:w=800:h=600:fps=25:type=png -ovc copy
8454
1a558102e0d4 bunkus: Removed "-oac copy" from the mf examples. Removed the paragraph about the "internal lavc controller": the examples right above that paragraph already use this syntax.
mosu
parents: 8402
diff changeset
199 -o output.avi</CODE></P>
4919
40b48a0a780e documented Multifile JPEG/PNG input (-mf)
gabucino
parents: 4908
diff changeset
200
7366
892ebabb04e2 tga support
jonas
parents: 7099
diff changeset
201 <P><I>Creating a Motion TGA (MTGA) file from all the TGA files in the current dir:</I><BR>
7699
5d4b0446a557 Cosmetics: Converted 2 spaces to one in section titles, changed some ugly
diego
parents: 7640
diff changeset
202 &nbsp;&nbsp;<CODE>mencoder \*.tga -mf on:w=800:h=600:fps=25:type=tga -ovc copy
8454
1a558102e0d4 bunkus: Removed "-oac copy" from the mf examples. Removed the paragraph about the "internal lavc controller": the examples right above that paragraph already use this syntax.
mosu
parents: 8402
diff changeset
203 -o output.avi</CODE></P>
7366
892ebabb04e2 tga support
jonas
parents: 7099
diff changeset
204
4919
40b48a0a780e documented Multifile JPEG/PNG input (-mf)
gabucino
parents: 4908
diff changeset
205
8133
630360b15089 Redundant compilation section removed, MEncoder features section moved to
diego
parents: 8035
diff changeset
206 <H3><A NAME="vobsub">2.4.7 Extracting DVD subtitles to a Vobsub file</A></H3>
6711
abe3f5b156f2 Document -vobsubout, -vobsubid and -vobsubindex
kmkaplan
parents: 6583
diff changeset
207
7814
988498df1996 <B>MPlayer</B> ---> MPlayer
diego
parents: 7699
diff changeset
208 <P>MEncoder is capable of extracting subtitles from a DVD into
6960
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6906
diff changeset
209 Vobsub fomat files. They consist of a pair of files ending in
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6906
diff changeset
210 <CODE>.idx</CODE> and <CODE>.sub</CODE> and are usually packaged in a single
7814
988498df1996 <B>MPlayer</B> ---> MPlayer
diego
parents: 7699
diff changeset
211 <CODE>.rar</CODE> archive. MPlayer can play these with the
6960
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6906
diff changeset
212 <CODE>-vobsub</CODE> and <CODE>-vobsubid</CODE> options.</P>
6711
abe3f5b156f2 Document -vobsubout, -vobsubid and -vobsubindex
kmkaplan
parents: 6583
diff changeset
213
6724
ab3d2c60b454 Some spellchecking, moved the section to the correct position, some
diego
parents: 6711
diff changeset
214 <P>You specify the basename (i.e without the <CODE>.idx</CODE> or
6960
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6906
diff changeset
215 <CODE>.sub</CODE> extension) of the output files with <CODE>-vobsubout</CODE>
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6906
diff changeset
216 and the index for this subtitle in the resulting files with
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6906
diff changeset
217 <CODE>-vobsuboutindex</CODE>.</P>
6711
abe3f5b156f2 Document -vobsubout, -vobsubid and -vobsubindex
kmkaplan
parents: 6583
diff changeset
218
6724
ab3d2c60b454 Some spellchecking, moved the section to the correct position, some
diego
parents: 6711
diff changeset
219 <P>If the input is not from a DVD you should use <CODE>-ifo</CODE> to
6960
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6906
diff changeset
220 indicate the <CODE>.ifo</CODE> file needed to construct the resulting
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6906
diff changeset
221 <CODE>.idx</CODE> file.</P>
6711
abe3f5b156f2 Document -vobsubout, -vobsubid and -vobsubindex
kmkaplan
parents: 6583
diff changeset
222
6960
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6906
diff changeset
223 <P>If the input is not from a DVD and you do not have the <CODE>.ifo</CODE>
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6906
diff changeset
224 file you will need to use the <CODE>-vobsubid</CODE> option to let it know
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6906
diff changeset
225 what language id to put in the <CODE>.idx</CODE> file.</P>
6711
abe3f5b156f2 Document -vobsubout, -vobsubid and -vobsubindex
kmkaplan
parents: 6583
diff changeset
226
6724
ab3d2c60b454 Some spellchecking, moved the section to the correct position, some
diego
parents: 6711
diff changeset
227 <P>Each run will append the running subtitle if the <CODE>.idx</CODE> and
6960
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6906
diff changeset
228 <CODE>.sub</CODE> files already exist. So you should remove any before
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6906
diff changeset
229 starting.</P>
6711
abe3f5b156f2 Document -vobsubout, -vobsubid and -vobsubindex
kmkaplan
parents: 6583
diff changeset
230
7047
4f87cd0f642f Converted the docs to use proper headings tags.
diego
parents: 7043
diff changeset
231 <H4>Examples</H4>
6711
abe3f5b156f2 Document -vobsubout, -vobsubid and -vobsubindex
kmkaplan
parents: 6583
diff changeset
232
abe3f5b156f2 Document -vobsubout, -vobsubid and -vobsubindex
kmkaplan
parents: 6583
diff changeset
233 <P><I>Copying two subtitles from a DVD while doing 3-pass encoding</I><BR>
6960
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6906
diff changeset
234 &nbsp;&nbsp;<CODE>rm subtitles.idx subtitles.sub</CODE><BR>
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6906
diff changeset
235 &nbsp;&nbsp;<CODE>mencoder -dvd 1 -vobsubout subtitles -vobsuboutindex 0
7640
427935644581 updates, fixes
gabucino
parents: 7366
diff changeset
236 -sid 2 -o frameno.avi -ovc frameno -oac mp3lame -lameopts vbr=3</CODE><BR>
8035
533e212cd282 document new 2pass syntax, remove/fix lots of obsolete junk in docs
rfelker
parents: 7814
diff changeset
237 &nbsp;&nbsp;<CODE>mencoder -dvd 1 -oac copy -ovc divx4 -divx4opts pass=1</CODE><BR>
533e212cd282 document new 2pass syntax, remove/fix lots of obsolete junk in docs
rfelker
parents: 7814
diff changeset
238 &nbsp;&nbsp;<CODE>mencoder -dvd 1 -oac copy -ovc divx4 -divx4opts pass=2 -vobsubout
6960
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6906
diff changeset
239 subtitles -vobsuboutindex 1 -sid 5</CODE></P>
6711
abe3f5b156f2 Document -vobsubout, -vobsubid and -vobsubindex
kmkaplan
parents: 6583
diff changeset
240
abe3f5b156f2 Document -vobsubout, -vobsubid and -vobsubindex
kmkaplan
parents: 6583
diff changeset
241 <P><I>Copying a french subtitle from an MPEG file</I><BR>
6960
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6906
diff changeset
242 &nbsp;&nbsp;<CODE>rm subtitles.idx subtitles.sub</CODE><BR>
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6906
diff changeset
243 &nbsp;&nbsp;<CODE>mencoder movie.mpg -ifo movie.ifo -vobsubout subtitles
87deea511b1f continuing paragraph reformatting
gabucino
parents: 6906
diff changeset
244 -vobsuboutindex 0 -vobsuboutid fr -sid 1</CODE></P>
6711
abe3f5b156f2 Document -vobsubout, -vobsubid and -vobsubindex
kmkaplan
parents: 6583
diff changeset
245
7047
4f87cd0f642f Converted the docs to use proper headings tags.
diego
parents: 7043
diff changeset
246
8260
352b654c7787 updates
gabucino
parents: 8133
diff changeset
247 <H3><A NAME="aspect">2.4.8 Preserving aspect ratio</A></H3>
352b654c7787 updates
gabucino
parents: 8133
diff changeset
248
352b654c7787 updates
gabucino
parents: 8133
diff changeset
249 <P>DVDs and SVCDs (i.e. MPEG1/2) files contain an aspect ratio value,
352b654c7787 updates
gabucino
parents: 8133
diff changeset
250 which describes how should the player scale the video stream, so humans
352b654c7787 updates
gabucino
parents: 8133
diff changeset
251 won't have egg heads (ex.: 480x480 + 4:3 = 640x480). However when encoding
352b654c7787 updates
gabucino
parents: 8133
diff changeset
252 to AVI (DivX) files, you have be aware that AVI headers don't store this
352b654c7787 updates
gabucino
parents: 8133
diff changeset
253 value. Rescaling the movie is disgusting and time consuming, there
352b654c7787 updates
gabucino
parents: 8133
diff changeset
254 must be a better feature!</P>
352b654c7787 updates
gabucino
parents: 8133
diff changeset
255
352b654c7787 updates
gabucino
parents: 8133
diff changeset
256 <P>There is.</P>
352b654c7787 updates
gabucino
parents: 8133
diff changeset
257
352b654c7787 updates
gabucino
parents: 8133
diff changeset
258 <P>MPEG4 has an unique feature: the video stream can contain
352b654c7787 updates
gabucino
parents: 8133
diff changeset
259 its needed aspect ratio. Yes, just like MPEG1/2 files (DVD, SVCD).
352b654c7787 updates
gabucino
parents: 8133
diff changeset
260 Regretfully, there are <U>no</U> video players outside which support this
352b654c7787 updates
gabucino
parents: 8133
diff changeset
261 attribute. Except MPlayer.</P>
352b654c7787 updates
gabucino
parents: 8133
diff changeset
262
352b654c7787 updates
gabucino
parents: 8133
diff changeset
263 <P>This feature can be used only with <B>libavcodec</B>'s <CODE>mpeg4</CODE>
352b654c7787 updates
gabucino
parents: 8133
diff changeset
264 codec. Keep in mind: although MPlayer will correctly play the created file,
352b654c7787 updates
gabucino
parents: 8133
diff changeset
265 other players will use the wrong aspect ratio.</P>
352b654c7787 updates
gabucino
parents: 8133
diff changeset
266
352b654c7787 updates
gabucino
parents: 8133
diff changeset
267 <P>You seriously should crop the black bands over and below the movie image.
8402
3f6029569733 misc fixes
gabucino
parents: 8260
diff changeset
268 See the manpage about the usage of the <CODE>cropdetect</CODE> and
3f6029569733 misc fixes
gabucino
parents: 8260
diff changeset
269 <CODE>crop</CODE> filters.</P>
8260
352b654c7787 updates
gabucino
parents: 8133
diff changeset
270
352b654c7787 updates
gabucino
parents: 8133
diff changeset
271 <H5>Usage:</H5>
352b654c7787 updates
gabucino
parents: 8133
diff changeset
272
352b654c7787 updates
gabucino
parents: 8133
diff changeset
273 <P><CODE>$ mencoder sample-svcd.mpg -ovc lavc -lavcopts
352b654c7787 updates
gabucino
parents: 8133
diff changeset
274 vcodec=mpeg4:aspect=16.0/9.0 -vop crop=714:548:0:14 -oac copy -o output.avi</CODE></P>
352b654c7787 updates
gabucino
parents: 8133
diff changeset
275
2674
aadcae54d45c started mencoder documentation
gabucino
parents:
diff changeset
276 </BODY>
aadcae54d45c started mencoder documentation
gabucino
parents:
diff changeset
277 </HTML>