9929d1fbfe90ef96228622443774ddb518da31d6
[asterisk/asterisk.git] / codecs / lpc10 / lpcdec.c
1 /*
2
3 $Log$
4 Revision 1.14  2003/02/12 13:59:15  matteo
5 mer feb 12 14:56:57 CET 2003
6
7 Revision 1.1.1.1  2003/02/12 13:59:15  matteo
8 mer feb 12 14:56:57 CET 2003
9
10 Revision 1.2  2000/01/05 08:20:39  markster
11 Some OSS fixes and a few lpc changes to make it actually work
12
13  * Revision 1.2  1996/08/20  20:30:11  jaf
14  * Removed all static local variables that were SAVE'd in the Fortran
15  * code, and put them in struct lpc10_encoder_state that is passed as an
16  * argument.
17  *
18  * Removed init function, since all initialization is now done in
19  * init_lpc10_encoder_state().
20  *
21  * Changed name of function from lpcenc_ to lpc10_encode, simply to make
22  * all lpc10 functions have more consistent naming with each other.
23  *
24  * Revision 1.1  1996/08/19  22:31:48  jaf
25  * Initial revision
26  *
27
28 */
29
30 #ifdef P_R_O_T_O_T_Y_P_E_S
31 extern int lpcdec_(integer *bits, real *speech);
32 extern int initlpcdec_(void);
33 /* comlen contrl_ 12 */
34 /*:ref: chanrd_ 14 5 4 4 4 4 4 */
35 /*:ref: decode_ 14 7 4 4 4 4 4 6 6 */
36 /*:ref: synths_ 14 6 4 4 6 6 6 4 */
37 /*:ref: initdecode_ 14 0 */
38 /*:ref: initsynths_ 14 0 */
39 #endif
40
41 /*  -- translated by f2c (version 19951025).
42    You must link the resulting object file with the libraries:
43         -lf2c -lm   (in that order)
44 */
45
46 #include "f2c.h"
47
48 /* Common Block Declarations */
49
50 extern struct {
51     integer order, lframe;
52     logical corrp;
53 } contrl_;
54
55 #define contrl_1 contrl_
56
57 /* Table of constant values */
58
59 static integer c__10 = 10;
60
61 /* ***************************************************************** */
62
63 /* $Log$
64  * Revision 1.14  2003/02/12 13:59:15  matteo
65  * mer feb 12 14:56:57 CET 2003
66  *
67 /* Revision 1.1.1.1  2003/02/12 13:59:15  matteo
68 /* mer feb 12 14:56:57 CET 2003
69 /*
70 /* Revision 1.2  2000/01/05 08:20:39  markster
71 /* Some OSS fixes and a few lpc changes to make it actually work
72 /*
73  * Revision 1.2  1996/08/20  20:30:11  jaf
74  * Removed all static local variables that were SAVE'd in the Fortran
75  * code, and put them in struct lpc10_encoder_state that is passed as an
76  * argument.
77  *
78  * Removed init function, since all initialization is now done in
79  * init_lpc10_encoder_state().
80  *
81  * Changed name of function from lpcenc_ to lpc10_encode, simply to make
82  * all lpc10 functions have more consistent naming with each other.
83  *
84  * Revision 1.1  1996/08/19  22:31:48  jaf
85  * Initial revision
86  * */
87 /* Revision 1.1  1996/03/28  00:03:00  jaf */
88 /* Initial revision */
89
90
91 /* ***************************************************************** */
92
93 /* Decode 54 bits to one frame of 180 speech samples. */
94
95 /* Input: */
96 /*  BITS   - 54 encoded bits, stored 1 per array element. */
97 /*           Indices 1 through 53 read (SYNC bit ignored). */
98 /* Output: */
99 /*  SPEECH - Speech encoded as real values in the range [-1,+1]. */
100 /*           Indices 1 through 180 written. */
101
102 /* This subroutine maintains local state from one call to the next.  If */
103 /* you want to switch to using a new audio stream for this filter, or */
104 /* reinitialize its state for any other reason, call the ENTRY */
105 /* INITLPCDEC. */
106
107 /* Subroutine */ int lpc10_decode(integer *bits, real *speech,
108                                   struct lpc10_decoder_state *st)
109 {
110     integer irms, voice[2], pitch, ipitv;
111     extern /* Subroutine */ int decode_(integer *, integer *, integer *, 
112             integer *, integer *, real *, real *, struct lpc10_decoder_state *);
113     real rc[10];
114     extern /* Subroutine */ int chanrd_(integer *, integer *, integer *, 
115             integer *, integer *), synths_(integer *, 
116             integer *, real *, real *, real *, integer *,
117                                            struct lpc10_decoder_state *);
118     integer irc[10], len;
119     real rms;
120
121 /* $Log$
122  * Revision 1.14  2003/02/12 13:59:15  matteo
123  * mer feb 12 14:56:57 CET 2003
124  *
125 /* Revision 1.1.1.1  2003/02/12 13:59:15  matteo
126 /* mer feb 12 14:56:57 CET 2003
127 /*
128 /* Revision 1.2  2000/01/05 08:20:39  markster
129 /* Some OSS fixes and a few lpc changes to make it actually work
130 /*
131  * Revision 1.2  1996/08/20  20:30:11  jaf
132  * Removed all static local variables that were SAVE'd in the Fortran
133  * code, and put them in struct lpc10_encoder_state that is passed as an
134  * argument.
135  *
136  * Removed init function, since all initialization is now done in
137  * init_lpc10_encoder_state().
138  *
139  * Changed name of function from lpcenc_ to lpc10_encode, simply to make
140  * all lpc10 functions have more consistent naming with each other.
141  *
142  * Revision 1.1  1996/08/19  22:31:48  jaf
143  * Initial revision
144  * */
145 /* Revision 1.3  1996/03/29  22:03:47  jaf */
146 /* Removed definitions for any constants that were no longer used. */
147
148 /* Revision 1.2  1996/03/26  19:34:33  jaf */
149 /* Added comments indicating which constants are not needed in an */
150 /* application that uses the LPC-10 coder. */
151
152 /* Revision 1.1  1996/02/07  14:43:51  jaf */
153 /* Initial revision */
154
155 /*   LPC Configuration parameters: */
156 /* Frame size, Prediction order, Pitch period */
157 /*       Arguments */
158 /* $Log$
159  * Revision 1.14  2003/02/12 13:59:15  matteo
160  * mer feb 12 14:56:57 CET 2003
161  *
162 /* Revision 1.1.1.1  2003/02/12 13:59:15  matteo
163 /* mer feb 12 14:56:57 CET 2003
164 /*
165 /* Revision 1.2  2000/01/05 08:20:39  markster
166 /* Some OSS fixes and a few lpc changes to make it actually work
167 /*
168  * Revision 1.2  1996/08/20  20:30:11  jaf
169  * Removed all static local variables that were SAVE'd in the Fortran
170  * code, and put them in struct lpc10_encoder_state that is passed as an
171  * argument.
172  *
173  * Removed init function, since all initialization is now done in
174  * init_lpc10_encoder_state().
175  *
176  * Changed name of function from lpcenc_ to lpc10_encode, simply to make
177  * all lpc10 functions have more consistent naming with each other.
178  *
179  * Revision 1.1  1996/08/19  22:31:48  jaf
180  * Initial revision
181  * */
182 /* Revision 1.3  1996/03/29  22:05:55  jaf */
183 /* Commented out the common block variables that are not needed by the */
184 /* embedded version. */
185
186 /* Revision 1.2  1996/03/26  19:34:50  jaf */
187 /* Added comments indicating which constants are not needed in an */
188 /* application that uses the LPC-10 coder. */
189
190 /* Revision 1.1  1996/02/07  14:44:09  jaf */
191 /* Initial revision */
192
193 /*   LPC Processing control variables: */
194
195 /* *** Read-only: initialized in setup */
196
197 /*  Files for Speech, Parameter, and Bitstream Input & Output, */
198 /*    and message and debug outputs. */
199
200 /* Here are the only files which use these variables: */
201
202 /* lpcsim.f setup.f trans.f error.f vqsetup.f */
203
204 /* Many files which use fdebug are not listed, since it is only used in */
205 /* those other files conditionally, to print trace statements. */
206 /*      integer fsi, fso, fpi, fpo, fbi, fbo, pbin, fmsg, fdebug */
207 /*  LPC order, Frame size, Quantization rate, Bits per frame, */
208 /*    Error correction */
209 /* Subroutine SETUP is the only place where order is assigned a value, */
210 /* and that value is 10.  It could increase efficiency 1% or so to */
211 /* declare order as a constant (i.e., a Fortran PARAMETER) instead of as 
212 */
213 /* a variable in a COMMON block, since it is used in many places in the */
214 /* core of the coding and decoding routines.  Actually, I take that back. 
215 */
216 /* At least when compiling with f2c, the upper bound of DO loops is */
217 /* stored in a local variable before the DO loop begins, and then that is 
218 */
219 /* compared against on each iteration. */
220 /* Similarly for lframe, which is given a value of MAXFRM in SETUP. */
221 /* Similarly for quant, which is given a value of 2400 in SETUP.  quant */
222 /* is used in only a few places, and never in the core coding and */
223 /* decoding routines, so it could be eliminated entirely. */
224 /* nbits is similar to quant, and is given a value of 54 in SETUP. */
225 /* corrp is given a value of .TRUE. in SETUP, and is only used in the */
226 /* subroutines ENCODE and DECODE.  It doesn't affect the speed of the */
227 /* coder significantly whether it is .TRUE. or .FALSE., or whether it is 
228 */
229 /* a constant or a variable, since it is only examined once per frame. */
230 /* Leaving it as a variable that is set to .TRUE.  seems like a good */
231 /* idea, since it does enable some error-correction capability for */
232 /* unvoiced frames, with no change in the coding rate, and no noticeable 
233 */
234 /* quality difference in the decoded speech. */
235 /*      integer quant, nbits */
236 /* *** Read/write: variables for debugging, not needed for LPC algorithm 
237 */
238
239 /*  Current frame, Unstable frames, Output clip count, Max onset buffer, 
240 */
241 /*    Debug listing detail level, Line count on listing page */
242
243 /* nframe is not needed for an embedded LPC10 at all. */
244 /* nunsfm is initialized to 0 in SETUP, and incremented in subroutine */
245 /* ERROR, which is only called from RCCHK.  When LPC10 is embedded into */
246 /* an application, I would recommend removing the call to ERROR in RCCHK, 
247 */
248 /* and remove ERROR and nunsfm completely. */
249 /* iclip is initialized to 0 in SETUP, and incremented in entry SWRITE in 
250 */
251 /* sread.f.  When LPC10 is embedded into an application, one might want */
252 /* to cause it to be incremented in a routine that takes the output of */
253 /* SYNTHS and sends it to an audio device.  It could be optionally */
254 /* displayed, for those that might want to know what it is. */
255 /* maxosp is never initialized to 0 in SETUP, although it probably should 
256 */
257 /* be, and it is updated in subroutine ANALYS.  I doubt that its value */
258 /* would be of much interest to an application in which LPC10 is */
259 /* embedded. */
260 /* listl and lincnt are not needed for an embedded LPC10 at all. */
261 /*      integer nframe, nunsfm, iclip, maxosp, listl, lincnt */
262 /*      common /contrl/ fsi, fso, fpi, fpo, fbi, fbo, pbin, fmsg, fdebug */
263 /*      common /contrl/ quant, nbits */
264 /*      common /contrl/ nframe, nunsfm, iclip, maxosp, listl, lincnt */
265 /*       Local variables that need not be saved */
266 /*       Uncoded speech parameters */
267 /*       Coded speech parameters */
268 /*       Others */
269 /*       Local state */
270 /*       None */
271     /* Parameter adjustments */
272     if (bits) {
273         --bits;
274         }
275     if (speech) {
276         --speech;
277         }
278
279     /* Function Body */
280
281     chanrd_(&c__10, &ipitv, &irms, irc, &bits[1]);
282     decode_(&ipitv, &irms, irc, voice, &pitch, &rms, rc, st);
283     synths_(voice, &pitch, &rms, rc, &speech[1], &len, st);
284     return 0;
285 } /* lpcdec_ */