mirror of
https://git.ffmpeg.org/ffmpeg.git
synced 2024-12-22 07:20:45 +00:00
doc/muxers/segment: apply minor documentation updates and adjustements
Update documentation to match code behavior after previous changes, also reword the examples section.
This commit is contained in:
parent
5eb4af6c59
commit
776a4e42a7
@ -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
|
||||||
|
Loading…
Reference in New Issue
Block a user