• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 /* -----------------------------------------------------------------------------
2 Software License for The Fraunhofer FDK AAC Codec Library for Android
3 
4 © Copyright  1995 - 2018 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 /******************* Library for basic calculation routines ********************
96 
97    Author(s):
98 
99    Description: matrix memory allocation
100 
101 *******************************************************************************/
102 
103 #include "FDK_matrixCalloc.h"
104 
105 #include "genericStds.h"
106 
fdkCallocMatrix1D_aligned(UINT dim1,UINT size)107 void *fdkCallocMatrix1D_aligned(UINT dim1, UINT size) {
108   return FDKaalloc(dim1 * size, ALIGNMENT_DEFAULT);
109 }
110 
fdkCallocMatrix1D_int(UINT dim,UINT size,MEMORY_SECTION s)111 void *fdkCallocMatrix1D_int(UINT dim, UINT size, MEMORY_SECTION s) {
112   return FDKcalloc_L(dim, size, s);
113 }
114 
fdkCallocMatrix1D_int_aligned(UINT dim,UINT size,MEMORY_SECTION s)115 void *fdkCallocMatrix1D_int_aligned(UINT dim, UINT size, MEMORY_SECTION s) {
116   return FDKaalloc_L(dim * size, ALIGNMENT_DEFAULT, s);
117 }
118 
fdkFreeMatrix1D(void * p)119 void fdkFreeMatrix1D(void *p) {
120   if (p != NULL) {
121     FDKfree_L(p);
122   }
123 }
124 
fdkFreeMatrix1D_aligned(void * p)125 void fdkFreeMatrix1D_aligned(void *p) {
126   if (p != NULL) {
127     FDKafree_L(p);
128   }
129 }
130 
fdkCallocMatrix1D(UINT dim1,UINT size)131 void *fdkCallocMatrix1D(UINT dim1, UINT size) { return FDKcalloc(dim1, size); }
132 
133 /* 2D */
fdkCallocMatrix2D(UINT dim1,UINT dim2,UINT size)134 void **fdkCallocMatrix2D(UINT dim1, UINT dim2, UINT size) {
135   void **p1;
136   UINT i;
137   char *p2;
138   if (!dim1 || !dim2) return NULL;
139   if ((p1 = (void **)fdkCallocMatrix1D(dim1, sizeof(void *))) == NULL) {
140     goto bail;
141   }
142   if ((p2 = (char *)fdkCallocMatrix1D(dim1 * dim2, size)) == NULL) {
143     fdkFreeMatrix1D(p1);
144     p1 = NULL;
145     goto bail;
146   }
147   for (i = 0; i < dim1; i++) {
148     p1[i] = p2;
149     p2 += dim2 * size;
150   }
151 bail:
152   return p1;
153 }
154 
fdkCallocMatrix2D_aligned(UINT dim1,UINT dim2,UINT size)155 void **fdkCallocMatrix2D_aligned(UINT dim1, UINT dim2, UINT size) {
156   void **p1;
157   UINT i;
158   char *p2;
159   if (!dim1 || !dim2) return NULL;
160   if ((p1 = (void **)fdkCallocMatrix1D(dim1, sizeof(void *))) == NULL) {
161     goto bail;
162   }
163   if ((p2 = (char *)fdkCallocMatrix1D_aligned(dim1 * dim2, size)) == NULL) {
164     fdkFreeMatrix1D(p1);
165     p1 = NULL;
166     goto bail;
167   }
168   for (i = 0; i < dim1; i++) {
169     p1[i] = p2;
170     p2 += dim2 * size;
171   }
172 bail:
173   return p1;
174 }
175 
fdkFreeMatrix2D(void ** p)176 void fdkFreeMatrix2D(void **p) {
177   if (!p) return;
178   fdkFreeMatrix1D(p[0]);
179   fdkFreeMatrix1D(p);
180 }
181 
fdkFreeMatrix2D_aligned(void ** p)182 void fdkFreeMatrix2D_aligned(void **p) {
183   if (!p) return;
184   fdkFreeMatrix1D_aligned(p[0]);
185   fdkFreeMatrix1D(p);
186 }
187 
fdkCallocMatrix2D_int(UINT dim1,UINT dim2,UINT size,MEMORY_SECTION s)188 void **fdkCallocMatrix2D_int(UINT dim1, UINT dim2, UINT size,
189                              MEMORY_SECTION s) {
190   void **p1;
191   UINT i;
192   char *p2;
193 
194   if (!dim1 || !dim2) return NULL;
195   if ((p1 = (void **)fdkCallocMatrix1D_int(dim1, sizeof(void *), s)) == NULL) {
196     goto bail;
197   }
198   if ((p2 = (char *)fdkCallocMatrix1D_int(dim1 * dim2, size, s)) == NULL) {
199     fdkFreeMatrix1D(p1);
200     p1 = NULL;
201     goto bail;
202   }
203   for (i = 0; i < dim1; i++) {
204     p1[i] = p2;
205     p2 += dim2 * size;
206   }
207 bail:
208   return p1;
209 }
210 
fdkCallocMatrix2D_int_aligned(UINT dim1,UINT dim2,UINT size,MEMORY_SECTION s)211 void **fdkCallocMatrix2D_int_aligned(UINT dim1, UINT dim2, UINT size,
212                                      MEMORY_SECTION s) {
213   void **p1;
214   UINT i;
215   char *p2;
216 
217   if (!dim1 || !dim2) return NULL;
218   if ((p1 = (void **)fdkCallocMatrix1D_int(dim1, sizeof(void *), s)) == NULL) {
219     goto bail;
220   }
221   if ((p2 = (char *)fdkCallocMatrix1D_int_aligned(dim1 * dim2, size, s)) ==
222       NULL) {
223     fdkFreeMatrix1D(p1);
224     p1 = NULL;
225     goto bail;
226   }
227   for (i = 0; i < dim1; i++) {
228     p1[i] = p2;
229     p2 += dim2 * size;
230   }
231 bail:
232   return p1;
233 }
234 
235 /* 3D */
fdkCallocMatrix3D(UINT dim1,UINT dim2,UINT dim3,UINT size)236 void ***fdkCallocMatrix3D(UINT dim1, UINT dim2, UINT dim3, UINT size) {
237   void ***p1;
238   UINT i, j;
239   void **p2;
240   char *p3;
241 
242   if (!dim1 || !dim2 || !dim3) return NULL;
243   if ((p1 = (void ***)fdkCallocMatrix1D(dim1, sizeof(void **))) == NULL) {
244     goto bail;
245   }
246   if ((p2 = (void **)fdkCallocMatrix1D(dim1 * dim2, sizeof(void *))) == NULL) {
247     fdkFreeMatrix1D(p1);
248     p1 = NULL;
249     goto bail;
250   }
251   p1[0] = p2;
252   if ((p3 = (char *)fdkCallocMatrix1D(dim1 * dim2 * dim3, size)) == NULL) {
253     fdkFreeMatrix1D(p1);
254     fdkFreeMatrix1D(p2);
255     p1 = NULL;
256     p2 = NULL;
257     goto bail;
258   }
259   for (i = 0; i < dim1; i++) {
260     p1[i] = p2;
261     for (j = 0; j < dim2; j++) {
262       p2[j] = p3;
263       p3 += dim3 * size;
264     }
265     p2 += dim2;
266   }
267 bail:
268   return p1;
269 }
270 
fdkFreeMatrix3D(void *** p)271 void fdkFreeMatrix3D(void ***p) {
272   if (!p) return;
273   if (p[0] != NULL) fdkFreeMatrix1D(p[0][0]);
274   fdkFreeMatrix1D(p[0]);
275   fdkFreeMatrix1D(p);
276 }
277 
fdkCallocMatrix3D_int(UINT dim1,UINT dim2,UINT dim3,UINT size,MEMORY_SECTION s)278 void ***fdkCallocMatrix3D_int(UINT dim1, UINT dim2, UINT dim3, UINT size,
279                               MEMORY_SECTION s) {
280   void ***p1;
281   UINT i, j;
282   void **p2;
283   char *p3;
284 
285   if (!dim1 || !dim2 || !dim3) return NULL;
286   if ((p1 = (void ***)fdkCallocMatrix1D_int(dim1, sizeof(void **), s)) ==
287       NULL) {
288     goto bail;
289   }
290   if ((p2 = (void **)fdkCallocMatrix1D_int(dim1 * dim2, sizeof(void *), s)) ==
291       NULL) {
292     fdkFreeMatrix1D(p1);
293     p1 = NULL;
294     goto bail;
295   }
296   p1[0] = p2;
297   if ((p3 = (char *)fdkCallocMatrix1D_int(dim1 * dim2 * dim3, size, s)) ==
298       NULL) {
299     fdkFreeMatrix1D(p1);
300     fdkFreeMatrix1D(p2);
301     p1 = NULL;
302     p2 = NULL;
303     goto bail;
304   }
305   for (i = 0; i < dim1; i++) {
306     p1[i] = p2;
307     for (j = 0; j < dim2; j++) {
308       p2[j] = p3;
309       p3 += dim3 * size;
310     }
311     p2 += dim2;
312   }
313 bail:
314   return p1;
315 }
316