High-band (for wideband) is now a shape-sign codebook, reducing search
[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 "speex_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 float *stack
44 );
45
46 void split_cb_search(
47 float target[],                 /* target vector */
48 float ak[],                     /* LPCs for this subframe */
49 float awk1[],                   /* Weighted LPCs for this subframe */
50 float awk2[],                   /* Weighted LPCs for this subframe */
51 void *par,                      /* Codebook/search parameters*/
52 int   p,                        /* number of LPC coeffs */
53 int   nsf,                      /* number of samples in subframe */
54 float *exc,
55 SpeexBits *bits,
56 float *stack
57 );
58
59 void split_cb_search_nogain(
60 float target[],                 /* target vector */
61 float ak[],                     /* LPCs for this subframe */
62 float awk1[],                   /* Weighted LPCs for this subframe */
63 float awk2[],                   /* Weighted LPCs for this subframe */
64 void *par,                      /* Codebook/search parameters*/
65 int   p,                        /* number of LPC coeffs */
66 int   nsf,                      /* number of samples in subframe */
67 float *exc,
68 SpeexBits *bits,
69 float *stack
70 );
71
72 void split_cb_search_nogain2(
73 float target[],                 /* target vector */
74 float ak[],                     /* LPCs for this subframe */
75 float awk1[],                   /* Weighted LPCs for this subframe */
76 float awk2[],                   /* Weighted LPCs for this subframe */
77 void *par,                      /* Codebook/search parameters*/
78 int   p,                        /* number of LPC coeffs */
79 int   nsf,                      /* number of samples in subframe */
80 float *exc,
81 SpeexBits *bits,
82 float *stack
83 );
84
85 void split_cb_search_shape_sign(
86 float target[],                 /* target vector */
87 float ak[],                     /* LPCs for this subframe */
88 float awk1[],                   /* Weighted LPCs for this subframe */
89 float awk2[],                   /* Weighted LPCs for this subframe */
90 void *par,                      /* Codebook/search parameters*/
91 int   p,                        /* number of LPC coeffs */
92 int   nsf,                      /* number of samples in subframe */
93 float *exc,
94 SpeexBits *bits,
95 float *stack
96 );
97
98 void split_cb_shape_sign_unquant(
99 float *exc,
100 void *par,                      /* non-overlapping codebook */
101 int   nsf,                      /* number of samples in subframe */
102 SpeexBits *bits,
103 float *stack
104 );
105
106 void split_cb_search2(
107 float target[],                 /* target vector */
108 float ak[],                     /* LPCs for this subframe */
109 float awk1[],                   /* Weighted LPCs for this subframe */
110 float awk2[],                   /* Weighted LPCs for this subframe */
111 void *par,                      /* Codebook/search parameters*/
112 int   p,                        /* number of LPC coeffs */
113 int   nsf,                      /* number of samples in subframe */
114 float *exc,
115 SpeexBits *bits,
116 float *stack
117 );
118
119
120 void split_cb_unquant(
121 float *exc,
122 void  *par,                     /* Innovation parameters */
123 int   nsf,                      /* number of samples in subframe */
124 SpeexBits *bits,
125 float *stack
126 );
127
128 void split_cb_nogain_unquant(
129 float *exc,
130 void *par,                      /* non-overlapping codebook */
131 int   nsf,                      /* number of samples in subframe */
132 SpeexBits *bits,
133 float *stack
134 );
135
136 #endif