/* ------------------------------------------------------------------ * Copyright (C) 1998-2009 PacketVideo * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either * express or implied. * See the License for the specific language governing permissions * and limitations under the License. * ------------------------------------------------------------------- */ /* Pathname: PVMP4AudioDecoderInitLibrary.c ------------------------------------------------------------------------------ REVISION HISTORY Description: Copied from aac_decode_frame Description: Clean up. Description: Update per review comments Description: Add frame_length, fix mistake in pseudo-code. Change frame_length to frameLength, to matcht the API, look more professional, etc. Description: (1) Added #include of "e_ProgConfigConst.h" Previously, this function was relying on another include file to include "e_ProgConfigConst.h" (2) Updated the copyright header. Description: (1) Modified to initialize pointers for shared memory techniques. Description: Since memory will be allocated continuously, it is initialized in one spot Description: Added field aacPlusUpsamplingFactor (default == 1) to have a common interface for all AAC variations Description: Added PVMP4AudioDecoderDisableAacPlus to disable sbr decoding Who: Date: MM/DD/YYYY Description: ------------------------------------------------------------------------------ INPUT AND OUTPUT DEFINITIONS Inputs: pExt = pointer to the external application-program interface (API) structure that a client program uses to communicate information with this library. Among the items in this structure is a pointer to the input and output buffers, data for handling the input buffer and output information. Look in PVMP4AudioDecoder_API.h for all the fields to this structure. Data type pointer to a tPVMP4AudioDecoderExternal structure. pMem = pointer to allocated memory, of the size returned by the function PVMP4AudioDecoderGetMemRequirements. This is a void pointer for two reasons: 1) So the external program does not need all of the header files for all of the fields in the structure tDec_Int_File 2) To hide data and the implementation of the program. Even knowing how data is stored can help in reverse engineering software. Local Stores/Buffers/Pointers Needed: None Global Stores/Buffers/Pointers Needed: None Outputs: status = 0 (SUCCESS). Presently there is no error checking in this function. Pointers and Buffers Modified: None Local Stores Modified: None Global Stores Modified: None ------------------------------------------------------------------------------ FUNCTION DESCRIPTION Initializes the internal memory for the MP4 Audio Decoder library. Also sets relevant values for the external interface structure, clears the bit rate, channel count, sampling rate, and number of used buffer elements. ------------------------------------------------------------------------------ REQUIREMENTS ------------------------------------------------------------------------------ REFERENCES (1) MPEG-2 NBC Audio Decoder "This software module was originally developed by AT&T, Dolby Laboratories, Fraunhofer Gesellschaft IIS in the course of development of the MPEG-2 NBC/MPEG-4 Audio standard ISO/IEC 13818-7, 14496-1,2 and 3. This software module is an implementation of a part of one or more MPEG-2 NBC/MPEG-4 Audio tools as specified by the MPEG-2 NBC/MPEG-4 Audio standard. ISO/IEC gives users of the MPEG-2 NBC/MPEG-4 Audio standards free license to this software module or modifications thereof for use in hardware or software products claiming conformance to the MPEG-2 NBC/MPEG-4 Audio standards. Those intending to use this software module in hardware or software products are advised that this use may infringe existing patents. The original developer of this software module and his/her company, the subsequent editors and their companies, and ISO/IEC have no liability for use of this software module or modifications thereof in an implementation. Copyright is not released for non MPEG-2 NBC/MPEG-4 Audio conforming products.The original developer retains full right to use the code for his/her own purpose, assign or donate the code to a third party and to inhibit third party from using the code for non MPEG-2 NBC/MPEG-4 Audio conforming products. This copyright notice must be included in all copies or derivative works." Copyright(c)1996. ------------------------------------------------------------------------------ PSEUDO-CODE pVars = pMem; CALL pv_memset( to = pVars, c = 0, n = sizeof(tDec_Int_File)) MODIFYING(*pVars = 0) RETURNING(nothing) pVars->current_program = -1 pVars->mc_info.sampling_rate_idx = Fs_44 pVars->frameLength = LONG_WINDOW pVars->winmap[ONLY_LONG_SEQUENCE] = &pVars->longFrameInfo; pVars->winmap[LONG_START_SEQUENCE] = &pVars->longFrameInfo; pVars->winmap[EIGHT_SHORT_SEQUENCE] = &pVars->shortFrameInfo; pVars->winmap[LONG_STOP_SEQUENCE] = &pVars->longFrameInfo; CALL infoinit( samp_rate_indx = pVars->mc_info.sampling_rate_idx, ppWin_seq_info = pVars->winmap, pSfbwidth128 = pVars->SFBWidth128) MODIFYING(ppWinSeq_info) MODIFYING(pSfbwidth128) RETURNING(nothing) pExt->bitRate = 0; pExt->encodedChannels = 0; pExt->samplingRate = 0; pExt->inputBufferUsedLength = 0; MODIFY(pExt) MODIFY(pMem) RETURN(SUCCESS) ------------------------------------------------------------------------------ RESOURCES USED When the code is written for a specific target processor the the resources used should be documented below. STACK USAGE: [stack count for this module] + [variable to represent stack usage for each subroutine called] where: [stack usage variable] = stack usage for [subroutine name] (see [filename].ext) DATA MEMORY USED: x words PROGRAM MEMORY USED: x words CLOCK CYCLES: [cycle count equation for this module] + [variable used to represent cycle count for each subroutine called] where: [cycle count variable] = cycle count for [subroutine name] (see [filename].ext) ------------------------------------------------------------------------------ */ /*---------------------------------------------------------------------------- ; INCLUDES ----------------------------------------------------------------------------*/ #include "pv_audio_type_defs.h" #include "s_tdec_int_file.h" #include "e_progconfigconst.h" #include "huffman.h" /* For the definition of infoinit */ #include "aac_mem_funcs.h" /* For pv_memset */ #include "pvmp4audiodecoder_api.h" /* Where this function is declared */ #include "s_tdec_int_chan.h" #include "sfb.h" /* samp_rate_info[] is declared here */ /*---------------------------------------------------------------------------- ; MACROS ; Define module specific macros here ----------------------------------------------------------------------------*/ /*---------------------------------------------------------------------------- ; DEFINES ; Include all pre-processor statements here. Include conditional ; compile variables also. ----------------------------------------------------------------------------*/ /*---------------------------------------------------------------------------- ; LOCAL FUNCTION DEFINITIONS ; Function Prototype declaration ----------------------------------------------------------------------------*/ /*---------------------------------------------------------------------------- ; LOCAL VARIABLE DEFINITIONS ; Variable declaration - defined here and used outside this module ----------------------------------------------------------------------------*/ /*---------------------------------------------------------------------------- ; EXTERNAL FUNCTION REFERENCES ; Declare functions defined elsewhere and referenced in this module ----------------------------------------------------------------------------*/ /*---------------------------------------------------------------------------- ; EXTERNAL VARIABLES REFERENCES ; Declare variables used in this module but defined elsewhere ----------------------------------------------------------------------------*/ /*---------------------------------------------------------------------------- ; FUNCTION CODE ----------------------------------------------------------------------------*/ OSCL_EXPORT_REF Int PVMP4AudioDecoderInitLibrary( tPVMP4AudioDecoderExternal *pExt, void *pMem) { tDec_Int_File *pVars; pVars = (tDec_Int_File *)pMem; /* * Initialize all memory. The pointers to channel memory will be * set to zero also. */ pv_memset( pVars, 0, sizeof(tDec_Int_File)); /* * Pick default values for the library. */ pVars->perChan[0].fxpCoef = pVars->fxpCoef[0]; pVars->perChan[1].fxpCoef = pVars->fxpCoef[1]; /* Here, the "shared memory" pointer is set to point * at the 1024th element of fxpCoef, because those spaces * in memory are not used until the filterbank is called. * * Therefore, any variables that are only used before * the filterbank can occupy this same space in memory. */ pVars->perChan[0].pShareWfxpCoef = (per_chan_share_w_fxpCoef *) & (pVars->perChan[0].fxpCoef[1024]); pVars->perChan[1].pShareWfxpCoef = (per_chan_share_w_fxpCoef *) & (pVars->perChan[1].fxpCoef[1024]); /* * This next line informs the function get_prog_config that no * configuration has been found thus far, so it is a default * configuration. */ pVars->current_program = -1; pVars->mc_info.sampling_rate_idx = Fs_44; /* Fs_44 = 4, 44.1kHz */ /* * In the future, the frame length will change with MP4 file format. * Presently this variable is used to simply the unit test for * the function PVMP4AudioDecodeFrame() .. otherwise the test would * have to pass around 1024 length arrays. */ pVars->frameLength = LONG_WINDOW; /* 1024*/ /* * The window types ONLY_LONG_SEQUENCE, LONG_START_SEQUENCE, and * LONG_STOP_SEQUENCE share the same information. The only difference * between the windows is accounted for in the "filterbank", in * the function trans4m_freq_2_time_fxp() */ pVars->winmap[ONLY_LONG_SEQUENCE] /* 0 */ = &pVars->longFrameInfo; pVars->winmap[LONG_START_SEQUENCE] /* 1 */ = &pVars->longFrameInfo; pVars->winmap[EIGHT_SHORT_SEQUENCE] /* 2 */ = &pVars->shortFrameInfo; pVars->winmap[LONG_STOP_SEQUENCE] /* 3 */ = &pVars->longFrameInfo; infoinit( pVars->mc_info.sampling_rate_idx, (FrameInfo **)pVars->winmap, pVars->SFBWidth128); /* * Clear out external output values. These values are set later at the end * of PVMP4AudioDecodeFrames() */ pExt->bitRate = 0; pExt->encodedChannels = 0; pExt->samplingRate = 0; pExt->aacPlusUpsamplingFactor = 1; /* Default for regular AAC */ pVars->aacPlusEnabled = pExt->aacPlusEnabled; #if defined(AAC_PLUS) pVars->sbrDecoderData.setStreamType = 1; /* Enable Lock for AAC stream type setting */ #endif /* * Initialize input buffer variable. */ pExt->inputBufferUsedLength = 0; return (MP4AUDEC_SUCCESS); } /* PVMP4AudioDecoderInitLibrary */ /* ------------------------------------------------------------------------------ INPUT AND OUTPUT DEFINITIONS Inputs: pExt = pointer to the external application-program interface (API) structure that a client program uses to communicate information with this library. Among the items in this structure is a pointer to the input and output buffers, data for handling the input buffer and output information. Look in PVMP4AudioDecoder_API.h for all the fields to this structure. Data type pointer to a tPVMP4AudioDecoderExternal structure. pMem = pointer to allocated memory, of the size returned by the function PVMP4AudioDecoderGetMemRequirements. This is a void pointer for two reasons: 1) So the external program does not need all of the header files for all of the fields in the structure tDec_Int_File 2) To hide data and the implementation of the program. Even knowing how data is stored can help in reverse engineering software. Local Stores/Buffers/Pointers Needed: None Global Stores/Buffers/Pointers Needed: None Outputs: status = 0 (SUCCESS). Presently there is no error checking in this function. Pointers and Buffers Modified: None Local Stores Modified: None Global Stores Modified: None ------------------------------------------------------------------------------ FUNCTION DESCRIPTION Disable SBR decoding functionality and set parameters accordingly ------------------------------------------------------------------------------ REQUIREMENTS ---------------------------------------------------------------------------- ; FUNCTION CODE ----------------------------------------------------------------------------*/ OSCL_EXPORT_REF void PVMP4AudioDecoderDisableAacPlus( tPVMP4AudioDecoderExternal *pExt, void *pMem) { tDec_Int_File *pVars; pVars = (tDec_Int_File *)pMem; if ((pVars->aacPlusEnabled == true) && (pExt->aacPlusEnabled == true)) { // disable only when makes sense pVars->aacPlusEnabled = false; pExt->aacPlusEnabled = false; #if defined(AAC_PLUS) pVars->mc_info.upsamplingFactor = 1; pVars->mc_info.psPresentFlag = 0; pVars->mc_info.sbrPresentFlag = 0; pVars->prog_config.sampling_rate_idx += 3; pVars->sbrDecoderData.SbrChannel[0].syncState = SBR_NOT_INITIALIZED; pVars->sbrDecoderData.SbrChannel[1].syncState = SBR_NOT_INITIALIZED; pExt->samplingRate = samp_rate_info[pVars->prog_config.sampling_rate_idx].samp_rate; pExt->aacPlusUpsamplingFactor = 1; #endif } } /* PVMP4AudioDecoderDisableAacPlus */