| |
| /* ----------------------------------------------------------------------------------------------------------- |
| Software License for The Fraunhofer FDK AAC Codec Library for Android |
| |
| © Copyright 1995 - 2012 Fraunhofer-Gesellschaft zur Förderung der angewandten Forschung e.V. |
| All rights reserved. |
| |
| 1. INTRODUCTION |
| The Fraunhofer FDK AAC Codec Library for Android ("FDK AAC Codec") is software that implements |
| the MPEG Advanced Audio Coding ("AAC") encoding and decoding scheme for digital audio. |
| This FDK AAC Codec software is intended to be used on a wide variety of Android devices. |
| |
| AAC's HE-AAC and HE-AAC v2 versions are regarded as today's most efficient general perceptual |
| audio codecs. AAC-ELD is considered the best-performing full-bandwidth communications codec by |
| independent studies and is widely deployed. AAC has been standardized by ISO and IEC as part |
| of the MPEG specifications. |
| |
| Patent licenses for necessary patent claims for the FDK AAC Codec (including those of Fraunhofer) |
| may be obtained through Via Licensing (www.vialicensing.com) or through the respective patent owners |
| individually for the purpose of encoding or decoding bit streams in products that are compliant with |
| the ISO/IEC MPEG audio standards. Please note that most manufacturers of Android devices already license |
| these patent claims through Via Licensing or directly from the patent owners, and therefore FDK AAC Codec |
| software may already be covered under those patent licenses when it is used for those licensed purposes only. |
| |
| Commercially-licensed AAC software libraries, including floating-point versions with enhanced sound quality, |
| are also available from Fraunhofer. Users are encouraged to check the Fraunhofer website for additional |
| applications information and documentation. |
| |
| 2. COPYRIGHT LICENSE |
| |
| Redistribution and use in source and binary forms, with or without modification, are permitted without |
| payment of copyright license fees provided that you satisfy the following conditions: |
| |
| You must retain the complete text of this software license in redistributions of the FDK AAC Codec or |
| your modifications thereto in source code form. |
| |
| You must retain the complete text of this software license in the documentation and/or other materials |
| provided with redistributions of the FDK AAC Codec or your modifications thereto in binary form. |
| You must make available free of charge copies of the complete source code of the FDK AAC Codec and your |
| modifications thereto to recipients of copies in binary form. |
| |
| The name of Fraunhofer may not be used to endorse or promote products derived from this library without |
| prior written permission. |
| |
| You may not charge copyright license fees for anyone to use, copy or distribute the FDK AAC Codec |
| software or your modifications thereto. |
| |
| Your modified versions of the FDK AAC Codec must carry prominent notices stating that you changed the software |
| and the date of any change. For modified versions of the FDK AAC Codec, the term |
| "Fraunhofer FDK AAC Codec Library for Android" must be replaced by the term |
| "Third-Party Modified Version of the Fraunhofer FDK AAC Codec Library for Android." |
| |
| 3. NO PATENT LICENSE |
| |
| NO EXPRESS OR IMPLIED LICENSES TO ANY PATENT CLAIMS, including without limitation the patents of Fraunhofer, |
| ARE GRANTED BY THIS SOFTWARE LICENSE. Fraunhofer provides no warranty of patent non-infringement with |
| respect to this software. |
| |
| You may use this FDK AAC Codec software or modifications thereto only for purposes that are authorized |
| by appropriate patent licenses. |
| |
| 4. DISCLAIMER |
| |
| This FDK AAC Codec software is provided by Fraunhofer on behalf of the copyright holders and contributors |
| "AS IS" and WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, including but not limited to the implied warranties |
| of merchantability and fitness for a particular purpose. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR |
| CONTRIBUTORS BE LIABLE for any direct, indirect, incidental, special, exemplary, or consequential damages, |
| including but not limited to procurement of substitute goods or services; loss of use, data, or profits, |
| or business interruption, however caused and on any theory of liability, whether in contract, strict |
| liability, or tort (including negligence), arising in any way out of the use of this software, even if |
| advised of the possibility of such damage. |
| |
| 5. CONTACT INFORMATION |
| |
| Fraunhofer Institute for Integrated Circuits IIS |
| Attention: Audio and Multimedia Departments - FDK AAC LL |
| Am Wolfsmantel 33 |
| 91058 Erlangen, Germany |
| |
| www.iis.fraunhofer.de/amm |
| amm-info@iis.fraunhofer.de |
| ----------------------------------------------------------------------------------------------------------- */ |
| |
| /******************************** MPEG Audio Encoder ************************** |
| |
| Initial author: M.Lohwasser |
| contents/description: PNS parameters depending on bitrate and bandwidth |
| |
| ******************************************************************************/ |
| |
| #include "pnsparam.h" |
| #include "psy_configuration.h" |
| |
| typedef struct { |
| SHORT startFreq; |
| /* Parameters for detection */ |
| FIXP_SGL refPower; |
| FIXP_SGL refTonality; |
| SHORT tnsGainThreshold; /* scaled by TNS_PREDGAIN_SCALE (=1000) */ |
| SHORT tnsPNSGainThreshold; /* scaled by TNS_PREDGAIN_SCALE (=1000) */ |
| FIXP_SGL gapFillThr; |
| SHORT minSfbWidth; |
| USHORT detectionAlgorithmFlags; |
| } PNS_INFO_TAB; |
| |
| |
| typedef struct { |
| ULONG brFrom; |
| ULONG brTo; |
| UCHAR S22050; |
| UCHAR S24000; |
| UCHAR S32000; |
| UCHAR S44100; |
| UCHAR S48000; |
| } AUTO_PNS_TAB; |
| |
| static const AUTO_PNS_TAB levelTable_mono[]= { |
| {0, 11999, 1, 1, 1, 1, 1,}, |
| {12000, 19999, 1, 1, 1, 1, 1,}, |
| {20000, 28999, 2, 1, 1, 1, 1,}, |
| {29000, 40999, 4, 4, 4, 2, 2,}, |
| {41000, 55999, 9, 9, 7, 7, 7,}, |
| {56000, 79999, 0, 0, 0, 9, 9,}, |
| {80000, 99999, 0, 0, 0, 0, 0,}, |
| {100000,999999, 0, 0, 0, 0, 0,}, |
| }; |
| |
| static const AUTO_PNS_TAB levelTable_stereo[]= { |
| {0, 11999, 1, 1, 1, 1, 1,}, |
| {12000, 19999, 3, 1, 1, 1, 1,}, |
| {20000, 28999, 3, 3, 3, 2, 2,}, |
| {29000, 40999, 7, 6, 6, 5, 5,}, |
| {41000, 55999, 9, 9, 7, 7, 7,}, |
| {56000, 79999, 0, 0, 0, 0, 0,}, |
| {80000, 99999, 0, 0, 0, 0, 0,}, |
| {100000,999999, 0, 0, 0, 0, 0,}, |
| }; |
| |
| |
| static const PNS_INFO_TAB pnsInfoTab[] = { |
| /*0 pns off */ |
| /*1*/ { 4000, FL2FXCONST_SGL(0.04), FL2FXCONST_SGL(0.06), 1150, 1200, FL2FXCONST_SGL(0.02), 8, |
| USE_POWER_DISTRIBUTION | USE_PSYCH_TONALITY | USE_TNS_GAIN_THR | USE_TNS_PNS /*| JUST_LONG_WINDOW*/ }, |
| /*2*/ { 4000, FL2FXCONST_SGL(0.04), FL2FXCONST_SGL(0.07), 1130, 1300, FL2FXCONST_SGL(0.05), 8, |
| USE_POWER_DISTRIBUTION | USE_PSYCH_TONALITY | USE_TNS_GAIN_THR | USE_TNS_PNS /*| JUST_LONG_WINDOW*/ }, |
| /*3*/ { 4100, FL2FXCONST_SGL(0.04), FL2FXCONST_SGL(0.07), 1100, 1400, FL2FXCONST_SGL(0.10), 8, |
| USE_POWER_DISTRIBUTION | USE_PSYCH_TONALITY | USE_TNS_GAIN_THR | USE_TNS_PNS /*| JUST_LONG_WINDOW*/ }, |
| /*4*/ { 4100, FL2FXCONST_SGL(0.03), FL2FXCONST_SGL(0.10), 1100, 1400, FL2FXCONST_SGL(0.15), 8, |
| USE_POWER_DISTRIBUTION | USE_PSYCH_TONALITY | USE_TNS_GAIN_THR | USE_TNS_PNS /*| JUST_LONG_WINDOW*/ }, |
| /*5*/ { 4300, FL2FXCONST_SGL(0.03), FL2FXCONST_SGL(0.10), 1100, 1400, FL2FXCONST_SGL(0.15), 8, |
| USE_POWER_DISTRIBUTION | USE_PSYCH_TONALITY | USE_TNS_GAIN_THR | USE_TNS_PNS | JUST_LONG_WINDOW }, |
| /*6*/ { 5000, FL2FXCONST_SGL(0.03), FL2FXCONST_SGL(0.10), 1100, 1400, FL2FXCONST_SGL(0.25), 8, |
| USE_POWER_DISTRIBUTION | USE_PSYCH_TONALITY | USE_TNS_GAIN_THR | USE_TNS_PNS | JUST_LONG_WINDOW }, |
| /*7*/ { 5500, FL2FXCONST_SGL(0.03), FL2FXCONST_SGL(0.12), 1100, 1400, FL2FXCONST_SGL(0.35), 8, |
| USE_POWER_DISTRIBUTION | USE_PSYCH_TONALITY | USE_TNS_GAIN_THR | USE_TNS_PNS | JUST_LONG_WINDOW }, |
| /*8*/ { 6000, FL2FXCONST_SGL(0.03), FL2FXCONST_SGL(0.12), 1080, 1400, FL2FXCONST_SGL(0.40), 8, |
| USE_POWER_DISTRIBUTION | USE_PSYCH_TONALITY | USE_TNS_GAIN_THR | USE_TNS_PNS | JUST_LONG_WINDOW }, |
| /*9*/ { 6000, FL2FXCONST_SGL(0.03), FL2FXCONST_SGL(0.14), 1070, 1400, FL2FXCONST_SGL(0.45), 8, |
| USE_POWER_DISTRIBUTION | USE_PSYCH_TONALITY | USE_TNS_GAIN_THR | USE_TNS_PNS | JUST_LONG_WINDOW }, |
| }; |
| |
| static const AUTO_PNS_TAB levelTable_lowComplexity[]= { |
| {0, 27999, 0, 0, 0, 0, 0,}, |
| {28000, 31999, 2, 2, 2, 2, 2,}, |
| {32000, 47999, 3, 3, 3, 3, 3,}, |
| {48000, 48000, 4, 4, 4, 4, 4,}, |
| {48001, 999999, 0, 0, 0, 0, 0,}, |
| }; |
| |
| /* conversion of old LC tuning tables to new (LD enc) structure (only entries which are actually used were converted) */ |
| static const PNS_INFO_TAB pnsInfoTab_lowComplexity[] = { |
| /*0 pns off */ |
| /* DEFAULT parameter set */ |
| /*1*/ { 4100, FL2FXCONST_SGL(0.03), FL2FXCONST_SGL(0.16), 1100, 1400, FL2FXCONST_SGL(0.5), 16, |
| USE_POWER_DISTRIBUTION | USE_PSYCH_TONALITY | USE_TNS_GAIN_THR | USE_TNS_PNS | JUST_LONG_WINDOW }, |
| /*2*/ { 4100, FL2FXCONST_SGL(0.05), FL2FXCONST_SGL(0.10), 1410, 1400, FL2FXCONST_SGL(0.5), 16, |
| USE_POWER_DISTRIBUTION | USE_PSYCH_TONALITY | USE_TNS_GAIN_THR | USE_TNS_PNS | JUST_LONG_WINDOW }, |
| /*3*/ { 4100, FL2FXCONST_SGL(0.05), FL2FXCONST_SGL(0.10), 1100, 1400, FL2FXCONST_SGL(0.5), 16, |
| USE_POWER_DISTRIBUTION | USE_PSYCH_TONALITY | USE_TNS_GAIN_THR | USE_TNS_PNS | JUST_LONG_WINDOW }, |
| /* LOWSUBST -> PNS is used less often than with DEFAULT parameter set (for br: 48000 - 79999) */ |
| /*4*/ { 4100, FL2FXCONST_SGL(0.20), FL2FXCONST_SGL(0.10), 1410, 1400, FL2FXCONST_SGL(0.5), 16, |
| USE_POWER_DISTRIBUTION | USE_PSYCH_TONALITY | USE_TNS_GAIN_THR | USE_TNS_PNS | JUST_LONG_WINDOW }, |
| }; |
| |
| /**************************************************************************** |
| function to look up used pns level |
| ****************************************************************************/ |
| int FDKaacEnc_lookUpPnsUse (int bitRate, int sampleRate, int numChan, const int isLC) { |
| |
| int hUsePns=0, size, i; |
| const AUTO_PNS_TAB *levelTable; |
| |
| if (isLC) { |
| levelTable = &levelTable_lowComplexity[0]; |
| size = sizeof(levelTable_lowComplexity); |
| } else |
| { /* (E)LD */ |
| levelTable = (numChan > 1) ? &levelTable_stereo[0] : &levelTable_mono[0]; |
| size = (numChan > 1) ? sizeof(levelTable_stereo) : sizeof(levelTable_mono); |
| } |
| |
| for(i = 0; i < (int) (size/sizeof(AUTO_PNS_TAB)); i++) { |
| if(((ULONG)bitRate >= levelTable[i].brFrom) && |
| ((ULONG)bitRate <= levelTable[i].brTo) ) |
| break; |
| } |
| |
| /* sanity check */ |
| if ((int)(sizeof(pnsInfoTab)/sizeof(PNS_INFO_TAB)) < i ) { |
| return (PNS_TABLE_ERROR); |
| } |
| |
| switch (sampleRate) { |
| case 22050: hUsePns = levelTable[i].S22050; break; |
| case 24000: hUsePns = levelTable[i].S24000; break; |
| case 32000: hUsePns = levelTable[i].S32000; break; |
| case 44100: hUsePns = levelTable[i].S44100; break; |
| case 48000: hUsePns = levelTable[i].S48000; break; |
| default: |
| if (isLC) { |
| hUsePns = levelTable[i].S48000; |
| } |
| break; |
| } |
| |
| return (hUsePns); |
| } |
| |
| |
| /***************************************************************************** |
| |
| functionname: FDKaacEnc_GetPnsParam |
| description: Gets PNS parameters depending on bitrate and bandwidth |
| returns: error status |
| input: Noiseparams struct, bitrate, sampling rate, |
| number of sfb's, pointer to sfb offset |
| output: PNS parameters |
| |
| *****************************************************************************/ |
| AAC_ENCODER_ERROR FDKaacEnc_GetPnsParam(NOISEPARAMS *np, |
| INT bitRate, |
| INT sampleRate, |
| INT sfbCnt, |
| const INT *sfbOffset, |
| INT *usePns, |
| INT numChan, |
| const int isLC) |
| |
| { |
| int i, hUsePns; |
| const PNS_INFO_TAB *pnsInfo; |
| |
| if (isLC) { |
| np->detectionAlgorithmFlags = IS_LOW_COMLEXITY; |
| pnsInfo = pnsInfoTab_lowComplexity; |
| } |
| else |
| { |
| np->detectionAlgorithmFlags = 0; |
| pnsInfo = pnsInfoTab; |
| } |
| |
| if (*usePns<=0) |
| return AAC_ENC_OK; |
| |
| /* new pns params */ |
| hUsePns = FDKaacEnc_lookUpPnsUse (bitRate, sampleRate, numChan, isLC); |
| if (hUsePns == 0) { |
| *usePns = 0; |
| return AAC_ENC_OK; |
| } |
| if (hUsePns == PNS_TABLE_ERROR) |
| return AAC_ENC_PNS_TABLE_ERROR; |
| |
| /* select correct row of tuning table */ |
| pnsInfo += hUsePns-1; |
| |
| np->startSfb = FDKaacEnc_FreqToBandWithRounding( pnsInfo->startFreq, |
| sampleRate, |
| sfbCnt, |
| sfbOffset ); |
| |
| np->detectionAlgorithmFlags |= pnsInfo->detectionAlgorithmFlags; |
| |
| np->refPower = FX_SGL2FX_DBL(pnsInfo->refPower); |
| np->refTonality = FX_SGL2FX_DBL(pnsInfo->refTonality); |
| np->tnsGainThreshold = pnsInfo->tnsGainThreshold; |
| np->tnsPNSGainThreshold = pnsInfo->tnsPNSGainThreshold; |
| np->minSfbWidth = pnsInfo->minSfbWidth; |
| |
| np->gapFillThr = (FIXP_SGL)pnsInfo->gapFillThr; |
| |
| /* assuming a constant dB/Hz slope in the signal's PSD curve, |
| the detection threshold needs to be corrected for the width of the band */ |
| for ( i = 0; i < (sfbCnt-1); i++) |
| { |
| INT qtmp, sfbWidth; |
| FIXP_DBL tmp; |
| |
| sfbWidth = sfbOffset[i+1]-sfbOffset[i]; |
| |
| tmp = fPow(np->refPower, 0, sfbWidth, DFRACT_BITS-1-5, &qtmp); |
| np->powDistPSDcurve[i] = (FIXP_SGL)((LONG)(scaleValue(tmp, qtmp) >> 16)); |
| } |
| np->powDistPSDcurve[sfbCnt] = np->powDistPSDcurve[sfbCnt-1]; |
| |
| return AAC_ENC_OK; |
| } |
