[MPlayer-dev-eng] [PATCH] Manpage update for vf_divtc

[Diego Biurrun]

Rich, OK to commit?

Diego

On Wed, Mar 02, 2005 at 07:32:20PM +0200, Ville Saari wrote:
> Here is a more thorough description of the two pass mode of vf_divtc
> for the manpage. Not necessarily easier to understand, but hopefully
> harder to misunderstand.
> 
> -- 
>  Ville

> --- DOCS/man/en/mplayer.1.orig	2005-03-02 11:34:18.659260000 +0200
> +++ DOCS/man/en/mplayer.1	2005-03-02 12:48:31.504550793 +0200
> @@ -4945,21 +4945,29 @@
>  This filter is intended to find and drop those duplicates and restore the
>  original film framerate.
>  When using this filter, you must specify \-ofps that is 4/\:5 of the fps of the
> -input file (23.976 if the input is 29.97fps).
> +input file and place the softskip later in the filter chain to make sure
> +that divtc sees all the frames. 
> +Two different modes are available:
> +One pass mode is the default and is straightforward to use, but has the
> +disadvantage that any changes in the telecine phase (lost frames or bad
> +edits) cause momentary judder until the filter can resync again.
> +Two pass mode avoids this by analyzing the whole video beforehand so it
> +will have forward knowledge about the phase changes and can resync at the
> +exact spot.
> +These passes do
> +.B not
> +correspond to pass one and two of the encoding process.
> +You must run an extra pass using divtc pass one before the actual encoding
> +throwing the resulting video away.
> +Use \-nosound \-ovc raw \-o /dev/null to avoid wasting cpu power for this pass.
> +You may add something like crop=2:2:0:0 after divtc to speed things up even
> +more.
> +Then use divtc pass two for the actual encoding.
> +If you use multiple encoder passes, use divtc pass two for all of them.
>  The options are:
>  .RSs
>  .IPs pass=1|2
>  Use two pass mode.
> -This produces best results.
> -Pass one analyzes the video and writes the results to a log file.
> -Pass two then reads this log file and uses the information to do
> -the actual work.
> -Note that these passes do
> -.B not
> -correspond to pass one and two of the encoding process.
> -In order to use divtc two pass with two pass video encoding, you must perform
> -three passes: first divtc pass one and encoder pass one, then divtc pass two
> -and encoder pass one, and finally divtc pass two and encoder pass two.
>  .IPs file=<filename>
>  Set the two pass log filename (default: "framediff.log").
>  .IPs threshold=<value>