diff options
author | Anton Khirnov <anton@khirnov.net> | 2012-05-28 09:28:58 +0400 |
---|---|---|
committer | Anton Khirnov <anton@khirnov.net> | 2012-06-22 23:26:18 +0400 |
commit | dc07fb6f7b8fe0f7febdd89e21d23ac50ae920ec (patch) | |
tree | 6a75b72b01de016e3f86db97a80f53904f43913f /doc | |
parent | f75be9856a99739b2c22ed73a3c51df0f54a5ce9 (diff) |
lavfi: add join audio filter.
It joins multiple input streams into one multi-channel output.
Diffstat (limited to 'doc')
-rw-r--r-- | doc/filters.texi | 37 |
1 files changed, 37 insertions, 0 deletions
diff --git a/doc/filters.texi b/doc/filters.texi index f17dad8051..e40f8798cc 100644 --- a/doc/filters.texi +++ b/doc/filters.texi @@ -232,6 +232,43 @@ front_center.wav -map '[LFE]' lfe.wav -map '[SL]' side_left.wav -map '[SR]' side_right.wav @end example +@section join +Join multiple input streams into one multi-channel stream. + +The filter accepts the following named parameters: +@table @option + +@item inputs +Number of input streams. Defaults to 2. + +@item channel_layout +Desired output channel layout. Defaults to stereo. + +@item map +Map channels from inputs to output. The argument is a comma-separated list of +mappings, each in the @code{@var{input_idx}.@var{in_channel}-@var{out_channel}} +form. @var{input_idx} is the 0-based index of the input stream. @var{in_channel} +can be either the name of the input channel (e.g. FR for front left) or its +index in the specified input stream. @var{out_channel} is the name of the output +channel. +@end table + +The filter will attempt to guess the mappings when those are not specified +explicitly. It does so by first trying to find an unused matching input channel +and if that fails it picks the first unused input channel. + +E.g. to join 3 inputs (with properly set channel layouts) +@example +avconv -i INPUT1 -i INPUT2 -i INPUT3 -filter_complex join=inputs=3 OUTPUT +@end example + +To build a 5.1 output from 6 single-channel streams: +@example +avconv -i fl -i fr -i fc -i sl -i sr -i lfe -filter_complex +'join=inputs=6:channel_layout=5.1:map=0.0-FL\,1.0-FR\,2.0-FC\,3.0-SL\,4.0-SR\,5.0-LFE' +out +@end example + @section resample Convert the audio sample format, sample rate and channel layout. This filter is not meant to be used directly, it is inserted automatically by libavfilter |