[FFmpeg-cvslog] doc/ffmpeg: document -channel_layout/ch_layout options

[Marton Balint]

ffmpeg | branch: master | Marton Balint <cus at passwd.hu> | Sat May 18 17:10:28 2024 +0200| [169b6ee732fdc35d0eb4be4d076d5265ce9b1304] | committer: Marton Balint

doc/ffmpeg: document -channel_layout/ch_layout options

Signed-off-by: Marton Balint <cus at passwd.hu>

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

 doc/ffmpeg.texi | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/doc/ffmpeg.texi b/doc/ffmpeg.texi
index da37e3ad37..f25f6192eb 100644
--- a/doc/ffmpeg.texi
+++ b/doc/ffmpeg.texi
@@ -1719,12 +1719,21 @@ 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})
+Alias for @code{-channel_layout}.
+ 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 of the
+input. Not all decoders respect the overridden channel layout. This option
+also sets the channel layout for audio grabbing devices and raw demuxers
+and is mapped to the corresponding demuxer 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
 tells to @command{ffmpeg} to recognize 1 channel as mono and 2 channels as
 stereo but not 6 channels as 5.1. The default is to always try to guess. Use
-0 to disable all guessing.
+0 to disable all guessing. Using the @code{-channel_layout} option to
+explicitly specify an input layout also disables guessing.
 @end table
 
 @section Subtitle options