| /* ----------------------------------------------------------------------------- | |
| Software License for The Fraunhofer FDK AAC Codec Library for Android | |
| © Copyright 1995 - 2018 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 | |
| ----------------------------------------------------------------------------- */ | |
| /**************************** AAC encoder library ****************************** | |
| Author(s): M. Lohwasser, M. Gayer | |
| Description: | |
| *******************************************************************************/ | |
| /*! | |
| \file | |
| \brief Memory layout | |
| \author Markus Lohwasser | |
| */ | |
| #include "aacEnc_ram.h" | |
| C_AALLOC_MEM(AACdynamic_RAM, FIXP_DBL, AAC_ENC_DYN_RAM_SIZE / sizeof(FIXP_DBL)) | |
| /* | |
| Static memory areas, must not be overwritten in other sections of the decoder | |
| ! | |
| */ | |
| /* | |
| The structure AacEncoder contains all Encoder structures. | |
| */ | |
| C_ALLOC_MEM(Ram_aacEnc_AacEncoder, struct AAC_ENC, 1) | |
| /* | |
| The structure PSY_INTERNAl contains all psych configuration and data pointer. | |
| * PsyStatic holds last and current Psych data. | |
| * PsyInputBuffer contains time input. Signal is needed at the beginning of | |
| Psych. Memory can be reused after signal is in time domain. | |
| * PsyData contains spectral, nrg and threshold information. Necessary data | |
| are copied into PsyOut, so memory is available after leaving psych. | |
| * TnsData, ChaosMeasure, PnsData are temporarily necessary, e.g. use memory | |
| from PsyInputBuffer. | |
| */ | |
| C_ALLOC_MEM2(Ram_aacEnc_PsyElement, PSY_ELEMENT, 1, ((8))) | |
| C_ALLOC_MEM(Ram_aacEnc_PsyInternal, PSY_INTERNAL, 1) | |
| C_ALLOC_MEM2(Ram_aacEnc_PsyStatic, PSY_STATIC, 1, (8)) | |
| C_ALLOC_MEM2(Ram_aacEnc_PsyInputBuffer, INT_PCM, MAX_INPUT_BUFFER_SIZE, (8)) | |
| PSY_DYNAMIC *GetRam_aacEnc_PsyDynamic(int n, UCHAR *dynamic_RAM) { | |
| FDK_ASSERT(dynamic_RAM != 0); | |
| /* The reinterpret_cast is used to suppress a compiler warning. We know that | |
| * (dynamic_RAM + P_BUF_1 + n*sizeof(PSY_DYNAMIC)) is sufficiently aligned, so | |
| * the cast is safe */ | |
| return reinterpret_cast<PSY_DYNAMIC *>(reinterpret_cast<void *>( | |
| dynamic_RAM + P_BUF_1 + n * sizeof(PSY_DYNAMIC))); | |
| } | |
| /* | |
| The structure PSY_OUT holds all psychoaccoustic data needed | |
| in quantization module | |
| */ | |
| C_ALLOC_MEM2(Ram_aacEnc_PsyOut, PSY_OUT, 1, (1)) | |
| C_ALLOC_MEM2(Ram_aacEnc_PsyOutElements, PSY_OUT_ELEMENT, 1, (1) * ((8))) | |
| C_ALLOC_MEM2(Ram_aacEnc_PsyOutChannel, PSY_OUT_CHANNEL, 1, (1) * (8)) | |
| /* | |
| The structure QC_STATE contains preinitialized settings and quantizer | |
| structures. | |
| * AdjustThreshold structure contains element-wise settings. | |
| * ElementBits contains elemnt-wise bit consumption settings. | |
| * When CRC is active, lookup table is necessary for fast crc calculation. | |
| * Bitcounter contains buffer to find optimal codebooks and minimal bit | |
| consumption. Values are temporarily, so dynamic memory can be used. | |
| */ | |
| C_ALLOC_MEM(Ram_aacEnc_QCstate, QC_STATE, 1) | |
| C_ALLOC_MEM(Ram_aacEnc_AdjustThreshold, ADJ_THR_STATE, 1) | |
| C_ALLOC_MEM2(Ram_aacEnc_AdjThrStateElement, ATS_ELEMENT, 1, ((8))) | |
| C_ALLOC_MEM2(Ram_aacEnc_ElementBits, ELEMENT_BITS, 1, ((8))) | |
| C_ALLOC_MEM(Ram_aacEnc_BitCntrState, struct BITCNTR_STATE, 1) | |
| INT *GetRam_aacEnc_BitLookUp(int n, UCHAR *dynamic_RAM) { | |
| FDK_ASSERT(dynamic_RAM != 0); | |
| /* The reinterpret_cast is used to suppress a compiler warning. We know that | |
| * (dynamic_RAM + P_BUF_1) is sufficiently aligned, so the cast is safe */ | |
| return reinterpret_cast<INT *>( | |
| reinterpret_cast<void *>(dynamic_RAM + P_BUF_1)); | |
| } | |
| INT *GetRam_aacEnc_MergeGainLookUp(int n, UCHAR *dynamic_RAM) { | |
| FDK_ASSERT(dynamic_RAM != 0); | |
| /* The reinterpret_cast is used to suppress a compiler warning. We know that | |
| * (dynamic_RAM + P_BUF_1 + sizeof(INT)*(MAX_SFB_LONG*(CODE_BOOK_ESC_NDX+1))) | |
| * is sufficiently aligned, so the cast is safe */ | |
| return reinterpret_cast<INT *>(reinterpret_cast<void *>( | |
| dynamic_RAM + P_BUF_1 + | |
| sizeof(INT) * (MAX_SFB_LONG * (CODE_BOOK_ESC_NDX + 1)))); | |
| } | |
| /* | |
| The structure QC_OUT contains settings and structures holding all necessary | |
| information needed in bitstreamwriter. | |
| */ | |
| C_ALLOC_MEM2(Ram_aacEnc_QCout, QC_OUT, 1, (1)) | |
| C_ALLOC_MEM2(Ram_aacEnc_QCelement, QC_OUT_ELEMENT, 1, (1) * ((8))) | |
| QC_OUT_CHANNEL *GetRam_aacEnc_QCchannel(int n, UCHAR *dynamic_RAM) { | |
| FDK_ASSERT(dynamic_RAM != 0); | |
| /* The reinterpret_cast is used to suppress a compiler warning. We know that | |
| * (dynamic_RAM + P_BUF_0 + n*sizeof(QC_OUT_CHANNEL)) is sufficiently aligned, | |
| * so the cast is safe */ | |
| return reinterpret_cast<QC_OUT_CHANNEL *>(reinterpret_cast<void *>( | |
| dynamic_RAM + P_BUF_0 + n * sizeof(QC_OUT_CHANNEL))); | |
| } |