From 59220d559b5077c15fa6434e42df95f3b92f0199 Mon Sep 17 00:00:00 2001 From: Justin Ruggles Date: Sun, 30 Dec 2012 17:00:00 -0500 Subject: oggenc: add a page_duration option and deprecate the pagesize option This uses page duration instead of byte size to determine when to buffer the page. Also, it tries to avoid continued pages by buffering the current page if there are already packets in the page and adding the next packet would require it to be continued on a new page. This can improve seeking performance. The default page duration is 1 second, which is much saner than filling all page segments by default. --- doc/muxers.texi | 15 +++++++++++++++ 1 file changed, 15 insertions(+) (limited to 'doc/muxers.texi') diff --git a/doc/muxers.texi b/doc/muxers.texi index 4973f1af1d..e368e684c5 100644 --- a/doc/muxers.texi +++ b/doc/muxers.texi @@ -434,4 +434,19 @@ avconv -i input.mp3 -i cover.png -c copy -metadata:s:v title="Album cover" -metadata:s:v comment="Cover (Front)" out.mp3 @end example +@section ogg + +Ogg container muxer. + +@table @option +@item -page_duration @var{duration} +Preferred page duration, in microseconds. The muxer will attempt to create +pages that are approximately @var{duration} microseconds long. This allows the +user to compromise between seek granularity and container overhead. The default +is 1 second. A value of 0 will fill all segments, making pages as large as +possible. A value of 1 will effectively use 1 packet-per-page in most +situations, giving a small seek granularity at the cost of additional container +overhead. +@end table + @c man end MUXERS -- cgit v1.2.3