1 
2 /* -----------------------------------------------------------------------------------------------------------
3 Software License for The Fraunhofer FDK AAC Codec Library for Android
4 
5 � Copyright  1995 - 2015 Fraunhofer-Gesellschaft zur F�rderung der angewandten Forschung e.V.
6   All rights reserved.
7 
8  1.    INTRODUCTION
9 The Fraunhofer FDK AAC Codec Library for Android ("FDK AAC Codec") is software that implements
10 the MPEG Advanced Audio Coding ("AAC") encoding and decoding scheme for digital audio.
11 This FDK AAC Codec software is intended to be used on a wide variety of Android devices.
12 
13 AAC's HE-AAC and HE-AAC v2 versions are regarded as today's most efficient general perceptual
14 audio codecs. AAC-ELD is considered the best-performing full-bandwidth communications codec by
15 independent studies and is widely deployed. AAC has been standardized by ISO and IEC as part
16 of the MPEG specifications.
17 
18 Patent licenses for necessary patent claims for the FDK AAC Codec (including those of Fraunhofer)
19 may be obtained through Via Licensing (www.vialicensing.com) or through the respective patent owners
20 individually for the purpose of encoding or decoding bit streams in products that are compliant with
21 the ISO/IEC MPEG audio standards. Please note that most manufacturers of Android devices already license
22 these patent claims through Via Licensing or directly from the patent owners, and therefore FDK AAC Codec
23 software may already be covered under those patent licenses when it is used for those licensed purposes only.
24 
25 Commercially-licensed AAC software libraries, including floating-point versions with enhanced sound quality,
26 are also available from Fraunhofer. Users are encouraged to check the Fraunhofer website for additional
27 applications information and documentation.
28 
29 2.    COPYRIGHT LICENSE
30 
31 Redistribution and use in source and binary forms, with or without modification, are permitted without
32 payment of copyright license fees provided that you satisfy the following conditions:
33 
34 You must retain the complete text of this software license in redistributions of the FDK AAC Codec or
35 your modifications thereto in source code form.
36 
37 You must retain the complete text of this software license in the documentation and/or other materials
38 provided with redistributions of the FDK AAC Codec or your modifications thereto in binary form.
39 You must make available free of charge copies of the complete source code of the FDK AAC Codec and your
40 modifications thereto to recipients of copies in binary form.
41 
42 The name of Fraunhofer may not be used to endorse or promote products derived from this library without
43 prior written permission.
44 
45 You may not charge copyright license fees for anyone to use, copy or distribute the FDK AAC Codec
46 software or your modifications thereto.
47 
48 Your modified versions of the FDK AAC Codec must carry prominent notices stating that you changed the software
49 and the date of any change. For modified versions of the FDK AAC Codec, the term
50 "Fraunhofer FDK AAC Codec Library for Android" must be replaced by the term
51 "Third-Party Modified Version of the Fraunhofer FDK AAC Codec Library for Android."
52 
53 3.    NO PATENT LICENSE
54 
55 NO EXPRESS OR IMPLIED LICENSES TO ANY PATENT CLAIMS, including without limitation the patents of Fraunhofer,
56 ARE GRANTED BY THIS SOFTWARE LICENSE. Fraunhofer provides no warranty of patent non-infringement with
57 respect to this software.
58 
59 You may use this FDK AAC Codec software or modifications thereto only for purposes that are authorized
60 by appropriate patent licenses.
61 
62 4.    DISCLAIMER
63 
64 This FDK AAC Codec software is provided by Fraunhofer on behalf of the copyright holders and contributors
65 "AS IS" and WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, including but not limited to the implied warranties
66 of merchantability and fitness for a particular purpose. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
67 CONTRIBUTORS BE LIABLE for any direct, indirect, incidental, special, exemplary, or consequential damages,
68 including but not limited to procurement of substitute goods or services; loss of use, data, or profits,
69 or business interruption, however caused and on any theory of liability, whether in contract, strict
70 liability, or tort (including negligence), arising in any way out of the use of this software, even if
71 advised of the possibility of such damage.
72 
73 5.    CONTACT INFORMATION
74 
75 Fraunhofer Institute for Integrated Circuits IIS
76 Attention: Audio and Multimedia Departments - FDK AAC LL
77 Am Wolfsmantel 33
78 91058 Erlangen, Germany
79 
80 www.iis.fraunhofer.de/amm
81 amm-info@iis.fraunhofer.de
82 ----------------------------------------------------------------------------------------------------------- */
83 
84 /*!
85   \file
86   \brief  Transient detector prototypes
87 */
88 #ifndef __TRAN_DET_H
89 #define __TRAN_DET_H
90 
91 #include "sbr_encoder.h"
92 #include "sbr_def.h"
93 
94 typedef struct
95 {
96   FIXP_DBL  transients[QMF_MAX_TIME_SLOTS+(QMF_MAX_TIME_SLOTS/2)];
97   FIXP_DBL  thresholds[QMF_CHANNELS];
98   FIXP_DBL  tran_thr;              /* Master threshold for transient signals */
99   FIXP_DBL  split_thr_m;           /* Threshold for splitting FIXFIX-frames into 2 env */
100   INT       split_thr_e;           /* Scale for splitting threshold */
101   FIXP_DBL  prevLowBandEnergy;     /* Energy of low band */
102   FIXP_DBL  prevHighBandEnergy;    /* Energy of high band */
103   INT    tran_fc;                  /* Number of lowband subbands to discard  */
104   INT    no_cols;
105   INT    no_rows;
106   INT    mode;
107 
108   int    frameShift;
109   int    tran_off;                 /* Offset for reading energy values. */
110 }
111 SBR_TRANSIENT_DETECTOR;
112 
113 
114 typedef SBR_TRANSIENT_DETECTOR *HANDLE_SBR_TRANSIENT_DETECTOR;
115 
116 #define TRAN_DET_LOOKAHEAD 2
117 #define TRAN_DET_START_FREQ 4500  /*start frequency for transient detection*/
118 #define TRAN_DET_STOP_FREQ  13500 /*stop frequency for transient detection*/
119 #define TRAN_DET_MIN_QMFBANDS 4 /* minimum qmf bands for transient detection */
120 #define QMF_HP_dBd_SLOPE_FIX FL2FXCONST_DBL(0.00075275f) /* 0.002266f/10 * log2(10) */
121 #define TRAN_DET_THRSHLD FL2FXCONST_DBL(3.2f/4.f)
122 #define TRAN_DET_THRSHLD_SCALE (2)
123 
124 typedef struct
125 {
126   INT transientCandidates[QMF_MAX_TIME_SLOTS + TRAN_DET_LOOKAHEAD];
127   INT nTimeSlots;
128   INT lookahead;
129   INT startBand;
130   INT stopBand;
131 
132   FIXP_DBL dBf_m[QMF_CHANNELS];
133   INT      dBf_e[QMF_CHANNELS];
134 
135   FIXP_DBL energy_timeSlots[QMF_MAX_TIME_SLOTS + TRAN_DET_LOOKAHEAD];
136   INT      energy_timeSlots_scale[QMF_MAX_TIME_SLOTS + TRAN_DET_LOOKAHEAD];
137 
138   FIXP_DBL delta_energy[QMF_MAX_TIME_SLOTS + TRAN_DET_LOOKAHEAD];
139   INT      delta_energy_scale[QMF_MAX_TIME_SLOTS + TRAN_DET_LOOKAHEAD];
140 
141   FIXP_DBL lowpass_energy[QMF_MAX_TIME_SLOTS + TRAN_DET_LOOKAHEAD];
142   INT      lowpass_energy_scale[QMF_MAX_TIME_SLOTS + TRAN_DET_LOOKAHEAD];
143 #if defined (FTD_LOG)
144   FDKFILE *ftd_log;
145 #endif
146 }
147 FAST_TRAN_DETECTOR;
148 typedef FAST_TRAN_DETECTOR *HANDLE_FAST_TRAN_DET;
149 
150 
151 INT FDKsbrEnc_InitSbrFastTransientDetector(
152         HANDLE_FAST_TRAN_DET h_sbrFastTransientDetector,
153         const INT time_slots_per_frame,
154         const INT bandwidth_qmf_slot,
155         const INT no_qmf_channels,
156         const INT sbr_qmf_1st_band
157         );
158 
159 void FDKsbrEnc_fastTransientDetect(
160         const HANDLE_FAST_TRAN_DET          h_sbrFastTransientDetector,
161         const FIXP_DBL              *const *Energies,
162         const int                   *const  scaleEnergies,
163         const INT                           YBufferWriteOffset,
164               UCHAR                 *const  tran_vector
165         );
166 
167 void
168 FDKsbrEnc_transientDetect(HANDLE_SBR_TRANSIENT_DETECTOR h_sbrTransientDetector,
169                           FIXP_DBL **Energies,
170                           INT *scaleEnergies,
171                           UCHAR *tran_vector,
172                           int YBufferWriteOffset,
173                           int YBufferSzShift,
174                           int timeStep,
175                           int frameMiddleBorder);
176 
177 int
178 FDKsbrEnc_InitSbrTransientDetector (HANDLE_SBR_TRANSIENT_DETECTOR h_sbrTransientDetector,
179                             UINT  sbrSyntaxFlags, /* SBR syntax flags derived from AOT. */
180                             INT   frameSize,
181                             INT   sampleFreq,
182                             sbrConfigurationPtr params,
183                             int   tran_fc,
184                             int   no_cols,
185                             int   no_rows,
186                             int   YBufferWriteOffset,
187                             int   YBufferSzShift,
188                             int   frameShift,
189                             int   tran_off);
190 
191 void
192 FDKsbrEnc_frameSplitter(FIXP_DBL **Energies,
193                         INT *scaleEnergies,
194                         HANDLE_SBR_TRANSIENT_DETECTOR h_sbrTransientDetector,
195                         UCHAR *freqBandTable,
196                         UCHAR *tran_vector,
197                         int YBufferWriteOffset,
198                         int YBufferSzShift,
199                         int nSfb,
200                         int timeStep,
201                         int no_cols,
202                         FIXP_DBL* tonality);
203 #endif
204