gc_pred.h revision 4f1efc098cb5791c3e9f483f2af84aef70d2d0a0
14f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber/* ------------------------------------------------------------------ 24f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber * Copyright (C) 1998-2009 PacketVideo 34f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber * 44f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber * Licensed under the Apache License, Version 2.0 (the "License"); 54f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber * you may not use this file except in compliance with the License. 64f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber * You may obtain a copy of the License at 74f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber * 84f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber * http://www.apache.org/licenses/LICENSE-2.0 94f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber * 104f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber * Unless required by applicable law or agreed to in writing, software 114f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber * distributed under the License is distributed on an "AS IS" BASIS, 124f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either 134f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber * express or implied. 144f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber * See the License for the specific language governing permissions 154f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber * and limitations under the License. 164f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber * ------------------------------------------------------------------- 174f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber */ 184f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber/**************************************************************************************** 194f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas HuberPortions of this file are derived from the following 3GPP standard: 204f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 214f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 3GPP TS 26.073 224f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber ANSI-C code for the Adaptive Multi-Rate (AMR) speech codec 234f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Available from http://www.3gpp.org 244f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 254f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber(C) 2004, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TTA, TTC) 264f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas HuberPermission to distribute, modify and use this file under the standard license 274f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huberterms listed above has been obtained from the copyright holder. 284f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber****************************************************************************************/ 294f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber/* 304f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 314f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Filename: /audio/gsm_amr/c/src/include/gc_pred.h 324f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 334f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 344f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber REVISION HISTORY 354f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 364f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Description: Replaced "int" and/or "char" with OSCL defined types. 374f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 384f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Description: Moved _cplusplus #ifdef after Include section. 394f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 404f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Who: Date: 414f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Description: 424f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 434f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 444f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber INCLUDE DESCRIPTION 454f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 464f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber File : gc_pred.h 474f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Purpose : codebook gain MA prediction 484f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 494f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber------------------------------------------------------------------------------ 504f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber*/ 514f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 524f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber#ifndef _GC_PRED_H_ 534f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber#define _GC_PRED_H_ 544f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber#define gc_pred_h "$Id $" 554f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 564f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber/*---------------------------------------------------------------------------- 574f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber; INCLUDES 584f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber----------------------------------------------------------------------------*/ 594f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber#include "typedef.h" 604f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber#include "mode.h" 614f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 624f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 634f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber/*--------------------------------------------------------------------------*/ 644f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber#ifdef __cplusplus 654f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huberextern "C" 664f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber{ 674f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber#endif 684f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 694f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber /*---------------------------------------------------------------------------- 704f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber ; MACROS 714f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber ; [Define module specific macros here] 724f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber ----------------------------------------------------------------------------*/ 734f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 744f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber /*---------------------------------------------------------------------------- 754f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber ; DEFINES 764f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber ; [Include all pre-processor statements here.] 774f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber ----------------------------------------------------------------------------*/ 784f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 794f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber /*---------------------------------------------------------------------------- 804f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber ; EXTERNAL VARIABLES REFERENCES 814f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber ; [Declare variables used in this module but defined elsewhere] 824f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber ----------------------------------------------------------------------------*/ 834f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 844f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber /*---------------------------------------------------------------------------- 854f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber ; SIMPLE TYPEDEF'S 864f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber ----------------------------------------------------------------------------*/ 874f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 884f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber /*---------------------------------------------------------------------------- 894f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber ; ENUMERATED TYPEDEF'S 904f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber ----------------------------------------------------------------------------*/ 914f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 924f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber /*---------------------------------------------------------------------------- 934f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber ; STRUCTURES TYPEDEF'S 944f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber ----------------------------------------------------------------------------*/ 954f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber typedef struct 964f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber { 974f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 past_qua_en[4]; /* normal MA predictor memory, Q10 */ 984f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber /* (contains 20*log10(qua_err)) */ 994f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 past_qua_en_MR122[4]; /* MA predictor memory for MR122 mode, Q10 */ 1004f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber /* (contains log2(qua_err)) */ 1014f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber } gc_predState; 1024f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1034f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber /*---------------------------------------------------------------------------- 1044f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber ; GLOBAL FUNCTION DEFINITIONS 1054f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber ; [List function prototypes here] 1064f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber ----------------------------------------------------------------------------*/ 1074f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1084f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 gc_pred_reset(gc_predState *st); 1094f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber /* reset of codebook gain MA predictor state (i.e. set state memory to zero) 1104f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber returns 0 on success 1114f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber */ 1124f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber void gc_pred_exit(gc_predState **st); 1134f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber /* de-initialize codebook gain MA predictor state (i.e. free state struct) 1144f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber stores NULL in *st 1154f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber */ 1164f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1174f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber void 1184f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber gc_pred_copy( 1194f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber gc_predState *st_src, /* i : State struct */ 1204f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber gc_predState *st_dest /* o : State struct */ 1214f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber ); 1224f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1234f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber /* 1244f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber * FUNCTION: gc_pred() 1254f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber * PURPOSE: MA prediction of the innovation energy 1264f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber * (in dB/(20*log10(2))) with mean removed). 1274f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber */ 1284f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber void gc_pred( 1294f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber gc_predState *st, /* i/o: State struct */ 1304f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber enum Mode mode, /* i : AMR mode */ 1314f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 *code, /* i : innovative codebook vector (L_SUBFR) */ 1324f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber /* MR122: Q12, other modes: Q13 */ 1334f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 *exp_gcode0, /* o : exponent of predicted gain factor, Q0 */ 1344f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 *frac_gcode0,/* o : fraction of predicted gain factor Q15 */ 1354f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 *exp_en, /* o : exponent of innovation energy, Q0 */ 1364f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber /* (only calculated for MR795) */ 1374f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 *frac_en, /* o : fraction of innovation energy, Q15 */ 1384f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber /* (only calculated for MR795) */ 1394f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Flag *pOverflow 1404f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber ); 1414f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1424f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber /* 1434f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber * FUNCTION: gc_pred_update() 1444f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber * PURPOSE: update MA predictor with last quantized energy 1454f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber */ 1464f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber void gc_pred_update( 1474f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber gc_predState *st, /* i/o: State struct */ 1484f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 qua_ener_MR122, /* i : quantized energy for update, Q10 */ 1494f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber /* (log2(qua_err)) */ 1504f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 qua_ener /* i : quantized energy for update, Q10 */ 1514f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber /* (20*log10(qua_err)) */ 1524f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber ); 1534f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1544f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber /* 1554f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber * FUNCTION: gc_pred_average_limited() 1564f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber * PURPOSE: get average of MA predictor state values (with a lower limit) 1574f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber * [used in error concealment] 1584f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber */ 1594f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber void gc_pred_average_limited( 1604f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber gc_predState *st, /* i: State struct */ 1614f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 *ener_avg_MR122, /* o: averaged quantized energy, Q10 */ 1624f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber /* (log2(qua_err)) */ 1634f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Word16 *ener_avg, /* o: averaged quantized energy, Q10 */ 1644f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber /* (20*log10(qua_err)) */ 1654f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber Flag *pOverflow 1664f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber ); 1674f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1684f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1694f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber#ifdef __cplusplus 1704f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber} 1714f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber#endif 1724f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1734f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber#endif /* _GC_PRED_H_ */ 1744f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1754f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 1764f1efc098cb5791c3e9f483f2af84aef70d2d0a0Andreas Huber 177