1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
|
/* ------------------------------------------------------------------
* 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.
****************************************************************************************/
/*
------------------------------------------------------------------------------
Filename: /audio/gsm_amr/c/include/dec_amr.h
Date: 02/06/2002
------------------------------------------------------------------------------
REVISION HISTORY
Description: Update function prototype for Decoder_amr(). Include overflow
flag in Decode_amrState structure
Description: Replaced "int" and/or "char" with OSCL defined types.
Description: Moved _cplusplus #ifdef after Include section.
Description:
------------------------------------------------------------------------------
INCLUDE DESCRIPTION
File : dec_amr.h
Purpose : Speech decoder routine.
------------------------------------------------------------------------------
*/
/*----------------------------------------------------------------------------
; CONTINUE ONLY IF NOT ALREADY DEFINED
----------------------------------------------------------------------------*/
#ifndef DEC_AMR_H
#define DEC_AMR_H "$Id $"
/*----------------------------------------------------------------------------
; INCLUDES
----------------------------------------------------------------------------*/
#include "typedef.h"
#include "cnst.h"
#include "mode.h"
#include "dtx_dec.h"
#include "d_plsf.h"
#include "gc_pred.h"
#include "ec_gains.h"
#include "ph_disp.h"
#include "c_g_aver.h"
#include "bgnscd.h"
#include "lsp_avg.h"
#include "frame.h"
/*--------------------------------------------------------------------------*/
#ifdef __cplusplus
extern "C"
{
#endif
/*----------------------------------------------------------------------------
; MACROS
; Define module specific macros here
----------------------------------------------------------------------------*/
/*----------------------------------------------------------------------------
; DEFINES
; Include all pre-processor statements here.
----------------------------------------------------------------------------*/
#define EXC_ENERGY_HIST_LEN 9
#define LTP_GAIN_HISTORY_LEN 9
/*----------------------------------------------------------------------------
; EXTERNAL VARIABLES REFERENCES
; Declare variables used in this module but defined elsewhere
----------------------------------------------------------------------------*/
/*----------------------------------------------------------------------------
; SIMPLE TYPEDEF'S
----------------------------------------------------------------------------*/
/*----------------------------------------------------------------------------
; ENUMERATED TYPEDEF'S
----------------------------------------------------------------------------*/
/*----------------------------------------------------------------------------
; STRUCTURES TYPEDEF'S
----------------------------------------------------------------------------*/
typedef struct Decoder_amrState
{
/* Excitation vector */
Word16 old_exc[L_SUBFR + PIT_MAX + L_INTERPOL];
Word16 *exc;
/* Lsp (Line spectral pairs) */
/* Word16 lsp[M]; */ /* Used by CN codec */
Word16 lsp_old[M];
/* Filter's memory */
Word16 mem_syn[M];
/* pitch sharpening */
Word16 sharp;
Word16 old_T0;
/* Memories for bad frame handling */
Word16 prev_bf;
Word16 prev_pdf;
Word16 state;
Word16 excEnergyHist[EXC_ENERGY_HIST_LEN];
/* Variable holding received ltpLag, used in background noise and BFI */
Word16 T0_lagBuff;
/* Variables for the source characteristic detector (SCD) */
Word16 inBackgroundNoise;
Word16 voicedHangover;
Word16 ltpGainHistory[LTP_GAIN_HISTORY_LEN];
Bgn_scdState background_state;
Word16 nodataSeed;
Cb_gain_averageState Cb_gain_averState;
lsp_avgState lsp_avg_st;
D_plsfState lsfState;
ec_gain_pitchState ec_gain_p_st;
ec_gain_codeState ec_gain_c_st;
gc_predState pred_state;
ph_dispState ph_disp_st;
dtx_decState dtxDecoderState;
Flag overflow;
} Decoder_amrState;
/*----------------------------------------------------------------------------
; GLOBAL FUNCTION DEFINITIONS
; Function Prototype declaration
----------------------------------------------------------------------------*/
/*
* Function : Decoder_amr_init
* Purpose : Allocates initializes state memory
* Description : Stores pointer to filter status struct in *st. This
* pointer has to be passed to Decoder_amr in each call.
* Returns : 0 on success
*/
Word16 Decoder_amr_init(Decoder_amrState *st);
/*
* Function : Decoder_amr_reset
* Purpose : Resets state memory
* Returns : 0 on success
*/
Word16 Decoder_amr_reset(Decoder_amrState *st, enum Mode mode);
/*
* Function : Decoder_amr
* Purpose : Speech decoder routine.
* Returns : 0
*/
void Decoder_amr(
Decoder_amrState *st, /* i/o : State variables */
enum Mode mode, /* i : AMR mode */
Word16 parm[], /* i : vector of synthesis parameters
(PRM_SIZE) */
enum RXFrameType frame_type, /* i : received frame type */
Word16 synth[], /* o : synthesis speech (L_FRAME) */
Word16 A_t[] /* o : decoded LP filter in 4 subframes
(AZ_SIZE) */
);
/*----------------------------------------------------------------------------
; END
----------------------------------------------------------------------------*/
#ifdef __cplusplus
}
#endif
#endif /* DEC_AMR_H_ */
|
