[Mplayer-cvslog] CVS: main/DOCS documentation.html,1.144,1.145 encoding.html,1.16,1.17 mencoder.1,1.19,1.20 mplayer.1,1.116,1.117
Winner of tha face compo
gabucino at mplayer.dev.hu
Tue Dec 25 00:00:09 CET 2001
Update of /cvsroot/mplayer/main/DOCS
In directory mplayer:/var/tmp.root/cvs-serv16625
Modified Files:
documentation.html encoding.html mencoder.1 mplayer.1
Log Message:
some quick updates for the prerelease
Index: documentation.html
===================================================================
RCS file: /cvsroot/mplayer/main/DOCS/documentation.html,v
retrieving revision 1.144
retrieving revision 1.145
diff -u -r1.144 -r1.145
--- documentation.html 24 Dec 2001 15:53:14 -0000 1.144
+++ documentation.html 24 Dec 2001 23:00:06 -0000 1.145
@@ -132,6 +132,7 @@
<LI><A HREF="encoding.html#2.4.3.2">2.4.3.2 Rescaling movies</A></LI>
<LI><A HREF="encoding.html#2.4.3.3">2.4.3.3 Streamcopy</A></LI>
<LI><A HREF="encoding.html#2.4.3.4">2.4.3.4 Fixing AVIs with broken index</A></LI>
+ <LI><A HREF="encoding.html#2.4.3.5">2.4.3.5 Encoding with the libavcodec codec family</A></LI>
</UL>
<LI><A HREF="encoding.html#2.4.4">2.4.4 Syntax</A></LI>
<LI><A HREF="encoding.html#2.4.5">2.4.5 Available options</A></LI>
Index: encoding.html
===================================================================
RCS file: /cvsroot/mplayer/main/DOCS/encoding.html,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -r1.16 -r1.17
--- encoding.html 19 Dec 2001 17:30:08 -0000 1.16
+++ encoding.html 24 Dec 2001 23:00:06 -0000 1.17
@@ -5,7 +5,8 @@
<P><B><A NAME=2.4>2.4. Encoding with MEncoder</A></B></P>
-<A NAME=2.4.1><P><B><I>Overview</I></B>
+<P><B><A NAME=2.4.1>2.4.1. Overview</B></P>
+
<P><B>MEncoder</B> (<B>MPlayer</B>'s Movie Encoder) is a simple movie encoder,
designed to encode MPlayer-playable movies
(<B>AVI/DVD/VCD/VOB/MPG/MOV/VIV/NET</B>) to other MPlayer-playable formats (see
@@ -14,15 +15,19 @@
copying abilities. In the future, there will be cropping, resizing filters, and
other interesting stuff.</P>
-<A NAME=2.4.2><P><B><I>Compiling</I></B>
+<P><B><A NAME=2.4.2>2.4.2. Compiling</B></P>
+
+<P>
<UL>
- <LI>read <B>MPlayer</B>'s compilation instructions, it contains info about
+ <LI><B>OPTIONAL</B> - read <B>MPlayer</B>'s compilation instructions, it contains info about
how to install <I>libdvdread</I> for <B>DVD</B> support, etc.</LI>
- <LI>download the newest <B>DivX4linux</B> libs
+ <LI><B>OPTIONAL</B> - download the newest <B>DivX4linux</B> libs
from <A HREF="http://avifile.sourceforge.net/download.htm">avifile.sourceforge.net</A>,
and have them PROPERLY installed. This is needed for DivX4 (1/2 pass)
encoding. And since this is mandatory (now), MEncoder is Linux-only.</LI>
- <LI>download and compile <B>libmp3lame</B> (from lame 3.89beta or lame CVS).<BR>
+ <LI><B>OPTIONAL</B> - for libavcodec support, install libavcodec as
+ described in the <A HREF="codecs.html#2.2.1.2">libavcodec section</A>.</LI>
+ <LI><B>OPTIONAL</B> - download and compile <B>libmp3lame</B> (from lame 3.89beta or lame CVS).<BR>
<B>WARNING : DO NOT COMPILE LAME WITH <U>GCC 2.96</U> ! It won't
work properly !</B><BR>
This
@@ -43,7 +48,9 @@
<P>You are ready. As you probably know, other encoding tools need the
<I>avifile</I> library installed. <B>MEncoder</B> doesn't need it at all.</P>
-<A NAME=2.4.3><P><B><I>MEncoder features</I></B> :
+<P><B><A NAME=2.4.3>2.4.3. MEncoder features</B></P>
+
+<P>
<UL>
<LI>encoding from the wide range of fileformats and decoders of <B>MPlayer</B></LI>
<LI>encoding from <B>V4L compatible TV tuners</B></LI>
@@ -68,7 +75,7 @@
</UL>
</P>
-<A NAME=2.4.3.1><P><B><I>Encoding 2-pass DivX4</I></B></P>
+<P><B><A NAME=2.4.3.1>2.4.3.1. Encoding 2-pass DivX4</B></P>
<P>The name comes from the fact that this method encodes the file <I>twice</I>.
The first encoding (dubbed <I>pass</I>) creates some temporary files (*.log) with a
@@ -83,7 +90,7 @@
-o movie.avi -pass 1<BR>
mencoder -dvd 2 -ovc divx4 -oac mp3lame -divx4opts br=1100 -o movie.avi -pass 2</CODE></P>
-<A NAME=2.4.3.2><P><B><I>Rescaling movies</I></B></P>
+<P><B><A NAME=2.4.3.2>2.4.3.2. Rescaling movies</B></P>
<P>Often the need to resize movie images' size emerges. Its reasons can be many,
examples are decreasing output file size, encoding SVCDs to DivX. Ripped DVDs
@@ -96,14 +103,14 @@
<P>The output size is specified with the <CODE>-x</CODE>, and <CODE>-y</CODE>
options. Furthermore, there are 3 rescaling filters in <B>MEncoder</B>, <I>0
- : fast 1 : bilinear</I>, <I>2 : bilinear</I>, <I>bicubic</I> (best quality).
+ : fast bilinear</I>, <I>1 : bilinear</I>, <I>2 : bicubic</I> (best quality).
They can be specified with the <CODE>-sws</CODE> option. If not specified,
<B>MEncoder</B> will use 0 : fast bilinear.</P>
<P>Rescaling is very simple :<BR>
<CODE> mencoder sample-svcd.mpg -divx4opts br=1300 -x 640 -y 480 -sws 2 -o output.avi</CODE></P>
-<A NAME=2.4.3.3><P><B><I>Stream copying</I></B></P>
+<P><B><A NAME=2.4.3.3>2.4.3.3. Stream copying</B></P>
<P><B>MEncoder</B> can handle input streams in two ways : <B>encode</B> or
<B>copy</B> them. This section is about <B>copying</B>.</P>
@@ -121,7 +128,7 @@
</UL>
</P>
-<A NAME=2.4.3.4><P><B><I>Fixing AVIs with broken index</I></B></P>
+<P><B><A NAME=2.4.3.4>2.4.3.4. Fixing AVIs with broken index</B></P>
<P>Easiest thing. We simply copy the video and audio streams, and
<B>MEncoder</B> generates the index. Of course this cannot fix possible bugs in
@@ -129,11 +136,32 @@
<P>Command : <CODE>mencoder input.avi -ovc copy -oac copy -o output.avi</CODE></P>
-<A NAME=2.4.4><P><B><I>Syntax</I></B></P>
+
+<P><B><A NAME=2.4.3.5>2.4.3.5. Encoding with the <I>libavcodec</I> codec family</B></P>
+
+<P>libavcodec 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 :</P>
+
+<P>
+<UL>
+ <LI>mjpeg - Motion JPEG</LI>
+ <LI>h263p - H263 Plus</LI>
+ <LI>mpeg4 - DivX4</LI>
+ <LI>msmpeg4 - the old DivX</LI>
+ <LI>rv10 - an old RealVideo codec</LI>
+ <LI>mpeg1video - MPEG1 video :)</LI>
+</UL>
+</P>
+
+<P>The first column contains the codec names that should be passed after the
+ <CODE>vcodec</CODE> config, like : <CODE>-lavcopts vcodec=msmpeg4</CODE></P>
+
+<P><B><A NAME=2.4.4>2.4.4. Syntax</B></P>
<P> <CODE>mencoder [options] [input file] [options] ...</P>
-<A NAME=2.4.5><P><B><I>Available options</I></B></P>
+<P><B><A NAME=2.4.5>2.4.5. Available options</B></P>
<P>NOTE : for all available options, <B>read the manpage !</B></P>
@@ -187,6 +215,7 @@
<B>help</B> - get list of available codecs<BR>
<B>copy</B> - no encoding, just copy the stream (only from AVI/ASF now)<BR>
<B>divx4</B> - encode to DivX4<BR>
+ <B>lavc</B> - encode with a codec from libavcodec<BR>
</TD>
</TR>
<TR>
@@ -214,6 +243,23 @@
<B>help</B> - get help<BR>
<B>br</B>=XXX - specify bitrate in kbit <4-16000> or bit <16001-24000000><BR>
<B>q</B>=XXXX - quality (1-fastest, 5-best - default 5)<BR>
+ <B>key</B>=XXXX - keyframe interval<BR>
+ </TD>
+</TR>
+<TR>
+ <TD> </TD>
+ <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
+ <I>-lavcopts</I></TD>
+ <TD> </TD>
+ <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>
+ If encoding with libavcodec, you can specify its parameters here, like:<BR>
+ <CODE>-lavcopts vcodec=msmpeg4:vbitrate=1800:vhq:keyint=250</CODE><BR>
+ Common options: <B>(for full list, check the manpage!)</B><BR>
+ <B>help</B> - get help<BR>
+ <B>vcodec</B>=XXX - select videocodec (for the full list, see the libavcodec section above)<BR>
+ <B>vbitrate</B>=XXX - specify bitrate in kbit <4-16000> or bit <16001-24000000><BR>
+ <B>vhq</B> - high quality<BR>
+ <B>keyint</B>=XXX - keyframe interval<BR>
</TD>
</TR>
<TR>
@@ -234,12 +280,15 @@
</TR>
</TABLE>
-<A NAME=2.4.6><P><B><I>Examples</I></B></P>
+<P><B><A NAME=2.4.6>2.4.6. Examples</B></P>
<P>Using <B>MEncoder</B> is the easiest thing on Earth. See the following :</P>
<P>Encoding from DVD, title 2 :<BR>
<CODE> mencoder -dvd 2 -o title2.avi</CODE></P>
+
+<P>The same, but with libavcodec family, MJPEG compression :<BR>
+ <CODE> mencoder -dvd 2 -o title2.avi -ovc lavc -lavcopts vcodec=mjpeg -ffourcc mjpg</CODE></P>
<P>Encoding from DVD, title 2, with rescaling :<BR>
<CODE> mencoder -dvd 2 -x 640 -y 480 -sws 2 -o title2.avi</CODE></P>
Index: mencoder.1
===================================================================
RCS file: /cvsroot/mplayer/main/DOCS/mencoder.1,v
retrieving revision 1.19
retrieving revision 1.20
diff -u -r1.19 -r1.20
--- mencoder.1 10 Dec 2001 01:00:37 -0000 1.19
+++ mencoder.1 24 Dec 2001 23:00:06 -0000 1.20
@@ -27,6 +27,7 @@
.RB [ \-ovc\ <video\ codec\ name> ]
.RB [ \-oac\ <audio\ codec\ name> ]
.RB [ \-divx4opts\ <codec\ options> ]
+.RB [ \-lavcopts\ <codec\ options> ]
.RB [ \-lameopts\ <codec\ options> ]
.RB [ \-pass\ <1/2> ]
.RB [ \-passlogfile\ <filename> ]
@@ -119,6 +120,7 @@
-ovc help get help
-ovc copy no encoding, just streamcopy
-ovc divx4 encode to DivX4
+ -ovc lavc encode with a libavcodec codec
.TP
.B \-oac <codecname>
Encode with the given codec (codec names are from codecs.conf).
@@ -154,6 +156,24 @@
reaction ratio
.TP
+.B \-lavcopts
+If encoding with a codec from libavcodec, you can specify its parameters here,
+like:
+
+ -lavcopts vcodec=msmpeg4:vbitrate=1800:vhq:keyint=250
+
+Available options:
+
+ help get help
+ vcodec=XXX use the specified codec
+ (for full list, see html doc!)
+ vbitrate=XXX specify bitrate in
+ kbit <4-16000> or
+ bit <16001-24000000>
+ keyint=XXX interval between keyframes
+ (specify in frames)
+ vhq very high quality
+.TP
.B \-lameopts
If encoding to MP3 with libmp3lame, you can specify its parameters here, like:
@@ -212,7 +232,7 @@
.B \-sws (0-2>
Type of scaling method
- 0 fast bilinear
+ 0 fast bilinear (default)
1 bilinear
2 bicubic (best quality)
@@ -221,6 +241,9 @@
.SH "EXAMPLES"
.B Encoding DVD title #2
mencoder -dvd 2 -o title2.avi
+.TP
+.B The same, but with libavcodec family, MJPEG compression
+mencoder -dvd 2 -o title2.avi -ovc lavc -lavcopts vcodec=mjpeg -ffourcc mjpg
.TP
.B Encoding from HTTP
mencoder http://mplayer.hq/example.avi -o example.avi
Index: mplayer.1
===================================================================
RCS file: /cvsroot/mplayer/main/DOCS/mplayer.1,v
retrieving revision 1.116
retrieving revision 1.117
diff -u -r1.116 -r1.117
--- mplayer.1 18 Dec 2001 17:07:20 -0000 1.116
+++ mplayer.1 24 Dec 2001 23:00:06 -0000 1.117
@@ -26,6 +26,7 @@
.RB [ \-zoom ]
.RB [ \-x\ x ]
.RB [ \-y\ y ]
+.RB [ \-sws\ software\ scaler\ type ]
.RB [ \-xy\ factor ]
.RB [ \-pp\ quality ]
.RB [ \-include\ configfile ]
@@ -172,6 +173,15 @@
.TP
.B \-y\ y
scale image to y height
+.TP
+.B \-sws\ software\ scaler\ type
+this option sets the quality (and speed, respectively) of the software scaler,
+with the -zoom option. For example with x11 or other outputs which lack
+hardware acceleration. Possible settings are :
+
+ 0 - fast bilinear (default)
+ 1 - bilinear
+ 2 - bicubic (best quality)
.TP
.B \-xy\ factor
scale image by <factor>
More information about the MPlayer-cvslog
mailing list