[FFmpeg-cvslog] doc/muxers: fix alphabetical sorting of entries

Gyan Doshi git at videolan.org
Wed Apr 7 12:17:05 EEST 2021


ffmpeg | branch: master | Gyan Doshi <ffmpeg at gyani.pro> | Wed Apr  7 14:59:44 2021 +0530| [c06465a70bd6e3a746f670e1d46d850d9233bfde] | committer: Gyan Doshi

doc/muxers: fix alphabetical sorting of entries

> http://git.videolan.org/gitweb.cgi/ffmpeg.git/?a=commit;h=c06465a70bd6e3a746f670e1d46d850d9233bfde
---

 doc/muxers.texi | 348 ++++++++++++++++++++++++++++----------------------------
 1 file changed, 174 insertions(+), 174 deletions(-)

diff --git a/doc/muxers.texi b/doc/muxers.texi
index 4c6eac1f84..5826d7e986 100644
--- a/doc/muxers.texi
+++ b/doc/muxers.texi
@@ -178,37 +178,6 @@ and the input video converted to MPEG-2 video, use the command:
 ffmpeg -i INPUT -c:a pcm_u8 -c:v mpeg2video -f crc -
 @end example
 
- at section flv
-
-Adobe Flash Video Format muxer.
-
-This muxer accepts the following options:
-
- at table @option
-
- at item flvflags @var{flags}
-Possible values:
-
- at table @samp
-
- at item aac_seq_header_detect
-Place AAC sequence header based on audio stream data.
-
- at item no_sequence_end
-Disable sequence end tag.
-
- at item no_metadata
-Disable metadata tag.
-
- at item no_duration_filesize
-Disable duration and filesize in metadata when they are equal to zero
-at the end of stream. (Be used to non-seekable living stream).
-
- at item add_keyframe_index
-Used to facilitate seeking; particularly for HTTP pseudo streaming.
- at end table
- at end table
-
 @anchor{dash}
 @section dash
 
@@ -385,6 +354,137 @@ adjusting playback latency and buffer occupancy during normal playback by client
 
 @end table
 
+ at anchor{fifo}
+ at section fifo
+
+The fifo pseudo-muxer allows the separation of encoding and muxing by using
+first-in-first-out queue and running the actual muxer in a separate thread. This
+is especially useful in combination with the @ref{tee} muxer and can be used to
+send data to several destinations with different reliability/writing speed/latency.
+
+API users should be aware that callback functions (interrupt_callback,
+io_open and io_close) used within its AVFormatContext must be thread-safe.
+
+The behavior of the fifo muxer if the queue fills up or if the output fails is
+selectable,
+
+ at itemize @bullet
+
+ at item
+output can be transparently restarted with configurable delay between retries
+based on real time or time of the processed stream.
+
+ at item
+encoding can be blocked during temporary failure, or continue transparently
+dropping packets in case fifo queue fills up.
+
+ at end itemize
+
+ at table @option
+
+ at item fifo_format
+Specify the format name. Useful if it cannot be guessed from the
+output name suffix.
+
+ at item queue_size
+Specify size of the queue (number of packets). Default value is 60.
+
+ at item format_opts
+Specify format options for the underlying muxer. Muxer options can be specified
+as a list of @var{key}=@var{value} pairs separated by ':'.
+
+ at item drop_pkts_on_overflow @var{bool}
+If set to 1 (true), in case the fifo queue fills up, packets will be dropped
+rather than blocking the encoder. This makes it possible to continue streaming without
+delaying the input, at the cost of omitting part of the stream. By default
+this option is set to 0 (false), so in such cases the encoder will be blocked
+until the muxer processes some of the packets and none of them is lost.
+
+ at item attempt_recovery @var{bool}
+If failure occurs, attempt to recover the output. This is especially useful
+when used with network output, since it makes it possible to restart streaming transparently.
+By default this option is set to 0 (false).
+
+ at item max_recovery_attempts
+Sets maximum number of successive unsuccessful recovery attempts after which
+the output fails permanently. By default this option is set to 0 (unlimited).
+
+ at item recovery_wait_time @var{duration}
+Waiting time before the next recovery attempt after previous unsuccessful
+recovery attempt. Default value is 5 seconds.
+
+ at item recovery_wait_streamtime @var{bool}
+If set to 0 (false), the real time is used when waiting for the recovery
+attempt (i.e. the recovery will be attempted after at least
+recovery_wait_time seconds).
+If set to 1 (true), the time of the processed stream is taken into account
+instead (i.e. the recovery will be attempted after at least @var{recovery_wait_time}
+seconds of the stream is omitted).
+By default, this option is set to 0 (false).
+
+ at item recover_any_error @var{bool}
+If set to 1 (true), recovery will be attempted regardless of type of the error
+causing the failure. By default this option is set to 0 (false) and in case of
+certain (usually permanent) errors the recovery is not attempted even when
+ at var{attempt_recovery} is set to 1.
+
+ at item restart_with_keyframe @var{bool}
+Specify whether to wait for the keyframe after recovering from
+queue overflow or failure. This option is set to 0 (false) by default.
+
+ at item timeshift @var{duration}
+Buffer the specified amount of packets and delay writing the output. Note that
+ at var{queue_size} must be big enough to store the packets for timeshift. At the
+end of the input the fifo buffer is flushed at realtime speed.
+
+ at end table
+
+ at subsection Examples
+
+ at itemize
+
+ at item
+Stream something to rtmp server, continue processing the stream at real-time
+rate even in case of temporary failure (network outage) and attempt to recover
+streaming every second indefinitely.
+ at example
+ffmpeg -re -i ... -c:v libx264 -c:a aac -f fifo -fifo_format flv -map 0:v -map 0:a
+  -drop_pkts_on_overflow 1 -attempt_recovery 1 -recovery_wait_time 1 rtmp://example.com/live/stream_name
+ at end example
+
+ at end itemize
+
+ at section flv
+
+Adobe Flash Video Format muxer.
+
+This muxer accepts the following options:
+
+ at table @option
+
+ at item flvflags @var{flags}
+Possible values:
+
+ at table @samp
+
+ at item aac_seq_header_detect
+Place AAC sequence header based on audio stream data.
+
+ at item no_sequence_end
+Disable sequence end tag.
+
+ at item no_metadata
+Disable metadata tag.
+
+ at item no_duration_filesize
+Disable duration and filesize in metadata when they are equal to zero
+at the end of stream. (Be used to non-seekable living stream).
+
+ at item add_keyframe_index
+Used to facilitate seeking; particularly for HTTP pseudo streaming.
+ at end table
+ at end table
+
 @anchor{framecrc}
 @section framecrc
 
@@ -2237,106 +2337,6 @@ ffmpeg -i INPUT -f streamhash -hash md5 -
 
 See also the @ref{hash} and @ref{framehash} muxers.
 
- at anchor{fifo}
- at section fifo
-
-The fifo pseudo-muxer allows the separation of encoding and muxing by using
-first-in-first-out queue and running the actual muxer in a separate thread. This
-is especially useful in combination with the @ref{tee} muxer and can be used to
-send data to several destinations with different reliability/writing speed/latency.
-
-API users should be aware that callback functions (interrupt_callback,
-io_open and io_close) used within its AVFormatContext must be thread-safe.
-
-The behavior of the fifo muxer if the queue fills up or if the output fails is
-selectable,
-
- at itemize @bullet
-
- at item
-output can be transparently restarted with configurable delay between retries
-based on real time or time of the processed stream.
-
- at item
-encoding can be blocked during temporary failure, or continue transparently
-dropping packets in case fifo queue fills up.
-
- at end itemize
-
- at table @option
-
- at item fifo_format
-Specify the format name. Useful if it cannot be guessed from the
-output name suffix.
-
- at item queue_size
-Specify size of the queue (number of packets). Default value is 60.
-
- at item format_opts
-Specify format options for the underlying muxer. Muxer options can be specified
-as a list of @var{key}=@var{value} pairs separated by ':'.
-
- at item drop_pkts_on_overflow @var{bool}
-If set to 1 (true), in case the fifo queue fills up, packets will be dropped
-rather than blocking the encoder. This makes it possible to continue streaming without
-delaying the input, at the cost of omitting part of the stream. By default
-this option is set to 0 (false), so in such cases the encoder will be blocked
-until the muxer processes some of the packets and none of them is lost.
-
- at item attempt_recovery @var{bool}
-If failure occurs, attempt to recover the output. This is especially useful
-when used with network output, since it makes it possible to restart streaming transparently.
-By default this option is set to 0 (false).
-
- at item max_recovery_attempts
-Sets maximum number of successive unsuccessful recovery attempts after which
-the output fails permanently. By default this option is set to 0 (unlimited).
-
- at item recovery_wait_time @var{duration}
-Waiting time before the next recovery attempt after previous unsuccessful
-recovery attempt. Default value is 5 seconds.
-
- at item recovery_wait_streamtime @var{bool}
-If set to 0 (false), the real time is used when waiting for the recovery
-attempt (i.e. the recovery will be attempted after at least
-recovery_wait_time seconds).
-If set to 1 (true), the time of the processed stream is taken into account
-instead (i.e. the recovery will be attempted after at least @var{recovery_wait_time}
-seconds of the stream is omitted).
-By default, this option is set to 0 (false).
-
- at item recover_any_error @var{bool}
-If set to 1 (true), recovery will be attempted regardless of type of the error
-causing the failure. By default this option is set to 0 (false) and in case of
-certain (usually permanent) errors the recovery is not attempted even when
- at var{attempt_recovery} is set to 1.
-
- at item restart_with_keyframe @var{bool}
-Specify whether to wait for the keyframe after recovering from
-queue overflow or failure. This option is set to 0 (false) by default.
-
- at item timeshift @var{duration}
-Buffer the specified amount of packets and delay writing the output. Note that
- at var{queue_size} must be big enough to store the packets for timeshift. At the
-end of the input the fifo buffer is flushed at realtime speed.
-
- at end table
-
- at subsection Examples
-
- at itemize
-
- at item
-Stream something to rtmp server, continue processing the stream at real-time
-rate even in case of temporary failure (network outage) and attempt to recover
-streaming every second indefinitely.
- at example
-ffmpeg -re -i ... -c:v libx264 -c:a aac -f fifo -fifo_format flv -map 0:v -map 0:a
-  -drop_pkts_on_overflow 1 -attempt_recovery 1 -recovery_wait_time 1 rtmp://example.com/live/stream_name
- at end example
-
- at end itemize
-
 @anchor{tee}
 @section tee
 
@@ -2469,6 +2469,49 @@ ffmpeg -i ... -map 0 -flags +global_header -c:v libx264 -c:a aac
 @end example
 @end itemize
 
+ at section webm_chunk
+
+WebM Live Chunk Muxer.
+
+This muxer writes out WebM headers and chunks as separate files which can be
+consumed by clients that support WebM Live streams via DASH.
+
+ at subsection Options
+
+This muxer supports the following options:
+
+ at table @option
+ at item chunk_start_index
+Index of the first chunk (defaults to 0).
+
+ at item header
+Filename of the header where the initialization data will be written.
+
+ at item audio_chunk_duration
+Duration of each audio chunk in milliseconds (defaults to 5000).
+ at end table
+
+ at subsection Example
+ at example
+ffmpeg -f v4l2 -i /dev/video0 \
+       -f alsa -i hw:0 \
+       -map 0:0 \
+       -c:v libvpx-vp9 \
+       -s 640x360 -keyint_min 30 -g 30 \
+       -f webm_chunk \
+       -header webm_live_video_360.hdr \
+       -chunk_start_index 1 \
+       webm_live_video_360_%d.chk \
+       -map 1:0 \
+       -c:a libvorbis \
+       -b:a 128k \
+       -f webm_chunk \
+       -header webm_live_audio_128.hdr \
+       -chunk_start_index 1 \
+       -audio_chunk_duration 1000 \
+       webm_live_audio_128_%d.chk
+ at end example
+
 @section webm_dash_manifest
 
 WebM DASH Manifest muxer.
@@ -2535,47 +2578,4 @@ ffmpeg -f webm_dash_manifest -i video1.webm \
        manifest.xml
 @end example
 
- at section webm_chunk
-
-WebM Live Chunk Muxer.
-
-This muxer writes out WebM headers and chunks as separate files which can be
-consumed by clients that support WebM Live streams via DASH.
-
- at subsection Options
-
-This muxer supports the following options:
-
- at table @option
- at item chunk_start_index
-Index of the first chunk (defaults to 0).
-
- at item header
-Filename of the header where the initialization data will be written.
-
- at item audio_chunk_duration
-Duration of each audio chunk in milliseconds (defaults to 5000).
- at end table
-
- at subsection Example
- at example
-ffmpeg -f v4l2 -i /dev/video0 \
-       -f alsa -i hw:0 \
-       -map 0:0 \
-       -c:v libvpx-vp9 \
-       -s 640x360 -keyint_min 30 -g 30 \
-       -f webm_chunk \
-       -header webm_live_video_360.hdr \
-       -chunk_start_index 1 \
-       webm_live_video_360_%d.chk \
-       -map 1:0 \
-       -c:a libvorbis \
-       -b:a 128k \
-       -f webm_chunk \
-       -header webm_live_audio_128.hdr \
-       -chunk_start_index 1 \
-       -audio_chunk_duration 1000 \
-       webm_live_audio_128_%d.chk
- at end example
-
 @c man end MUXERS



More information about the ffmpeg-cvslog mailing list