From e18ba689db6d832697223def8ed79ad1f06105ed Mon Sep 17 00:00:00 2001 From: gpoirier Date: Sun, 7 Nov 2004 20:30:11 +0000 Subject: [PATCH] Some work on the XviD section: - better divx5bvop description - "new" (no)packed and (no)closed_gop options explained - more appropriate wordings git-svn-id: svn://svn.mplayerhq.hu/mplayer/trunk@13895 b3059339-0415-0410-9bf9-f77b7e298cf2 --- DOCS/man/en/mplayer.1 | 40 ++++++++++++++++++++++++++------------ DOCS/man/fr/mplayer.1 | 45 ++++++++++++++++++++++++++++++++----------- 2 files changed, 62 insertions(+), 23 deletions(-) diff --git a/DOCS/man/en/mplayer.1 b/DOCS/man/en/mplayer.1 index e79d7b6c37..518222e17c 100644 --- a/DOCS/man/en/mplayer.1 +++ b/DOCS/man/en/mplayer.1 @@ -33,7 +33,7 @@ .\" Title .\" -------------------------------------------------------------------------- . -.TH MPlayer 1 "2004-11-02" "The MPlayer Project" "The Movie Player" +.TH MPlayer 1 "2004-11-07" "The MPlayer Project" "The Movie Player" . .SH NAME mplayer \- movie player @@ -6495,8 +6495,8 @@ Use 4 motion vectors per macroblock. This might give better compression, but slows down encoding. .br .I WARNING: -This option is deprecated in XviD-1.0.x, as all is now taken care of -by the me_quality option. +As of XviD-1.0.x, this option is no longer available separately, and its +functionality is included in the me_quality option. When me_quality > 4, 4mv is activated. . .TP @@ -6525,7 +6525,7 @@ CBR mode: min & max quantizer for all frames (default: 2\-31) 2pass mode: min & max quantizer for I/\:P-frames (default: 2\-31/\:2\-31) .br .I WARNING: -This option is deprecated in XviD-1.0.x, and is replaced by the +As of XviD-1.0.x, this option is replaced by the [min|max]_[i|p|b]quant options. . .TP @@ -6544,8 +6544,7 @@ 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: -This option is deprecated in XviD-1.0.x, and is replaced by the quant_type -option. +As of XviD-1.0.x, this option is replaced by the quant_type option. . .TP .B mod_quant @@ -6557,7 +6556,7 @@ This will generate an illegal bitstream, and most likely not be decodable by any MPEG4 decoder besides libavcodec or XviD. .br .I WARNING: -This option is deprecated in XviD-1.0.x. +As of XviD-1.0.x, this option is no longer available. . .TP .B keyframe_boost=<0\-1000> @@ -6579,6 +6578,14 @@ The last I-frame will get treated normally. (default: 30, 2pass mode only) . .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. +. +.TP .B (no)greyscale Make XviD discard chroma planes so the encoded video is greyscale only. Note that this does not speed up encoding, it just prevents chroma data @@ -6597,7 +6604,12 @@ releases of XviD 1.0.x (api4). . .TP .B (no)packed -Create a bitstream which can be decoded delay-free. +This option is meant to solve frame-order issues when encoding to +container formats like AVI that cannot cope with out-of-order frames. +In practise, most decoders (both software and hardware) are able to deal +with frame-order themselves, and may get confused when this option is +turned on, so you can safely leave if off, unless you really know what +you are doing. .br .I WARNING: This will generate an illegal bitstream, and will not be @@ -6608,10 +6620,6 @@ This will also store a fake DivX version in the file so the bug autodetection of some decoders might be confused. . .TP -.B divx5bvop -Generate DivX5 compatible B-frames (default: on). -. -.TP .B max_bframes=<0\-4> Maximum number of B-frames to put between I/\:P-frames (default: 0). . @@ -6635,6 +6643,14 @@ The higher the value, the higher the probability of B-frames being used. (default: 0) . .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 eiter 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 diff --git a/DOCS/man/fr/mplayer.1 b/DOCS/man/fr/mplayer.1 index 70686d25ad..2f623443b1 100644 --- a/DOCS/man/fr/mplayer.1 +++ b/DOCS/man/fr/mplayer.1 @@ -1,4 +1,4 @@ -.\" synced with 1.800 +.\" synced with 1.801 .\" MPlayer (C) 2000-2004 MPlayer Team .\" This man page was/is done by Gabucino, Diego Biurrun, Jonas Jermann .\" Traduction: Nicolas Le Gaillart < nicolas AT legaillart.com > @@ -35,7 +35,7 @@ .\" Titre .\" -------------------------------------------------------------------------- . -.TH MPlayer 1 "2 Novembre 2004" "The MPlayer Project" "Le Lecteur Vidéo" +.TH MPlayer 1 "7 Novembre 2004" "The MPlayer Project" "Le Lecteur Vidéo" . .SH NAME mplayer \- Lecteur vidéo @@ -3010,7 +3010,7 @@ Transforme le flux vid et les stocke dans un fichier nommé 'stream.yuv' dans le répertoire courant. Ce format est identique à celui employé par la suite mjpegtools, ce qui peut vous être utile pour retraiter cette vidéo avec cette suite. -Ne que gère les formats YV12, RGB (24 bits/pixel) et BGR (24 bits/pixel). +Ne gère que les formats YV12, RGB (24 bits/pixel) et BGR (24 bits/pixel). .PD 0 .RSs .IPs interlaced @@ -6785,6 +6785,7 @@ redimentionnement adapt .B 4mv\ \ \ \ Utilise 4 vecteurs de mouvement par macro-bloc. Peut améliorer la compressibilité mais ralenti l'encodage. +.br .I ATTENTION\ : Cette option n'existe plus séparément avec XviD 1.0.x, mais est activée automatiquement quand me_quality > 4. @@ -6816,7 +6817,7 @@ mode 2passes\ : quantificateur min & max pour trames-I/\:P (par défaut\ : 2\-31/\:2\-31) .br .I ATTENTION\ : -Cette option est dépassée avec XviD-1.0.x, où elle est remplacée par les +À partir de XviD-1.0.x, cette option est remplacée par les options [min|max]_[i|p|b]quant. . .TP @@ -6837,19 +6838,20 @@ image o Si vous utilisez vos propres matrices de quantization, vous devez utiliser MPEG. .I ATTENTION\ : -Cette option est dépassée avec XviD-1.0.x, où elle est remplacée par l'option +À partir de XviD-1.0.x, cette option est remplacée par l'option quant_type. . .TP .B mod_quant Décide trame par trame d'utiliser ou non les quantificateurs MPEG ou H.263. +.br .I ATTENTION\ : Cette option génèrera un flux vidéo incompatible avec la norme MPEG4. Ainsi, ne pourrez-vous vraisemblablement le lire qu'avec libavcodec ou XviD. (mode 2passes uniquement) .br .I ATTENTION\ : -Cette option n'existe plus avec XviD-1.0.x. +Cette option n'existe plus à partir de XviD-1.0.x. . .TP .B keyframe_boost=<0\-1000> @@ -6871,6 +6873,15 @@ La derni (défaut\ : 0, mode 2passes uniquement) . .TP +.B divx5bvop +Génère des trames-B compatibles DivX5 (par défaut\ : on). +Ceci ne semble nécessaire qu'avec de vieilles versions du décodeur de DivX. +.br +.I ATTENTION\ : +À partir de XviD-1.0.x, cette option est remplacée par l'option +closed_gop. +. +.TP .B (no)greyscale Indique à XviD de ne pas enregistrer l'information de chroma pour que la vidéo produite ne soit qu'en noir & blanc. @@ -6890,7 +6901,14 @@ stables 1.0.x de XviD (api4). . .TP .B (no)packed -Crée un flux de bits pouvant être décodé sans délais. +Cette option a pour but de résoudre les problèmes de l'ordre des trames +lorsque l'encodage est fait vers un container comme AVI qui ne gère pas +les trames dans le désordre. +En pratique, la plupart des décodeurs (autant logiciels que matériels) +sont capables de gérer les trames dans le désordre eux-même, et peuvent +même être gênés lorsque cette option est activée, c'est pourquoi vous +pouvez sans problème laisser cette option désactivée, à moins de savoir +précisément ce que vous faites. .br .I ATTENTION\ : Ceci engendrera un flux de bits illégal vis à vis de la norme MPEG4, @@ -6901,10 +6919,6 @@ Ceci ajoutera l'autodétection de bogues risque de ne pas fonctionner. . .TP -.B divx5bvop -Génère des trames-B compatibles DivX5 (par défaut\ : on). -. -.TP .B max_bframes=<0\-4> Nombre maximum de trames-B à insérer entre les trames-I/\:P (par défaut\ : 0). . @@ -6928,6 +6942,15 @@ Plus la valeur est haute, plus la probabilit une trame-B est forte (par défaut\ : 0). . .TP +.B (no)closed_gop +Cette option demande à XviD de fermer chaque GOP (Group Of Pictures\ : +Groupe D'Images encadrées par deux trames-I), ce qui signifie que chaque +GOP sera indépendant des GOP suivants. +Ceci implique que la dernière trame du GOP est soit une trame-P ou une +trame-N, mais pas une trame-B. +Il est plutôt recommandé d'activer cette option (par défaut\ : activé) +. +.TP .B frame_drop_ratio=<0\-100> (max_bframes=0 uniquement) Cette option vous permet de créer les flux vidéo à débit de trame variable. Le paramètre définit un seuil en dessous duquel, si la différence