November 2006 - MPlayer-DOCS - lists.mplayerhq.hu

r21026 - trunk/DOCS/man/en/mplayer.1
by nicodvb 18 Nov '06

18 Nov '06

Author: nicodvb Date: Sat Nov 18 15:47:53 2006 New Revision: 21026 Modified: trunk/DOCS/man/en/mplayer.1 Log: TAB switches between programs Modified: trunk/DOCS/man/en/mplayer.1 ============================================================================== --- trunk/DOCS/man/en/mplayer.1 (original) +++ trunk/DOCS/man/en/mplayer.1 Sat Nov 18 15:47:53 2006 @@ -244,6 +244,8 @@ Cycle through the available video tracks. .IPs "# (MPEG and Matroska only)" Cycle through the available audio tracks. +.IPs "TAB (MPEG-TS only)" +Cycle through the available programs. .IPs "f\ \ \ \ " Toggle fullscreen (also see \-fs). .IPs "T\ \ \ \ "

1 0

r21019 - trunk/DOCS/man/en/mplayer.1
by gpoirier 18 Nov '06

18 Nov '06

Author: gpoirier Date: Sat Nov 18 13:38:20 2006 New Revision: 21019 Modified: trunk/DOCS/man/en/mplayer.1 Log: group together xvid's rate control options Modified: trunk/DOCS/man/en/mplayer.1 ============================================================================== --- trunk/DOCS/man/en/mplayer.1 (original) +++ trunk/DOCS/man/en/mplayer.1 Sat Nov 18 13:38:20 2006 @@ -8605,25 +8605,6 @@ which you can activate with \-vf scale=<width>:<height>:1. . .TP -.B rc_reaction_delay_factor=<value> -This parameter controls the number of frames the CBR rate controller -will wait before reacting to bitrate changes and compensating for them -to obtain a constant bitrate over an averaging range of frames. -. -.TP -.B rc_averaging_period=<value> -Real CBR is hard to achieve. -Depending on the video material, bitrate can be variable, and hard to predict. -Therefore Xvid uses an averaging period for which it guarantees a given -amount of bits (minus a small variation). -This settings expresses the "number of frames" for which Xvid averages -bitrate and tries to achieve CBR. -. -.TP -.B rc_buffer=<value> -size of the rate control buffer -. -.TP .B min_iquant=<0\-31> minimum I-frame quantizer (default: 2) . @@ -8759,6 +8740,25 @@ own risks! . .TP +.B rc_reaction_delay_factor=<value> +This parameter controls the number of frames the CBR rate controller +will wait before reacting to bitrate changes and compensating for them +to obtain a constant bitrate over an averaging range of frames. +. +.TP +.B rc_averaging_period=<value> +Real CBR is hard to achieve. +Depending on the video material, bitrate can be variable, and hard to predict. +Therefore Xvid uses an averaging period for which it guarantees a given +amount of bits (minus a small variation). +This settings expresses the "number of frames" for which Xvid averages +bitrate and tries to achieve CBR. +. +.TP +.B rc_buffer=<value> +size of the rate control buffer +. +.TP .B curve_compression_high=<0\-100> This setting allows Xvid to take a certain percentage of bits away from high bitrate scenes and give them back to the bit reservoir.

1 0

r21017 - trunk/DOCS/man/en/mplayer.1
by gpoirier 18 Nov '06

18 Nov '06

Author: gpoirier Date: Sat Nov 18 13:35:29 2006 New Revision: 21017 Modified: trunk/DOCS/man/en/mplayer.1 Log: group together "quant_type" and quant_*_matrix since they are related Modified: trunk/DOCS/man/en/mplayer.1 ============================================================================== --- trunk/DOCS/man/en/mplayer.1 (original) +++ trunk/DOCS/man/en/mplayer.1 Sat Nov 18 13:35:29 2006 @@ -8665,6 +8665,16 @@ be used. . .TP +.B quant_intra_matrix=<filename> +Load a custom intra matrix file. +You can build such a file with xvid4conf's matrix editor. +. +.TP +.B quant_inter_matrix=<filename> +Load a custom inter matrix file. +You can build such a file with xvid4conf's matrix editor. +. +.TP .B keyframe_boost=<0\-1000> (two pass mode only) Shift some bits from the pool for other frame types to intra frames, thus improving keyframe quality. @@ -8749,16 +8759,6 @@ own risks! . .TP -.B quant_intra_matrix=<filename> -Load a custom intra matrix file. -You can build such a file with xvid4conf's matrix editor. -. -.TP -.B quant_inter_matrix=<filename> -Load a custom inter matrix file. -You can build such a file with xvid4conf's matrix editor. -. -.TP .B curve_compression_high=<0\-100> This setting allows Xvid to take a certain percentage of bits away from high bitrate scenes and give them back to the bit reservoir.

1 0

r21015 - trunk/DOCS/man/en/mplayer.1
by gpoirier 18 Nov '06

18 Nov '06

Author: gpoirier Date: Sat Nov 18 13:32:12 2006 New Revision: 21015 Modified: trunk/DOCS/man/en/mplayer.1 Log: group together "debug" and "psnr", note that "threads" option is featured on 1.2.x release Modified: trunk/DOCS/man/en/mplayer.1 ============================================================================== --- trunk/DOCS/man/en/mplayer.1 (original) +++ trunk/DOCS/man/en/mplayer.1 Sat Nov 18 13:32:12 2006 @@ -8715,12 +8715,6 @@ autodetection of some decoders might be confused. . .TP -.B "debug\ \ " -Save per-frame statistics in ./xvid.dbg. (This is not the two pass control -file.) -.RE -. -.TP .B max_bframes=<0\-4> Maximum number of B-frames to put between I/P-frames (default: 2). . @@ -8941,6 +8935,12 @@ the current directory. Returned values are in dB (decibel), the higher the better. . +.TP +.B "debug\ \ " +Save per-frame statistics in ./xvid.dbg. (This is not the two pass control +file.) +.RE +. .PP .sp 1 The following option is only available in Xvid 1.1.x. @@ -8955,7 +8955,7 @@ . .PP .sp 1 -The following option is only available in the CVS version of Xvid. +The following option is only available in the 1.2.x version of Xvid. . .TP .B threads=<0\-n>

1 0

r21013 - trunk/DOCS/man/en/mplayer.1
by gpoirier 18 Nov '06

18 Nov '06

Author: gpoirier Date: Sat Nov 18 13:26:04 2006 New Revision: 21013 Modified: trunk/DOCS/man/en/mplayer.1 Log: Move xvid 'grayscale' option close to 'interlacing' Modified: trunk/DOCS/man/en/mplayer.1 ============================================================================== --- trunk/DOCS/man/en/mplayer.1 (original) +++ trunk/DOCS/man/en/mplayer.1 Sat Nov 18 13:26:04 2006 @@ -8590,6 +8590,12 @@ subjective quality and possibly reducing PSNR. . .TP +.B (no)grayscale +Make Xvid discard chroma planes so the encoded video is grayscale only. +Note that this does not speed up encoding, it just prevents chroma data +from being written in the last stage of encoding. +. +.TP .B (no)interlacing Encode the fields of interlaced video material. Turn this option on for interlaced content. @@ -8709,12 +8715,6 @@ autodetection of some decoders might be confused. . .TP -.B (no)grayscale -Make Xvid discard chroma planes so the encoded video is grayscale only. -Note that this does not speed up encoding, it just prevents chroma data -from being written in the last stage of encoding. -. -.TP .B "debug\ \ " Save per-frame statistics in ./xvid.dbg. (This is not the two pass control file.)

1 0

r21012 - trunk/DOCS/man/en/mplayer.1
by gpoirier 18 Nov '06

18 Nov '06

Author: gpoirier Date: Sat Nov 18 13:23:05 2006 New Revision: 21012 Modified: trunk/DOCS/man/en/mplayer.1 Log: group together "quality" control options Modified: trunk/DOCS/man/en/mplayer.1 ============================================================================== --- trunk/DOCS/man/en/mplayer.1 (original) +++ trunk/DOCS/man/en/mplayer.1 Sat Nov 18 13:23:05 2006 @@ -8496,6 +8496,100 @@ you need realtime encoding. . .TP +.B (no)qpel +MPEG-4 uses a half pixel precision for its motion search by default. +The standard proposes a mode where encoders are allowed to use quarter +pixel precision. +This option usually results in a sharper image. +Unfortunately it has a great impact on bitrate and sometimes the +higher bitrate use will prevent it from giving a better image +quality at a fixed bitrate. +It is better to test with and without this option and see whether it +is worth activating. +. +.TP +.B (no)gmc +Enable Global Motion Compensation, which makes Xvid generate special +frames (GMC-frames) which are well suited for Pan/\:Zoom/\:Rotating images. +Whether or not the use of this option will save bits is highly +dependent on the source material. +. +.TP +.B (no)trellis +Trellis Quantization is a kind of adaptive quantization method that +saves bits by modifying quantized coefficients to make them more +compressible by the entropy encoder. +Its impact on quality is good, and if VHQ uses too much CPU for you, +this setting can be a good alternative to save a few bits (and gain +quality at fixed bitrate) at a lesser cost than with VHQ (default: on). +. +.TP +.B (no)cartoon +Activate this if your encoded sequence is an anime/\:cartoon. +It modifies some Xvid internal thresholds so Xvid takes better decisions on +frame types and motion vectors for flat looking cartoons. +. +.TP +.B (no)chroma_me +The usual motion estimation algorithm uses only the luminance information to +find the best motion vector. +However for some video material, using the chroma planes can help find +better vectors. +This setting toggles the use of chroma planes for motion estimation +(default: on). +. +.TP +.B (no)chroma_opt +Enable a chroma optimizer prefilter. +It will do some extra magic on color information to minimize the +stepped-stairs effect on edges. +It will improve quality at the cost of encoding speed. +It reduces PSNR by nature, as the mathematical deviation to the original +picture will get bigger, but the subjective image quality will raise. +Since it works with color information, you might want to turn it off when +encoding in grayscale. +. +.TP +.B (no)hq_ac +Activates high-quality prediction of AC coefficients for intra frames from +neighbor blocks (default: on). +. +.TP +.B vhq=<0\-4> +The motion search algorithm is based on a search in the usual color domain +and tries to find a motion vector that minimizes the difference between the +reference frame and the encoded frame. +With this setting activated, Xvid will also use the frequency domain (DCT) +to search for a motion vector that minimizes not only the spatial +difference but also the encoding length of the block. +Fastest to slowest: +.PD 0 +.RSs +.IPs 0 +off +.IPs 1 +mode decision (inter/\:intra MB) (default) +.IPs 2 +limited search +.IPs 3 +medium search +.IPs 4 +wide search +.RE +.PD 1 +. +.TP +.B (no)lumi_mask +Adaptive quantization allows the macroblock quantizers to vary inside +each frame. +This is a 'psychosensory' setting that is supposed to make use of the +fact that the human eye tends to notice fewer details in very bright +and very dark parts of the picture. +It compresses those areas more strongly than medium ones, which will +save bits that can be spent again on other frames, raising overall +subjective quality and possibly reducing PSNR. +. +.TP .B (no)interlacing Encode the fields of interlaced video material. Turn this option on for interlaced content. @@ -8661,100 +8755,6 @@ own risks! . .TP -.B (no)qpel -MPEG-4 uses a half pixel precision for its motion search by default. -The standard proposes a mode where encoders are allowed to use quarter -pixel precision. -This option usually results in a sharper image. -Unfortunately it has a great impact on bitrate and sometimes the -higher bitrate use will prevent it from giving a better image -quality at a fixed bitrate. -It is better to test with and without this option and see whether it -is worth activating. -. -.TP -.B (no)gmc -Enable Global Motion Compensation, which makes Xvid generate special -frames (GMC-frames) which are well suited for Pan/\:Zoom/\:Rotating images. -Whether or not the use of this option will save bits is highly -dependent on the source material. -. -.TP -.B (no)trellis -Trellis Quantization is a kind of adaptive quantization method that -saves bits by modifying quantized coefficients to make them more -compressible by the entropy encoder. -Its impact on quality is good, and if VHQ uses too much CPU for you, -this setting can be a good alternative to save a few bits (and gain -quality at fixed bitrate) at a lesser cost than with VHQ (default: on). -. -.TP -.B (no)cartoon -Activate this if your encoded sequence is an anime/\:cartoon. -It modifies some Xvid internal thresholds so Xvid takes better decisions on -frame types and motion vectors for flat looking cartoons. -. -.TP -.B (no)chroma_me -The usual motion estimation algorithm uses only the luminance information to -find the best motion vector. -However for some video material, using the chroma planes can help find -better vectors. -This setting toggles the use of chroma planes for motion estimation -(default: on). -. -.TP -.B (no)chroma_opt -Enable a chroma optimizer prefilter. -It will do some extra magic on color information to minimize the -stepped-stairs effect on edges. -It will improve quality at the cost of encoding speed. -It reduces PSNR by nature, as the mathematical deviation to the original -picture will get bigger, but the subjective image quality will raise. -Since it works with color information, you might want to turn it off when -encoding in grayscale. -. -.TP -.B (no)hq_ac -Activates high-quality prediction of AC coefficients for intra frames from -neighbor blocks (default: on). -. -.TP -.B vhq=<0\-4> -The motion search algorithm is based on a search in the usual color domain -and tries to find a motion vector that minimizes the difference between the -reference frame and the encoded frame. -With this setting activated, Xvid will also use the frequency domain (DCT) -to search for a motion vector that minimizes not only the spatial -difference but also the encoding length of the block. -Fastest to slowest: -.PD 0 -.RSs -.IPs 0 -off -.IPs 1 -mode decision (inter/\:intra MB) (default) -.IPs 2 -limited search -.IPs 3 -medium search -.IPs 4 -wide search -.RE -.PD 1 -. -.TP -.B (no)lumi_mask -Adaptive quantization allows the macroblock quantizers to vary inside -each frame. -This is a 'psychosensory' setting that is supposed to make use of the -fact that the human eye tends to notice fewer details in very bright -and very dark parts of the picture. -It compresses those areas more strongly than medium ones, which will -save bits that can be spent again on other frames, raising overall -subjective quality and possibly reducing PSNR. -. -.TP .B quant_intra_matrix=<filename> Load a custom intra matrix file. You can build such a file with xvid4conf's matrix editor.

1 0

r21011 - trunk/DOCS/man/en/mplayer.1
by gpoirier 18 Nov '06

18 Nov '06

Author: gpoirier Date: Sat Nov 18 13:16:52 2006 New Revision: 21011 Modified: trunk/DOCS/man/en/mplayer.1 Log: group together xvid's 'closed_gop' and 'packed' options Modified: trunk/DOCS/man/en/mplayer.1 ============================================================================== --- trunk/DOCS/man/en/mplayer.1 (original) +++ trunk/DOCS/man/en/mplayer.1 Sat Nov 18 13:16:52 2006 @@ -8598,23 +8598,6 @@ It is usually a good idea to turn this option on (default: on). . .TP -.B (no)grayscale -Make Xvid discard chroma planes so the encoded video is grayscale only. -Note that this does not speed up encoding, it just prevents chroma data -from being written in the last stage of encoding. -. -.TP -.B "debug\ \ " -Save per-frame statistics in ./xvid.dbg. (This is not the two pass control -file.) -.RE -. -.PP -.sp 1 -The following options are only available with the latest stable -releases of Xvid 1.0.x (api4). -. -.TP .B (no)packed This option is meant to solve frame-order issues when encoding to container formats like AVI that cannot cope with out-of-order frames. @@ -8632,6 +8615,18 @@ autodetection of some decoders might be confused. . .TP +.B (no)grayscale +Make Xvid discard chroma planes so the encoded video is grayscale only. +Note that this does not speed up encoding, it just prevents chroma data +from being written in the last stage of encoding. +. +.TP +.B "debug\ \ " +Save per-frame statistics in ./xvid.dbg. (This is not the two pass control +file.) +.RE +. +.TP .B max_bframes=<0\-4> Maximum number of B-frames to put between I/P-frames (default: 2). .

1 0

r21010 - trunk/DOCS/man/en/mplayer.1
by gpoirier 18 Nov '06

18 Nov '06

Author: gpoirier Date: Sat Nov 18 12:38:24 2006 New Revision: 21010 Modified: trunk/DOCS/man/en/mplayer.1 Log: remove xvid3's divx5bvop and replace it by xvid4's closed_gop Modified: trunk/DOCS/man/en/mplayer.1 ============================================================================== --- trunk/DOCS/man/en/mplayer.1 (original) +++ trunk/DOCS/man/en/mplayer.1 Sat Nov 18 12:38:24 2006 @@ -8590,12 +8590,12 @@ (default: 30). . .TP -.B divx5bvop -Generate DivX5 compatible B-frames (default: on). -This seems to be mandatory only for old versions of DivX's decoder. -.br -.I WARNING: -As of Xvid-1.0.x, this option is replaced by the closed_gop option. +.B (no)closed_gop +This option tells Xvid to close every GOP (Group Of Pictures bounded +by two I-frames), which makes GOPs independent from each other. +This just implies that the last frame of the GOP is either a P-frame or a +N-frame but not a B-frame. +It is usually a good idea to turn this option on (default: on). . .TP .B (no)grayscale @@ -8653,14 +8653,6 @@ aggressive production of B-frames may cause worse visual quality. . .TP -.B (no)closed_gop -This option tells Xvid to close every GOP (Group Of Pictures bounded -by two I-frames), which makes GOPs independent from each other. -This just implies that the last frame of the GOP is either a P-frame or a -N-frame but not a B-frame. -It is usually a good idea to turn this option on (default: on). -. -.TP .B frame_drop_ratio=<0\-100> (max_bframes=0 only) This setting allows the creation of variable framerate video streams. The value of the setting specifies a threshold under which, if the

1 0

r21008 - trunk/DOCS/man/en/mplayer.1
by gpoirier 18 Nov '06

18 Nov '06

Author: gpoirier Date: Sat Nov 18 12:34:40 2006 New Revision: 21008 Modified: trunk/DOCS/man/en/mplayer.1 Log: remove xvid3's mpeg_quant, replace it by xvid4's quant_type Modified: trunk/DOCS/man/en/mplayer.1 ============================================================================== --- trunk/DOCS/man/en/mplayer.1 (original) +++ trunk/DOCS/man/en/mplayer.1 Sat Nov 18 12:34:40 2006 @@ -8556,14 +8556,13 @@ maximum interval between keyframes (default: 10*fps) . .TP -.B mpeg_quant -Use MPEG quantizers instead of H.263. +.B quant_type=<h263|mpeg> +Sets the type of quantizer to use. For high bitrates, you will find that MPEG quantization preserves more detail. For low bitrates, the smoothing of H.263 will give you less block noise. -When using custom matrices, MPEG must be used. -.br -.I WARNING: -As of Xvid-1.0.x, this option is replaced by the quant_type option. +When using custom matrices, MPEG quantization +.B must +be used. . .TP .B keyframe_boost=<0\-1000> (two pass mode only) @@ -8709,15 +8708,6 @@ frame types and motion vectors for flat looking cartoons. . .TP -.B quant_type=<h263|mpeg> -Sets the type of quantizer to use. -For high bitrates, you will find that MPEG quantization preserves more detail. -For low bitrates, the smoothing of H.263 will give you less block noise. -When using custom matrices, MPEG quantization -.B must -be used. -. -.TP .B (no)chroma_me The usual motion estimation algorithm uses only the luminance information to find the best motion vector.

1 0

r21005 - trunk/DOCS/man/en/mplayer.1
by kraymer 18 Nov '06

18 Nov '06

Author: kraymer Date: Sat Nov 18 11:56:43 2006 New Revision: 21005 Modified: trunk/DOCS/man/en/mplayer.1 Log: document new "D" keybinding for deinterlacing, introduced in r20989: Add deinterlace property, patch by Carl Eugen Hoyos [..] Modified: trunk/DOCS/man/en/mplayer.1 ============================================================================== --- trunk/DOCS/man/en/mplayer.1 (original) +++ trunk/DOCS/man/en/mplayer.1 Sat Nov 18 11:56:43 2006 @@ -279,6 +279,8 @@ Show filename on the OSD. .IPs "! and @" Seek to the beginning of the previous/next chapter. +.IPs "D (\-vo xvmc only)" +Activate/deactivate deinterlacer. .RE .PD 1 .PP

1 0