FFmpeg
mpeg4audio.c
Go to the documentation of this file.
1 /*
2  * MPEG-4 Audio common code
3  * Copyright (c) 2008 Baptiste Coudurier <baptiste.coudurier@free.fr>
4  * Copyright (c) 2009 Alex Converse <alex.converse@gmail.com>
5  *
6  * This file is part of FFmpeg.
7  *
8  * FFmpeg is free software; you can redistribute it and/or
9  * modify it under the terms of the GNU Lesser General Public
10  * License as published by the Free Software Foundation; either
11  * version 2.1 of the License, or (at your option) any later version.
12  *
13  * FFmpeg is distributed in the hope that it will be useful,
14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16  * Lesser General Public License for more details.
17  *
18  * You should have received a copy of the GNU Lesser General Public
19  * License along with FFmpeg; if not, write to the Free Software
20  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
21  */
22 
23 #include "get_bits.h"
24 #include "put_bits.h"
25 #include "mpeg4audio.h"
26 
27 /**
28  * Parse MPEG-4 audio configuration for ALS object type.
29  * @param[in] gb bit reader context
30  * @param[in] c MPEG4AudioConfig structure to fill
31  * @return on success 0 is returned, otherwise a value < 0
32  */
33 static int parse_config_ALS(GetBitContext *gb, MPEG4AudioConfig *c, void *logctx)
34 {
35  if (get_bits_left(gb) < 112)
36  return AVERROR_INVALIDDATA;
37 
38  if (get_bits_long(gb, 32) != MKBETAG('A','L','S','\0'))
39  return AVERROR_INVALIDDATA;
40 
41  // override AudioSpecificConfig channel configuration and sample rate
42  // which are buggy in old ALS conformance files
43  c->sample_rate = get_bits_long(gb, 32);
44 
45  if (c->sample_rate <= 0) {
46  av_log(logctx, AV_LOG_ERROR, "Invalid sample rate %d\n", c->sample_rate);
47  return AVERROR_INVALIDDATA;
48  }
49 
50  // skip number of samples
51  skip_bits_long(gb, 32);
52 
53  // read number of channels
54  c->chan_config = 0;
55  c->channels = get_bits(gb, 16) + 1;
56 
57  return 0;
58 }
59 
60 /* XXX: make sure to update the copies in the different encoders if you change
61  * this table */
63  96000, 88200, 64000, 48000, 44100, 32000,
64  24000, 22050, 16000, 12000, 11025, 8000, 7350
65 };
66 
67 const uint8_t ff_mpeg4audio_channels[14] = {
68  0,
69  1, // mono (1/0)
70  2, // stereo (2/0)
71  3, // 3/0
72  4, // 3/1
73  5, // 3/2
74  6, // 3/2.1
75  8, // 5/2.1
76  0,
77  0,
78  0,
79  7, // 3/3.1
80  8, // 3/2/2.1
81  24 // 3/3/3 - 5/2/3 - 3/0/0.2
82 };
83 
84 static inline int get_object_type(GetBitContext *gb)
85 {
86  int object_type = get_bits(gb, 5);
87  if (object_type == AOT_ESCAPE)
88  object_type = 32 + get_bits(gb, 6);
89  return object_type;
90 }
91 
92 static inline int get_sample_rate(GetBitContext *gb, int *index)
93 {
94  *index = get_bits(gb, 4);
95  return *index == 0x0f ? get_bits(gb, 24) :
97 }
98 
100  int sync_extension, void *logctx)
101 {
102  int specific_config_bitindex, ret;
103  int start_bit_index = get_bits_count(gb);
104  c->object_type = get_object_type(gb);
105  c->sample_rate = get_sample_rate(gb, &c->sampling_index);
106  c->chan_config = get_bits(gb, 4);
107  if (c->chan_config < FF_ARRAY_ELEMS(ff_mpeg4audio_channels))
108  c->channels = ff_mpeg4audio_channels[c->chan_config];
109  else {
110  av_log(logctx, AV_LOG_ERROR, "Invalid chan_config %d\n", c->chan_config);
111  return AVERROR_INVALIDDATA;
112  }
113  c->sbr = -1;
114  c->ps = -1;
115  if (c->object_type == AOT_SBR || (c->object_type == AOT_PS &&
116  // check for W6132 Annex YYYY draft MP3onMP4
117  !(show_bits(gb, 3) & 0x03 && !(show_bits(gb, 9) & 0x3F)))) {
118  if (c->object_type == AOT_PS)
119  c->ps = 1;
120  c->ext_object_type = AOT_SBR;
121  c->sbr = 1;
122  c->ext_sample_rate = get_sample_rate(gb, &c->ext_sampling_index);
123  c->object_type = get_object_type(gb);
124  if (c->object_type == AOT_ER_BSAC)
125  c->ext_chan_config = get_bits(gb, 4);
126  } else {
127  c->ext_object_type = AOT_NULL;
128  c->ext_sample_rate = 0;
129  }
130  specific_config_bitindex = get_bits_count(gb);
131 
132  if (c->object_type == AOT_ALS) {
133  skip_bits(gb, 5);
134  if (show_bits(gb, 24) != MKBETAG('\0','A','L','S'))
135  skip_bits(gb, 24);
136 
137  specific_config_bitindex = get_bits_count(gb);
138 
139  ret = parse_config_ALS(gb, c, logctx);
140  if (ret < 0)
141  return ret;
142  }
143 
144  if (c->ext_object_type != AOT_SBR && sync_extension) {
145  while (get_bits_left(gb) > 15) {
146  if (show_bits(gb, 11) == 0x2b7) { // sync extension
147  get_bits(gb, 11);
148  c->ext_object_type = get_object_type(gb);
149  if (c->ext_object_type == AOT_SBR && (c->sbr = get_bits1(gb)) == 1) {
150  c->ext_sample_rate = get_sample_rate(gb, &c->ext_sampling_index);
151  if (c->ext_sample_rate == c->sample_rate)
152  c->sbr = -1;
153  }
154  if (get_bits_left(gb) > 11 && get_bits(gb, 11) == 0x548)
155  c->ps = get_bits1(gb);
156  break;
157  } else
158  get_bits1(gb); // skip 1 bit
159  }
160  }
161 
162  //PS requires SBR
163  if (!c->sbr)
164  c->ps = 0;
165  //Limit implicit PS to the HE-AACv2 Profile
166  if ((c->ps == -1 && c->object_type != AOT_AAC_LC) || c->channels & ~0x01)
167  c->ps = 0;
168 
169  return specific_config_bitindex - start_bit_index;
170 }
171 
173  int size, int sync_extension, void *logctx)
174 {
175  GetBitContext gb;
176  int ret;
177 
178  if (size <= 0)
179  return AVERROR_INVALIDDATA;
180 
181  ret = init_get_bits8(&gb, buf, size);
182  if (ret < 0)
183  return ret;
184 
185  return ff_mpeg4audio_get_config_gb(c, &gb, sync_extension, logctx);
186 }
get_sample_rate
static int get_sample_rate(GetBitContext *gb, int *index)
Definition: mpeg4audio.c:92
skip_bits_long
static void skip_bits_long(GetBitContext *s, int n)
Skips the specified number of bits.
Definition: get_bits.h:292
get_bits_left
static int get_bits_left(GetBitContext *gb)
Definition: get_bits.h:850
AOT_PS
@ AOT_PS
N Parametric Stereo.
Definition: mpeg4audio.h:102
get_bits_long
static unsigned int get_bits_long(GetBitContext *s, int n)
Read 0-32 bits.
Definition: get_bits.h:547
get_bits_count
static int get_bits_count(const GetBitContext *s)
Definition: get_bits.h:220
index
fg index
Definition: ffmpeg_filter.c:168
MPEG4AudioConfig
Definition: mpeg4audio.h:33
skip_bits
static void skip_bits(GetBitContext *s, int n)
Definition: get_bits.h:468
get_bits
static unsigned int get_bits(GetBitContext *s, int n)
Read 1-25 bits.
Definition: get_bits.h:380
mpeg4audio.h
AOT_ESCAPE
@ AOT_ESCAPE
Y Escape Value.
Definition: mpeg4audio.h:104
GetBitContext
Definition: get_bits.h:62
AV_LOG_ERROR
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
Definition: log.h:180
FF_ARRAY_ELEMS
#define FF_ARRAY_ELEMS(a)
Definition: sinewin_tablegen.c:29
init_get_bits8
static int init_get_bits8(GetBitContext *s, const uint8_t *buffer, int byte_size)
Initialize GetBitContext.
Definition: get_bits.h:678
avpriv_mpeg4audio_get_config2
int avpriv_mpeg4audio_get_config2(MPEG4AudioConfig *c, const uint8_t *buf, int size, int sync_extension, void *logctx)
Parse MPEG-4 systems extradata from a raw buffer to retrieve audio configuration.
Definition: mpeg4audio.c:172
get_bits.h
parse_config_ALS
static int parse_config_ALS(GetBitContext *gb, MPEG4AudioConfig *c, void *logctx)
Parse MPEG-4 audio configuration for ALS object type.
Definition: mpeg4audio.c:33
ff_mpeg4audio_channels
const uint8_t ff_mpeg4audio_channels[14]
Definition: mpeg4audio.c:67
get_bits1
static unsigned int get_bits1(GetBitContext *s)
Definition: get_bits.h:499
get_object_type
static int get_object_type(GetBitContext *gb)
Definition: mpeg4audio.c:84
c
Undefined Behavior In the C some operations are like signed integer dereferencing freed accessing outside allocated Undefined Behavior must not occur in a C it is not safe even if the output of undefined operations is unused The unsafety may seem nit picking but Optimizing compilers have in fact optimized code on the assumption that no undefined Behavior occurs Optimizing code based on wrong assumptions can and has in some cases lead to effects beyond the output of computations The signed integer overflow problem in speed critical code Code which is highly optimized and works with signed integers sometimes has the problem that often the output of the computation does not c
Definition: undefined.txt:32
size
int size
Definition: twinvq_data.h:10344
MKBETAG
#define MKBETAG(a, b, c, d)
Definition: macros.h:56
ff_mpeg4audio_get_config_gb
int ff_mpeg4audio_get_config_gb(MPEG4AudioConfig *c, GetBitContext *gb, int sync_extension, void *logctx)
Parse MPEG-4 systems extradata from a potentially unaligned GetBitContext to retrieve audio configura...
Definition: mpeg4audio.c:99
show_bits
static unsigned int show_bits(GetBitContext *s, int n)
Show 1-25 bits.
Definition: get_bits.h:447
AOT_NULL
@ AOT_NULL
Definition: mpeg4audio.h:75
AOT_ER_BSAC
@ AOT_ER_BSAC
N Error Resilient Bit-Sliced Arithmetic Coding.
Definition: mpeg4audio.h:95
ret
ret
Definition: filter_design.txt:187
AOT_SBR
@ AOT_SBR
Y Spectral Band Replication.
Definition: mpeg4audio.h:81
avpriv_mpeg4audio_sample_rates
const int avpriv_mpeg4audio_sample_rates[16]
Definition: mpeg4audio.c:62
AOT_ALS
@ AOT_ALS
Y Audio LosslesS.
Definition: mpeg4audio.h:109
av_log
#define av_log(a,...)
Definition: tableprint_vlc.h:28
AVERROR_INVALIDDATA
#define AVERROR_INVALIDDATA
Invalid data found when processing input.
Definition: error.h:61
put_bits.h
AOT_AAC_LC
@ AOT_AAC_LC
Y Low Complexity.
Definition: mpeg4audio.h:78