[FFmpeg-devel] [PATCH 2/5] doc/ffmpeg: document -channel_layout/ch_layout options

Marton Balint cus at passwd.hu
Sat May 18 19:11:13 EEST 2024


Signed-off-by: Marton Balint <cus at passwd.hu>
---
 doc/ffmpeg.texi | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/doc/ffmpeg.texi b/doc/ffmpeg.texi
index 83db6584fd..9b490f523f 100644
--- a/doc/ffmpeg.texi
+++ b/doc/ffmpeg.texi
@@ -1720,6 +1720,16 @@ This is an alias for @code{-filter:a}, see the @ref{filter_option,,-filter optio
 @table @option
 @item -atag @var{fourcc/tag} (@emph{output})
 Force audio tag/fourcc. This is an alias for @code{-tag:a}.
+ at item -ch_layout[:@var{stream_specifier}] @var{layout} (@emph{input/output,per-stream})
+ at item -channel_layout[:@var{stream_specifier}] @var{layout} (@emph{input/output,per-stream})
+Set the audio channel layout. For output streams it is set by default to the
+input channel layout. For input streams it overrides the channel layout if the
+decoder allows it. When used without a stream specifier it also sets the input
+channel layout for audio grabbing devices and raw demuxers and is mapped to the
+corresponding demuxer options.
+
+Note that specifying a channel layout also sets the channel count and this
+option has precedence over the @code{-ac} option.
 @item -guess_layout_max @var{channels} (@emph{input,per-stream})
 If some input channel layout is not known, try to guess only if it
 corresponds to at most the specified number of channels. For example, 2
-- 
2.35.3



More information about the ffmpeg-devel mailing list