diff options
| author | Marton Balint <cus@passwd.hu> | 2016-12-26 01:19:34 +0100 |
|---|---|---|
| committer | Marton Balint <cus@passwd.hu> | 2017-01-24 23:51:36 +0100 |
| commit | c4618f842a2de85097627763f02931afc3fde6d9 (patch) | |
| tree | 3ce0700ff1dfa7f52726aa984558c04cc3e5209f /doc/utils.texi | |
| parent | 5049f05f27c20f0606209bf3508e1157e0eabc9e (diff) | |
avutil/channel_layout: add av_get_extended_channel_layout
Return a channel layout and the number of channels based on the specified name.
This function is similar to av_get_channel_layout(), but can also parse unknown
channel layout specifications.
Unknown channel layout specifications are a decimal number and a capital 'C'
suffix, in order to not break compatibility with the lowercase 'c' suffix,
which is used for a guessed channel layout with the specified number of
channels.
Signed-off-by: Marton Balint <cus@passwd.hu>
Diffstat (limited to 'doc/utils.texi')
| -rw-r--r-- | doc/utils.texi | 7 |
1 files changed, 6 insertions, 1 deletions
diff --git a/doc/utils.texi b/doc/utils.texi index df887c7768..30a962ac0e 100644 --- a/doc/utils.texi +++ b/doc/utils.texi @@ -725,13 +725,18 @@ layout for that number of channels (see the function default layout. @item +a number of channels, in decimal, followed by 'C', yielding an unknown channel +layout with the specified number of channels. Note that not all channel layout +specification strings support unknown channel layouts. + +@item a channel layout mask, in hexadecimal starting with "0x" (see the @code{AV_CH_*} macros in @file{libavutil/channel_layout.h}. @end itemize Before libavutil version 53 the trailing character "c" to specify a number of channels was optional, but now it is required, while a channel layout mask can -also be specified as a decimal number (if and only if not followed by "c"). +also be specified as a decimal number (if and only if not followed by "c" or "C"). See also the function @code{av_get_channel_layout} defined in @file{libavutil/channel_layout.h}. |