[FFmpeg-cvslog] doc/filters/apad: extend documentation

Stefano Sabatini git at videolan.org
Thu Aug 21 17:23:40 CEST 2014


ffmpeg | branch: master | Stefano Sabatini <stefasab at gmail.com> | Mon Aug 18 14:52:08 2014 +0200| [7e4a4bda0e5a86c7b6b47d36c356499109688cc5] | committer: Stefano Sabatini

doc/filters/apad: extend documentation

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

 doc/filters.texi |   54 ++++++++++++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 52 insertions(+), 2 deletions(-)

diff --git a/doc/filters.texi b/doc/filters.texi
index a20253a..8badc54 100644
--- a/doc/filters.texi
+++ b/doc/filters.texi
@@ -742,8 +742,58 @@ Pass the audio source unchanged to the output.
 
 @section apad
 
-Pad the end of a audio stream with silence, this can be used together with
--shortest to extend audio streams to the same length as the video stream.
+Pad the end of an audio stream with silence.
+
+This can be used together with @command{ffmpeg} @option{-shortest} to
+extend audio streams to the same length as the video stream.
+
+A description of the accepted options follows.
+
+ at table @option
+ at item packet_size
+Set silence packet size. Default value is 4096.
+
+ at item pad_len
+Set the number of samples of silence to add to the end. After the
+value is reached, the stream is terminated. This option is mutually
+exclusive with @option{whole_len}.
+
+ at item whole_len
+Set the minimum total number of samples in the output audio stream. If
+the value is longer than the input audio length, silence is added to
+the end, until the value is reached. This option is mutually exclusive
+with @option{pad_len}.
+ at end table
+
+If neither the @option{pad_len} nor the @option{whole_len} option is
+set, the filter will add silence to the end of the input stream
+indefinitely.
+
+ at subsection Examples
+
+ at itemize
+ at item
+Add 1024 samples of silence to the end of the input:
+ at example
+apad=pad_len=1024
+ at end example
+
+ at item
+Make sure the audio output will contain at least 10000 samples, pad
+the input with silence if required:
+ at example
+apad=whole_len=10000
+ at end example
+
+ at item
+Use @command{ffmpeg} to pad the audio input with silence, so that the
+video stream will always result the shortest and will be converted
+until the end in the output file when using the @option{shortest}
+option:
+ at example
+ffmpeg -i VIDEO -i AUDIO -filter_complex "[1:0]apad" -shortest OUTPUT
+ at end example
+ at end itemize
 
 @section aphaser
 Add a phasing effect to the input audio.



More information about the ffmpeg-cvslog mailing list