/src/aac/libSACdec/src/sac_rom.h
Line | Count | Source (jump to first uncovered line) |
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 | | /*********************** MPEG surround decoder library ************************* |
96 | | |
97 | | Author(s): |
98 | | |
99 | | Description: SAC Dec tables |
100 | | |
101 | | *******************************************************************************/ |
102 | | |
103 | | #ifndef SAC_ROM_H |
104 | | #define SAC_ROM_H |
105 | | |
106 | | #include "FDK_archdef.h" |
107 | | #include "sac_dec_interface.h" |
108 | | |
109 | | #include "huff_nodes.h" |
110 | | #include "sac_bitdec.h" |
111 | | #include "machine_type.h" |
112 | | |
113 | | /* Global ROM table data type: */ |
114 | 0 | #define FIXP_CFG FIXP_DBL |
115 | | #define FX_CFG2FX_DBL |
116 | | #define FX_CFG2FX_SGL FX_DBL2FX_SGL |
117 | | #define CFG(a) FIXP_DBL(a) |
118 | | #define FL2FXCONST_CFG FL2FXCONST_DBL |
119 | | #define FX_DBL2FX_CFG(x) ((FIXP_DBL)(x)) |
120 | | |
121 | | /* others */ |
122 | | #define SCALE_INV_ICC (2) |
123 | | #define G_dd_SCALE (2) |
124 | | |
125 | | #define QCC_SCALE 1 |
126 | | #define M1M2_DATA FIXP_DBL |
127 | | #define M1M2_CDATA FIXP_DBL |
128 | | #define M1M2_CDATA2FX_DBL(a) (a) |
129 | | #define FX_DBL2M1M2_CDATA(a) (a) |
130 | | |
131 | | #define CLIP_PROTECT_GAIN_0(x) FL2FXCONST_CFG(((x) / (float)(1 << 0))) |
132 | | #define CLIP_PROTECT_GAIN_1(x) FL2FXCONST_CFG(((x) / (float)(1 << 1))) |
133 | | #define CLIP_PROTECT_GAIN_2(x) FL2FXCONST_CFG(((x) / (float)(1 << 2))) |
134 | | |
135 | 0 | #define SF_CLD_C1C2 (9) |
136 | | |
137 | | extern const FIXP_CFG dequantCPC__FDK[]; |
138 | | extern const FIXP_CFG dequantICC__FDK[8]; |
139 | | extern const FIXP_CFG dequantCLD__FDK[31]; |
140 | | |
141 | 0 | #define IPD_SCALE (5) |
142 | 0 | #define PI__IPD (FL2FXCONST_DBL(3.1415926535897932f / (float)(1 << IPD_SCALE))) |
143 | | /* Define for PI*2 for better precision in SpatialDecApplyPhase() */ |
144 | | #define PIx2__IPD \ |
145 | 0 | (FL2FXCONST_DBL(3.1415926535897932f / (float)(1 << (IPD_SCALE - 1)))) |
146 | | |
147 | | extern const FIXP_CFG dequantIPD__FDK[16]; |
148 | | extern const FIXP_DBL dequantIPD_CLD_ICC_splitAngle__FDK[15][31][8]; |
149 | | |
150 | | extern const FIXP_CFG H11_nc[31][8]; |
151 | | extern const FIXP_CFG H12_nc[31][8]; |
152 | | |
153 | | extern const FIXP_DBL dequantCLD_c1[31]; |
154 | | |
155 | | extern const FIXP_CFG BP__FDK[]; |
156 | | extern const FIXP_CFG BP_GF__FDK[]; |
157 | | extern const SCHAR row2channelSTP[][MAX_M2_INPUT]; |
158 | | |
159 | | /* sac_bitdec */ |
160 | | extern const INT samplingFreqTable[16]; |
161 | | extern const UCHAR freqResTable[]; |
162 | | extern const UCHAR freqResTable_LD[]; |
163 | | extern const UCHAR tempShapeChanTable[2][8]; |
164 | | extern const TREEPROPERTIES treePropertyTable[]; |
165 | | |
166 | | extern const SCHAR kernels_4_to_71[MAX_HYBRID_BANDS]; |
167 | | extern const SCHAR kernels_5_to_71[MAX_HYBRID_BANDS]; |
168 | | extern const SCHAR kernels_7_to_71[MAX_HYBRID_BANDS]; |
169 | | extern const SCHAR kernels_10_to_71[MAX_HYBRID_BANDS]; |
170 | | extern const SCHAR kernels_14_to_71[MAX_HYBRID_BANDS]; |
171 | | extern const SCHAR kernels_20_to_71[MAX_HYBRID_BANDS]; |
172 | | extern const SCHAR kernels_28_to_71[MAX_HYBRID_BANDS]; |
173 | | |
174 | | extern const UCHAR mapping_4_to_28[MAX_PARAMETER_BANDS]; |
175 | | extern const UCHAR mapping_5_to_28[MAX_PARAMETER_BANDS]; |
176 | | extern const UCHAR mapping_7_to_28[MAX_PARAMETER_BANDS]; |
177 | | extern const UCHAR mapping_10_to_28[MAX_PARAMETER_BANDS]; |
178 | | extern const UCHAR mapping_14_to_28[MAX_PARAMETER_BANDS]; |
179 | | extern const UCHAR mapping_20_to_28[MAX_PARAMETER_BANDS]; |
180 | | extern const SCHAR kernels_4_to_64[MAX_HYBRID_BANDS]; |
181 | | extern const SCHAR kernels_5_to_64[MAX_HYBRID_BANDS]; |
182 | | extern const SCHAR kernels_7_to_64[MAX_HYBRID_BANDS]; |
183 | | extern const SCHAR kernels_9_to_64[MAX_HYBRID_BANDS]; |
184 | | extern const SCHAR kernels_12_to_64[MAX_HYBRID_BANDS]; |
185 | | extern const SCHAR kernels_15_to_64[MAX_HYBRID_BANDS]; |
186 | | extern const SCHAR kernels_23_to_64[MAX_HYBRID_BANDS]; |
187 | | |
188 | | extern const UCHAR mapping_15_to_23[MAX_PARAMETER_BANDS_LD]; |
189 | | extern const UCHAR mapping_12_to_23[MAX_PARAMETER_BANDS_LD]; |
190 | | extern const UCHAR mapping_9_to_23[MAX_PARAMETER_BANDS_LD]; |
191 | | extern const UCHAR mapping_7_to_23[MAX_PARAMETER_BANDS_LD]; |
192 | | extern const UCHAR mapping_5_to_23[MAX_PARAMETER_BANDS_LD]; |
193 | | extern const UCHAR mapping_4_to_23[MAX_PARAMETER_BANDS_LD]; |
194 | | |
195 | | extern const FIXP_CFG clipGainTable__FDK[]; |
196 | | extern const UCHAR clipGainSFTable__FDK[]; |
197 | | |
198 | | extern const UCHAR pbStrideTable[]; |
199 | | extern const int smgTimeTable[]; |
200 | | |
201 | | extern const FIXP_CFG envShapeDataTable__FDK[5][2]; |
202 | | extern const SCHAR row2channelGES[][MAX_M2_INPUT]; |
203 | | |
204 | | /* sac_calcM1andM2 */ |
205 | | extern const SCHAR row2residual[][MAX_M2_INPUT]; |
206 | | |
207 | | void SpatialDequantGetCLDValues(int index, FIXP_DBL* cu, FIXP_DBL* cl); |
208 | | |
209 | | void SpatialDequantGetCLD2Values(int index, FIXP_DBL* x); |
210 | | |
211 | | /* External helper functions */ |
212 | 92 | static inline int SacGetHybridSubbands(int qmfSubbands) { |
213 | 92 | return qmfSubbands - MAX_QMF_BANDS_TO_HYBRID + 10; |
214 | 92 | } Unexecuted instantiation: sac_bitdec.cpp:SacGetHybridSubbands(int) Unexecuted instantiation: sac_calcM1andM2.cpp:SacGetHybridSubbands(int) sac_dec.cpp:SacGetHybridSubbands(int) Line | Count | Source | 212 | 92 | static inline int SacGetHybridSubbands(int qmfSubbands) { | 213 | 92 | return qmfSubbands - MAX_QMF_BANDS_TO_HYBRID + 10; | 214 | 92 | } |
Unexecuted instantiation: sac_process.cpp:SacGetHybridSubbands(int) Unexecuted instantiation: sac_qmf.cpp:SacGetHybridSubbands(int) Unexecuted instantiation: sac_reshapeBBEnv.cpp:SacGetHybridSubbands(int) Unexecuted instantiation: sac_rom.cpp:SacGetHybridSubbands(int) Unexecuted instantiation: sac_smoothing.cpp:SacGetHybridSubbands(int) Unexecuted instantiation: sac_stp.cpp:SacGetHybridSubbands(int) |
215 | | |
216 | | #endif /* SAC_ROM_H */ |