Re-wrote the gain quantization for split-VQ excitation. Added more bits
[speexdsp.git] / libspeex / cb_search.h
1 /* Copyright (C) 2002 Jean-Marc Valin & David Rowe
2    File: cb_search.c
3    Overlapped codebook search
4
5    This library is free software; you can redistribute it and/or
6    modify it under the terms of the GNU Lesser General Public
7    License as published by the Free Software Foundation; either
8    version 2.1 of the License, or (at your option) any later version.
9    
10    This library is distributed in the hope that it will be useful,
11    but WITHOUT ANY WARRANTY; without even the implied warranty of
12    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
13    Lesser General Public License for more details.
14    
15    You should have received a copy of the GNU Lesser General Public
16    License along with this library; if not, write to the Free Software
17    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
18 */
19
20 #ifndef CB_SEARCH_H
21 #define CB_SEARCH_H
22
23 #include "bits.h"
24
25 typedef struct split_cb_params {
26    int     subvect_size;
27    int     nb_subvect;
28    float  *shape_cb;
29    int     shape_bits;
30 } split_cb_params;
31
32 float overlap_cb_search(
33 float target[],                 /* target vector */
34 float ak[],                     /* LPCs for this subframe */
35 float awk1[],                   /* Weighted LPCs for this subframe */
36 float awk2[],                   /* Weighted LPCs for this subframe */
37 float codebook[],               /* overlapping codebook */
38 int   entries,                  /* number of overlapping entries to search */
39 float *gain,                    /* gain of optimum entry */
40 int   *index,                   /* index of optimum entry */
41 int   p,                        /* number of LPC coeffs */
42 int   nsf                       /* number of samples in subframe */
43 );
44
45 void split_cb_search(
46 float target[],                 /* target vector */
47 float ak[],                     /* LPCs for this subframe */
48 float awk1[],                   /* Weighted LPCs for this subframe */
49 float awk2[],                   /* Weighted LPCs for this subframe */
50 void *par,                      /* Codebook/search parameters*/
51 int   p,                        /* number of LPC coeffs */
52 int   nsf,                      /* number of samples in subframe */
53 float *exc,
54 FrameBits *bits,
55 float *stack
56 );
57
58 void split_cb_search_wb(
59 float target[],                 /* target vector */
60 float ak[],                     /* LPCs for this subframe */
61 float awk1[],                   /* Weighted LPCs for this subframe */
62 float awk2[],                   /* Weighted LPCs for this subframe */
63 void *par,                      /* Codebook/search parameters*/
64 int   p,                        /* number of LPC coeffs */
65 int   nsf,                      /* number of samples in subframe */
66 float *exc,
67 FrameBits *bits,
68 float *stack
69 );
70
71 void split_cb_unquant(
72 float *exc,
73 void  *par,                     /* Innovation parameters */
74 int   nsf,                      /* number of samples in subframe */
75 FrameBits *bits,
76 float *stack
77 );
78
79 #endif