Coverage Report

Created: 2025-07-11 06:39

/proc/self/cwd/libfaad/tns.c
Line
Count
Source (jump to first uncovered line)
1
/*
2
** FAAD2 - Freeware Advanced Audio (AAC) Decoder including SBR decoding
3
** Copyright (C) 2003-2005 M. Bakker, Nero AG, http://www.nero.com
4
**
5
** This program is free software; you can redistribute it and/or modify
6
** it under the terms of the GNU General Public License as published by
7
** the Free Software Foundation; either version 2 of the License, or
8
** (at your option) any later version.
9
**
10
** This program 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
13
** GNU General Public License for more details.
14
**
15
** You should have received a copy of the GNU General Public License
16
** along with this program; if not, write to the Free Software
17
** Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
18
**
19
** Any non-GPL usage of this software or parts of this software is strictly
20
** forbidden.
21
**
22
** The "appropriate copyright message" mentioned in section 2c of the GPLv2
23
** must read: "Code from FAAD2 is copyright (c) Nero AG, www.nero.com"
24
**
25
** Commercial non-GPL licensing of this software is possible.
26
** For more info contact Nero AG through Mpeg4AAClicense@nero.com.
27
**
28
** $Id: tns.c,v 1.40 2007/11/01 12:33:40 menno Exp $
29
**/
30
31
#include "common.h"
32
#include "structs.h"
33
34
#include "syntax.h"
35
#include "tns.h"
36
37
38
/* static function declarations */
39
/* returns exp */
40
static uint8_t tns_decode_coef(uint8_t order, uint8_t coef_res_bits,
41
                               uint8_t coef_compress, uint8_t *coef, real_t *a);
42
static void tns_ar_filter(real_t *spectrum, uint16_t size, int8_t inc, real_t *lpc,
43
                          uint8_t order, uint8_t exp);
44
static void tns_ma_filter(real_t *spectrum, uint16_t size, int8_t inc, real_t *lpc,
45
                          uint8_t order, uint8_t exp);
46
47
48
#ifdef _MSC_VER
49
#pragma warning(disable:4305)
50
#pragma warning(disable:4244)
51
#endif
52
static real_t tns_coef_0_3[] =
53
{
54
    COEF_CONST(0.0), COEF_CONST(0.4338837391), COEF_CONST(0.7818314825), COEF_CONST(0.9749279122),
55
    COEF_CONST(-0.9848077530), COEF_CONST(-0.8660254038), COEF_CONST(-0.6427876097), COEF_CONST(-0.3420201433),
56
    COEF_CONST(-0.4338837391), COEF_CONST(-0.7818314825), COEF_CONST(-0.9749279122), COEF_CONST(-0.9749279122),
57
    COEF_CONST(-0.9848077530), COEF_CONST(-0.8660254038), COEF_CONST(-0.6427876097), COEF_CONST(-0.3420201433)
58
};
59
static real_t tns_coef_0_4[] =
60
{
61
    COEF_CONST(0.0), COEF_CONST(0.2079116908), COEF_CONST(0.4067366431), COEF_CONST(0.5877852523),
62
    COEF_CONST(0.7431448255), COEF_CONST(0.8660254038), COEF_CONST(0.9510565163), COEF_CONST(0.9945218954),
63
    COEF_CONST(-0.9957341763), COEF_CONST(-0.9618256432), COEF_CONST(-0.8951632914), COEF_CONST(-0.7980172273),
64
    COEF_CONST(-0.6736956436), COEF_CONST(-0.5264321629), COEF_CONST(-0.3612416662), COEF_CONST(-0.1837495178)
65
};
66
static real_t tns_coef_1_3[] =
67
{
68
    COEF_CONST(0.0), COEF_CONST(0.4338837391), COEF_CONST(-0.6427876097), COEF_CONST(-0.3420201433),
69
    COEF_CONST(0.9749279122), COEF_CONST(0.7818314825), COEF_CONST(-0.6427876097), COEF_CONST(-0.3420201433),
70
    COEF_CONST(-0.4338837391), COEF_CONST(-0.7818314825), COEF_CONST(-0.6427876097), COEF_CONST(-0.3420201433),
71
    COEF_CONST(-0.7818314825), COEF_CONST(-0.4338837391), COEF_CONST(-0.6427876097), COEF_CONST(-0.3420201433)
72
};
73
static real_t tns_coef_1_4[] =
74
{
75
    COEF_CONST(0.0), COEF_CONST(0.2079116908), COEF_CONST(0.4067366431), COEF_CONST(0.5877852523),
76
    COEF_CONST(-0.6736956436), COEF_CONST(-0.5264321629), COEF_CONST(-0.3612416662), COEF_CONST(-0.1837495178),
77
    COEF_CONST(0.9945218954), COEF_CONST(0.9510565163), COEF_CONST(0.8660254038), COEF_CONST(0.7431448255),
78
    COEF_CONST(-0.6736956436), COEF_CONST(-0.5264321629), COEF_CONST(-0.3612416662), COEF_CONST(-0.1837495178)
79
};
80
81
static real_t* all_tns_coefs[] = {tns_coef_0_3, tns_coef_0_4, tns_coef_1_3, tns_coef_1_4};
82
83
/* TNS decoding for one channel and frame */
84
void tns_decode_frame(ic_stream *ics, tns_info *tns, uint8_t sr_index,
85
                      uint8_t object_type, real_t *spec, uint16_t frame_len)
86
0
{
87
0
    uint8_t w, f, tns_order;
88
0
    int8_t inc;
89
0
    int16_t size;
90
0
    uint16_t bottom, top, start, end;
91
0
    uint16_t nshort = frame_len/8;
92
0
    real_t lpc[TNS_MAX_ORDER+1];
93
0
    uint8_t exp;
94
95
0
    if (!ics->tns_data_present)
96
0
        return;
97
98
0
    for (w = 0; w < ics->num_windows; w++)
99
0
    {
100
0
        bottom = ics->num_swb;
101
102
0
        for (f = 0; f < tns->n_filt[w]; f++)
103
0
        {
104
0
            top = bottom;
105
0
            bottom = max(top - tns->length[w][f], 0);
106
0
            tns_order = min(tns->order[w][f], TNS_MAX_ORDER);
107
0
            if (!tns_order)
108
0
                continue;
109
110
0
            exp = tns_decode_coef(tns_order, tns->coef_res[w]+3,
111
0
                tns->coef_compress[w][f], tns->coef[w][f], lpc);
112
113
0
            start = min(bottom, max_tns_sfb(sr_index, object_type, (ics->window_sequence == EIGHT_SHORT_SEQUENCE)));
114
0
            start = min(start, ics->max_sfb);
115
0
            start = min(ics->swb_offset[start], ics->swb_offset_max);
116
117
0
            end = min(top, max_tns_sfb(sr_index, object_type, (ics->window_sequence == EIGHT_SHORT_SEQUENCE)));
118
0
            end = min(end, ics->max_sfb);
119
0
            end = min(ics->swb_offset[end], ics->swb_offset_max);
120
121
0
            size = end - start;
122
0
            if (size <= 0)
123
0
                continue;
124
125
0
            if (tns->direction[w][f])
126
0
            {
127
0
                inc = -1;
128
0
                start = end - 1;
129
0
            } else {
130
0
                inc = 1;
131
0
            }
132
133
0
            tns_ar_filter(&spec[(w*nshort)+start], size, inc, lpc, tns_order, exp);
134
0
        }
135
0
    }
136
0
}
137
138
/* TNS encoding for one channel and frame */
139
void tns_encode_frame(ic_stream *ics, tns_info *tns, uint8_t sr_index,
140
                      uint8_t object_type, real_t *spec, uint16_t frame_len)
141
0
{
142
0
    uint8_t w, f, tns_order;
143
0
    int8_t inc;
144
0
    int16_t size;
145
0
    uint16_t bottom, top, start, end;
146
0
    uint16_t nshort = frame_len/8;
147
0
    real_t lpc[TNS_MAX_ORDER+1];
148
0
    uint8_t exp;
149
150
0
    if (!ics->tns_data_present)
151
0
        return;
152
153
0
    for (w = 0; w < ics->num_windows; w++)
154
0
    {
155
0
        bottom = ics->num_swb;
156
157
0
        for (f = 0; f < tns->n_filt[w]; f++)
158
0
        {
159
0
            top = bottom;
160
0
            bottom = max(top - tns->length[w][f], 0);
161
0
            tns_order = min(tns->order[w][f], TNS_MAX_ORDER);
162
0
            if (!tns_order)
163
0
                continue;
164
165
0
            exp = tns_decode_coef(tns_order, tns->coef_res[w]+3,
166
0
                tns->coef_compress[w][f], tns->coef[w][f], lpc);
167
168
0
            start = min(bottom, max_tns_sfb(sr_index, object_type, (ics->window_sequence == EIGHT_SHORT_SEQUENCE)));
169
0
            start = min(start, ics->max_sfb);
170
0
            start = min(ics->swb_offset[start], ics->swb_offset_max);
171
172
0
            end = min(top, max_tns_sfb(sr_index, object_type, (ics->window_sequence == EIGHT_SHORT_SEQUENCE)));
173
0
            end = min(end, ics->max_sfb);
174
0
            end = min(ics->swb_offset[end], ics->swb_offset_max);
175
176
0
            size = end - start;
177
0
            if (size <= 0)
178
0
                continue;
179
180
0
            if (tns->direction[w][f])
181
0
            {
182
0
                inc = -1;
183
0
                start = end - 1;
184
0
            } else {
185
0
                inc = 1;
186
0
            }
187
188
0
            tns_ma_filter(&spec[(w*nshort)+start], size, inc, lpc, tns_order, exp);
189
0
        }
190
0
    }
191
0
}
192
193
/* Decoder transmitted coefficients for one TNS filter */
194
static uint8_t tns_decode_coef(uint8_t order, uint8_t coef_res_bits, uint8_t coef_compress,
195
                            uint8_t *coef, real_t *a)
196
0
{
197
0
    uint8_t i, m;
198
0
    real_t tmp2[TNS_MAX_ORDER+1], b[TNS_MAX_ORDER+1];
199
0
    uint8_t table_index = 2 * (coef_compress != 0) + (coef_res_bits != 3);
200
0
    real_t* tns_coef = all_tns_coefs[table_index];
201
0
    uint8_t exp = 0;
202
203
    /* Conversion to signed integer */
204
0
    for (i = 0; i < order; i++)
205
0
        tmp2[i] = tns_coef[coef[i]];
206
207
    /* Conversion to LPC coefficients */
208
0
    a[0] = COEF_CONST(1.0);
209
0
    for (m = 1; m <= order; m++)
210
0
    {
211
0
        a[m] = tmp2[m-1]; /* changed */
212
0
        for (i = 1; i < m; i++) /* loop only while i<m */
213
0
            b[i] = a[i] + MUL_C(a[m], a[m-i]);
214
215
0
        for (i = 1; i < m; i++) /* loop only while i<m */
216
0
            a[i] = b[i];
217
218
#ifdef FIXED_POINT
219
        a[m] >>= exp;
220
221
        /* OK not to check after the last iteration. */
222
        if (m < order)
223
        {
224
            real_t sum_abs = COEF_CONST(0.0);
225
            for (i = 1; i <= m; ++i)
226
            {
227
                sum_abs += (a[i] >= 0) ? a[i] : -a[i];
228
            }
229
            /* Next iteration would turn sum to 2*sum + 1; maximal "coef" is 7.999 */
230
            if (sum_abs >= COEF_CONST(3.5))
231
            {
232
                exp++;
233
                for (i = 1; i <= m; ++i)
234
                {
235
                    a[i] >>= 1;
236
                }
237
            }
238
        }
239
#endif
240
0
    }
241
0
    return exp;
242
0
}
243
244
static void tns_ar_filter(real_t *spectrum, uint16_t size, int8_t inc, real_t *lpc,
245
                          uint8_t order, uint8_t exp)
246
0
{
247
    /*
248
     - Simple all-pole filter of order "order" defined by
249
       y(n) = x(n) - lpc[1]*y(n-1) - ... - lpc[order]*y(n-order)
250
     - The state variables of the filter are initialized to zero every time
251
     - The output data is written over the input data ("in-place operation")
252
     - An input vector of "size" samples is processed and the index increment
253
       to the next data sample is given by "inc"
254
    */
255
256
0
    uint8_t j;
257
0
    uint16_t i;
258
    /* state is stored as a double ringbuffer */
259
0
    real_t state[2*TNS_MAX_ORDER] = {0};
260
0
    int8_t state_index = 0;
261
0
    int32_t mul = 1;
262
263
#ifdef FIXED_POINT
264
    if (exp >= 4)
265
        return;
266
    mul = 1 << exp;
267
#else
268
0
    (void)exp;
269
0
#endif
270
271
0
    for (i = 0; i < size; i++)
272
0
    {
273
0
        real_t y = REAL_CONST(0.0);
274
0
        for (j = 0; j < order; j++)
275
0
            y += MUL_C(state[state_index+j], lpc[j+1]);
276
0
        y = *spectrum - (y * mul);
277
278
        /* double ringbuffer state */
279
0
        state_index--;
280
0
        if (state_index < 0)
281
0
            state_index = order-1;
282
0
        state[state_index] = state[state_index + order] = y;
283
284
0
        *spectrum = y;
285
0
        spectrum += inc;
286
287
//#define TNS_PRINT
288
#ifdef TNS_PRINT
289
        //printf("%d\n", y);
290
        printf("0x%.8X\n", y);
291
#endif
292
0
    }
293
0
}
294
295
static void tns_ma_filter(real_t *spectrum, uint16_t size, int8_t inc, real_t *lpc,
296
                          uint8_t order, uint8_t exp)
297
0
{
298
    /*
299
     - Simple all-zero filter of order "order" defined by
300
       y(n) =  x(n) + a(2)*x(n-1) + ... + a(order+1)*x(n-order)
301
     - The state variables of the filter are initialized to zero every time
302
     - The output data is written over the input data ("in-place operation")
303
     - An input vector of "size" samples is processed and the index increment
304
       to the next data sample is given by "inc"
305
    */
306
307
0
    uint8_t j;
308
0
    uint16_t i;
309
    /* state is stored as a double ringbuffer */
310
0
    real_t state[2*TNS_MAX_ORDER] = {0};
311
0
    int8_t state_index = 0;
312
0
    int32_t mul = 1;
313
314
#ifdef FIXED_POINT
315
    if (exp >= 4)
316
        return;
317
    mul = 1 << exp;
318
#else
319
0
    (void)exp;
320
0
#endif
321
322
0
    for (i = 0; i < size; i++)
323
0
    {
324
0
        real_t y = REAL_CONST(0.0);
325
0
        for (j = 0; j < order; j++)
326
0
            y += MUL_C(state[state_index+j], lpc[j+1]);
327
328
0
        y = *spectrum + (y * mul);
329
330
        /* double ringbuffer state */
331
0
        state_index--;
332
0
        if (state_index < 0)
333
0
            state_index = order-1;
334
0
        state[state_index] = state[state_index + order] = *spectrum;
335
336
0
        *spectrum = y;
337
0
        spectrum += inc;
338
0
    }
339
0
}