generic-library/ffmpeg
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

doc/muxers/segment: apply minor documentation updates and adjustements

Browse Source 
Update documentation to match code behavior after previous changes, also
reword the examples section.
This commit is contained in:
Stefano Sabatini 2012-01-14 11:25:45 +01:00
parent 5eb4af6c59
commit 776a4e42a7
1 changed files with 35 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

40
doc/muxers.texi
View File

@ -411,7 +411,7 @@ For example a 3D WebM clip can be created using the following command line:
ffmpeg -i sample_left_right_clip.mpg -an -c:v libvpx -metadata stereo_mode=left_right -y stereo_clip.webm ffmpeg -i sample_left_right_clip.mpg -an -c:v libvpx -metadata stereo_mode=left_right -y stereo_clip.webm
@end example @end example
@section segment @section segment, stream_segment, ssegment
Basic stream segmenter. Basic stream segmenter.
@ -419,30 +419,60 @@ The segmenter muxer outputs streams to a number of separate files of nearly
fixed duration. Output filename pattern can be set in a fashion similar to fixed duration. Output filename pattern can be set in a fashion similar to
@ref{image2}. @ref{image2}.
@code{stream_segment} is a variant of the muxer used to write to
streaming output formats, i.e. which do not require global headers,
and is recommended for outputting e.g. to MPEG transport stream segments.
@code{ssegment} is a shorter alias for @code{stream_segment}.
Every segment starts with a video keyframe, if a video stream is present. Every segment starts with a video keyframe, if a video stream is present.
Note that if you want accurate splitting for a video file, you need to
make the input key frames correspond to the exact splitting times
expected by the segmenter, or the segment muxer will start the new
segment with the key frame found next after the specified start
time.
The segment muxer works best with a single constant frame rate video. The segment muxer works best with a single constant frame rate video.
Optionally it can generate a flat list of the created segments, one segment Optionally it can generate a flat list of the created segments, one segment
per line. per line, by setting the option @var{segment_list}.
The segment muxer supports the following options:
@table @option @table @option
@item segment_format @var{format} @item segment_format @var{format}
Override the inner container format, by default it is guessed by the filename Override the inner container format, by default it is guessed by the filename
extension. extension.
@item segment_time @var{t} @item segment_time @var{t}
Set segment duration to @var{t} seconds. Set segment duration to @var{t} seconds. Default value is 2.
@item segment_list @var{name} @item segment_list @var{name}
Generate also a listfile named @var{name}. Generate also a listfile named @var{name}. If not specified no
listfile is generated.
@item segment_list_size @var{size} @item segment_list_size @var{size}
Overwrite the listfile once it reaches @var{size} entries. Overwrite the listfile once it reaches @var{size} entries. If 0
the listfile is never overwritten. Default value is 5.
@item segment_wrap @var{limit} @item segment_wrap @var{limit}
Wrap around segment index once it reaches @var{limit}. Wrap around segment index once it reaches @var{limit}.
@end table @end table
Some examples follow.
@itemize
@item
To remux the content of file @file{in.mkv} to a list of segments
@file{out-000.nut}, @file{out-001.nut}, etc., and write the list of
generated segments to @file{out.list}:
@example @example
ffmpeg -i in.mkv -codec copy -map 0 -f segment -segment_list out.list out%03d.nut ffmpeg -i in.mkv -codec copy -map 0 -f segment -segment_list out.list out%03d.nut
@end example @end example
@item
To convert the @file{in.mkv} to TS segments using the @code{libx264}
and @code{libfaac} encoders:
@example
ffmpeg -i in.mkv -map 0 -codec:v libx264 -codec:a libfaac -f ssegment -segment_list out.list out%03d.ts
@end example
@end itemize
@section mp3 @section mp3
The MP3 muxer writes a raw MP3 stream with an ID3v2 header at the beginning and The MP3 muxer writes a raw MP3 stream with an ID3v2 header at the beginning and