Mercurial > mplayer.hg
annotate DOCS/encoding.html @ 3347:21af9f3d5372
Minor fixes
author | nick |
---|---|
date | Thu, 06 Dec 2001 10:21:02 +0000 |
parents | e1cf5e6338a8 |
children | 7f06ef6c0168 |
rev | line source |
---|---|
2674 | 1 <HTML> |
2 <BODY BGCOLOR=white> | |
3 | |
4 <FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> | |
5 | |
2745 | 6 <P><B><A NAME=2.4>2.4. Encoding with MEncoder</A></B></P> |
2674 | 7 |
8 <P><B><I>Overview</I></B> | |
9 <P><B>MEncoder</B> (<B>MPlayer</B>'s Movie Encoder) is a simple movie encoder, | |
10 designed to encode MPlayer-playable movies | |
11 (<B>AVI/DVD/VCD/VOB/MPG/MOV/VIV/NET</B>) to other MPlayer-playable formats (see | |
12 below). Currently it's in beta stage, and encodes only to <B>DivX4</B> (1 or 2 | |
13 passes) video, <B>PCM</B>/<B>MP3</B>/<B>VBRMP3</B> audio. Also has stream | |
14 copying abilities. In the future, there will be cropping, resizing filters, and | |
15 other interesting stuff.</P> | |
16 | |
17 <P><B><I>Compiling</I></B> | |
18 <UL> | |
19 <LI>read <B>MPlayer</B>'s compilation instructions, it contains info about | |
3027 | 20 how to install <I>libdvdread</I> for <B>DVD</B> support, etc.</LI> |
2674 | 21 <LI>download the newest <B>DivX4linux</B> libs |
3027 | 22 from <A HREF="http://avifile.sourceforge.net/download.htm">avifile.sourceforge.net</A>, |
23 and have them PROPERLY installed. This is needed for DivX4 (1/2 pass) | |
24 encoding. And since this is mandatory (now), MEncoder is Linux-only.</LI> | |
3211 | 25 <LI>download and compile <B>libmp3lame</B> (from lame 3.89beta or lame CVS).<BR> |
26 <B>WARNING : DO NOT COMPILE LAME WITH <U>GCC 2.96</U> ! It won't | |
27 work properly !</B><BR> | |
28 This | |
3027 | 29 is needed for CBR/VBR MP3 audio encoding ability. Note that a single |
30 <CODE>lame</CODE> binary isn't sufficient. BTW: the less optimization | |
31 you use for lame, the better the quality will be. You can test | |
32 quality by running <CODE>make test</CODE> after lame's compiling process | |
33 is over. The resulting number should be less than <B>30</B>. Don't | |
34 panic if it's <B>400</B> or so, you shouldn't heard any audible | |
35 quality decrease. Oh, and if your compiler doesn't even run <CODE>make test</CODE> ... | |
36 Well, delete that <B>GCC 2.96</B>.</LI> | |
2950
20157c719b2c
new features in TV input dox (chan, chanlist, norm, keys)
gabucino
parents:
2939
diff
changeset
|
37 <LI>use <CODE>./configure</CODE> with optional parameters as usual |
3027 | 38 (use <CODE>--enable-tv</CODE> to include V4L tuner grabbing code), and |
39 type : <CODE>make mencoder</CODE> , then <CODE>make install</CODE>.</LI> | |
2674 | 40 </UL> |
41 </P> | |
42 | |
43 <P>You are ready. As you probably know, other encoding tools need the | |
44 <I>avifile</I> library installed. <B>MEncoder</B> doesn't need it at all.</P> | |
45 | |
46 <P><B><I>MEncoder features</I></B> : | |
47 <UL> | |
2868 | 48 <LI>encoding from the wide range of fileformats and decoders of <B>MPlayer</B></LI> |
49 <LI>encoding from <B>V4L compatible TV tuners</B></LI> | |
2674 | 50 <LI>encoding/multiplexing to interleaved AVI files with proper index</LI> |
51 <LI>1 or 2 pass <B>DivX4</B> video</LI> | |
52 <LI><B>VBR</B> MP3 audio</LI> | |
53 <LI>PCM audio</LI> | |
54 <LI>stream copying (only from AVI/ASF now, and CBR audio only)</LI> | |
55 <LI>input A/V synchronizing (PTS-based, can be disabled with -mc 0 option)</LI> | |
56 <LI>FPS correction with <CODE>-ofps</CODE> option (useful when encoding | |
57 29.97fps VOB to 24fps AVI)</LI> | |
58 </UL> | |
59 </P> | |
60 | |
61 <P><B><I>Planned features</I></B> : | |
62 <UL> | |
63 <LI>using audio from separate file (AC3, MP3, OGG)</LI> | |
64 <LI>VBR audio stream copy</LI> | |
65 <LI>even wider variety of available en/decoding formats/codecs | |
66 (creating VOB files with DivX4/Indeo5/VIVO streams :)</LI> | |
67 </UL> | |
68 </P> | |
69 | |
2848
33c32f3d9f1f
many small updates, fixes (some/more to be completed soon)
gabucino
parents:
2745
diff
changeset
|
70 <P><B><I>Encoding 2-pass DivX4</I></B></P> |
33c32f3d9f1f
many small updates, fixes (some/more to be completed soon)
gabucino
parents:
2745
diff
changeset
|
71 |
33c32f3d9f1f
many small updates, fixes (some/more to be completed soon)
gabucino
parents:
2745
diff
changeset
|
72 <P>The name comes from the fact that this method encodes the file <I>twice</I>. |
3027 | 73 The first encoding (dubbed <I>pass</I>) creates some temporary files with a |
74 size of few megabytes (do not delete them yet). In the second pass, the output | |
75 file is created, using the bitrate data from the temporary file. The resulting | |
76 file will have much better image quality. If this is the first time you heard | |
77 about this, you should consult some guides available on the Net.</P> | |
2848
33c32f3d9f1f
many small updates, fixes (some/more to be completed soon)
gabucino
parents:
2745
diff
changeset
|
78 |
33c32f3d9f1f
many small updates, fixes (some/more to be completed soon)
gabucino
parents:
2745
diff
changeset
|
79 <P>This example shows how to encode a DVD to a 2-pass DivX4 AVI. Just two |
33c32f3d9f1f
many small updates, fixes (some/more to be completed soon)
gabucino
parents:
2745
diff
changeset
|
80 commands are needed :<BR> |
2907 | 81 <CODE> mencoder -dvd 2 -ovc divx4 -oac mp3lame -divx4opts br=1100 |
2848
33c32f3d9f1f
many small updates, fixes (some/more to be completed soon)
gabucino
parents:
2745
diff
changeset
|
82 -o movie.avi -pass 1<BR> |
2907 | 83 mencoder -dvd 2 -ovc divx4 -oac mp3lame -divx4opts br=1100 -o movie.avi -pass 2</CODE></P> |
2868 | 84 |
85 <P><B><I>Syntax</I></B></P> | |
86 | |
87 <P> <CODE>mencoder [options] <input file> [options] ...</P> | |
88 | |
89 <P><B><I>Available options</I></B></P> | |
90 | |
91 <P>NOTE : for all available options, <B>read the manpage !</B></P> | |
92 | |
93 <TABLE BORDER=0> | |
94 <TR> | |
95 <TD> </TD> | |
96 <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> | |
97 <I>-o</I> filename</TD> | |
98 <TD> </TD> | |
99 <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> | |
100 specify output filename | |
101 </TD> | |
102 </TR> | |
103 <TR> | |
104 <TD> </TD> | |
105 <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> | |
3287 | 106 <I>-x</I> width in pixels</TD> |
107 <TD> </TD> | |
108 <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> | |
109 rescale output video to given pixels width | |
110 </TD> | |
111 </TR> | |
112 <TR> | |
113 <TD> </TD> | |
114 <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> | |
115 <I>-y</I> height in pixels</TD> | |
116 <TD> </TD> | |
117 <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> | |
118 rescale output video to given pixels height | |
119 </TD> | |
120 </TR> | |
121 <TR> | |
122 <TD> </TD> | |
123 <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> | |
124 <I>-sws</I> 0-2</TD> | |
125 <TD> </TD> | |
126 <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> | |
127 type of scaling method<BR> | |
128 0 - fast bilinear<BR> | |
129 1 - bilinear<BR> | |
130 2 - bicubic (best quality)<BR> | |
131 </TD> | |
132 </TR> | |
133 <TR> | |
134 <TD> </TD> | |
135 <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> | |
2868 | 136 <I>-ovc</I> codecname</TD> |
137 <TD> </TD> | |
138 <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> | |
139 Encode with the given codec (codec names are from codecs.conf). Examples:<BR> | |
140 <B>help</B> - get list of available codecs<BR> | |
141 <B>copy</B> - no encoding, just copy the stream (only from AVI/ASF now)<BR> | |
142 <B>divx4</B> - encode to DivX4<BR> | |
143 </TD> | |
144 </TR> | |
145 <TR> | |
146 <TD> </TD> | |
147 <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> | |
148 <I>-oac</I> codecname</TD> | |
149 <TD> </TD> | |
150 <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> | |
151 Encode with the given codec (codec names are from codecs.conf). Examples:<BR> | |
152 <B>help</B> - get list of available codecs<BR> | |
153 <B>copy</B> - no encoding, just copy the stream (only from AVI/ASF now)<BR> | |
154 <B>pcm</B> - encode to uncompressed PCM<BR> | |
155 <B>mp3lame</B> - encode to MP3 (using Lame)<BR> | |
156 </TD> | |
157 </TR> | |
158 <TR> | |
159 <TD> </TD> | |
160 <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> | |
161 <I>-divx4opts</I></TD> | |
162 <TD> </TD> | |
163 <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> | |
164 If encoding to DivX4, you can specify its parameters here, like:<BR> | |
165 <CODE>-divx4opts br=1800:deinterlace:key=250</CODE><BR> | |
166 Common options: <B>(for full list, check the manpage!)</B><BR> | |
167 <B>help</B> - get help<BR> | |
168 <B>br</B>=XXX - specify bitrate in kbit <4-16000> or bit <16001-24000000><BR> | |
169 <B>q</B>=XXXX - quality (1-fastest, 5-best - default 5)<BR> | |
170 </TD> | |
171 </TR> | |
172 <TR> | |
173 <TD> </TD> | |
174 <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> | |
175 <I>-lameopts</I></TD> | |
176 <TD> </TD> | |
177 <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> | |
178 If encoding to MP3 with libmp3lame, you can specify its parameters here, like:<BR> | |
179 <CODE>-lameopts q=3</CODE><BR> | |
180 <CODE>-lameopts br=192:cbr</CODE><BR> | |
181 Common options: <B>(for full list, check the manpage!)</B><BR> | |
182 <B>help</B> - get help<BR> | |
183 <B>cbr</B> - select <B>CBR</B> MP3 (default is <B>VBR</B>)<BR> | |
184 <B>br</B>=XXX - specify bitrate in kbit <0-1024> (this is for <B>CBR</B> only!)<BR> | |
185 <B>q</B>=XXXX - quality (0-highest, 9-fastest - default 0) (this is for <B>VBR</B> only!)<BR> | |
186 </TD> | |
187 </TR> | |
188 </TABLE> | |
2848
33c32f3d9f1f
many small updates, fixes (some/more to be completed soon)
gabucino
parents:
2745
diff
changeset
|
189 |
2674 | 190 <P><B><I>Examples</I></B></P> |
191 | |
192 <P>Using <B>MEncoder</B> is the easiest thing on Earth. See the following :</P> | |
193 | |
194 <P>Encoding from DVD, title 2 :<BR> | |
195 <CODE> mencoder -dvd 2 -o title2.avi</CODE></P> | |
196 | |
197 <P>Encoding from HTTP :<BR> | |
198 <CODE> mencoder http://mplayer.hq/example.avi -o example.avi</CODE></P> | |
199 | |
2874
632032ff27bf
patch applied from Colin Marquardt <colin@marquardt-home.de>
gabucino
parents:
2868
diff
changeset
|
200 <P>Encoding from a pipe :<BR> |
2674 | 201 <CODE> rar p test-SVCD.rar | mencoder -divx4opts br=800 -ofps 24 -pass 1 -- -</CODE></P> |
202 | |
2874
632032ff27bf
patch applied from Colin Marquardt <colin@marquardt-home.de>
gabucino
parents:
2868
diff
changeset
|
203 <P>Encoding multiple *.vob files :<BR> |
632032ff27bf
patch applied from Colin Marquardt <colin@marquardt-home.de>
gabucino
parents:
2868
diff
changeset
|
204 <CODE> cat *.vob | mencoder <options> -</CODE></P> |
632032ff27bf
patch applied from Colin Marquardt <colin@marquardt-home.de>
gabucino
parents:
2868
diff
changeset
|
205 |
2950
20157c719b2c
new features in TV input dox (chan, chanlist, norm, keys)
gabucino
parents:
2939
diff
changeset
|
206 <P>Encoding from tuner (for tuner options <A HREF="documentation.html#2.5">see the TV input section !</A>) :<BR> |
20157c719b2c
new features in TV input dox (chan, chanlist, norm, keys)
gabucino
parents:
2939
diff
changeset
|
207 <CODE> mencoder -tv on:driver=v4l:width=640:height=480 <options> -</CODE></P> |
20157c719b2c
new features in TV input dox (chan, chanlist, norm, keys)
gabucino
parents:
2939
diff
changeset
|
208 |
2674 | 209 <P>For all available options, <B><I>check the MEncoder man page !</I></B> |
210 <P> | |
211 </FONT> | |
212 </BODY> | |
213 </HTML> |