/* ------------------------------------------------------------------ * 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. * ------------------------------------------------------------------- */ /**************************************************************************************** Portions of this file are derived from the following 3GPP standard: 3GPP TS 26.073 ANSI-C code for the Adaptive Multi-Rate (AMR) speech codec Available from http://www.3gpp.org (C) 2004, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TTA, TTC) Permission to distribute, modify and use this file under the standard license terms listed above has been obtained from the copyright holder. ****************************************************************************************/ /* ------------------------------------------------------------------------------ Pathname: ./audio/gsm-amr/c/src/d_plsf_3.c Functions: D_plsf_3 ------------------------------------------------------------------------------ INPUT AND OUTPUT DEFINITIONS Inputs: st -- Pointer to type struct D_plsfState mode -- enum Mode -- coder mode bfi -- Word16 -- bad frame indicator (set to 1 if a bad frame is received) indice -- Pointer to type Word16 -- quantization indices of 3 submatrices, Q0 Outputs: st -- Pointer to type struct D_plsfState lsp1_q -- Pointer to type Word16 -- quantized 1st LSP vector Q15 pOverflow -- Pointer to type Flag -- Flag set when overflow occurs Returns: None. Global Variables Used: None Local Variables Needed: None ------------------------------------------------------------------------------ FUNCTION DESCRIPTION PURPOSE: Decodes the LSP parameters using the received quantization indices.1st order MA prediction and split by 3 vector quantization (split-VQ) ------------------------------------------------------------------------------ REQUIREMENTS ------------------------------------------------------------------------------ REFERENCES d_plsf_3.c, UMTS GSM AMR speech codec, R99 - Version 3.2.0, March 2, 2001 ------------------------------------------------------------------------------ PSEUDO-CODE ------------------------------------------------------------------------------ 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 "d_plsf.h" #include "typedef.h" #include "basic_op.h" #include "lsp_lsf.h" #include "reorder.h" #include "copy.h" #include "q_plsf_3_tbl.h" /*---------------------------------------------------------------------------- ; MACROS ; Define module specific macros here ----------------------------------------------------------------------------*/ /*---------------------------------------------------------------------------- ; DEFINES ; Include all pre-processor statements here. Include conditional ; compile variables also. ----------------------------------------------------------------------------*/ #define ALPHA 29491 /* ALPHA -> 0.9 */ #define ONE_ALPHA 3277 /* ONE_ALPHA-> (1.0-ALPHA) */ /*---------------------------------------------------------------------------- ; LOCAL FUNCTION DEFINITIONS ; Function Prototype declaration ----------------------------------------------------------------------------*/ /*---------------------------------------------------------------------------- ; LOCAL STORE/BUFFER/POINTER DEFINITIONS ; Variable declaration - defined here and used outside this module ----------------------------------------------------------------------------*/ /*---------------------------------------------------------------------------- ; EXTERNAL FUNCTION REFERENCES ; Declare functions defined elsewhere and referenced in this module ----------------------------------------------------------------------------*/ /*---------------------------------------------------------------------------- ; EXTERNAL GLOBAL STORE/BUFFER/POINTER REFERENCES ; Declare variables used in this module but defined elsewhere ----------------------------------------------------------------------------*/ /*---------------------------------------------------------------------------- ; FUNCTION CODE ----------------------------------------------------------------------------*/ void D_plsf_3( D_plsfState *st, /* i/o: State struct */ enum Mode mode, /* i : coder mode */ Word16 bfi, /* i : bad frame indicator (set to 1 if a */ /* bad frame is received) */ Word16 * indice, /* i : quantization indices of 3 submatrices, Q0 */ Word16 * lsp1_q, /* o : quantized 1st LSP vector, Q15 */ Flag *pOverflow /* o : Flag set when overflow occurs */ ) { Word16 i; Word16 temp; Word16 index; Word16 lsf1_r[M]; Word16 lsf1_q[M]; if (bfi != 0) /* if bad frame */ { /* use the past LSFs slightly shifted towards their mean */ for (i = 0; i < M; i++) { /* lsfi_q[i] = ALPHA*past_lsf_q[i] + ONE_ALPHA*mean_lsf[i]; */ temp = mult( st->past_lsf_q[i], ALPHA, pOverflow); index = mult( mean_lsf_3[i], ONE_ALPHA, pOverflow); lsf1_q[i] = add( index, temp, pOverflow); } /* estimate past quantized residual to be used in next frame */ if (mode != MRDTX) { for (i = 0; i < M; i++) { /* temp = mean_lsf[i] + past_r2_q[i] * PRED_FAC; */ temp = mult( st->past_r_q[i], pred_fac_3[i], pOverflow); temp = add( mean_lsf_3[i], temp, pOverflow); st->past_r_q[i] = sub( lsf1_q[i], temp, pOverflow); } } /* if (mode == MRDTX) */ else { for (i = 0; i < M; i++) { /* temp = mean_lsf[i] + past_r2_q[i]; */ temp = add( mean_lsf_3[i], st->past_r_q[i], pOverflow); st->past_r_q[i] = sub( lsf1_q[i], temp, pOverflow); } } } /* if (bfi != 0) */ else /* if good LSFs received */ { Word16 index_limit_1 = 0; Word16 index_limit_2 = (DICO2_SIZE - 1) * 3; Word16 index_limit_3 = 0; const Word16 *p_cb1; const Word16 *p_cb2; const Word16 *p_cb3; const Word16 *p_dico; p_cb2 = dico2_lsf_3; /* size DICO2_SIZE*3 */ if ((mode == MR475) || (mode == MR515)) { /* MR475, MR515 */ p_cb1 = dico1_lsf_3; /* size DICO1_SIZE*3 */ p_cb3 = mr515_3_lsf; /* size MR515_3_SIZE*4 */ index_limit_1 = (DICO1_SIZE - 1) * 3; index_limit_3 = (MR515_3_SIZE - 1) * 4; } else if (mode == MR795) { /* MR795 */ p_cb1 = mr795_1_lsf; /* size MR795_1_SIZE*3 */ p_cb3 = dico3_lsf_3; /* size DICO3_SIZE*4 */ index_limit_1 = (MR795_1_SIZE - 1) * 3; index_limit_3 = (DICO3_SIZE - 1) * 4; } else { /* MR59, MR67, MR74, MR102, MRDTX */ p_cb1 = dico1_lsf_3; /* size DICO1_SIZE*3 */ p_cb3 = dico3_lsf_3; /* size DICO3_SIZE*4 */ index_limit_1 = (DICO1_SIZE - 1) * 3; index_limit_3 = (DICO3_SIZE - 1) * 4; } /* decode prediction residuals from 3 received indices */ index = *indice++; /* temp = 3*index; */ temp = index + (index << 1); if (temp > index_limit_1) { temp = index_limit_1; /* avoid buffer overrun */ } p_dico = &p_cb1[temp]; lsf1_r[0] = *p_dico++; lsf1_r[1] = *p_dico++; lsf1_r[2] = *p_dico++; index = *indice++; if (mode == MR475 || mode == MR515) { /* MR475, MR515 only using every second entry */ index <<= 1; } /* temp = 3*index */ temp = index + (index << 1); if (temp > index_limit_2) { temp = index_limit_2; /* avoid buffer overrun */ } p_dico = &p_cb2[temp]; lsf1_r[3] = *p_dico++; lsf1_r[4] = *p_dico++; lsf1_r[5] = *p_dico++; index = *indice++; temp = index << 2; if (temp > index_limit_3) { temp = index_limit_3; /* avoid buffer overrun */ } p_dico = &p_cb3[temp]; lsf1_r[6] = *p_dico++; lsf1_r[7] = *p_dico++; lsf1_r[8] = *p_dico++; lsf1_r[9] = *p_dico++; /* Compute quantized LSFs and update the past quantized residual */ if (mode != MRDTX) { for (i = 0; i < M; i++) { temp = mult( st->past_r_q[i], pred_fac_3[i], pOverflow); temp = add( mean_lsf_3[i], temp, pOverflow); lsf1_q[i] = add( lsf1_r[i], temp, pOverflow); st->past_r_q[i] = lsf1_r[i]; } } else { for (i = 0; i < M; i++) { temp = add( mean_lsf_3[i], st->past_r_q[i], pOverflow); lsf1_q[i] = add( lsf1_r[i], temp, pOverflow); st->past_r_q[i] = lsf1_r[i]; } } } /* verification that LSFs has minimum distance of LSF_GAP Hz */ Reorder_lsf( lsf1_q, LSF_GAP, M, pOverflow); Copy( lsf1_q, st->past_lsf_q, M); /* convert LSFs to the cosine domain */ Lsf_lsp( lsf1_q, lsp1_q, M, pOverflow); return; } /* ------------------------------------------------------------------------------ FUNCTION NAME: Init_D_plsf_3 ------------------------------------------------------------------------------ INPUT AND OUTPUT DEFINITIONS Inputs: st = pointer to a structure of type D_plsfState index = Word16, past_rq_init[] index [0, 7] Outputs: st = pointer to a structure of type D_plsfState Returns: None Global Variables Used: None. Local Variables Needed: None. ------------------------------------------------------------------------------ FUNCTION DESCRIPTION This function initializes the D_plsfState structure. ------------------------------------------------------------------------------ REQUIREMENTS None. ------------------------------------------------------------------------------ REFERENCES d_plsf_3.c, UMTS GSM AMR speech codec, R99 - Version 3.2.0, March 2, 2001 ------------------------------------------------------------------------------ PSEUDO-CODE ------------------------------------------------------------------------------ RESOURCES USED [optional] When the code is written for a specific target processor the the resources used should be documented below. HEAP MEMORY USED: x bytes STACK MEMORY USED: x bytes CLOCK CYCLES: (cycle count equation for this function) + (variable used to represent cycle count for each subroutine called) where: (cycle count variable) = cycle count for [subroutine name] ------------------------------------------------------------------------------ CAUTION [optional] [State any special notes, constraints or cautions for users of this function] ------------------------------------------------------------------------------ */ void Init_D_plsf_3( D_plsfState *st, /* i/o: State struct */ Word16 index /* i : past_rq_init[] index [0, 7] */) { Copy( &past_rq_init[index * M], st->past_r_q, M); }