@mentra/bluetooth-sdk 0.1.0

package/android/lc3Lib/src/main/cpp/liblc3/liblc3/spec.c

@@ -0,0 +1,904 @@
+/******************************************************************************
+ *
+ *  Copyright 2022 Google LLC
+ *
+ *  Licensed under the Apache License, Version 2.0 (the "License");
+ *  you may not use this file except in compliance with the License.
+ *  You may obtain a copy of the License at:
+ *
+ *  http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  Unless required by applicable law or agreed to in writing, software
+ *  distributed under the License is distributed on an "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *  See the License for the specific language governing permissions and
+ *  limitations under the License.
+ *
+ ******************************************************************************/
+
+#include "spec.h"
+#include "bits.h"
+#include "tables.h"
+
+
+/* ----------------------------------------------------------------------------
+ *  Global Gain / Quantization
+ * -------------------------------------------------------------------------- */
+
+/**
+ * Resolve quantized gain index offset
+ * sr, nbytes      Samplerate and size of the frame
+ * return          Gain index offset
+ */
+static int resolve_gain_offset(enum lc3_srate sr, int nbytes)
+{
+    int g_off = (nbytes * 8) / (10 * (1 + sr));
+    return 105 + 5*(1 + sr) + LC3_MIN(g_off, 115);
+}
+
+/**
+ * Global Gain Estimation
+ * dt, sr          Duration and samplerate of the frame
+ * x               Spectral coefficients
+ * nbits_budget    Number of bits available coding the spectrum
+ * nbits_off       Offset on the available bits, temporarily smoothed
+ * g_off           Gain index offset
+ * reset_off       Return True when the nbits_off must be reset
+ * return          The quantized gain value
+ */
+LC3_HOT static int estimate_gain(
+    enum lc3_dt dt, enum lc3_srate sr, const float *x,
+    int nbits_budget, float nbits_off, int g_off, bool *reset_off)
+{
+    int ne = LC3_NE(dt, sr) >> 2;
+    int e[ne];
+
+    /* --- Energy (dB) by 4 MDCT blocks --- */
+
+    float x2_max = 0;
+
+    for (int i = 0; i < ne; i++, x += 4) {
+        float x0 = x[0] * x[0];
+        float x1 = x[1] * x[1];
+        float x2 = x[2] * x[2];
+        float x3 = x[3] * x[3];
+
+        x2_max = fmaxf(x2_max, x0);
+        x2_max = fmaxf(x2_max, x1);
+        x2_max = fmaxf(x2_max, x2);
+        x2_max = fmaxf(x2_max, x3);
+
+        e[i] = fast_db_q16(fmaxf(x0 + x1 + x2 + x3, 1e-10f));
+    }
+
+    /* --- Determine gain index --- */
+
+    int nbits = nbits_budget + nbits_off + 0.5f;
+    int g_int = 255 - g_off;
+
+    const int k_20_28 = 20.f/28 * 0x1p16f + 0.5f;
+    const int k_2u7 = 2.7f * 0x1p16f + 0.5f;
+    const int k_1u4 = 1.4f * 0x1p16f + 0.5f;
+
+    for (int i = 128, j, j0 = ne-1, j1 ; i > 0; i >>= 1) {
+        int gn = (g_int - i) * k_20_28;
+        int v = 0;
+
+        for (j = j0; j >= 0 && e[j] < gn; j--);
+
+        for (j1 = j; j >= 0; j--) {
+            int e_diff = e[j] - gn;
+
+            v += e_diff < 0 ? k_2u7 :
+                 e_diff < 43 << 16 ?   e_diff + ( 7 << 16)
+                                   : 2*e_diff - (36 << 16);
+        }
+
+        if (v > nbits * k_1u4)
+            j0 = j1;
+        else
+            g_int = g_int - i;
+    }
+
+    /* --- Limit gain index --- */
+
+    int g_min = x2_max == 0 ? -g_off :
+        ceilf(28 * log10f(sqrtf(x2_max) / (32768 - 0.375f)));
+
+    *reset_off = g_int < g_min || x2_max == 0;
+    if (*reset_off)
+        g_int = g_min;
+
+    return g_int;
+}
+
+/**
+ * Global Gain Adjustment
+ * sr              Samplerate of the frame
+ * g_idx           The estimated quantized gain index
+ * nbits           Computed number of bits coding the spectrum
+ * nbits_budget    Number of bits available for coding the spectrum
+ * return          Gain adjust value (-1 to 2)
+ */
+LC3_HOT static int adjust_gain(
+    enum lc3_srate sr, int g_idx, int nbits, int nbits_budget)
+{
+    /* --- Compute delta threshold --- */
+
+    const int *t = (const int [LC3_NUM_SRATE][3]){
+        {  80,  500,  850 }, { 230, 1025, 1700 }, { 380, 1550, 2550 },
+        { 530, 2075, 3400 }, { 680, 2600, 4250 }
+    }[sr];
+
+    int delta, den = 48;
+
+    if (nbits < t[0]) {
+        delta = 3*(nbits + 48);
+
+    } else if (nbits < t[1]) {
+        int n0 = 3*(t[0] + 48), range = t[1] - t[0];
+        delta = n0 * range + (nbits - t[0]) * (t[1] - n0);
+        den *= range;
+
+    } else {
+        delta = LC3_MIN(nbits, t[2]);
+    }
+
+    delta = (delta + den/2) / den;
+
+    /* --- Adjust gain --- */
+
+    if (nbits < nbits_budget - (delta + 2))
+        return -(g_idx > 0);
+
+    if (nbits > nbits_budget)
+        return (g_idx < 255) + (g_idx < 254 && nbits >= nbits_budget + delta);
+
+    return 0;
+}
+
+/**
+ * Unquantize gain
+ * g_int           Quantization gain value
+ * return          Unquantized gain value
+ */
+static float unquantize_gain(int g_int)
+{
+    /* Unquantization gain table :
+     * G[i] = 10 ^ (i / 28) , i = [0..64] */
+
+    static const float iq_table[] = {
+        1.00000000e+00, 1.08571112e+00, 1.17876863e+00, 1.27980221e+00,
+        1.38949549e+00, 1.50859071e+00, 1.63789371e+00, 1.77827941e+00,
+        1.93069773e+00, 2.09617999e+00, 2.27584593e+00, 2.47091123e+00,
+        2.68269580e+00, 2.91263265e+00, 3.16227766e+00, 3.43332002e+00,
+        3.72759372e+00, 4.04708995e+00, 4.39397056e+00, 4.77058270e+00,
+        5.17947468e+00, 5.62341325e+00, 6.10540230e+00, 6.62870316e+00,
+        7.19685673e+00, 7.81370738e+00, 8.48342898e+00, 9.21055318e+00,
+        1.00000000e+01, 1.08571112e+01, 1.17876863e+01, 1.27980221e+01,
+        1.38949549e+01, 1.50859071e+01, 1.63789371e+01, 1.77827941e+01,
+        1.93069773e+01, 2.09617999e+01, 2.27584593e+01, 2.47091123e+01,
+        2.68269580e+01, 2.91263265e+01, 3.16227766e+01, 3.43332002e+01,
+        3.72759372e+01, 4.04708995e+01, 4.39397056e+01, 4.77058270e+01,
+        5.17947468e+01, 5.62341325e+01, 6.10540230e+01, 6.62870316e+01,
+        7.19685673e+01, 7.81370738e+01, 8.48342898e+01, 9.21055318e+01,
+        1.00000000e+02, 1.08571112e+02, 1.17876863e+02, 1.27980221e+02,
+        1.38949549e+02, 1.50859071e+02, 1.63789371e+02, 1.77827941e+02,
+        1.93069773e+02
+    };
+
+    float g = iq_table[LC3_ABS(g_int) & 0x3f];
+    for(int n64 = LC3_ABS(g_int) >> 6; n64--; )
+        g *= iq_table[64];
+
+    return g_int >= 0 ? g : 1 / g;
+}
+
+/**
+ * Spectrum quantization
+ * dt, sr          Duration and samplerate of the frame
+ * g_int           Quantization gain value
+ * x               Spectral coefficients, scaled as output
+ * xq, nq          Output spectral quantized coefficients, and count
+ *
+ * The spectral coefficients `xq` are stored as :
+ *   b0       0:positive or zero  1:negative
+ *   b15..b1  Absolute value
+ */
+LC3_HOT static void quantize(enum lc3_dt dt, enum lc3_srate sr,
+    int g_int, float *x, uint16_t *xq, int *nq)
+{
+    float g_inv = 1 / unquantize_gain(g_int);
+    int ne = LC3_NE(dt, sr);
+
+    *nq = ne;
+
+    for (int i = 0; i < ne; i += 2) {
+        uint16_t x0, x1;
+
+        x[i+0] *= g_inv;
+        x[i+1] *= g_inv;
+
+        x0 = fminf(fabsf(x[i+0]) + 6.f/16, INT16_MAX);
+        x1 = fminf(fabsf(x[i+1]) + 6.f/16, INT16_MAX);
+
+        xq[i+0] = (x0 << 1) + ((x0 > 0) & (x[i+0] < 0));
+        xq[i+1] = (x1 << 1) + ((x1 > 0) & (x[i+1] < 0));
+
+        *nq = x0 || x1 ? ne : *nq - 2;
+    }
+}
+
+/**
+ * Spectrum quantization inverse
+ * dt, sr          Duration and samplerate of the frame
+ * g_int           Quantization gain value
+ * x, nq           Spectral quantized, and count of significants
+ * return          Unquantized gain value
+ */
+LC3_HOT static float unquantize(enum lc3_dt dt, enum lc3_srate sr,
+    int g_int, float *x, int nq)
+{
+    float g = unquantize_gain(g_int);
+    int i, ne = LC3_NE(dt, sr);
+
+    for (i = 0; i < nq; i++)
+        x[i] = x[i] * g;
+
+    for ( ; i < ne; i++)
+        x[i] = 0;
+
+    return g;
+}
+
+
+/* ----------------------------------------------------------------------------
+ *  Spectrum coding
+ * -------------------------------------------------------------------------- */
+
+/**
+ * Resolve High-bitrate mode according size of the frame
+ * sr, nbytes      Samplerate and size of the frame
+ * return          True when High-Rate mode enabled
+ */
+static int resolve_high_rate(enum lc3_srate sr, int nbytes)
+{
+    return nbytes > 20 * (1 + (int)sr);
+}
+
+/**
+ * Bit consumption
+ * dt, sr, nbytes  Duration, samplerate and size of the frame
+ * x               Spectral quantized coefficients
+ * n               Count of significant coefficients, updated on truncation
+ * nbits_budget    Truncate to stay in budget, when not zero
+ * p_lsb_mode      Return True when LSB's are not AC coded, or NULL
+ * return          The number of bits coding the spectrum
+ *
+ * The spectral coefficients `x` storage is :
+ *   b0       0:positive or zero  1:negative
+ *   b15..b1  Absolute value
+ */
+LC3_HOT static int compute_nbits(
+    enum lc3_dt dt, enum lc3_srate sr, int nbytes,
+    const uint16_t *x, int *n, int nbits_budget, bool *p_lsb_mode)
+{
+    int ne = LC3_NE(dt, sr);
+
+    /* --- Mode and rate --- */
+
+    bool lsb_mode  = nbytes >= 20 * (3 + (int)sr);
+    bool high_rate = resolve_high_rate(sr, nbytes);
+
+    /* --- Loop on quantized coefficients --- */
+
+    int nbits = 0, nbits_lsb = 0;
+    uint8_t state = 0;
+
+    int nbits_end = 0;
+    int n_end = 0;
+
+    nbits_budget = nbits_budget ? nbits_budget * 2048 : INT_MAX;
+
+    for (int i = 0, h = 0; h < 2; h++) {
+        const uint8_t (*lut_coeff)[4] = lc3_spectrum_lookup[high_rate][h];
+
+        for ( ; i < LC3_MIN(*n, (ne + 2) >> (1 - h))
+                && nbits <= nbits_budget; i += 2) {
+
+            const uint8_t *lut = lut_coeff[state];
+            uint16_t a = x[i] >> 1, b = x[i+1] >> 1;
+
+            /* --- Sign values --- */
+
+            int s = (a > 0) + (b > 0);
+            nbits += s * 2048;
+
+            /* --- LSB values Reduce to 2*2 bits MSB values ---
+             * Reduce to 2x2 bits MSB values. The LSB's pair are arithmetic
+             * coded with an escape code followed by 1 bit for each values.
+             * The LSB mode does not arthmetic code the first LSB,
+             * add the sign of the LSB when one of pair was at value 1 */
+
+            int k = 0;
+            int m = (a | b) >> 2;
+
+            if (m) {
+
+                if (lsb_mode) {
+                    nbits += lc3_spectrum_bits[lut[k++]][16] - 2*2048;
+                    nbits_lsb += 2 + (a == 1) + (b == 1);
+                }
+
+                for (m >>= lsb_mode; m; m >>= 1, k++)
+                    nbits += lc3_spectrum_bits[lut[LC3_MIN(k, 3)]][16];
+
+                nbits += k * 2*2048;
+                a >>= k;
+                b >>= k;
+
+                k = LC3_MIN(k, 3);
+            }
+
+            /* --- MSB values --- */
+
+            nbits += lc3_spectrum_bits[lut[k]][a + 4*b];
+
+            /* --- Update state --- */
+
+            if (s && nbits <= nbits_budget) {
+                n_end = i + 2;
+                nbits_end = nbits;
+            }
+
+            state = (state << 4) + (k > 1 ? 12 + k : 1 + (a + b) * (k + 1));
+        }
+    }
+
+    /* --- Return --- */
+
+    *n = n_end;
+
+    if (p_lsb_mode)
+        *p_lsb_mode = lsb_mode &&
+            nbits_end + nbits_lsb * 2048 > nbits_budget;
+
+    if (nbits_budget >= INT_MAX)
+        nbits_end += nbits_lsb * 2048;
+
+    return (nbits_end + 2047) / 2048;
+}
+
+/**
+ * Put quantized spectrum
+ * bits            Bitstream context
+ * dt, sr, nbytes  Duration, samplerate and size of the frame
+ * x               Spectral quantized
+ * nq, lsb_mode    Count of significants, and LSB discard indication
+ *
+ * The spectral coefficients `x` storage is :
+ *   b0       0:positive or zero  1:negative
+ *   b15..b1  Absolute value
+ */
+LC3_HOT static void put_quantized(lc3_bits_t *bits,
+    enum lc3_dt dt, enum lc3_srate sr, int nbytes,
+    const uint16_t *x, int nq, bool lsb_mode)
+{
+    int ne = LC3_NE(dt, sr);
+    bool high_rate = resolve_high_rate(sr, nbytes);
+
+    /* --- Loop on quantized coefficients --- */
+
+    uint8_t state = 0;
+
+    for (int i = 0, h = 0; h < 2; h++) {
+        const uint8_t (*lut_coeff)[4] = lc3_spectrum_lookup[high_rate][h];
+
+        for ( ; i < LC3_MIN(nq, (ne + 2) >> (1 - h)); i += 2) {
+
+            const uint8_t *lut = lut_coeff[state];
+            uint16_t a = x[i] >> 1, b = x[i+1] >> 1;
+
+            /* --- LSB values Reduce to 2*2 bits MSB values ---
+             * Reduce to 2x2 bits MSB values. The LSB's pair are arithmetic
+             * coded with an escape code and 1 bits for each values.
+             * The LSB mode discard the first LSB (at this step) */
+
+            int m = (a | b) >> 2;
+            int k = 0, shr = 0;
+
+            if (m) {
+
+                if (lsb_mode)
+                    lc3_put_symbol(bits,
+                        lc3_spectrum_models + lut[k++], 16);
+
+                for (m >>= lsb_mode; m; m >>= 1, k++) {
+                    lc3_put_bit(bits, (a >> k) & 1);
+                    lc3_put_bit(bits, (b >> k) & 1);
+                    lc3_put_symbol(bits,
+                        lc3_spectrum_models + lut[LC3_MIN(k, 3)], 16);
+                }
+
+                a >>= lsb_mode;
+                b >>= lsb_mode;
+
+                shr = k - lsb_mode;
+                k = LC3_MIN(k, 3);
+            }
+
+            /* --- Sign values --- */
+
+            if (a) lc3_put_bit(bits, x[i+0] & 1);
+            if (b) lc3_put_bit(bits, x[i+1] & 1);
+
+            /* --- MSB values --- */
+
+            a >>= shr;
+            b >>= shr;
+
+            lc3_put_symbol(bits, lc3_spectrum_models + lut[k], a + 4*b);
+
+            /* --- Update state --- */
+
+            state = (state << 4) + (k > 1 ? 12 + k : 1 + (a + b) * (k + 1));
+        }
+    }
+}
+
+/**
+ * Get quantized spectrum
+ * bits            Bitstream context
+ * dt, sr, nbytes  Duration, samplerate and size of the frame
+ * nq, lsb_mode    Count of significants, and LSB discard indication
+ * xq              Return `nq` spectral quantized coefficients
+ * nf_seed         Return the noise factor seed associated
+ * return          0: Ok  -1: Invalid bitstream data
+ */
+LC3_HOT static int get_quantized(lc3_bits_t *bits,
+    enum lc3_dt dt, enum lc3_srate sr, int nbytes,
+    int nq, bool lsb_mode, float *xq, uint16_t *nf_seed)
+{
+    int ne = LC3_NE(dt, sr);
+    bool high_rate = resolve_high_rate(sr, nbytes);
+
+     *nf_seed = 0;
+
+    /* --- Loop on quantized coefficients --- */
+
+    uint8_t state = 0;
+
+    for (int i = 0, h = 0; h < 2; h++) {
+        const uint8_t (*lut_coeff)[4] = lc3_spectrum_lookup[high_rate][h];
+
+        for ( ; i < LC3_MIN(nq, (ne + 2) >> (1 - h)); i += 2) {
+
+            const uint8_t *lut = lut_coeff[state];
+
+            /* --- LSB values ---
+             * Until the symbol read indicates the escape value 16,
+             * read an LSB bit for each values.
+             * The LSB mode discard the first LSB (at this step) */
+
+            int u = 0, v = 0;
+            int k = 0, shl = 0;
+
+            unsigned s = lc3_get_symbol(bits, lc3_spectrum_models + lut[k]);
+
+            if (lsb_mode && s >= 16) {
+                s = lc3_get_symbol(bits, lc3_spectrum_models + lut[++k]);
+                shl++;
+            }
+
+            for ( ; s >= 16 && shl < 14; shl++) {
+                u |= lc3_get_bit(bits) << shl;
+                v |= lc3_get_bit(bits) << shl;
+
+                k += (k < 3);
+                s  = lc3_get_symbol(bits, lc3_spectrum_models + lut[k]);
+            }
+
+            if (s >= 16)
+                return -1;
+
+            /* --- MSB & sign values --- */
+
+            int a = s % 4;
+            int b = s / 4;
+
+            u |= a << shl;
+            v |= b << shl;
+
+            xq[i  ] = u && lc3_get_bit(bits) ? -u : u;
+            xq[i+1] = v && lc3_get_bit(bits) ? -v : v;
+
+            *nf_seed = (*nf_seed + u * i + v * (i+1)) & 0xffff;
+
+            /* --- Update state --- */
+
+            state = (state << 4) + (k > 1 ? 12 + k : 1 + (a + b) * (k + 1));
+        }
+    }
+
+    return 0;
+}
+
+/**
+ * Put residual bits of quantization
+ * bits            Bitstream context
+ * nbits           Maximum number of bits to output
+ * x, n            Spectral quantized, and count of significants
+ * xf              Scaled spectral coefficients
+ *
+ * The spectral coefficients `x` storage is :
+ *   b0       0:positive or zero  1:negative
+ *   b15..b1  Absolute value
+ */
+LC3_HOT static void put_residual(
+    lc3_bits_t *bits, int nbits, const uint16_t *x, int n, const float *xf)
+{
+    for (int i = 0; i < n && nbits > 0; i++) {
+
+        if (x[i] == 0)
+            continue;
+
+        float xq = x[i] & 1 ? -(x[i] >> 1) : (x[i] >> 1);
+
+        lc3_put_bit(bits, xf[i] >= xq);
+        nbits--;
+    }
+}
+
+/**
+ * Get residual bits of quantization
+ * bits            Bitstream context
+ * nbits           Maximum number of bits to output
+ * x, nq           Spectral quantized, and count of significants
+ */
+LC3_HOT static void get_residual(
+    lc3_bits_t *bits, int nbits, float *x, int nq)
+{
+    for (int i = 0; i < nq && nbits > 0; i++) {
+
+        if (x[i] == 0)
+            continue;
+
+        if (lc3_get_bit(bits) == 0)
+            x[i] -= x[i] < 0 ? 5.f/16 : 3.f/16;
+        else
+            x[i] += x[i] > 0 ? 5.f/16 : 3.f/16;
+
+        nbits--;
+    }
+}
+
+/**
+ * Put LSB values of quantized spectrum values
+ * bits            Bitstream context
+ * nbits           Maximum number of bits to output
+ * x, n            Spectral quantized, and count of significants
+ *
+ * The spectral coefficients `x` storage is :
+ *   b0       0:positive or zero  1:negative
+ *   b15..b1  Absolute value
+ */
+LC3_HOT static void put_lsb(
+    lc3_bits_t *bits, int nbits, const uint16_t *x, int n)
+{
+    for (int i = 0; i < n && nbits > 0; i += 2) {
+        uint16_t a = x[i] >> 1, b = x[i+1] >> 1;
+        int a_neg = x[i] & 1, b_neg = x[i+1] & 1;
+
+        if ((a | b) >> 2 == 0)
+            continue;
+
+        if (nbits-- > 0)
+            lc3_put_bit(bits, a & 1);
+
+        if (a == 1 && nbits-- > 0)
+            lc3_put_bit(bits, a_neg);
+
+        if (nbits-- > 0)
+            lc3_put_bit(bits, b & 1);
+
+        if (b == 1 && nbits-- > 0)
+            lc3_put_bit(bits, b_neg);
+    }
+}
+
+/**
+ * Get LSB values of quantized spectrum values
+ * bits            Bitstream context
+ * nbits           Maximum number of bits to output
+ * x, nq           Spectral quantized, and count of significants
+ * nf_seed         Update the noise factor seed according
+ */
+LC3_HOT static void get_lsb(lc3_bits_t *bits,
+    int nbits, float *x, int nq, uint16_t *nf_seed)
+{
+    for (int i = 0; i < nq && nbits > 0; i += 2) {
+
+        float a = fabsf(x[i]), b = fabsf(x[i+1]);
+
+        if (fmaxf(a, b) < 4)
+            continue;
+
+        if (nbits-- > 0 && lc3_get_bit(bits)) {
+            if (a) {
+                x[i] += x[i] < 0 ? -1 : 1;
+                *nf_seed = (*nf_seed + i) & 0xffff;
+            } else if (nbits-- > 0) {
+                x[i] = lc3_get_bit(bits) ? -1 : 1;
+                *nf_seed = (*nf_seed + i) & 0xffff;
+            }
+        }
+
+        if (nbits-- > 0 && lc3_get_bit(bits)) {
+            if (b) {
+                x[i+1] += x[i+1] < 0 ? -1 : 1;
+                *nf_seed = (*nf_seed + i+1) & 0xffff;
+            } else if (nbits-- > 0) {
+                x[i+1] = lc3_get_bit(bits) ? -1 : 1;
+                *nf_seed = (*nf_seed + i+1) & 0xffff;
+            }
+        }
+    }
+}
+
+
+/* ----------------------------------------------------------------------------
+ *  Noise coding
+ * -------------------------------------------------------------------------- */
+
+/**
+ * Estimate noise level
+ * dt, bw          Duration and bandwidth of the frame
+ * xq, nq          Quantized spectral coefficients
+ * x               Quantization scaled spectrum coefficients
+ * return          Noise factor (0 to 7)
+ *
+ * The spectral coefficients `x` storage is :
+ *   b0       0:positive or zero  1:negative
+ *   b15..b1  Absolute value
+ */
+LC3_HOT static int estimate_noise(enum lc3_dt dt, enum lc3_bandwidth bw,
+    const uint16_t *xq, int nq, const float *x)
+{
+    int bw_stop = (dt == LC3_DT_7M5 ? 60 : 80) * (1 + bw);
+    int w = 2 + dt;
+
+    float sum = 0;
+    int i, n = 0, z = 0;
+
+    for (i = 6*(3 + dt) - w; i < LC3_MIN(nq, bw_stop); i++) {
+        z = xq[i] ? 0 : z + 1;
+        if (z > 2*w)
+            sum += fabsf(x[i - w]), n++;
+    }
+
+    for ( ; i < bw_stop + w; i++)
+        if (++z > 2*w)
+            sum += fabsf(x[i - w]), n++;
+
+    int nf = n ? 8 - (int)((16 * sum) / n + 0.5f) : 0;
+
+    return LC3_CLIP(nf, 0, 7);
+}
+
+/**
+ * Noise filling
+ * dt, bw          Duration and bandwidth of the frame
+ * nf, nf_seed     The noise factor and pseudo-random seed
+ * g               Quantization gain
+ * x, nq           Spectral quantized, and count of significants
+ */
+LC3_HOT static void fill_noise(enum lc3_dt dt, enum lc3_bandwidth bw,
+    int nf, uint16_t nf_seed, float g, float *x, int nq)
+{
+    int bw_stop = (dt == LC3_DT_7M5 ? 60 : 80) * (1 + bw);
+    int w = 2 + dt;
+
+    float s = g * (float)(8 - nf) / 16;
+    int i, z = 0;
+
+    for (i = 6*(3 + dt) - w; i < LC3_MIN(nq, bw_stop); i++) {
+        z = x[i] ? 0 : z + 1;
+        if (z > 2*w) {
+            nf_seed = (13849 + nf_seed*31821) & 0xffff;
+            x[i - w] = nf_seed & 0x8000 ? -s : s;
+        }
+    }
+
+    for ( ; i < bw_stop + w; i++)
+        if (++z > 2*w) {
+            nf_seed = (13849 + nf_seed*31821) & 0xffff;
+            x[i - w] = nf_seed & 0x8000 ? -s : s;
+        }
+}
+
+/**
+ * Put noise factor
+ * bits            Bitstream context
+ * nf              Noise factor (0 to 7)
+ */
+static void put_noise_factor(lc3_bits_t *bits, int nf)
+{
+    lc3_put_bits(bits, nf, 3);
+}
+
+/**
+ * Get noise factor
+ * bits            Bitstream context
+ * return          Noise factor (0 to 7)
+ */
+static int get_noise_factor(lc3_bits_t *bits)
+{
+    return lc3_get_bits(bits, 3);
+}
+
+
+/* ----------------------------------------------------------------------------
+ *  Encoding
+ * -------------------------------------------------------------------------- */
+
+/**
+ * Bit consumption of the number of coded coefficients
+ * dt, sr          Duration, samplerate of the frame
+ * return          Bit consumpution of the number of coded coefficients
+ */
+static int get_nbits_nq(enum lc3_dt dt, enum lc3_srate sr)
+{
+    int ne = LC3_NE(dt, sr);
+    return 4 + (ne > 32) + (ne > 64) + (ne > 128) + (ne > 256);
+}
+
+/**
+ * Bit consumption of the arithmetic coder
+ * dt, sr, nbytes  Duration, samplerate and size of the frame
+ * return          Bit consumption of bitstream data
+ */
+static int get_nbits_ac(enum lc3_dt dt, enum lc3_srate sr, int nbytes)
+{
+    return get_nbits_nq(dt, sr) + 3 + LC3_MIN((nbytes-1) / 160, 2);
+}
+
+/**
+ * Spectrum analysis
+ */
+void lc3_spec_analyze(enum lc3_dt dt, enum lc3_srate sr,
+    int nbytes, bool pitch, const lc3_tns_data_t *tns,
+    struct lc3_spec_analysis *spec, float *x,
+    uint16_t *xq, struct lc3_spec_side *side)
+{
+    bool reset_off;
+
+    /* --- Bit budget --- */
+
+    const int nbits_gain = 8;
+    const int nbits_nf = 3;
+
+    int nbits_budget = 8*nbytes - get_nbits_ac(dt, sr, nbytes) -
+        lc3_bwdet_get_nbits(sr) - lc3_ltpf_get_nbits(pitch) -
+        lc3_sns_get_nbits() - lc3_tns_get_nbits(tns) - nbits_gain - nbits_nf;
+
+    /* --- Global gain --- */
+
+    float nbits_off = spec->nbits_off + spec->nbits_spare;
+    nbits_off = fminf(fmaxf(nbits_off, -40), 40);
+    nbits_off = 0.8f * spec->nbits_off + 0.2f * nbits_off;
+
+    int g_off = resolve_gain_offset(sr, nbytes);
+
+    int g_int = estimate_gain(dt, sr,
+        x, nbits_budget, nbits_off, g_off, &reset_off);
+
+    /* --- Quantization --- */
+
+    quantize(dt, sr, g_int, x, xq, &side->nq);
+
+    int nbits = compute_nbits(dt, sr, nbytes, xq, &side->nq, 0, NULL);
+
+    spec->nbits_off = reset_off ? 0 : nbits_off;
+    spec->nbits_spare = reset_off ? 0 : nbits_budget - nbits;
+
+    /* --- Adjust gain and requantize --- */
+
+    int g_adj = adjust_gain(sr, g_int + g_off, nbits, nbits_budget);
+
+    if (g_adj)
+        quantize(dt, sr, g_adj, x, xq, &side->nq);
+
+    side->g_idx = g_int + g_adj + g_off;
+    nbits = compute_nbits(dt, sr, nbytes,
+        xq, &side->nq, nbits_budget, &side->lsb_mode);
+}
+
+/**
+ * Put spectral quantization side data
+ */
+void lc3_spec_put_side(lc3_bits_t *bits,
+    enum lc3_dt dt, enum lc3_srate sr, const struct lc3_spec_side *side)
+{
+    int nbits_nq = get_nbits_nq(dt, sr);
+
+    lc3_put_bits(bits, LC3_MAX(side->nq >> 1, 1) - 1, nbits_nq);
+    lc3_put_bits(bits, side->lsb_mode, 1);
+    lc3_put_bits(bits, side->g_idx, 8);
+}
+
+/**
+ * Encode spectral coefficients
+ */
+void lc3_spec_encode(lc3_bits_t *bits,
+    enum lc3_dt dt, enum lc3_srate sr, enum lc3_bandwidth bw, int nbytes,
+    const uint16_t *xq, const lc3_spec_side_t *side, const float *x)
+{
+    bool lsb_mode = side->lsb_mode;
+    int nq = side->nq;
+
+    put_noise_factor(bits, estimate_noise(dt, bw, xq, nq, x));
+
+    put_quantized(bits, dt, sr, nbytes, xq, nq, lsb_mode);
+
+    int nbits_left = lc3_get_bits_left(bits);
+
+    if (lsb_mode)
+        put_lsb(bits, nbits_left, xq, nq);
+    else
+        put_residual(bits, nbits_left, xq, nq, x);
+}
+
+
+/* ----------------------------------------------------------------------------
+ *  Decoding
+ * -------------------------------------------------------------------------- */
+
+/**
+ * Get spectral quantization side data
+ */
+int lc3_spec_get_side(lc3_bits_t *bits,
+    enum lc3_dt dt, enum lc3_srate sr, struct lc3_spec_side *side)
+{
+    int nbits_nq = get_nbits_nq(dt, sr);
+    int ne = LC3_NE(dt, sr);
+
+    side->nq = (lc3_get_bits(bits, nbits_nq) + 1) << 1;
+    side->lsb_mode = lc3_get_bit(bits);
+    side->g_idx = lc3_get_bits(bits, 8);
+
+    return side->nq > ne ? (side->nq = ne), -1 : 0;
+}
+
+/**
+ * Decode spectral coefficients
+ */
+int lc3_spec_decode(lc3_bits_t *bits,
+    enum lc3_dt dt, enum lc3_srate sr, enum lc3_bandwidth bw,
+    int nbytes, const lc3_spec_side_t *side, float *x)
+{
+    bool lsb_mode = side->lsb_mode;
+    int nq = side->nq;
+    int ret = 0;
+
+    int nf = get_noise_factor(bits);
+    uint16_t nf_seed;
+
+    if ((ret = get_quantized(bits, dt, sr, nbytes,
+                    nq, lsb_mode, x, &nf_seed)) < 0)
+        return ret;
+
+    int nbits_left = lc3_get_bits_left(bits);
+
+    if (lsb_mode)
+        get_lsb(bits, nbits_left, x, nq, &nf_seed);
+    else
+        get_residual(bits, nbits_left, x, nq);
+
+    int g_int = side->g_idx - resolve_gain_offset(sr, nbytes);
+    float g = unquantize(dt, sr, g_int, x, nq);
+
+    if (nq > 2 || x[0] || x[1] || side->g_idx > 0 || nf < 7)
+        fill_noise(dt, bw, nf, nf_seed, g, x, nq);
+
+    return 0;
+}