mirror of
https://git.ffmpeg.org/ffmpeg.git
synced 2024-12-27 01:42:20 +00:00
9c22039c15
Also try to document the rational behind it. This might fix Ticket2376 Signed-off-by: Michael Niedermayer <michaelni@gmx.at>
182 lines
4.9 KiB
Plaintext
182 lines
4.9 KiB
Plaintext
\input texinfo @c -*- texinfo -*-
|
|
|
|
@settitle FFmpeg Formats Documentation
|
|
@titlepage
|
|
@center @titlefont{FFmpeg Formats Documentation}
|
|
@end titlepage
|
|
|
|
@top
|
|
|
|
@contents
|
|
|
|
@chapter Description
|
|
@c man begin DESCRIPTION
|
|
|
|
This document describes the supported formats (muxers and demuxers)
|
|
provided by the libavformat library.
|
|
|
|
@c man end DESCRIPTION
|
|
|
|
@chapter Format Options
|
|
@c man begin FORMAT OPTIONS
|
|
|
|
The libavformat library provides some generic global options, which
|
|
can be set on all the muxers and demuxers. In addition each muxer or
|
|
demuxer may support so-called private options, which are specific for
|
|
that component.
|
|
|
|
Options may be set by specifying -@var{option} @var{value} in the
|
|
FFmpeg tools, or by setting the value explicitly in the
|
|
@code{AVFormatContext} options or using the @file{libavutil/opt.h} API
|
|
for programmatic use.
|
|
|
|
The list of supported options follows:
|
|
|
|
@table @option
|
|
@item avioflags @var{flags} (@emph{input/output})
|
|
Possible values:
|
|
@table @samp
|
|
@item direct
|
|
Reduce buffering.
|
|
@end table
|
|
|
|
@item probesize @var{integer} (@emph{input})
|
|
Set probing size in bytes, i.e. the size of the data to analyze to get
|
|
stream information. A higher value will allow to detect more
|
|
information in case it is dispersed into the stream, but will increase
|
|
latency. Must be an integer not lesser than 32. It is 5000000 by default.
|
|
|
|
@item packetsize @var{integer} (@emph{output})
|
|
Set packet size.
|
|
|
|
@item fflags @var{flags} (@emph{input/output})
|
|
Set format flags.
|
|
|
|
Possible values:
|
|
@table @samp
|
|
@item ignidx
|
|
Ignore index.
|
|
@item genpts
|
|
Generate PTS.
|
|
@item nofillin
|
|
Do not fill in missing values that can be exactly calculated.
|
|
@item noparse
|
|
Disable AVParsers, this needs @code{+nofillin} too.
|
|
@item igndts
|
|
Ignore DTS.
|
|
@item discardcorrupt
|
|
Discard corrupted frames.
|
|
@item sortdts
|
|
Try to interleave output packets by DTS.
|
|
@item keepside
|
|
Do not merge side data.
|
|
@item latm
|
|
Enable RTP MP4A-LATM payload.
|
|
@item nobuffer
|
|
Reduce the latency introduced by optional buffering
|
|
@end table
|
|
|
|
@item analyzeduration @var{integer} (@emph{input})
|
|
Specify how many microseconds are analyzed to probe the input. A
|
|
higher value will allow to detect more accurate information, but will
|
|
increase latency. It defaults to 5,000,000 microseconds = 5 seconds.
|
|
|
|
@item cryptokey @var{hexadecimal string} (@emph{input})
|
|
Set decryption key.
|
|
|
|
@item indexmem @var{integer} (@emph{input})
|
|
Set max memory used for timestamp index (per stream).
|
|
|
|
@item rtbufsize @var{integer} (@emph{input})
|
|
Set max memory used for buffering real-time frames.
|
|
|
|
@item fdebug @var{flags} (@emph{input/output})
|
|
Print specific debug info.
|
|
|
|
Possible values:
|
|
@table @samp
|
|
@item ts
|
|
@end table
|
|
|
|
@item max_delay @var{integer} (@emph{input/output})
|
|
Set maximum muxing or demuxing delay in microseconds.
|
|
|
|
@item fpsprobesize @var{integer} (@emph{input})
|
|
Set number of frames used to probe fps.
|
|
|
|
@item audio_preload @var{integer} (@emph{output})
|
|
Set microseconds by which audio packets should be interleaved earlier.
|
|
|
|
@item chunk_duration @var{integer} (@emph{output})
|
|
Set microseconds for each chunk.
|
|
|
|
@item chunk_size @var{integer} (@emph{output})
|
|
Set size in bytes for each chunk.
|
|
|
|
@item err_detect, f_err_detect @var{flags} (@emph{input})
|
|
Set error detection flags. @code{f_err_detect} is deprecated and
|
|
should be used only via the @command{ffmpeg} tool.
|
|
|
|
Possible values:
|
|
@table @samp
|
|
@item crccheck
|
|
Verify embedded CRCs.
|
|
@item bitstream
|
|
Detect bitstream specification deviations.
|
|
@item buffer
|
|
Detect improper bitstream length.
|
|
@item explode
|
|
Abort decoding on minor error detection.
|
|
@item careful
|
|
Consider things that violate the spec and have not been seen in the
|
|
wild as errors.
|
|
@item compliant
|
|
Consider all spec non compliancies as errors.
|
|
@item aggressive
|
|
Consider things that a sane encoder should not do as an error.
|
|
@end table
|
|
|
|
@item use_wallclock_as_timestamps @var{integer} (@emph{input})
|
|
Use wallclock as timestamps.
|
|
|
|
@item avoid_negative_ts @var{integer} (@emph{output})
|
|
Shift timestamps to make them positive. 1 enables, 0 disables, default
|
|
of -1 enables when required by target format.
|
|
When timestamps are shifted, all timestamps of a output file are shifted
|
|
together by the same amount. AV sync, subtitle sync and relative timestamp
|
|
differences are preserved compared to how they would have been without
|
|
shifting.
|
|
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
|
|
which do not support negative timestamps wont get any and can be used
|
|
with vsync/async and copyts.
|
|
@end table
|
|
|
|
@c man end FORMAT OPTIONS
|
|
|
|
@include demuxers.texi
|
|
@include muxers.texi
|
|
@include metadata.texi
|
|
|
|
@chapter See Also
|
|
|
|
@ifhtml
|
|
@url{ffmpeg.html,ffmpeg}, @url{ffplay.html,ffplay}, @url{ffprobe.html,ffprobe}, @url{ffserver.html,ffserver},
|
|
@url{libavformat.html,libavformat}
|
|
@end ifhtml
|
|
|
|
@ifnothtml
|
|
ffmpeg(1), ffplay(1), ffprobe(1), ffserver(1), libavformat(3)
|
|
@end ifnothtml
|
|
|
|
@include authors.texi
|
|
|
|
@ignore
|
|
|
|
@setfilename ffmpeg-formats
|
|
@settitle FFmpeg formats
|
|
|
|
@end ignore
|
|
|
|
@bye
|