xref: /aosp_15_r20/external/aac/libFDK/include/huff_nodes.h (revision e54365361535b070c2db7374cec45c159c7d0e7a)
1*e5436536SAndroid Build Coastguard Worker /* -----------------------------------------------------------------------------
2*e5436536SAndroid Build Coastguard Worker Software License for The Fraunhofer FDK AAC Codec Library for Android
3*e5436536SAndroid Build Coastguard Worker 
4*e5436536SAndroid Build Coastguard Worker © Copyright  1995 - 2018 Fraunhofer-Gesellschaft zur Förderung der angewandten
5*e5436536SAndroid Build Coastguard Worker Forschung e.V. All rights reserved.
6*e5436536SAndroid Build Coastguard Worker 
7*e5436536SAndroid Build Coastguard Worker  1.    INTRODUCTION
8*e5436536SAndroid Build Coastguard Worker The Fraunhofer FDK AAC Codec Library for Android ("FDK AAC Codec") is software
9*e5436536SAndroid Build Coastguard Worker that implements the MPEG Advanced Audio Coding ("AAC") encoding and decoding
10*e5436536SAndroid Build Coastguard Worker scheme for digital audio. This FDK AAC Codec software is intended to be used on
11*e5436536SAndroid Build Coastguard Worker a wide variety of Android devices.
12*e5436536SAndroid Build Coastguard Worker 
13*e5436536SAndroid Build Coastguard Worker AAC's HE-AAC and HE-AAC v2 versions are regarded as today's most efficient
14*e5436536SAndroid Build Coastguard Worker general perceptual audio codecs. AAC-ELD is considered the best-performing
15*e5436536SAndroid Build Coastguard Worker full-bandwidth communications codec by independent studies and is widely
16*e5436536SAndroid Build Coastguard Worker deployed. AAC has been standardized by ISO and IEC as part of the MPEG
17*e5436536SAndroid Build Coastguard Worker specifications.
18*e5436536SAndroid Build Coastguard Worker 
19*e5436536SAndroid Build Coastguard Worker Patent licenses for necessary patent claims for the FDK AAC Codec (including
20*e5436536SAndroid Build Coastguard Worker those of Fraunhofer) may be obtained through Via Licensing
21*e5436536SAndroid Build Coastguard Worker (www.vialicensing.com) or through the respective patent owners individually for
22*e5436536SAndroid Build Coastguard Worker the purpose of encoding or decoding bit streams in products that are compliant
23*e5436536SAndroid Build Coastguard Worker with the ISO/IEC MPEG audio standards. Please note that most manufacturers of
24*e5436536SAndroid Build Coastguard Worker Android devices already license these patent claims through Via Licensing or
25*e5436536SAndroid Build Coastguard Worker directly from the patent owners, and therefore FDK AAC Codec software may
26*e5436536SAndroid Build Coastguard Worker already be covered under those patent licenses when it is used for those
27*e5436536SAndroid Build Coastguard Worker licensed purposes only.
28*e5436536SAndroid Build Coastguard Worker 
29*e5436536SAndroid Build Coastguard Worker Commercially-licensed AAC software libraries, including floating-point versions
30*e5436536SAndroid Build Coastguard Worker with enhanced sound quality, are also available from Fraunhofer. Users are
31*e5436536SAndroid Build Coastguard Worker encouraged to check the Fraunhofer website for additional applications
32*e5436536SAndroid Build Coastguard Worker information and documentation.
33*e5436536SAndroid Build Coastguard Worker 
34*e5436536SAndroid Build Coastguard Worker 2.    COPYRIGHT LICENSE
35*e5436536SAndroid Build Coastguard Worker 
36*e5436536SAndroid Build Coastguard Worker Redistribution and use in source and binary forms, with or without modification,
37*e5436536SAndroid Build Coastguard Worker are permitted without payment of copyright license fees provided that you
38*e5436536SAndroid Build Coastguard Worker satisfy the following conditions:
39*e5436536SAndroid Build Coastguard Worker 
40*e5436536SAndroid Build Coastguard Worker You must retain the complete text of this software license in redistributions of
41*e5436536SAndroid Build Coastguard Worker the FDK AAC Codec or your modifications thereto in source code form.
42*e5436536SAndroid Build Coastguard Worker 
43*e5436536SAndroid Build Coastguard Worker You must retain the complete text of this software license in the documentation
44*e5436536SAndroid Build Coastguard Worker and/or other materials provided with redistributions of the FDK AAC Codec or
45*e5436536SAndroid Build Coastguard Worker your modifications thereto in binary form. You must make available free of
46*e5436536SAndroid Build Coastguard Worker charge copies of the complete source code of the FDK AAC Codec and your
47*e5436536SAndroid Build Coastguard Worker modifications thereto to recipients of copies in binary form.
48*e5436536SAndroid Build Coastguard Worker 
49*e5436536SAndroid Build Coastguard Worker The name of Fraunhofer may not be used to endorse or promote products derived
50*e5436536SAndroid Build Coastguard Worker from this library without prior written permission.
51*e5436536SAndroid Build Coastguard Worker 
52*e5436536SAndroid Build Coastguard Worker You may not charge copyright license fees for anyone to use, copy or distribute
53*e5436536SAndroid Build Coastguard Worker the FDK AAC Codec software or your modifications thereto.
54*e5436536SAndroid Build Coastguard Worker 
55*e5436536SAndroid Build Coastguard Worker Your modified versions of the FDK AAC Codec must carry prominent notices stating
56*e5436536SAndroid Build Coastguard Worker that you changed the software and the date of any change. For modified versions
57*e5436536SAndroid Build Coastguard Worker of the FDK AAC Codec, the term "Fraunhofer FDK AAC Codec Library for Android"
58*e5436536SAndroid Build Coastguard Worker must be replaced by the term "Third-Party Modified Version of the Fraunhofer FDK
59*e5436536SAndroid Build Coastguard Worker AAC Codec Library for Android."
60*e5436536SAndroid Build Coastguard Worker 
61*e5436536SAndroid Build Coastguard Worker 3.    NO PATENT LICENSE
62*e5436536SAndroid Build Coastguard Worker 
63*e5436536SAndroid Build Coastguard Worker NO EXPRESS OR IMPLIED LICENSES TO ANY PATENT CLAIMS, including without
64*e5436536SAndroid Build Coastguard Worker limitation the patents of Fraunhofer, ARE GRANTED BY THIS SOFTWARE LICENSE.
65*e5436536SAndroid Build Coastguard Worker Fraunhofer provides no warranty of patent non-infringement with respect to this
66*e5436536SAndroid Build Coastguard Worker software.
67*e5436536SAndroid Build Coastguard Worker 
68*e5436536SAndroid Build Coastguard Worker You may use this FDK AAC Codec software or modifications thereto only for
69*e5436536SAndroid Build Coastguard Worker purposes that are authorized by appropriate patent licenses.
70*e5436536SAndroid Build Coastguard Worker 
71*e5436536SAndroid Build Coastguard Worker 4.    DISCLAIMER
72*e5436536SAndroid Build Coastguard Worker 
73*e5436536SAndroid Build Coastguard Worker This FDK AAC Codec software is provided by Fraunhofer on behalf of the copyright
74*e5436536SAndroid Build Coastguard Worker holders and contributors "AS IS" and WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES,
75*e5436536SAndroid Build Coastguard Worker including but not limited to the implied warranties of merchantability and
76*e5436536SAndroid Build Coastguard Worker fitness for a particular purpose. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
77*e5436536SAndroid Build Coastguard Worker CONTRIBUTORS BE LIABLE for any direct, indirect, incidental, special, exemplary,
78*e5436536SAndroid Build Coastguard Worker or consequential damages, including but not limited to procurement of substitute
79*e5436536SAndroid Build Coastguard Worker goods or services; loss of use, data, or profits, or business interruption,
80*e5436536SAndroid Build Coastguard Worker however caused and on any theory of liability, whether in contract, strict
81*e5436536SAndroid Build Coastguard Worker liability, or tort (including negligence), arising in any way out of the use of
82*e5436536SAndroid Build Coastguard Worker this software, even if advised of the possibility of such damage.
83*e5436536SAndroid Build Coastguard Worker 
84*e5436536SAndroid Build Coastguard Worker 5.    CONTACT INFORMATION
85*e5436536SAndroid Build Coastguard Worker 
86*e5436536SAndroid Build Coastguard Worker Fraunhofer Institute for Integrated Circuits IIS
87*e5436536SAndroid Build Coastguard Worker Attention: Audio and Multimedia Departments - FDK AAC LL
88*e5436536SAndroid Build Coastguard Worker Am Wolfsmantel 33
89*e5436536SAndroid Build Coastguard Worker 91058 Erlangen, Germany
90*e5436536SAndroid Build Coastguard Worker 
91*e5436536SAndroid Build Coastguard Worker www.iis.fraunhofer.de/amm
92*e5436536SAndroid Build Coastguard Worker [email protected]
93*e5436536SAndroid Build Coastguard Worker ----------------------------------------------------------------------------- */
94*e5436536SAndroid Build Coastguard Worker 
95*e5436536SAndroid Build Coastguard Worker /******************* Library for basic calculation routines ********************
96*e5436536SAndroid Build Coastguard Worker 
97*e5436536SAndroid Build Coastguard Worker    Author(s):   Omer Osman
98*e5436536SAndroid Build Coastguard Worker 
99*e5436536SAndroid Build Coastguard Worker    Description: MPEG-D SAC/USAC/SAOC Huffman Part0 Tables
100*e5436536SAndroid Build Coastguard Worker 
101*e5436536SAndroid Build Coastguard Worker *******************************************************************************/
102*e5436536SAndroid Build Coastguard Worker 
103*e5436536SAndroid Build Coastguard Worker #ifndef HUFF_NODES_H
104*e5436536SAndroid Build Coastguard Worker #define HUFF_NODES_H
105*e5436536SAndroid Build Coastguard Worker 
106*e5436536SAndroid Build Coastguard Worker #include "genericStds.h"
107*e5436536SAndroid Build Coastguard Worker 
108*e5436536SAndroid Build Coastguard Worker typedef struct {
109*e5436536SAndroid Build Coastguard Worker   SHORT nodeTab[39][2];
110*e5436536SAndroid Build Coastguard Worker 
111*e5436536SAndroid Build Coastguard Worker } HUFF_RES_NODES;
112*e5436536SAndroid Build Coastguard Worker 
113*e5436536SAndroid Build Coastguard Worker /* 1D Nodes */
114*e5436536SAndroid Build Coastguard Worker typedef struct {
115*e5436536SAndroid Build Coastguard Worker   SHORT nodeTab[30][2];
116*e5436536SAndroid Build Coastguard Worker 
117*e5436536SAndroid Build Coastguard Worker } HUFF_CLD_NOD_1D;
118*e5436536SAndroid Build Coastguard Worker 
119*e5436536SAndroid Build Coastguard Worker typedef struct {
120*e5436536SAndroid Build Coastguard Worker   SHORT nodeTab[7][2];
121*e5436536SAndroid Build Coastguard Worker 
122*e5436536SAndroid Build Coastguard Worker } HUFF_ICC_NOD_1D;
123*e5436536SAndroid Build Coastguard Worker 
124*e5436536SAndroid Build Coastguard Worker typedef struct {
125*e5436536SAndroid Build Coastguard Worker   SHORT nodeTab[50][2];
126*e5436536SAndroid Build Coastguard Worker 
127*e5436536SAndroid Build Coastguard Worker } HUFF_CPC_NOD_1D;
128*e5436536SAndroid Build Coastguard Worker 
129*e5436536SAndroid Build Coastguard Worker typedef struct {
130*e5436536SAndroid Build Coastguard Worker   SHORT nodeTab[15][2];
131*e5436536SAndroid Build Coastguard Worker 
132*e5436536SAndroid Build Coastguard Worker } HUFF_OLD_NOD_1D;
133*e5436536SAndroid Build Coastguard Worker 
134*e5436536SAndroid Build Coastguard Worker typedef struct {
135*e5436536SAndroid Build Coastguard Worker   SHORT nodeTab[63][2];
136*e5436536SAndroid Build Coastguard Worker 
137*e5436536SAndroid Build Coastguard Worker } HUFF_NRG_NOD_1D;
138*e5436536SAndroid Build Coastguard Worker 
139*e5436536SAndroid Build Coastguard Worker /* 2D Nodes */
140*e5436536SAndroid Build Coastguard Worker typedef struct {
141*e5436536SAndroid Build Coastguard Worker   SHORT lav3[15][2];
142*e5436536SAndroid Build Coastguard Worker   SHORT lav5[35][2];
143*e5436536SAndroid Build Coastguard Worker   SHORT lav7[63][2];
144*e5436536SAndroid Build Coastguard Worker   SHORT lav9[99][2];
145*e5436536SAndroid Build Coastguard Worker 
146*e5436536SAndroid Build Coastguard Worker } HUFF_CLD_NOD_2D;
147*e5436536SAndroid Build Coastguard Worker 
148*e5436536SAndroid Build Coastguard Worker typedef struct {
149*e5436536SAndroid Build Coastguard Worker   SHORT lav1[3][2];
150*e5436536SAndroid Build Coastguard Worker   SHORT lav3[15][2];
151*e5436536SAndroid Build Coastguard Worker   SHORT lav5[35][2];
152*e5436536SAndroid Build Coastguard Worker   SHORT lav7[63][2];
153*e5436536SAndroid Build Coastguard Worker 
154*e5436536SAndroid Build Coastguard Worker } HUFF_ICC_NOD_2D;
155*e5436536SAndroid Build Coastguard Worker 
156*e5436536SAndroid Build Coastguard Worker typedef struct {
157*e5436536SAndroid Build Coastguard Worker   SHORT lav3[15][2];
158*e5436536SAndroid Build Coastguard Worker   SHORT lav6[48][2];
159*e5436536SAndroid Build Coastguard Worker   SHORT lav9[99][2];
160*e5436536SAndroid Build Coastguard Worker   SHORT lav12[168][2];
161*e5436536SAndroid Build Coastguard Worker 
162*e5436536SAndroid Build Coastguard Worker } HUFF_OLD_NOD_2D;
163*e5436536SAndroid Build Coastguard Worker 
164*e5436536SAndroid Build Coastguard Worker typedef struct {
165*e5436536SAndroid Build Coastguard Worker   SHORT lav3[15][2];
166*e5436536SAndroid Build Coastguard Worker   SHORT lav5[35][2];
167*e5436536SAndroid Build Coastguard Worker   SHORT lav7[63][2];
168*e5436536SAndroid Build Coastguard Worker   SHORT lav9[99][2];
169*e5436536SAndroid Build Coastguard Worker 
170*e5436536SAndroid Build Coastguard Worker } HUFF_NRG_NOD_2D_df;
171*e5436536SAndroid Build Coastguard Worker 
172*e5436536SAndroid Build Coastguard Worker typedef struct {
173*e5436536SAndroid Build Coastguard Worker   SHORT lav3[15][2];
174*e5436536SAndroid Build Coastguard Worker   SHORT lav6[48][2];
175*e5436536SAndroid Build Coastguard Worker   SHORT lav9[99][2];
176*e5436536SAndroid Build Coastguard Worker   SHORT lav12[168][2];
177*e5436536SAndroid Build Coastguard Worker 
178*e5436536SAndroid Build Coastguard Worker } HUFF_NRG_NOD_2D_dt;
179*e5436536SAndroid Build Coastguard Worker 
180*e5436536SAndroid Build Coastguard Worker typedef struct {
181*e5436536SAndroid Build Coastguard Worker   HUFF_NRG_NOD_2D_df df[2];
182*e5436536SAndroid Build Coastguard Worker   HUFF_NRG_NOD_2D_dt dt[2];
183*e5436536SAndroid Build Coastguard Worker   HUFF_NRG_NOD_2D_df dp[2];
184*e5436536SAndroid Build Coastguard Worker 
185*e5436536SAndroid Build Coastguard Worker } HUFF_NRG_NOD_2D;
186*e5436536SAndroid Build Coastguard Worker 
187*e5436536SAndroid Build Coastguard Worker /* Complete bs Parameter Nodes */
188*e5436536SAndroid Build Coastguard Worker typedef struct {
189*e5436536SAndroid Build Coastguard Worker   const HUFF_CLD_NOD_1D *h1D[3];
190*e5436536SAndroid Build Coastguard Worker   const HUFF_CLD_NOD_2D *h2D[3][2];
191*e5436536SAndroid Build Coastguard Worker 
192*e5436536SAndroid Build Coastguard Worker } HUFF_CLD_NODES;
193*e5436536SAndroid Build Coastguard Worker 
194*e5436536SAndroid Build Coastguard Worker typedef struct {
195*e5436536SAndroid Build Coastguard Worker   const HUFF_ICC_NOD_1D *h1D[3];
196*e5436536SAndroid Build Coastguard Worker   const HUFF_ICC_NOD_2D *h2D[3][2];
197*e5436536SAndroid Build Coastguard Worker 
198*e5436536SAndroid Build Coastguard Worker } HUFF_ICC_NODES;
199*e5436536SAndroid Build Coastguard Worker 
200*e5436536SAndroid Build Coastguard Worker typedef struct {
201*e5436536SAndroid Build Coastguard Worker   const HUFF_OLD_NOD_1D *h1D[3];
202*e5436536SAndroid Build Coastguard Worker   const HUFF_OLD_NOD_2D *h2D[3][2];
203*e5436536SAndroid Build Coastguard Worker 
204*e5436536SAndroid Build Coastguard Worker } HUFF_OLD_NODES;
205*e5436536SAndroid Build Coastguard Worker 
206*e5436536SAndroid Build Coastguard Worker typedef struct {
207*e5436536SAndroid Build Coastguard Worker   const HUFF_NRG_NOD_1D *h1D[3];
208*e5436536SAndroid Build Coastguard Worker   const HUFF_NRG_NOD_2D *h2D;
209*e5436536SAndroid Build Coastguard Worker 
210*e5436536SAndroid Build Coastguard Worker } HUFF_NRG_NODES;
211*e5436536SAndroid Build Coastguard Worker 
212*e5436536SAndroid Build Coastguard Worker /* parameter instance */
213*e5436536SAndroid Build Coastguard Worker typedef struct {
214*e5436536SAndroid Build Coastguard Worker   SHORT cld[30][2];
215*e5436536SAndroid Build Coastguard Worker   SHORT icc[7][2];
216*e5436536SAndroid Build Coastguard Worker   SHORT ipd[7][2];
217*e5436536SAndroid Build Coastguard Worker   SHORT old[15][2];
218*e5436536SAndroid Build Coastguard Worker   SHORT nrg[63][2];
219*e5436536SAndroid Build Coastguard Worker } HUFF_PT0_NODES;
220*e5436536SAndroid Build Coastguard Worker 
221*e5436536SAndroid Build Coastguard Worker typedef struct {
222*e5436536SAndroid Build Coastguard Worker   SHORT nodeTab[3][2];
223*e5436536SAndroid Build Coastguard Worker 
224*e5436536SAndroid Build Coastguard Worker } HUFF_LAV_NODES;
225*e5436536SAndroid Build Coastguard Worker 
226*e5436536SAndroid Build Coastguard Worker /* USAC specific */
227*e5436536SAndroid Build Coastguard Worker typedef struct {
228*e5436536SAndroid Build Coastguard Worker   SHORT nodeTab[7][2];
229*e5436536SAndroid Build Coastguard Worker 
230*e5436536SAndroid Build Coastguard Worker } HUFF_IPD_NOD_1D;
231*e5436536SAndroid Build Coastguard Worker 
232*e5436536SAndroid Build Coastguard Worker typedef struct {
233*e5436536SAndroid Build Coastguard Worker   SHORT lav1[3][2];
234*e5436536SAndroid Build Coastguard Worker   SHORT lav3[15][2];
235*e5436536SAndroid Build Coastguard Worker   SHORT lav5[35][2];
236*e5436536SAndroid Build Coastguard Worker   SHORT lav7[63][2];
237*e5436536SAndroid Build Coastguard Worker 
238*e5436536SAndroid Build Coastguard Worker } HUFF_IPD_NOD_2D;
239*e5436536SAndroid Build Coastguard Worker 
240*e5436536SAndroid Build Coastguard Worker typedef struct {
241*e5436536SAndroid Build Coastguard Worker   HUFF_IPD_NOD_1D h1D[3];
242*e5436536SAndroid Build Coastguard Worker   HUFF_IPD_NOD_2D h2D[3][2];
243*e5436536SAndroid Build Coastguard Worker 
244*e5436536SAndroid Build Coastguard Worker } HUFF_IPD_NODES;
245*e5436536SAndroid Build Coastguard Worker 
246*e5436536SAndroid Build Coastguard Worker /* non-lossy coding decoder */
247*e5436536SAndroid Build Coastguard Worker extern const HUFF_PT0_NODES FDK_huffPart0Nodes;
248*e5436536SAndroid Build Coastguard Worker extern const HUFF_LAV_NODES FDK_huffLavIdxNodes;
249*e5436536SAndroid Build Coastguard Worker 
250*e5436536SAndroid Build Coastguard Worker extern const HUFF_ICC_NODES FDK_huffICCNodes;
251*e5436536SAndroid Build Coastguard Worker extern const HUFF_CLD_NODES FDK_huffCLDNodes;
252*e5436536SAndroid Build Coastguard Worker extern const HUFF_RES_NODES FDK_huffReshapeNodes;
253*e5436536SAndroid Build Coastguard Worker 
254*e5436536SAndroid Build Coastguard Worker extern const HUFF_OLD_NODES huffOLDNodes;
255*e5436536SAndroid Build Coastguard Worker 
256*e5436536SAndroid Build Coastguard Worker extern const HUFF_IPD_NODES FDK_huffIPDNodes;
257*e5436536SAndroid Build Coastguard Worker 
258*e5436536SAndroid Build Coastguard Worker #endif /* HUFF_NODES_H */
259