Merge remote-tracking branch 'qatar/master'
authorMichael Niedermayer <michaelni@gmx.at>
Wed, 28 Aug 2013 11:03:09 +0000 (13:03 +0200)
committerMichael Niedermayer <michaelni@gmx.at>
Wed, 28 Aug 2013 11:03:09 +0000 (13:03 +0200)
* qatar/master:
  doc: document the asf demuxer

Conflicts:
doc/demuxers.texi

Merged-by: Michael Niedermayer <michaelni@gmx.at>
1  2 
doc/demuxers.texi

@@@ -18,127 -18,6 +18,138 @@@ enabled demuxers
  
  The description of some of the currently available demuxers follows.
  
- @item -flv_demuxer @var{bool}
 +@section applehttp
 +
 +Apple HTTP Live Streaming demuxer.
 +
 +This demuxer presents all AVStreams from all variant streams.
 +The id field is set to the bitrate variant index number. By setting
 +the discard flags on AVStreams (by pressing 'a' or 'v' in ffplay),
 +the caller can decide which variant streams to actually receive.
 +The total bitrate of the variant that the stream belongs to is
 +available in a metadata key named "variant_bitrate".
 +
++@section asf
++
++Advanced Systems Format demuxer.
++
++This demuxer is used to demux ASF files and MMS network streams.
++
++@table @option
++@item -no_resync_search @var{bool}
++Do not try to resynchronize by looking for a certain optional start code.
++@end table
++
 +@anchor{concat}
 +@section concat
 +
 +Virtual concatenation script demuxer.
 +
 +This demuxer reads a list of files and other directives from a text file and
 +demuxes them one after the other, as if all their packet had been muxed
 +together.
 +
 +The timestamps in the files are adjusted so that the first file starts at 0
 +and each next file starts where the previous one finishes. Note that it is
 +done globally and may cause gaps if all streams do not have exactly the same
 +length.
 +
 +All files must have the same streams (same codecs, same time base, etc.).
 +
 +The duration of each file is used to adjust the timestamps of the next file:
 +if the duration is incorrect (because it was computed using the bit-rate or
 +because the file is truncated, for example), it can cause artifacts. The
 +@code{duration} directive can be used to override the duration stored in
 +each file.
 +
 +@subsection Syntax
 +
 +The script is a text file in extended-ASCII, with one directive per line.
 +Empty lines, leading spaces and lines starting with '#' are ignored. The
 +following directive is recognized:
 +
 +@table @option
 +
 +@item @code{file @var{path}}
 +Path to a file to read; special characters and spaces must be escaped with
 +backslash or single quotes.
 +
 +All subsequent directives apply to that file.
 +
 +@item @code{ffconcat version 1.0}
 +Identify the script type and version. It also sets the @option{safe} option
 +to 1 if it was to its default -1.
 +
 +To make FFmpeg recognize the format automatically, this directive must
 +appears exactly as is (no extra space or byte-order-mark) on the very first
 +line of the script.
 +
 +@item @code{duration @var{dur}}
 +Duration of the file. This information can be specified from the file;
 +specifying it here may be more efficient or help if the information from the
 +file is not available or accurate.
 +
 +If the duration is set for all files, then it is possible to seek in the
 +whole concatenated video.
 +
 +@end table
 +
 +@subsection Options
 +
 +This demuxer accepts the following option:
 +
 +@table @option
 +
 +@item safe
 +If set to 1, reject unsafe file paths. A file path is considered safe if it
 +does not contain a protocol specification and is relative and all components
 +only contain characters from the portable character set (letters, digits,
 +period, underscore and hyphen) and have no period at the beginning of a
 +component.
 +
 +If set to 0, any file name is accepted.
 +
 +The default is -1, it is equivalent to 1 if the format was automatically
 +probed and 0 otherwise.
 +
 +@end table
 +
 +@section flv
 +
 +Adobe Flash Video Format demuxer.
 +
 +This demuxer is used to demux FLV files and RTMP network streams.
 +
 +@table @option
++@item -flv_metadata @var{bool}
 +Allocate the streams according to the onMetaData array content.
 +@end table
 +
 +@section libgme
 +
 +The Game Music Emu library is a collection of video game music file emulators.
 +
 +See @url{http://code.google.com/p/game-music-emu/} for more information.
 +
 +Some files have multiple tracks. The demuxer will pick the first track by
 +default. The @option{track_index} option can be used to select a different
 +track. Track indexes start at 0. The demuxer exports the number of tracks as
 +@var{tracks} meta data entry.
 +
 +For very large files, the @option{max_size} option may have to be adjusted.
 +
 +@section libquvi
 +
 +Play media from Internet services using the quvi project.
 +
 +The demuxer accepts a @option{format} option to request a specific quality. It
 +is by default set to @var{best}.
 +
 +See @url{http://quvi.sourceforge.net/} for more information.
 +
 +FFmpeg needs to be built with @code{--enable-libquvi} for this demuxer to be
 +enabled.
 +
  @section image2
  
  Image file demuxer.