Coverage Report

Created: 2026-10-28 07:04

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/proc/self/cwd/libfaad/pns.c
Line
Count
Source
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: pns.c,v 1.39 2010/06/04 20:47:56 menno Exp $
29
**/
30
31
#include "common.h"
32
#include "structs.h"
33
34
#include "pns.h"
35
36
37
/* static function declarations */
38
static void gen_rand_vector(real_t *spec, int16_t scale_factor, uint16_t size,
39
                            uint8_t sub,
40
                            /* RNG states */ uint32_t *__r1, uint32_t *__r2);
41
42
43
#ifdef FIXED_POINT
44
45
static real_t const pow2_table[] =
46
{
47
    COEF_CONST(1.0),
48
    COEF_CONST(1.18920711500272),
49
    COEF_CONST(1.41421356237310),
50
    COEF_CONST(1.68179283050743)
51
};
52
53
// mean_energy_table[x] == sqrt(3 / x)
54
static real_t const mean_energy_table[] =
55
{
56
    COEF_CONST(0.0),                // should not happen
57
    COEF_CONST(1.7320508075688772),
58
    COEF_CONST(1.224744871391589),
59
    COEF_CONST(1.0),                // sqrt(3/3)
60
    COEF_CONST(0.8660254037844386),
61
    COEF_CONST(0.7745966692414834),
62
    COEF_CONST(0.7071067811865476),
63
    COEF_CONST(0.6546536707079771),
64
    COEF_CONST(0.6123724356957945),
65
    COEF_CONST(0.5773502691896257),
66
    COEF_CONST(0.5477225575051661),
67
    COEF_CONST(0.5222329678670935),
68
    COEF_CONST(0.5),                // sqrt(3/12)
69
    COEF_CONST(0.4803844614152614),
70
    COEF_CONST(0.4629100498862757),
71
    COEF_CONST(0.4472135954999579),
72
};
73
#endif
74
75
/* The function gen_rand_vector(addr, size) generates a vector of length
76
   <size> with signed random values of average energy MEAN_NRG per random
77
   value. A suitable random number generator can be realized using one
78
   multiplication/accumulation per random value.
79
*/
80
static INLINE void gen_rand_vector(real_t *spec, int16_t scale_factor, uint16_t size,
81
                                   uint8_t sub,
82
                                   /* RNG states */ uint32_t *__r1, uint32_t *__r2)
83
66.4k
{
84
66.4k
#ifndef FIXED_POINT
85
66.4k
    uint16_t i;
86
66.4k
    real_t energy = 0.0;
87
66.4k
    (void)sub;
88
89
66.4k
    scale_factor = min(max(scale_factor, -120), 120);
90
91
730k
    for (i = 0; i < size; i++)
92
664k
    {
93
664k
        real_t tmp = (real_t)(int32_t)ne_rng(__r1, __r2);
94
664k
        spec[i] = tmp;
95
664k
        energy += tmp*tmp;
96
664k
    }
97
98
66.4k
    if (energy > 0)
99
66.4k
    {
100
66.4k
        real_t scale = (real_t)1.0/(real_t)sqrt(energy);
101
66.4k
        scale *= (real_t)pow(2.0, 0.25 * scale_factor);
102
730k
        for (i = 0; i < size; i++)
103
664k
        {
104
664k
            spec[i] *= scale;
105
664k
        }
106
66.4k
    }
107
#else
108
    uint16_t i;
109
    real_t scale;
110
    int32_t exp, frac;
111
    int32_t idx, mask;
112
113
    /* IMDCT pre-scaling */
114
    scale_factor -= 4 * sub;
115
116
    // 52 stands for 2**13 == 8192 factor; larger factor causes overflows later (in cfft).
117
    scale_factor = min(max(scale_factor, -(REAL_BITS * 4)), 52);
118
119
    exp = scale_factor >> 2;
120
    frac = scale_factor & 3;
121
122
    /* 29 <= REAL_BITS + exp <= 0 */
123
    mask = (1 << (REAL_BITS + exp)) - 1;
124
125
    idx = size;
126
    scale = COEF_CONST(1);
127
    // At most 2 iterations.
128
    while (idx >= 16)
129
    {
130
        idx >>= 2;
131
        scale >>= 1;
132
    }
133
    scale = MUL_C(scale, mean_energy_table[idx]);
134
    if (frac)
135
        scale = MUL_C(scale, pow2_table[frac]);
136
    // scale is less than 4.0 now.
137
138
    for (i = 0; i < size; i++)
139
    {
140
        real_t tmp = (int32_t)ne_rng(__r1, __r2);
141
        if (tmp < 0)
142
            tmp = -(tmp & mask);
143
        else
144
            tmp = (tmp & mask);
145
        spec[i] = MUL_C(tmp, scale);
146
    }
147
#endif
148
66.4k
}
149
150
void pns_decode(ic_stream *ics_left, ic_stream *ics_right,
151
                real_t *spec_left, real_t *spec_right, uint16_t frame_len,
152
                uint8_t channel_pair, uint8_t object_type,
153
                /* RNG states */ uint32_t *__r1, uint32_t *__r2)
154
241k
{
155
241k
    uint8_t g, sfb, b;
156
241k
    uint16_t begin, end;
157
158
241k
    uint8_t group = 0;
159
241k
    uint16_t nshort = frame_len >> 3;
160
161
241k
    uint8_t sub = 0;
162
163
#ifdef FIXED_POINT
164
    /* IMDCT scaling */
165
    if (object_type == LD)
166
    {
167
        sub = 9 /*9*/;
168
    } else {
169
        if (ics_left->window_sequence == EIGHT_SHORT_SEQUENCE)
170
            sub = 7 /*7*/;
171
        else
172
            sub = 10 /*10*/;
173
    }
174
#else
175
241k
    (void)object_type;
176
241k
#endif
177
178
598k
    for (g = 0; g < ics_left->num_window_groups; g++)
179
356k
    {
180
        /* Do perceptual noise substitution decoding */
181
745k
        for (b = 0; b < ics_left->window_group_length[g]; b++)
182
388k
        {
183
388k
            uint16_t base = group * nshort;
184
554k
            for (sfb = 0; sfb < ics_left->max_sfb; sfb++)
185
165k
            {
186
165k
                uint32_t r1_dep = 0, r2_dep = 0;
187
188
165k
                if (is_noise(ics_left, g, sfb))
189
40.7k
                {
190
40.7k
#ifdef LTP_DEC
191
                    /* Simultaneous use of LTP and PNS is not prevented in the
192
                       syntax. If both LTP, and PNS are enabled on the same
193
                       scalefactor band, PNS takes precedence, and no prediction
194
                       is applied to this band.
195
                    */
196
40.7k
                    ics_left->ltp.long_used[sfb] = 0;
197
40.7k
                    ics_left->ltp2.long_used[sfb] = 0;
198
40.7k
#endif
199
200
40.7k
#ifdef MAIN_DEC
201
                    /* For scalefactor bands coded using PNS the corresponding
202
                       predictors are switched to "off".
203
                    */
204
40.7k
                    ics_left->pred.prediction_used[sfb] = 0;
205
40.7k
#endif
206
                    /* swb_offset_max is per-window, not per-frame; clamping
207
                       group>0 offsets against it zeroed out begin/end. */
208
40.7k
                    begin = min(base + ics_left->swb_offset[sfb], frame_len);
209
40.7k
                    end = min(base + ics_left->swb_offset[sfb+1], frame_len);
210
211
40.7k
                    r1_dep = *__r1;
212
40.7k
                    r2_dep = *__r2;
213
214
                    /* Generate random vector */
215
40.7k
                    gen_rand_vector(&spec_left[begin],
216
40.7k
                        ics_left->scale_factors[g][sfb], end - begin, sub, __r1, __r2);
217
40.7k
                }
218
219
/* From the spec:
220
   If the same scalefactor band and group is coded by perceptual noise
221
   substitution in both channels of a channel pair, the correlation of
222
   the noise signal can be controlled by means of the ms_used field: While
223
   the default noise generation process works independently for each channel
224
   (separate generation of random vectors), the same random vector is used
225
   for both channels if ms_used[] is set for a particular scalefactor band
226
   and group. In this case, no M/S stereo coding is carried out (because M/S
227
   stereo coding and noise substitution coding are mutually exclusive).
228
   If the same scalefactor band and group is coded by perceptual noise
229
   substitution in only one channel of a channel pair the setting of ms_used[]
230
   is not evaluated.
231
*/
232
165k
                if ((ics_right != NULL)
233
49.0k
                    && is_noise(ics_right, g, sfb))
234
25.7k
                {
235
25.7k
#ifdef LTP_DEC
236
                    /* See comment above. */
237
25.7k
                    ics_right->ltp.long_used[sfb] = 0;
238
25.7k
                    ics_right->ltp2.long_used[sfb] = 0;
239
25.7k
#endif
240
25.7k
#ifdef MAIN_DEC
241
                    /* See comment above. */
242
25.7k
                    ics_right->pred.prediction_used[sfb] = 0;
243
25.7k
#endif
244
245
25.7k
                    if (channel_pair && is_noise(ics_left, g, sfb) &&
246
20.6k
                        (((ics_left->ms_mask_present == 1) &&
247
19.8k
                        (ics_left->ms_used[g][sfb])) ||
248
5.67k
                        (ics_left->ms_mask_present == 2)))
249
15.7k
                    {
250
                        /*uint16_t c;*/
251
252
15.7k
                        begin = min(base + ics_right->swb_offset[sfb], frame_len);
253
15.7k
                        end = min(base + ics_right->swb_offset[sfb+1], frame_len);
254
255
                        /* Generate random vector dependent on left channel*/
256
15.7k
                        gen_rand_vector(&spec_right[begin],
257
15.7k
                            ics_right->scale_factors[g][sfb], end - begin, sub, &r1_dep, &r2_dep);
258
259
15.7k
                    } else /*if (ics_left->ms_mask_present == 0)*/ {
260
9.98k
                        begin = min(base + ics_right->swb_offset[sfb], frame_len);
261
9.98k
                        end = min(base + ics_right->swb_offset[sfb+1], frame_len);
262
263
                        /* Generate random vector */
264
9.98k
                        gen_rand_vector(&spec_right[begin],
265
9.98k
                            ics_right->scale_factors[g][sfb], end - begin, sub, __r1, __r2);
266
9.98k
                    }
267
25.7k
                }
268
165k
            } /* sfb */
269
388k
            group++;
270
388k
        } /* b */
271
356k
    } /* g */
272
241k
}