summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorPaul B Mahol <onemda@gmail.com>2018-03-20 18:02:26 +0100
committerPaul B Mahol <onemda@gmail.com>2018-03-23 10:11:19 +0100
commit4e1307c0f76d015941a1217bcd44a20f25e04fad (patch)
tree85d536d3c70992dbe230ea075edcc6c4e0a6ea88 /doc
parentabf35afb6f70f2b1fdf99ce48112ad314bd8ca0f (diff)
avfilter/af_channelsplit: add channels option
So user can pick which channels to extract. Signed-off-by: Paul B Mahol <onemda@gmail.com>
Diffstat (limited to 'doc')
-rw-r--r--doc/filters.texi18
1 files changed, 18 insertions, 0 deletions
diff --git a/doc/filters.texi b/doc/filters.texi
index d6ea56b851..870c50441b 100644
--- a/doc/filters.texi
+++ b/doc/filters.texi
@@ -2208,8 +2208,17 @@ It accepts the following parameters:
@table @option
@item channel_layout
The channel layout of the input stream. The default is "stereo".
+@item channels
+A channel layout describing the channels to be extracted as separate output streams
+or "all" to extract each input channel as a separate stream. The default is "all".
+
+Choosing channels not present in channel layout in the input will result in an error.
@end table
+@subsection Examples
+
+@itemize
+@item
For example, assuming a stereo input MP3 file,
@example
ffmpeg -i in.mp3 -filter_complex channelsplit out.mkv
@@ -2217,6 +2226,7 @@ ffmpeg -i in.mp3 -filter_complex channelsplit out.mkv
will create an output Matroska file with two audio streams, one containing only
the left channel and the other the right channel.
+@item
Split a 5.1 WAV file into per-channel files:
@example
ffmpeg -i in.wav -filter_complex
@@ -2226,6 +2236,14 @@ front_center.wav -map '[LFE]' lfe.wav -map '[SL]' side_left.wav -map '[SR]'
side_right.wav
@end example
+@item
+Extract only LFE from a 5.1 WAV file:
+@example
+ffmpeg -i in.wav -filter_complex 'channelsplit=channel_layout=5.1:channels=LFE[LFE]'
+-map '[LFE]' lfe.wav
+@end example
+@end itemize
+
@section chorus
Add a chorus effect to the audio.