1b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber/* ------------------------------------------------------------------ 2b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber * Copyright (C) 1998-2009 PacketVideo 3b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber * 4b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber * Licensed under the Apache License, Version 2.0 (the "License"); 5b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber * you may not use this file except in compliance with the License. 6b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber * You may obtain a copy of the License at 7b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber * 8b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber * http://www.apache.org/licenses/LICENSE-2.0 9b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber * 10b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber * Unless required by applicable law or agreed to in writing, software 11b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber * distributed under the License is distributed on an "AS IS" BASIS, 12b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either 13b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber * express or implied. 14b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber * See the License for the specific language governing permissions 15b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber * and limitations under the License. 16b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber * ------------------------------------------------------------------- 17b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber */ 18b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber/**************************************************************************************** 19b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas HuberPortions of this file are derived from the following 3GPP standard: 20b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 21b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 3GPP TS 26.073 22b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber ANSI-C code for the Adaptive Multi-Rate (AMR) speech codec 23b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Available from http://www.3gpp.org 24b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 25b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber(C) 2004, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TTA, TTC) 26b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas HuberPermission to distribute, modify and use this file under the standard license 27b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huberterms listed above has been obtained from the copyright holder. 28b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber****************************************************************************************/ 29b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber/* 30b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 31b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 32b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 33b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 34b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Filename: /audio/gsm_amr/c/include/g_adapt.h 35b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 36b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Date: 02/05/2002 37b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 38b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 39b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber REVISION HISTORY 40b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 41b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Description: Placed header file in the proper template format. Added 42b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber parameter pOverflow for the basic math ops. 43b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 44b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Description: Replaced "int" and/or "char" with OSCL defined types. 45b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 46b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Description: Moved _cplusplus #ifdef after Include section. 47b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 48b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Description: 49b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 50b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 51b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber INCLUDE DESCRIPTION 52b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 53b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber This file contains all the constant definitions and prototype definitions 54b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber needed by the file, g_adapt.c 55b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 56b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber------------------------------------------------------------------------------ 57b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber*/ 58b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 59b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber/*---------------------------------------------------------------------------- 60b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber; CONTINUE ONLY IF NOT ALREADY DEFINED 61b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber----------------------------------------------------------------------------*/ 62b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber#ifndef g_adapt_h 63b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber#define g_adapt_h "$Id $" 64b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 65b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber/*---------------------------------------------------------------------------- 66b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber; INCLUDES 67b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber----------------------------------------------------------------------------*/ 68b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber#include "typedef.h" 69b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 70b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber/*--------------------------------------------------------------------------*/ 71b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber#ifdef __cplusplus 72b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huberextern "C" 73b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber{ 74b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber#endif 75b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 76b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber /*---------------------------------------------------------------------------- 77b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber ; MACROS 78b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber ; Define module specific macros here 79b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber ----------------------------------------------------------------------------*/ 80b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 81b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber /*---------------------------------------------------------------------------- 82b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber ; DEFINES 83b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber ; Include all pre-processor statements here. 84b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber ----------------------------------------------------------------------------*/ 85b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber#define LTPG_MEM_SIZE 5 /* number of stored past LTP coding gains + 1 */ 86b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 87b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber /*---------------------------------------------------------------------------- 88b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber ; EXTERNAL VARIABLES REFERENCES 89b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber ; Declare variables used in this module but defined elsewhere 90b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber ----------------------------------------------------------------------------*/ 91b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 92b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber /*---------------------------------------------------------------------------- 93b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber ; SIMPLE TYPEDEF'S 94b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber ----------------------------------------------------------------------------*/ 95b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 96b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber /*---------------------------------------------------------------------------- 97b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber ; ENUMERATED TYPEDEF'S 98b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber ----------------------------------------------------------------------------*/ 99b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 100b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber /*---------------------------------------------------------------------------- 101b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber ; STRUCTURES TYPEDEF'S 102b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber ----------------------------------------------------------------------------*/ 103b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber typedef struct 104b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber { 105b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Word16 onset; /* onset state, Q0 */ 106b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Word16 prev_alpha; /* previous adaptor output, Q15 */ 107b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Word16 prev_gc; /* previous code gain, Q1 */ 108b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 109b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Word16 ltpg_mem[LTPG_MEM_SIZE]; /* LTP coding gain history, Q13 */ 110b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber /* (ltpg_mem[0] not used for history) */ 111b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber } GainAdaptState; 112b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 113b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber /*---------------------------------------------------------------------------- 114b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber ; GLOBAL FUNCTION DEFINITIONS 115b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber ; Function Prototype declaration 116b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber ----------------------------------------------------------------------------*/ 117b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Word16 gain_adapt_init(GainAdaptState **st); 118b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber /* initialize one instance of the gain adaptor 119b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Stores pointer to state struct in *st. This pointer has to 120b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber be passed to gain_adapt and gain_adapt_update in each call. 121b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber returns 0 on success 122b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber */ 123b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 124b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Word16 gain_adapt_reset(GainAdaptState *st); 125b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber /* reset of gain adaptor state (i.e. set state memory to zero) 126b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber returns 0 on success 127b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber */ 128b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 129b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber void gain_adapt_exit(GainAdaptState **st); 130b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber /* de-initialize gain adaptor state (i.e. free state struct) 131b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber stores NULL in *st 132b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber */ 133b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 134b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber /************************************************************************* 135b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber * 136b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber * Function: gain_adapt() 137b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber * Purpose: calculate pitch/codebook gain adaptation factor alpha 138b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber * (and update the adaptor state) 139b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber * 140b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber ************************************************************************** 141b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber */ 142b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber void gain_adapt( 143b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber GainAdaptState *st, /* i : state struct */ 144b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Word16 ltpg, /* i : ltp coding gain (log2()), Q */ 145b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Word16 gain_cod, /* i : code gain, Q13 */ 146b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Word16 *alpha, /* o : gain adaptation factor, Q15 */ 147b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber Flag *pOverflow /* o : overflow indicator */ 148b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber ); 149b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 150b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber /*---------------------------------------------------------------------------- 151b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber ; END 152b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber ----------------------------------------------------------------------------*/ 153b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber#ifdef __cplusplus 154b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber} 155b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber#endif 156b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 157b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber#endif /* _H_ */ 158b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 159b841f14f8e51f2365945281fbfa54ef6a1b1b5a6Andreas Huber 160