1 /* -----------------------------------------------------------------------------
2 Software License for The Fraunhofer FDK AAC Codec Library for Android
3
4 © Copyright 1995 - 2019 Fraunhofer-Gesellschaft zur Förderung der angewandten
5 Forschung e.V. All rights reserved.
6
7 1. INTRODUCTION
8 The Fraunhofer FDK AAC Codec Library for Android ("FDK AAC Codec") is software
9 that implements the MPEG Advanced Audio Coding ("AAC") encoding and decoding
10 scheme for digital audio. This FDK AAC Codec software is intended to be used on
11 a wide variety of Android devices.
12
13 AAC's HE-AAC and HE-AAC v2 versions are regarded as today's most efficient
14 general perceptual audio codecs. AAC-ELD is considered the best-performing
15 full-bandwidth communications codec by independent studies and is widely
16 deployed. AAC has been standardized by ISO and IEC as part of the MPEG
17 specifications.
18
19 Patent licenses for necessary patent claims for the FDK AAC Codec (including
20 those of Fraunhofer) may be obtained through Via Licensing
21 (www.vialicensing.com) or through the respective patent owners individually for
22 the purpose of encoding or decoding bit streams in products that are compliant
23 with the ISO/IEC MPEG audio standards. Please note that most manufacturers of
24 Android devices already license these patent claims through Via Licensing or
25 directly from the patent owners, and therefore FDK AAC Codec software may
26 already be covered under those patent licenses when it is used for those
27 licensed purposes only.
28
29 Commercially-licensed AAC software libraries, including floating-point versions
30 with enhanced sound quality, are also available from Fraunhofer. Users are
31 encouraged to check the Fraunhofer website for additional applications
32 information and documentation.
33
34 2. COPYRIGHT LICENSE
35
36 Redistribution and use in source and binary forms, with or without modification,
37 are permitted without payment of copyright license fees provided that you
38 satisfy the following conditions:
39
40 You must retain the complete text of this software license in redistributions of
41 the FDK AAC Codec or your modifications thereto in source code form.
42
43 You must retain the complete text of this software license in the documentation
44 and/or other materials provided with redistributions of the FDK AAC Codec or
45 your modifications thereto in binary form. You must make available free of
46 charge copies of the complete source code of the FDK AAC Codec and your
47 modifications thereto to recipients of copies in binary form.
48
49 The name of Fraunhofer may not be used to endorse or promote products derived
50 from this library without prior written permission.
51
52 You may not charge copyright license fees for anyone to use, copy or distribute
53 the FDK AAC Codec software or your modifications thereto.
54
55 Your modified versions of the FDK AAC Codec must carry prominent notices stating
56 that you changed the software and the date of any change. For modified versions
57 of the FDK AAC Codec, the term "Fraunhofer FDK AAC Codec Library for Android"
58 must be replaced by the term "Third-Party Modified Version of the Fraunhofer FDK
59 AAC Codec Library for Android."
60
61 3. NO PATENT LICENSE
62
63 NO EXPRESS OR IMPLIED LICENSES TO ANY PATENT CLAIMS, including without
64 limitation the patents of Fraunhofer, ARE GRANTED BY THIS SOFTWARE LICENSE.
65 Fraunhofer provides no warranty of patent non-infringement with respect to this
66 software.
67
68 You may use this FDK AAC Codec software or modifications thereto only for
69 purposes that are authorized by appropriate patent licenses.
70
71 4. DISCLAIMER
72
73 This FDK AAC Codec software is provided by Fraunhofer on behalf of the copyright
74 holders and contributors "AS IS" and WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES,
75 including but not limited to the implied warranties of merchantability and
76 fitness for a particular purpose. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
77 CONTRIBUTORS BE LIABLE for any direct, indirect, incidental, special, exemplary,
78 or consequential damages, including but not limited to procurement of substitute
79 goods or services; loss of use, data, or profits, or business interruption,
80 however caused and on any theory of liability, whether in contract, strict
81 liability, or tort (including negligence), arising in any way out of the use of
82 this software, even if advised of the possibility of such damage.
83
84 5. CONTACT INFORMATION
85
86 Fraunhofer Institute for Integrated Circuits IIS
87 Attention: Audio and Multimedia Departments - FDK AAC LL
88 Am Wolfsmantel 33
89 91058 Erlangen, Germany
90
91 www.iis.fraunhofer.de/amm
92 amm-info@iis.fraunhofer.de
93 ----------------------------------------------------------------------------- */
94
95 /**************************** AAC encoder library ******************************
96
97 Author(s): M. Schug / A. Groeschel
98
99 Description: bandwidth expert
100
101 *******************************************************************************/
102
103 #include "channel_map.h"
104 #include "bandwidth.h"
105 #include "aacEnc_ram.h"
106
107 typedef struct {
108 INT chanBitRate;
109 INT bandWidthMono;
110 INT bandWidth2AndMoreChan;
111
112 } BANDWIDTH_TAB;
113
114 static const BANDWIDTH_TAB bandWidthTable[] = {
115 {0, 3700, 5000}, {12000, 5000, 6400}, {20000, 6900, 9640},
116 {28000, 9600, 13050}, {40000, 12060, 14260}, {56000, 13950, 15500},
117 {72000, 14200, 16120}, {96000, 17000, 17000}, {576001, 17000, 17000}};
118
119 static const BANDWIDTH_TAB bandWidthTable_LD_22050[] = {
120 {8000, 2000, 2400}, {12000, 2500, 2700}, {16000, 3300, 3100},
121 {24000, 6250, 7200}, {32000, 9200, 10500}, {40000, 16000, 16000},
122 {48000, 16000, 16000}, {282241, 16000, 16000}};
123
124 static const BANDWIDTH_TAB bandWidthTable_LD_24000[] = {
125 {8000, 2000, 2000}, {12000, 2000, 2300}, {16000, 2200, 2500},
126 {24000, 5650, 7200}, {32000, 11600, 12000}, {40000, 12000, 16000},
127 {48000, 16000, 16000}, {64000, 16000, 16000}, {307201, 16000, 16000}};
128
129 static const BANDWIDTH_TAB bandWidthTable_LD_32000[] = {
130 {8000, 2000, 2000}, {12000, 2000, 2000}, {24000, 4250, 7200},
131 {32000, 8400, 9000}, {40000, 9400, 11300}, {48000, 11900, 14700},
132 {64000, 14800, 16000}, {76000, 16000, 16000}, {409601, 16000, 16000}};
133
134 static const BANDWIDTH_TAB bandWidthTable_LD_44100[] = {
135 {8000, 2000, 2000}, {24000, 2000, 2000}, {32000, 4400, 5700},
136 {40000, 7400, 8800}, {48000, 9000, 10700}, {56000, 11000, 12900},
137 {64000, 14400, 15500}, {80000, 16000, 16200}, {96000, 16500, 16000},
138 {128000, 16000, 16000}, {564481, 16000, 16000}};
139
140 static const BANDWIDTH_TAB bandWidthTable_LD_48000[] = {
141 {8000, 2000, 2000}, {24000, 2000, 2000}, {32000, 4400, 5700},
142 {40000, 7400, 8800}, {48000, 9000, 10700}, {56000, 11000, 12800},
143 {64000, 14300, 15400}, {80000, 16000, 16200}, {96000, 16500, 16000},
144 {128000, 16000, 16000}, {614401, 16000, 16000}};
145
146 typedef struct {
147 AACENC_BITRATE_MODE bitrateMode;
148 int bandWidthMono;
149 int bandWidth2AndMoreChan;
150 } BANDWIDTH_TAB_VBR;
151
152 static const BANDWIDTH_TAB_VBR bandWidthTableVBR[] = {
153 {AACENC_BR_MODE_CBR, 0, 0},
154 {AACENC_BR_MODE_VBR_1, 13000, 13000},
155 {AACENC_BR_MODE_VBR_2, 13000, 13000},
156 {AACENC_BR_MODE_VBR_3, 15750, 15750},
157 {AACENC_BR_MODE_VBR_4, 16500, 16500},
158 {AACENC_BR_MODE_VBR_5, 19293, 19293},
159 {AACENC_BR_MODE_SFR, 0, 0},
160 {AACENC_BR_MODE_FF, 0, 0}
161
162 };
163
GetBandwidthEntry(const INT frameLength,const INT sampleRate,const INT chanBitRate,const INT entryNo)164 static INT GetBandwidthEntry(const INT frameLength, const INT sampleRate,
165 const INT chanBitRate, const INT entryNo) {
166 INT bandwidth = -1;
167 const BANDWIDTH_TAB *pBwTab = NULL;
168 INT bwTabSize = 0;
169
170 switch (frameLength) {
171 case 960:
172 case 1024:
173 pBwTab = bandWidthTable;
174 bwTabSize = sizeof(bandWidthTable) / sizeof(BANDWIDTH_TAB);
175 break;
176 case 120:
177 case 128:
178 case 240:
179 case 256:
180 case 480:
181 case 512:
182 switch (sampleRate) {
183 case 8000:
184 case 11025:
185 case 12000:
186 case 16000:
187 case 22050:
188 pBwTab = bandWidthTable_LD_22050;
189 bwTabSize = sizeof(bandWidthTable_LD_22050) / sizeof(BANDWIDTH_TAB);
190 break;
191 case 24000:
192 pBwTab = bandWidthTable_LD_24000;
193 bwTabSize = sizeof(bandWidthTable_LD_24000) / sizeof(BANDWIDTH_TAB);
194 break;
195 case 32000:
196 pBwTab = bandWidthTable_LD_32000;
197 bwTabSize = sizeof(bandWidthTable_LD_32000) / sizeof(BANDWIDTH_TAB);
198 break;
199 case 44100:
200 pBwTab = bandWidthTable_LD_44100;
201 bwTabSize = sizeof(bandWidthTable_LD_44100) / sizeof(BANDWIDTH_TAB);
202 break;
203 case 48000:
204 case 64000:
205 case 88200:
206 case 96000:
207 pBwTab = bandWidthTable_LD_48000;
208 bwTabSize = sizeof(bandWidthTable_LD_48000) / sizeof(BANDWIDTH_TAB);
209 break;
210 }
211 break;
212 default:
213 pBwTab = NULL;
214 bwTabSize = 0;
215 }
216
217 if (pBwTab != NULL) {
218 int i;
219 for (i = 0; i < bwTabSize - 1; i++) {
220 if (chanBitRate >= pBwTab[i].chanBitRate &&
221 chanBitRate < pBwTab[i + 1].chanBitRate) {
222 switch (frameLength) {
223 case 960:
224 case 1024:
225 bandwidth = (entryNo == 0) ? pBwTab[i].bandWidthMono
226 : pBwTab[i].bandWidth2AndMoreChan;
227 break;
228 case 120:
229 case 128:
230 case 240:
231 case 256:
232 case 480:
233 case 512: {
234 INT q_res = 0;
235 INT startBw = (entryNo == 0) ? pBwTab[i].bandWidthMono
236 : pBwTab[i].bandWidth2AndMoreChan;
237 INT endBw = (entryNo == 0) ? pBwTab[i + 1].bandWidthMono
238 : pBwTab[i + 1].bandWidth2AndMoreChan;
239 INT startBr = pBwTab[i].chanBitRate;
240 INT endBr = pBwTab[i + 1].chanBitRate;
241
242 FIXP_DBL bwFac_fix =
243 fDivNorm(chanBitRate - startBr, endBr - startBr, &q_res);
244 bandwidth =
245 (INT)scaleValue(fMult(bwFac_fix, (FIXP_DBL)(endBw - startBw)),
246 q_res) +
247 startBw;
248 } break;
249 default:
250 bandwidth = -1;
251 }
252 break;
253 } /* within bitrate range */
254 }
255 } /* pBwTab!=NULL */
256
257 return bandwidth;
258 }
259
FDKaacEnc_DetermineBandWidth(const INT proposedBandWidth,const INT bitrate,const AACENC_BITRATE_MODE bitrateMode,const INT sampleRate,const INT frameLength,const CHANNEL_MAPPING * const cm,const CHANNEL_MODE encoderMode,INT * const bandWidth)260 AAC_ENCODER_ERROR FDKaacEnc_DetermineBandWidth(
261 const INT proposedBandWidth, const INT bitrate,
262 const AACENC_BITRATE_MODE bitrateMode, const INT sampleRate,
263 const INT frameLength, const CHANNEL_MAPPING *const cm,
264 const CHANNEL_MODE encoderMode, INT *const bandWidth) {
265 AAC_ENCODER_ERROR ErrorStatus = AAC_ENC_OK;
266 INT chanBitRate = bitrate / cm->nChannelsEff;
267
268 switch (bitrateMode) {
269 case AACENC_BR_MODE_VBR_1:
270 case AACENC_BR_MODE_VBR_2:
271 case AACENC_BR_MODE_VBR_3:
272 case AACENC_BR_MODE_VBR_4:
273 case AACENC_BR_MODE_VBR_5:
274 if (proposedBandWidth != 0) {
275 /* use given bw */
276 *bandWidth = proposedBandWidth;
277 } else {
278 /* take bw from table */
279 switch (encoderMode) {
280 case MODE_1:
281 *bandWidth = bandWidthTableVBR[bitrateMode].bandWidthMono;
282 break;
283 case MODE_2:
284 case MODE_1_2:
285 case MODE_1_2_1:
286 case MODE_1_2_2:
287 case MODE_1_2_2_1:
288 case MODE_6_1:
289 case MODE_1_2_2_2_1:
290 case MODE_7_1_REAR_SURROUND:
291 case MODE_7_1_FRONT_CENTER:
292 case MODE_7_1_BACK:
293 case MODE_7_1_TOP_FRONT:
294 *bandWidth = bandWidthTableVBR[bitrateMode].bandWidth2AndMoreChan;
295 break;
296 default:
297 return AAC_ENC_UNSUPPORTED_CHANNELCONFIG;
298 }
299 }
300 break;
301 case AACENC_BR_MODE_CBR:
302 case AACENC_BR_MODE_SFR:
303 case AACENC_BR_MODE_FF:
304
305 /* bandwidth limiting */
306 if (proposedBandWidth != 0) {
307 *bandWidth = fMin(proposedBandWidth, fMin(20000, sampleRate >> 1));
308 } else { /* search reasonable bandwidth */
309
310 int entryNo = 0;
311
312 switch (encoderMode) {
313 case MODE_1: /* mono */
314 entryNo = 0; /* use mono bandwidth settings */
315 break;
316
317 case MODE_2: /* stereo */
318 case MODE_1_2: /* sce + cpe */
319 case MODE_1_2_1: /* sce + cpe + sce */
320 case MODE_1_2_2: /* sce + cpe + cpe */
321 case MODE_1_2_2_1: /* (5.1) sce + cpe + cpe + lfe */
322 case MODE_6_1:
323 case MODE_1_2_2_2_1:
324 case MODE_7_1_REAR_SURROUND:
325 case MODE_7_1_FRONT_CENTER:
326 case MODE_7_1_BACK:
327 case MODE_7_1_TOP_FRONT:
328 entryNo = 1; /* use stereo bandwidth settings */
329 break;
330
331 default:
332 return AAC_ENC_UNSUPPORTED_CHANNELCONFIG;
333 }
334
335 *bandWidth =
336 GetBandwidthEntry(frameLength, sampleRate, chanBitRate, entryNo);
337
338 if (*bandWidth == -1) {
339 switch (frameLength) {
340 case 120:
341 case 128:
342 case 240:
343 case 256:
344 *bandWidth = 16000;
345 break;
346 default:
347 ErrorStatus = AAC_ENC_INVALID_CHANNEL_BITRATE;
348 }
349 }
350 }
351 break;
352 default:
353 *bandWidth = 0;
354 return AAC_ENC_UNSUPPORTED_BITRATE_MODE;
355 }
356
357 *bandWidth = fMin(*bandWidth, sampleRate / 2);
358
359 return ErrorStatus;
360 }
361