April 2005 - MPlayer-DOCS - lists.mplayerhq.hu

[PATCH] man page: -af volnorm method parameter
by Thierry Reding 28 Apr '05

28 Apr '05

Hi, this is a small patch to the mplayer man page describing the parameters that can be passed to the volnorm filter. The patch basically reformulates what is stated at the top of libaf/af_vornorm.c. Thanks to albeu for pointing out where to find this information. Cheers, Thierry

2 1

CVS: main/DOCS/man/en mplayer.1,1.947,1.948
by syncmail＠mplayerhq.hu 28 Apr '05

28 Apr '05

CVS change done by Diego Biurrun CVS Update of /cvsroot/mplayer/main/DOCS/man/en In directory mail:/var2/tmp/cvs-serv30885/DOCS/man/en Modified Files: mplayer.1 Log Message: af_volnorm method suboption patch by Thierry Reding < thierry at doppeltgemoppelt dot de > Index: mplayer.1 =================================================================== RCS file: /cvsroot/mplayer/main/DOCS/man/en/mplayer.1,v retrieving revision 1.947 retrieving revision 1.948 diff -u -r1.947 -r1.948 --- mplayer.1 27 Apr 2005 21:37:54 -0000 1.947 +++ mplayer.1 28 Apr 2005 23:08:16 -0000 1.948 @@ -3985,8 +3985,21 @@ .PD 1 . .TP -.B volnorm +.B volnorm[=method] Maximizes the volume without distorting the sound. +.PD 0 +.RSs +.IPs <method> +Sets the used method. +.RSss +1: Use a single sample to smooth the variations via the standard +weighted mean over past samples (default). +.br +2: Use several samples to smooth the variations via the standard +weighted mean over past samples. +.REss +.RE +.PD 1 . .TP .B ladspa=file:label[:controls...]

1 0

CVS: main/DOCS/man/en mplayer.1,1.946,1.947
by syncmail＠mplayerhq.hu 27 Apr '05

27 Apr '05

CVS change done by Diego Biurrun CVS Update of /cvsroot/mplayer/main/DOCS/man/en In directory mail:/var2/tmp/cvs-serv12657/DOCS/man/en Modified Files: mplayer.1 Log Message: wording improvents Index: mplayer.1 =================================================================== RCS file: /cvsroot/mplayer/main/DOCS/man/en/mplayer.1,v retrieving revision 1.946 retrieving revision 1.947 diff -u -r1.946 -r1.947 --- mplayer.1 27 Apr 2005 19:43:36 -0000 1.946 +++ mplayer.1 27 Apr 2005 21:37:54 -0000 1.947 @@ -5882,14 +5882,14 @@ . .TP .B br=<32\-384> -in CBR mode this parameter indicates the bitrate in kbps, -when in VBR mode it's the minimum bitrate allowed per frame; -in this last case it has to be set to a value >= 112 or VBR mode won't work +In CBR mode this parameter indicates the bitrate in kbps, +when in VBR mode it is the minimum bitrate allowed per frame. +VBR mode will not work with a value below 112. .TP .B vbr=<-50\-50> (VBR only) -variability range; if negative toolame shifts the average bitrate towards -the lower limit, if positive towards the higher. -When set to 0 CBR is used (default) +variability range; if negative toolame shifts the average bitrate +towards the lower limit, if positive towards the higher. +When set to 0 CBR is used (default). .TP .B maxvbr=<32\-384> (VBR only) maximum bitrate allowed per frame, in kpbs

1 0

CVS: main/DOCS/man/en mplayer.1,1.944,1.945
by syncmail＠mplayerhq.hu 27 Apr '05

27 Apr '05

CVS change done by Reimar Döffinger CVS Update of /cvsroot/mplayer/main/DOCS/man/en In directory mail:/var2/tmp/cvs-serv28927 Modified Files: mplayer.1 Log Message: Document replacing , by . for -vo ggi: Index: mplayer.1 =================================================================== RCS file: /cvsroot/mplayer/main/DOCS/man/en/mplayer.1,v retrieving revision 1.944 retrieving revision 1.945 diff -u -r1.944 -r1.945 --- mplayer.1 26 Apr 2005 10:00:05 -0000 1.944 +++ mplayer.1 27 Apr 2005 12:17:49 -0000 1.945 @@ -2690,6 +2690,7 @@ .RSs .IPs <driver> Explicitly choose the GGI driver to use. +Replace any ',' that would appear in the driver string by a '.'. .RE .PD 1 .

1 0

CVS: main/DOCS/xml/en mencoder.xml,1.55,1.56
by syncmail＠mplayerhq.hu 26 Apr '05

26 Apr '05

CVS change done by Guillaume Poirier CVS Update of /cvsroot/mplayer/main/DOCS/xml/en In directory mail:/var2/tmp/cvs-serv17693/en Modified Files: mencoder.xml Log Message: Fix the pattern that wasn't repeated every 4 lines. Index: mencoder.xml =================================================================== RCS file: /cvsroot/mplayer/main/DOCS/xml/en/mencoder.xml,v retrieving revision 1.55 retrieving revision 1.56 diff -u -r1.55 -r1.56 --- mencoder.xml 20 Apr 2005 11:16:29 -0000 1.55 +++ mencoder.xml 26 Apr 2005 19:24:28 -0000 1.56 @@ -990,6 +990,24 @@ <entry>L</entry> </row> <row> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry></entry> + </row> + <row> <entry spanname="spa1-2">C</entry> <entry spanname="spa3-4">C</entry> <entry spanname="spa5-6">C</entry>

1 0

CVS: main/DOCS/xml/en mencoder.xml,1.54,1.55
by syncmail＠mplayerhq.hu 26 Apr '05

26 Apr '05

CVS change done by Guillaume Poirier CVS Update of /cvsroot/mplayer/main/DOCS/xml/en In directory mail:/var2/tmp/cvs-serv15335/DOCS/xml/en Modified Files: mencoder.xml Log Message: Rich's tips regarding cropping and scaling Index: mencoder.xml =================================================================== RCS file: /cvsroot/mplayer/main/DOCS/xml/en/mencoder.xml,v retrieving revision 1.54 retrieving revision 1.55 diff -u -r1.54 -r1.55 --- mencoder.xml 19 Apr 2005 06:48:33 -0000 1.54 +++ mencoder.xml 20 Apr 2005 11:16:29 -0000 1.55 @@ -753,6 +753,335 @@ <title>Cropping and Scaling</title> <para> + Recall from the previous section that the final picture size you + encode should be a multiple of 16 (in both width and height). + This can be achieved by cropping, scaling, or a combination of both. +</para> + +<para> + When cropping, there are a few guidelines that must be followed to + avoid damaging your movie. + The normal YUV format, 4:2:0, stores chroma (color) information + subsampled, i.e. chroma is only sampled half as often in each + direction as luma (intensity) information. + Observe this diagram, where L indicates luma sampling points and C + chroma. +</para> + +<informaltable> +<?dbhtml table-width="40%" ?> +<?dbfo table-width="40%" ?> +<tgroup cols="8" align="center"> +<colspec colnum="1" colname="col1"/> +<colspec colnum="2" colname="col2"/> +<colspec colnum="3" colname="col3"/> +<colspec colnum="4" colname="col4"/> +<colspec colnum="5" colname="col5"/> +<colspec colnum="6" colname="col6"/> +<colspec colnum="7" colname="col7"/> +<colspec colnum="8" colname="col8"/> +<spanspec spanname="spa1-2" namest="col1" nameend="col2"/> +<spanspec spanname="spa3-4" namest="col3" nameend="col4"/> +<spanspec spanname="spa5-6" namest="col5" nameend="col6"/> +<spanspec spanname="spa7-8" namest="col7" nameend="col8"/> + <tbody> + <row> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + </row> + <row> + <entry spanname="spa1-2">C</entry> + <entry spanname="spa3-4">C</entry> + <entry spanname="spa5-6">C</entry> + <entry spanname="spa7-8">C</entry> + </row> + <row> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + </row> + <row> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + </row> + <row> + <entry spanname="spa1-2">C</entry> + <entry spanname="spa3-4">C</entry> + <entry spanname="spa5-6">C</entry> + <entry spanname="spa7-8">C</entry> + </row> + <row> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + </row> + </tbody> +</tgroup> +</informaltable> + +<para> + As you can see, rows and columns of the image naturally come in pairs. + Thus your crop offsets and dimensions <emphasis>must</emphasis> be + even numbers. + If they are not, the chroma will no longer line up correctly with the + luma. + In theory, it's possible to crop with odd offsets, but it requires + resampling the chroma which is potentially a lossy operation and not + supported by the crop filter. +</para> + +<para> + Further, interlaced video is sampled as follows: +</para> + +<informaltable> +<?dbhtml table-width="80%" ?> +<?dbfo table-width="80%" ?> +<tgroup cols="16" align="center"> +<colspec colnum="1" colname="col1"/> +<colspec colnum="2" colname="col2"/> +<colspec colnum="3" colname="col3"/> +<colspec colnum="4" colname="col4"/> +<colspec colnum="5" colname="col5"/> +<colspec colnum="6" colname="col6"/> +<colspec colnum="7" colname="col7"/> +<colspec colnum="8" colname="col8"/> +<colspec colnum="9" colname="col9"/> +<colspec colnum="10" colname="col10"/> +<colspec colnum="11" colname="col11"/> +<colspec colnum="12" colname="col12"/> +<colspec colnum="13" colname="col13"/> +<colspec colnum="14" colname="col14"/> +<colspec colnum="15" colname="col15"/> +<colspec colnum="16" colname="col16"/> +<spanspec spanname="spa1-2" namest="col1" nameend="col2"/> +<spanspec spanname="spa3-4" namest="col3" nameend="col4"/> +<spanspec spanname="spa5-6" namest="col5" nameend="col6"/> +<spanspec spanname="spa7-8" namest="col7" nameend="col8"/> +<spanspec spanname="spa9-10" namest="col9" nameend="col10"/> +<spanspec spanname="spa11-12" namest="col11" nameend="col12"/> +<spanspec spanname="spa13-14" namest="col13" nameend="col14"/> +<spanspec spanname="spa15-16" namest="col15" nameend="col16"/> + <tbody> + <row> + <entry namest="col1" nameend="col8">Top field</entry> + <entry namest="col9" nameend="col16">Bottom field</entry> + </row> + <row> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry></entry> + </row> + <row> + <entry spanname="spa1-2">C</entry> + <entry spanname="spa3-4">C</entry> + <entry spanname="spa5-6">C</entry> + <entry spanname="spa7-8">C</entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry></entry> + </row> + <row> + <entry></entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + </row> + <row> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry></entry> + </row> + <row> + <entry></entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry spanname="spa9-10">C</entry> + <entry spanname="spa11-12">C</entry> + <entry spanname="spa13-14">C</entry> + <entry spanname="spa15-16">C</entry> + </row> + <row> + <entry></entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + </row> + <row> + <entry spanname="spa1-2">C</entry> + <entry spanname="spa3-4">C</entry> + <entry spanname="spa5-6">C</entry> + <entry spanname="spa7-8">C</entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry></entry> + </row> + <row> + <entry></entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + </row> + <row> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry></entry> + </row> + <row> + <entry></entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry spanname="spa9-10">C</entry> + <entry spanname="spa11-12">C</entry> + <entry spanname="spa13-14">C</entry> + <entry spanname="spa15-16">C</entry> + </row> + <row> + <entry></entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry></entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + <entry>L</entry> + </row> + </tbody> +</tgroup> +</informaltable> + +<para> + As you can see, the pattern does not repeat until after 4 lines. + So for interlaced video, your y-offset and height for cropping must + be multiples of 4. +</para> + +<para> Native DVD resolution is 720x480 for NTSC, and 720x576 for PAL, but there's an aspect flag that specifies whether it's full-screen (4:3) or wide-screen (16:9). Many (if not most) widescreen DVDs are not strictly @@ -763,11 +1092,40 @@ <para> <application>MPlayer</application> provides a crop detection filter that will determine the crop rectangle (<option>-vf cropdetect</option>). + Run <application>MPlayer</application> with + <option>-vf cropdetect</option> and it will print out the crop + settings to remove the borders. + You should let the movie run long enough that the whole picture + area is used, in order to get accurate crop values. +</para> + +<para> + Then, test the values you get with <application>MPlayer</application>, + using the command line which was printed by + <option>cropdetect</option>, and adjust the rectangle as needed. + The <option>rectangle</option> filter can help by allowing you to + interactively position the crop rectangle over your movie. + Remember to follow the above divisibility guidelines so that you + do not misalign the chroma planes. +</para> + +<para> + In certain cases, scaling may be undesirable. + Scaling in the vertical direction is difficult with interlaced + video, and if you wish to preserve the interlacing, you should + usually refrain from scaling. + If you will not be scaling but you still want to use multiple-of-16 + dimensions, you will have to overcrop. + Do not undercrop, since black borders are very bad for encoding! +</para> + +<para> Because MPEG-4 uses 16x16 macroblocks, you'll want to make sure that each dimension of the video you're encoding is a multiple of 16 or else you will be degrading quality, especially at lower bitrates. You can do this by rounding the width and height of the crop rectangle down to the nearest - multiple of 16. When cropping, you'll want to increase the y-offset by + multiple of 16. + As stated earlier, when cropping, you'll want to increase the Y offset by half the difference of the old and the new height so that the resulting video is taken from the center of the frame. And because of the way DVD video is sampled, make sure the offset is an even number. (In fact, as a

2 1

CVS: main/DOCS/man/en mplayer.1,1.943,1.944
by syncmail＠mplayerhq.hu 26 Apr '05

26 Apr '05

CVS change done by Diego Biurrun CVS Update of /cvsroot/mplayer/main/DOCS/man/en In directory mail:/var2/tmp/cvs-serv6419/DOCS/man/en Modified Files: mplayer.1 Log Message: better slave mode description, spelling/grammar Index: mplayer.1 =================================================================== RCS file: /cvsroot/mplayer/main/DOCS/man/en/mplayer.1,v retrieving revision 1.943 retrieving revision 1.944 diff -u -r1.943 -r1.944 --- mplayer.1 25 Apr 2005 09:04:26 -0000 1.943 +++ mplayer.1 26 Apr 2005 10:00:05 -0000 1.944 @@ -719,10 +719,11 @@ .TP .B \-slave (also see \-input) Switches on slave mode, in which MPlayer works as a backend for other programs. -Instead of intercepting keyboard events, MPlayer will read commands from stdin. +Instead of intercepting keyboard events, MPlayer will read commands separated +by a newline (\\n) from stdin. .br .I NOTE: -See \-input cmdlist for a list of slave commands and DOCS/\:tech/\:slave.txt +See \-input cmdlist for a list of slave commands and DOCS/tech/slave.txt for their description. . .TP @@ -1118,7 +1119,7 @@ .PD 1 . .TP -.B \-rtsp-stream-over-tcp (live.com only) +.B \-rtsp-stream-over-tcp (LIVE.COM only) Used with 'rtsp://' URLs to specify that the resulting incoming RTP and RTCP packets be streamed over TCP (using the same TCP connection as RTSP). This option may be useful if you have a broken internet connection that does @@ -2284,7 +2285,7 @@ .TP .B \-xineramascreen <0\-...> In Xinerama configurations (i.e.\& a single desktop that spans across multiple -displays) this option tells MPlayer which screen to display movie on. +displays) this option tells MPlayer which screen to display the movie on. . .TP .B \-zrbw (\-vo zr only)

1 0

CVS: main/DOCS/man/en mplayer.1,1.941,1.942
by syncmail＠mplayerhq.hu 25 Apr '05

25 Apr '05

CVS change done by Nico Sabbi CVS Update of /cvsroot/mplayer/main/DOCS/man/en In directory mail:/var2/tmp/cvs-serv32009 Modified Files: mplayer.1 Log Message: faac options Index: mplayer.1 =================================================================== RCS file: /cvsroot/mplayer/main/DOCS/man/en/mplayer.1,v retrieving revision 1.941 retrieving revision 1.942 diff -u -r1.941 -r1.942 --- mplayer.1 20 Apr 2005 11:52:30 -0000 1.941 +++ mplayer.1 25 Apr 2005 07:42:34 -0000 1.942 @@ -5661,7 +5661,7 @@ .B \-<codec>opts <option1[=value],option2,...> . .PP -Where <codec> may be: lavc, xvidenc, divx4, lame, toolame, x264enc, mpeg. +Where <codec> may be: lavc, xvidenc, divx4, lame, toolame, faac, x264enc, mpeg. . . .SS divx4 (\-divx4opts) @@ -5897,6 +5897,36 @@ .PD 1 . . +.SS faac (\-faacopts) +. +.TP +.B br=<bitrate> +average bitrate in kbps +.TP +.B quality=<1\-1000> +quality mode, in exclusion to br +.TP +.B object=<0\-3> +object type complexity: 0: MAIN (default), 1: LOW, 2: SSR, 3: LTP (extremely slow) +.TP +.B mpeg=<2 | 4> +mpeg version, default is 4 +.TP +.B tns +enables temporal noise shaping, disabled by default +.TP +.B cutoff=<0\-sampling_rate/2> +cutoff frequency, default is sampling_rate/2 +.TP +.B raw +stores the bitstream as raw payload with extradata in the container header. +Default is 0, which corresponds to ADTS. +Don't set this flag if not explicitly required, or you won't be able to remux the +audio stream later. +.RE +.PD 1 +. +. .SS lavc (\-lavcopts) Many libavcodec (lavc for short) options are tersely documented. Read the source for full details.

4 4

CVS: main/DOCS/xml/en faq.xml,1.72,1.73
by syncmail＠mplayerhq.hu 24 Apr '05

24 Apr '05

CVS change done by Guillaume Poirier CVS Update of /cvsroot/mplayer/main/DOCS/xml/en In directory mail:/var2/tmp/cvs-serv426/en Modified Files: faq.xml Log Message: explains how to fix the aspect ratio of an AVI file Index: faq.xml =================================================================== RCS file: /cvsroot/mplayer/main/DOCS/xml/en/faq.xml,v retrieving revision 1.72 retrieving revision 1.73 diff -u -r1.72 -r1.73 --- faq.xml 11 Apr 2005 21:40:05 -0000 1.72 +++ faq.xml 24 Apr 2005 21:04:26 -0000 1.73 @@ -1353,6 +1353,20 @@ <qandaentry> <question><para> +How can I fix the aspect ration of an AVI file? +</para></question> +<answer><para> +You can do such a thing thanks to <application>MEncoder</application>'s +<option>-force-avi-aspect</option> option, which overrides the aspect +stored in the AVI OpenDML vprp header option. For example: +<screen> +mencoder <replaceable>input.avi</replaceable> -ovc copy -oac copy -o <replaceable>output.avi</replaceable> -force-avi-aspect 4/3 +</screen> +</para></answer> +</qandaentry> + +<qandaentry> +<question><para> I can't encode DVD subtitles into the AVI! </para></question> <answer><para>

1 0

CVS: homepage/src donations.src.en,1.78,1.79
by syncmail＠mplayerhq.hu 23 Apr '05

23 Apr '05

CVS change done by Ivan Kalvachev CVS Update of /cvsroot/mplayer/homepage/src In directory mail:/var2/tmp/cvs-serv11885 Modified Files: donations.src.en Log Message: bt878 tuner donation from merbanan Index: donations.src.en =================================================================== RCS file: /cvsroot/mplayer/homepage/src/donations.src.en,v retrieving revision 1.78 retrieving revision 1.79 diff -u -r1.78 -r1.79 --- donations.src.en 12 Apr 2005 10:32:56 -0000 1.78 +++ donations.src.en 23 Apr 2005 13:52:36 -0000 1.79 @@ -127,6 +127,7 @@ Received: <ul> <li>Sound Blaster Live! emu10k1 (James Bilotto)</li> +<li>Hauppauge WinTV BT878 tuner card (Benjamin Larsson)</li> </ul> <br>

1 0