doc/ffmpeg-formats: reword and extend documentation for avoid_negative_ts option

Hopefully increase readability.
This commit is contained in:
Stefano Sabatini 2013-03-18 23:55:19 +01:00
parent 608bccf470
commit 2bac6b6f5e
1 changed files with 12 additions and 6 deletions

View File

@ -140,12 +140,18 @@ Consider things that a sane encoder should not do as an error.
Use wallclock as timestamps. Use wallclock as timestamps.
@item avoid_negative_ts @var{integer} (@emph{output}) @item avoid_negative_ts @var{integer} (@emph{output})
Shift timestamps to make them positive. 1 enables, 0 disables, default Shift timestamps to make them positive. A value of 1 enables shifting,
of -1 enables when required by target format. a value of 0 disables it, the default value of -1 enables shifting
When timestamps are shifted, all timestamps of a output file are shifted when required by the target format.
together by the same amount. AV sync, subtitle sync and relative timestamp
differences are preserved compared to how they would have been without When shifting is enabled, all output timestamps are shifted by the
shifting. same amount. Audio, video, and subtitles desynching and relative
timestamp differences are preserved compared to how they would have
been without shifting.
Also note that this affects only leading negative timestamps, and not
non-monotonic negative timestamps.
When avoid_negative_ts is used together with copyts, vsync or async then When avoid_negative_ts is used together with copyts, vsync or async then
avoid_negative_ts is applied last. This is neccessary so that containers avoid_negative_ts is applied last. This is neccessary so that containers
which do not support negative timestamps wont get any and can be used which do not support negative timestamps wont get any and can be used