diff mbox series

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

Message ID 20240519195258.13627-2-cus@passwd.hu
State Accepted
Commit 169b6ee732fdc35d0eb4be4d076d5265ce9b1304
Headers show
Series [FFmpeg-devel,v2,1/5] fftools/ffmpeg_demux: honor -ch_layout options for overriding input stream channel layout | expand


Context Check Description
yinshiyou/make_loongarch64 success Make finished
yinshiyou/make_fate_loongarch64 fail Make fate failed
andriy/make_x86 success Make finished
andriy/make_fate_x86 fail Make fate failed

Commit Message

Marton Balint May 19, 2024, 7:52 p.m. UTC
Signed-off-by: Marton Balint <cus@passwd.hu>
 doc/ffmpeg.texi | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)
diff mbox series


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}.
+@item -ch_layout[:@var{stream_specifier}] @var{layout} (@emph{input/output,per-stream})
+Alias for @code{-channel_layout}.
+@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