qcelpdata.h File Reference

Data tables for the QCELP decoder. More...

#include <stddef.h>
#include <stdint.h>
#include "libavutil/common.h"

Go to the source code of this file.

Data Structures
struct	QCELPFrame
	QCELP unpacked data frame. More...
struct	QCELPBitmap

Macros
#define	QCELP_OF(variable, bit, len)   {offsetof(QCELPFrame, variable), bit, len}
#define	QCELP_SCALE   8192.
	The final gain scalefactor before clipping into a usable output float. More...
#define	QCELP_RATE_FULL_CODEBOOK_RATIO   .01
#define	QCELP_RATE_HALF_CODEBOOK_RATIO   0.5
#define	QCELP_SQRT1887   1.373681186
	sqrt(1.887) is the maximum of the pseudorandom white sequence used to generate the scaled codebook vector for bitrate 1/4. More...
#define	QCELP_LSP_SPREAD_FACTOR   0.02
	This spread factor is used, for bitrate 1/8 and I_F_Q, to force LSP frequencies to be at least 80 Hz apart. More...
#define	QCELP_LSP_OCTAVE_PREDICTOR   29.0/32
	Predictor coefficient for the conversion of LSP codes to LSP frequencies for 1/8 and I_F_Q. More...
#define	QCELP_BANDWIDTH_EXPANSION_COEFF   0.9883
	Initial coefficient to perform bandwidth expansion on LPC. More...

Typedefs
typedef uint16_t	qcelp_vector[2]

Variables
static const float	qcelp_hammsinc_table [4] = { -0.006822, 0.041249, -0.143459, 0.588863}
	Pre-calculated table for hammsinc function. More...
static const QCELPBitmap	qcelp_rate_full_bitmap []
	Bitmap unpacking tables for RATE_FULL. More...
static const QCELPBitmap	qcelp_rate_half_bitmap []
	Bitmap unpacking tables for RATE_HALF. More...
static const QCELPBitmap	qcelp_rate_quarter_bitmap []
	Bitmap unpacking tables for RATE_QUARTER. More...
static const QCELPBitmap	qcelp_rate_octave_bitmap []
	Bitmap unpacking tables for RATE_OCTAVE. More...
static const QCELPBitmap *const	qcelp_unpacking_bitmaps_per_rate [5]
	Bitmapping data position for each packet type in the QCELPContext. More...
static const uint16_t	qcelp_unpacking_bitmaps_lengths [5]
static const qcelp_vector	qcelp_lspvq1 [64]
	LSP vector quantization tables in x*10000 form. More...
static const qcelp_vector	qcelp_lspvq2 [128]
static const qcelp_vector	qcelp_lspvq3 [128]
static const qcelp_vector	qcelp_lspvq4 [64]
static const qcelp_vector	qcelp_lspvq5 [64]
static const qcelp_vector *const	qcelp_lspvq [5]
static const float	qcelp_g12ga [61]
	Table for computing Ga (decoded linear codebook gain magnitude) More...
static const int16_t	qcelp_rate_full_codebook [128]
	Circular codebook for rate 1 frames in x*100 form. More...
static const int8_t	qcelp_rate_half_codebook [128]
	Circular codebook for rate 1/2 frames in x*2 form. More...
static const double	qcelp_rnd_fir_coefs [11]
	Table for impulse response of BPF used to filter the white excitation for bitrate 1/4 synthesis. More...

Detailed Description

Data tables for the QCELP decoder.

Author

Reynaldo H. Verdejo Pinochet

Remarks

FFmpeg merging spearheaded by Kenan Gillet

Development mentored by Benjamin Larson

Definition in file qcelpdata.h.

Macro Definition Documentation

QCELP_OF

#define QCELP_OF	(		variable,
			bit,
			len
	)		{offsetof(QCELPFrame, variable), bit, len}

Definition at line 82 of file qcelpdata.h.

QCELP_SCALE

#define QCELP_SCALE   8192.

The final gain scalefactor before clipping into a usable output float.

Definition at line 425 of file qcelpdata.h.

QCELP_RATE_FULL_CODEBOOK_RATIO

#define QCELP_RATE_FULL_CODEBOOK_RATIO   .01

Definition at line 477 of file qcelpdata.h.

Referenced by compute_svector().

QCELP_RATE_HALF_CODEBOOK_RATIO

#define QCELP_RATE_HALF_CODEBOOK_RATIO   0.5

Definition at line 502 of file qcelpdata.h.

Referenced by compute_svector().

QCELP_SQRT1887

#define QCELP_SQRT1887   1.373681186

sqrt(1.887) is the maximum of the pseudorandom white sequence used to generate the scaled codebook vector for bitrate 1/4.

TIA/EIA/IS-733 2.4.8.1.2

Definition at line 511 of file qcelpdata.h.

Referenced by compute_svector().

QCELP_LSP_SPREAD_FACTOR

#define QCELP_LSP_SPREAD_FACTOR   0.02

This spread factor is used, for bitrate 1/8 and I_F_Q, to force LSP frequencies to be at least 80 Hz apart.

TIA/EIA/IS-733 2.4.3.3.2

Definition at line 533 of file qcelpdata.h.

Referenced by decode_lspf().

QCELP_LSP_OCTAVE_PREDICTOR

#define QCELP_LSP_OCTAVE_PREDICTOR   29.0/32

Predictor coefficient for the conversion of LSP codes to LSP frequencies for 1/8 and I_F_Q.

TIA/EIA/IS-733 2.4.3.2.7-2

Definition at line 541 of file qcelpdata.h.

Referenced by decode_lspf().

QCELP_BANDWIDTH_EXPANSION_COEFF

#define QCELP_BANDWIDTH_EXPANSION_COEFF   0.9883

Initial coefficient to perform bandwidth expansion on LPC.

Note

: 0.9883 looks like an approximation of 253/256.

TIA/EIA/IS-733 2.4.3.3.6 6

Definition at line 550 of file qcelpdata.h.

Referenced by lspf2lpc().

Typedef Documentation

qcelp_vector

typedef uint16_t qcelp_vector[2]

Definition at line 284 of file qcelpdata.h.

Variable Documentation

qcelp_hammsinc_table

const float qcelp_hammsinc_table[4] = { -0.006822, 0.041249, -0.143459, 0.588863}

static

Pre-calculated table for hammsinc function.

Only half of the table is needed because of symmetry.

TIA/EIA/IS-733 2.4.5.2-2/3

Definition at line 74 of file qcelpdata.h.

Referenced by do_pitchfilter().

qcelp_rate_full_bitmap

const QCELPBitmap qcelp_rate_full_bitmap[]

static

Bitmap unpacking tables for RATE_FULL.

TIA/EIA/IS-733 Table 2.4.7.1-1

Definition at line 89 of file qcelpdata.h.

qcelp_rate_half_bitmap

const QCELPBitmap qcelp_rate_half_bitmap[]

static

Bitmap unpacking tables for RATE_HALF.

TIA/EIA/IS-733 Table 2.4.7.2-1

Definition at line 176 of file qcelpdata.h.

qcelp_rate_quarter_bitmap

const QCELPBitmap qcelp_rate_quarter_bitmap[]

static

Initial value:

= {
                               
    QCELP_OF(lspv  [2], 0, 3), 
    QCELP_OF(lspv  [1], 0, 7), 
    QCELP_OF(lspv  [0], 0, 6), 
    QCELP_OF(lspv  [4], 0, 6), 
    QCELP_OF(lspv  [3], 0, 6), 
    QCELP_OF(lspv  [2], 3, 4), 
    QCELP_OF(cbgain[3], 0, 4), 
    QCELP_OF(cbgain[2], 0, 4), 
    QCELP_OF(cbgain[1], 0, 4), 
    QCELP_OF(cbgain[0], 0, 4), 
    QCELP_OF(reserved,  0, 2), 
    QCELP_OF(cbgain[4], 0, 4)  
}

Bitmap unpacking tables for RATE_QUARTER.

TIA/EIA/IS-733 Table 2.4.7.3-1

Definition at line 218 of file qcelpdata.h.

qcelp_rate_octave_bitmap

const QCELPBitmap qcelp_rate_octave_bitmap[]

static

Initial value:

= {
                                
    QCELP_OF(cbsign[15], 3, 1), 
    QCELP_OF(lspv   [0], 0, 1), 
    QCELP_OF(lspv   [1], 0, 1), 
    QCELP_OF(lspv   [2], 0, 1), 
    QCELP_OF(cbsign[15], 2, 1), 
    QCELP_OF(lspv   [3], 0, 1), 
    QCELP_OF(lspv   [4], 0, 1), 
    QCELP_OF(lspv   [5], 0, 1), 
    QCELP_OF(cbsign[15], 1, 1), 
    QCELP_OF(lspv   [6], 0, 1), 
    QCELP_OF(lspv   [7], 0, 1), 
    QCELP_OF(lspv   [8], 0, 1), 
    QCELP_OF(cbsign[15], 0, 1), 
    QCELP_OF(lspv   [9], 0, 1), 
    QCELP_OF(cbgain [0], 0, 2), 
    QCELP_OF(reserved,   0, 4)  
}

Bitmap unpacking tables for RATE_OCTAVE.

trick: CBSEED is written into QCELPContext.cbsign[15], which is not used for RATE_OCTAVE. CBSEED is only used to ensure the occurrence of random bit patterns in the 16 first bits that are used as the seed.

TIA/EIA/IS-733 Table 2.4.7.4-1

Definition at line 244 of file qcelpdata.h.

qcelp_unpacking_bitmaps_per_rate

const QCELPBitmap* const qcelp_unpacking_bitmaps_per_rate[5]

static

Initial value:

= {
    NULL,                     
    qcelp_rate_octave_bitmap,
    qcelp_rate_quarter_bitmap,
    qcelp_rate_half_bitmap,
    qcelp_rate_full_bitmap,
}

Bitmapping data position for each packet type in the QCELPContext.

Definition at line 268 of file qcelpdata.h.

Referenced by qcelp_decode_frame().

qcelp_unpacking_bitmaps_lengths

const uint16_t qcelp_unpacking_bitmaps_lengths[5]

static

Initial value:

= {
    0, 
    FF_ARRAY_ELEMS(qcelp_rate_octave_bitmap),
    FF_ARRAY_ELEMS(qcelp_rate_quarter_bitmap),
    FF_ARRAY_ELEMS(qcelp_rate_half_bitmap),
    FF_ARRAY_ELEMS(qcelp_rate_full_bitmap),
}

Definition at line 276 of file qcelpdata.h.

Referenced by qcelp_decode_frame().

qcelp_lspvq1

const qcelp_vector qcelp_lspvq1[64]

static

Initial value:

= {
{ 327, 118},{ 919, 111},{ 427, 440},{1327, 185},
{ 469,  50},{1272,  91},{ 892,  59},{1771, 193},
{ 222, 158},{1100, 127},{ 827,  55},{ 978, 791},
{ 665,  47},{ 700,1401},{ 670, 859},{1913,1048},
{ 471, 215},{1046, 125},{ 645, 298},{1599, 160},
{ 593,  39},{1187, 462},{ 749, 341},{1520, 511},
{ 290, 792},{ 909, 362},{ 753,  81},{1111,1058},
{ 519, 253},{ 828, 839},{ 685, 541},{1421,1258},
{ 386, 130},{ 962, 119},{ 542, 387},{1431, 185},
{ 526,  51},{1175, 260},{ 831, 167},{1728, 510},
{ 273, 437},{1172, 113},{ 771, 144},{1122, 751},
{ 619, 119},{ 492,1276},{ 658, 695},{1882, 615},
{ 415, 200},{1018,  88},{ 681, 339},{1436, 325},
{ 555, 122},{1042, 485},{ 826, 345},{1374, 743},
{ 383,1018},{1005, 358},{ 704,  86},{1301, 586},
{ 597, 241},{ 832, 621},{ 555, 573},{1504, 839}}

LSP vector quantization tables in x*10000 form.

TIA/EIA/IS-733 tables 2.4.3.2.6.3-1 through 2.4.3.2.6.3-5

Definition at line 292 of file qcelpdata.h.

qcelp_lspvq2

const qcelp_vector qcelp_lspvq2[128]

static

Definition at line 310 of file qcelpdata.h.

qcelp_lspvq3

const qcelp_vector qcelp_lspvq3[128]

static

Definition at line 344 of file qcelpdata.h.

qcelp_lspvq4

const qcelp_vector qcelp_lspvq4[64]

static

Initial value:

= {
{ 348, 311},{ 812,1145},{ 552, 461},{1826, 263},
{ 601, 675},{1730, 172},{1523, 193},{2449, 277},
{ 334, 668},{ 805,1441},{1319, 207},{1684, 910},
{ 582,1318},{1403,1098},{ 979, 832},{2700,1359},
{ 624, 228},{1292, 979},{ 800, 195},{2226, 285},
{ 730, 862},{1537, 601},{1115, 509},{2720, 354},
{ 218,1167},{1212,1538},{1074, 247},{1674,1710},
{ 322,2142},{1263, 777},{ 981, 556},{2119,1710},
{ 193, 596},{1035, 957},{ 694, 397},{1997, 253},
{ 743, 603},{1584, 321},{1346, 346},{2221, 708},
{ 451, 732},{1040,1415},{1184, 230},{1853, 919},
{ 310,1661},{1625, 706},{ 856, 843},{2902, 702},
{ 467, 348},{1108,1048},{ 859, 306},{1964, 463},
{ 560,1013},{1425, 533},{1142, 634},{2391, 879},
{ 397,1084},{1345,1700},{ 976, 248},{1887,1189},
{ 644,2087},{1262, 603},{ 877, 550},{2203,1307}}

Definition at line 378 of file qcelpdata.h.

qcelp_lspvq5

const qcelp_vector qcelp_lspvq5[64]

static

Initial value:

= {
{ 360, 222},{ 820,1097},{ 601, 319},{1656, 198},
{ 604, 513},{1552, 141},{1391, 155},{2474, 261},
{ 269, 785},{1463, 646},{1123, 191},{2015, 223},
{ 785, 844},{1202,1011},{ 980, 807},{3014, 793},
{ 570, 180},{1135,1382},{ 778, 256},{1901, 179},
{ 807, 622},{1461, 458},{1231, 178},{2028, 821},
{ 387, 927},{1496,1004},{ 888, 392},{2246, 341},
{ 295,1462},{1156, 694},{1022, 473},{2226,1364},
{ 210, 478},{1029,1020},{ 722, 181},{1730, 251},
{ 730, 488},{1465, 293},{1303, 326},{2595, 387},
{ 458, 584},{1569, 742},{1029, 173},{1910, 495},
{ 605,1159},{1268, 719},{ 973, 646},{2872, 428},
{ 443, 334},{ 835,1465},{ 912, 138},{1716, 442},
{ 620, 778},{1316, 450},{1186, 335},{1446,1665},
{ 486,1050},{1675,1019},{ 880, 278},{2214, 202},
{ 539,1564},{1142, 533},{ 984, 391},{2130,1089}}

Definition at line 396 of file qcelpdata.h.

qcelp_lspvq

const qcelp_vector* const qcelp_lspvq[5]

static

Initial value:

= {
    qcelp_lspvq1,
    qcelp_lspvq2,
    qcelp_lspvq3,
    qcelp_lspvq4,
    qcelp_lspvq5
}

Definition at line 414 of file qcelpdata.h.

Referenced by decode_lspf().

qcelp_g12ga

const float qcelp_g12ga[61]

static

Initial value:

= {
    1.000/QCELP_SCALE,   1.125/QCELP_SCALE,   1.250/QCELP_SCALE,   1.375/QCELP_SCALE,
    1.625/QCELP_SCALE,   1.750/QCELP_SCALE,   2.000/QCELP_SCALE,   2.250/QCELP_SCALE,
    2.500/QCELP_SCALE,   2.875/QCELP_SCALE,   3.125/QCELP_SCALE,   3.500/QCELP_SCALE,
    4.000/QCELP_SCALE,   4.500/QCELP_SCALE,   5.000/QCELP_SCALE,   5.625/QCELP_SCALE,
    6.250/QCELP_SCALE,   7.125/QCELP_SCALE,   8.000/QCELP_SCALE,   8.875/QCELP_SCALE,
   10.000/QCELP_SCALE,  11.250/QCELP_SCALE,  12.625/QCELP_SCALE,  14.125/QCELP_SCALE,
   15.875/QCELP_SCALE,  17.750/QCELP_SCALE,  20.000/QCELP_SCALE,  22.375/QCELP_SCALE,
   25.125/QCELP_SCALE,  28.125/QCELP_SCALE,  31.625/QCELP_SCALE,  35.500/QCELP_SCALE,
   39.750/QCELP_SCALE,  44.625/QCELP_SCALE,  50.125/QCELP_SCALE,  56.250/QCELP_SCALE,
   63.125/QCELP_SCALE,  70.750/QCELP_SCALE,  79.375/QCELP_SCALE,  89.125/QCELP_SCALE,
  100.000/QCELP_SCALE, 112.250/QCELP_SCALE, 125.875/QCELP_SCALE, 141.250/QCELP_SCALE,
  158.500/QCELP_SCALE, 177.875/QCELP_SCALE, 199.500/QCELP_SCALE, 223.875/QCELP_SCALE,
  251.250/QCELP_SCALE, 281.875/QCELP_SCALE, 316.250/QCELP_SCALE, 354.875/QCELP_SCALE,
  398.125/QCELP_SCALE, 446.625/QCELP_SCALE, 501.125/QCELP_SCALE, 562.375/QCELP_SCALE,
  631.000/QCELP_SCALE, 708.000/QCELP_SCALE, 794.375/QCELP_SCALE, 891.250/QCELP_SCALE,
 1000.000/QCELP_SCALE}

Table for computing Ga (decoded linear codebook gain magnitude)

Note

The table could fit in int16_t in x*8 form, but it seems to be slower on x86

TIA/EIA/IS-733 2.4.6.2.1-3

Definition at line 436 of file qcelpdata.h.

Referenced by decode_gain_and_index().

qcelp_rate_full_codebook

const int16_t qcelp_rate_full_codebook[128]

static

Initial value:

= {
     10,  -65,  -59,   12,  110,   34, -134,  157,
    104,  -84,  -34, -115,   23, -101,    3,   45,
   -101,  -16,  -59,   28,  -45,  134,  -67,   22,
     61,  -29,  226,  -26,  -55, -179,  157,  -51,
   -220,  -93,  -37,   60,  118,   74,  -48,  -95,
   -181,  111,   36,  -52, -215,   78, -112,   39,
    -17,  -47, -223,   19,   12,  -98, -142,  130,
     54, -127,   21,  -12,   39,  -48,   12,  128,
      6, -167,   82, -102,  -79,   55,  -44,   48,
    -20,  -53,    8,  -61,   11,  -70, -157, -168,
     20,  -56,  -74,   78,   33,  -63, -173,   -2,
    -75,  -53, -146,   77,   66,  -29,    9,  -75,
     65,  119,  -43,   76,  233,   98,  125, -156,
    -27,   78,   -9,  170,  176,  143, -148,   -7,
     27, -136,    5,   27,   18,  139,  204,    7,
   -184, -197,   52,   -3,   78, -189,    8,  -65
}

Circular codebook for rate 1 frames in x*100 form.

TIA/EIA/IS-733 2.4.6.1-2

Definition at line 459 of file qcelpdata.h.

Referenced by compute_svector().

qcelp_rate_half_codebook

const int8_t qcelp_rate_half_codebook[128]

static

Initial value:

= {
     0, -4,  0, -3,  0,  0,  0,  0,
     0,  0,  0,  0,  0,  0,  0,  0,
     0, -3, -2,  0,  0,  0,  0,  0,
     0,  0,  0,  0,  0,  0,  0,  5,
     0,  0,  0,  0,  0,  0,  4,  0,
     0,  3,  2,  0,  3,  4,  0,  0,
     0,  0,  0,  0,  0,  0,  0,  0,
     0,  0,  0,  0,  0,  3,  0,  0,
    -3,  3,  0,  0, -2,  0,  3,  0,
     0,  0,  0,  0,  0,  0, -5,  0,
     0,  0,  0,  3,  0,  0,  0,  3,
     0,  0,  0,  0,  0,  0,  0,  4,
     0,  0,  0,  0,  0,  0,  0,  0,
     0,  3,  6, -3, -4,  0, -3, -3,
     3, -3,  0,  0,  0,  0,  0,  0,
     0,  0,  0,  0,  0,  0,  0,  0
}

Circular codebook for rate 1/2 frames in x*2 form.

TIA/EIA/IS-733 2.4.6.1-1

Definition at line 484 of file qcelpdata.h.

Referenced by compute_svector().

qcelp_rnd_fir_coefs

const double qcelp_rnd_fir_coefs[11]

static

Initial value:

= {
  -1.344519e-1, 1.735384e-2, -6.905826e-2, 2.434368e-2,
  -8.210701e-2, 3.041388e-2, -9.251384e-2, 3.501983e-2,
  -9.918777e-2, 3.749518e-2,  8.985137e-1
}

Table for impulse response of BPF used to filter the white excitation for bitrate 1/4 synthesis.

Only half the tables are needed because of symmetry.

TIA/EIA/IS-733 2.4.8.1.2-1.1

Definition at line 521 of file qcelpdata.h.

Referenced by compute_svector().