From 5ee03c86bc86effa7d8bedf91bcb59006c9ce24a Mon Sep 17 00:00:00 2001 From: Fabrice Bellard Date: Sun, 24 Aug 2003 21:34:12 +0000 Subject: [PATCH] update Originally committed as revision 2155 to svn://svn.ffmpeg.org/ffmpeg/trunk --- doc/TODO | 4 +-- doc/ffmpeg-doc.texi | 79 +++++++++++++++++++++++++------------------ doc/ffserver-doc.texi | 3 +- 3 files changed, 50 insertions(+), 36 deletions(-) diff --git a/doc/TODO b/doc/TODO index d1412a649b..59928a7eea 100644 --- a/doc/TODO +++ b/doc/TODO @@ -9,13 +9,13 @@ Short term: - seeking API and example in ffplay - parse_only mode - use AVFMTCTX_DISCARD_PKT in ffplay so that DV has a chance to work -- fix windows compile -- add man page +- add RTSP regression test (both client and server) - make ffserver allocate AVFormatContext - clean up (incompatible change, for 0.5.0): * AVStream -> AVComponent * AVFormatContext -> AVInputStream/AVOutputStream * CODEC_ID_MP3LAME and CODEC_ID_MP2 -> CODEC_ID_MPEGAUDIO + * suppress rate_emu from AVCodecContext - add av_log() in libavcodec and suppress all printf - add new float/integer audio filterting and conversion : suppress CODEC_ID_PCM_xxc and use CODEC_ID_RAWAUDIO. diff --git a/doc/ffmpeg-doc.texi b/doc/ffmpeg-doc.texi index 771f1e54ee..58b2a69c4b 100644 --- a/doc/ffmpeg-doc.texi +++ b/doc/ffmpeg-doc.texi @@ -198,9 +198,9 @@ set the video bitrate in kbit/s (default = 200 kb/s) @item -r fps set frame rate (default = 25) @item -s size -set frame size. The format is @samp{WxH}. (default 160x128) -The following abbreviations are regognized: -@table @sampe +set frame size. The format is @samp{WxH} (default 160x128). The +following abbreviations are recognized: +@table @samp @item sqcif 128x96 @item qcif @@ -232,15 +232,19 @@ set min video bitrate tolerance (in kbit/s) @item -bufsize size set ratecontrol buffere size (in kbit) @item -vcodec codec -force video codec +force video codec to @var{codec}. Use the @code{copy} special value to +tell that the raw codec data must be copied as is. @item -sameq use same video quality as source (implies VBR) @item -pass n -select the pass number (1 or 2). It is useful to do two pass encoding. The statistics of the video are recorded in the first pass and the video at the exact requested bit rate is generated in the second pass. +select the pass number (1 or 2). It is useful to do two pass +encoding. The statistics of the video are recorded in the first pass and +the video at the exact requested bit rate is generated in the second +pass. @item -passlogfile file -select two pass log file name +select two pass log file name to @var{file}. @end table @@ -275,14 +279,16 @@ qp offset between p and b frames @item -i_qoffset offset qp offset between p and i frames @item -rc_eq equation -set rate control equation (@pxref{FFmpeg formula evaluator}) -@item -rc_override override_string -rate control override for specific internals +set rate control equation (@pxref{FFmpeg formula +evaluator}). Default is @code{tex^qComp}. +@item -rc_override override +rate control override for specific intervals @item -me method -set motion estimation method. Available methods are (from lower to best quality): +set motion estimation method to @var{method}. Available methods are +(from lower to best quality): @table @samp @item zero -Try just (0, 0) vector. +Try just the (0, 0) vector. @item phods @item log @item x1 @@ -293,7 +299,7 @@ exhaustive search (slow and marginally better than epzs) @end table @item -dct_algo algo -set dct algo +set dct algorithm to @var{algo}. Available values are: @table @samp @item 0 FF_DCT_AUTO (default) @@ -310,7 +316,7 @@ FF_DCT_ALTIVEC @end table @item -idct_algo algo -set idct algo +set idct algorithm to @var{algo}. Available values are: @table @samp @item 0 FF_IDCT_AUTO (default) @@ -337,25 +343,26 @@ FF_IDCT_SIMPLEARM @end table @item -er n -set error resilience to 'n' +set error resilience to @var{n}. @table @samp @item 1 -FF_ER_CAREFULL +FF_ER_CAREFULL (default) @item 2 -FF_ER_COMPLIANT (default) +FF_ER_COMPLIANT @item 3 FF_ER_AGGRESSIVE @item 4 FF_ER_VERY_AGGRESSIVE @end table -@item -ec n -set error concealment to n +@item -ec bit_mask +set error concealment to @var{bit_mask}. @var{bit_mask} is a bit mask of +the following values: @table @samp @item 1 -FF_EC_GUESS_MVS +FF_EC_GUESS_MVS (default=enabled) @item 2 -FF_EC_DEBLOCK +FF_EC_DEBLOCK (default=enabled) @end table @item -bf frames @@ -379,20 +386,20 @@ use data partitioning (only MPEG-4) workaround not auto detected encoder bugs @item -strict strictness how strictly to follow the standarts +@item -aic +enable Advanced intra coding (h263+) +@item -umv +enable Unlimited Motion Vector (h263+) @item -deinterlace deinterlace pictures @item -psnr calculate PSNR of compressed frames @item -vstats -dump video coding statistics to file +dump video coding statistics to @file{vstats_HHMMSS.log}. @item -vhook module insert video processing @var{module}. @var{module} contains the module name and its parameters separated by spaces. -@item -aic -enable Advanced intra coding (h263+) -@item -umv -enable Unlimited Motion Vector (h263+) @end table @section Audio Options @@ -401,15 +408,16 @@ enable Unlimited Motion Vector (h263+) @item -ab bitrate set audio bitrate (in kbit/s) @item -ar freq - set the audio sampling freq (default = 44100 Hz) +set the audio sampling freq (default = 44100 Hz) @item -ab bitrate - set the audio bitrate in kbit/s (default = 64) +set the audio bitrate in kbit/s (default = 64) @item -ac channels - set the number of audio channels (default = 1) -@item -an - disable audio recording -@item -acodec codec -force audio codec +set the number of audio channels (default = 1) +@item -an +disable audio recording +@item -acodec codec +force audio codec to @var{codec}. Use the @code{copy} special value to +tell that the raw codec data must be copied as is. @end table @section Audio/Video grab options @@ -442,6 +450,11 @@ dump each input packet only use bit exact algorithms (for codec testing) @item -ps size set packet size in bits +@item -re +read input at native frame rate. Mainly used to simulate a grab device. +@item -loop +loop over the input stream. Currently it works only for image +streams. This option is used for ffserver automatic testing. @end table @node FFmpeg formula evaluator @@ -827,7 +840,7 @@ as well. Run 'make test' to test all the codecs. -Run 'make libavtest' to test all the codecs. +Run 'make fulltest' to test all the codecs, formats and ffserver. [Of course, some patches may change the regression tests results. In this case, the regression tests reference results shall be modified diff --git a/doc/ffserver-doc.texi b/doc/ffserver-doc.texi index f6ddb71b27..87ea5b90e0 100644 --- a/doc/ffserver-doc.texi +++ b/doc/ffserver-doc.texi @@ -210,7 +210,8 @@ use @file{configfile} instead of @file{/etc/ffserver.conf} @settitle FFserver video server @c man begin SEEALSO -ffmpeg(1), ffplay(1) and the html documentation of @file{ffmpeg}. +ffmpeg(1), ffplay(1), the @file{ffmpeg/doc/ffserver.conf} example and +the html documentation of @file{ffmpeg}. @c man end @c man begin AUTHOR