Browse code

qcelp: grammar

Signed-off-by: Reynaldo H. Verdejo Pinochet <r.verdejo@sisa.samsung.com>

Reynaldo H. Verdejo Pinochet authored on 2014/02/15 05:42:23
Showing 2 changed files
... ...
@@ -66,7 +66,7 @@ typedef struct QCELPFrame {
66 66
 } QCELPFrame;
67 67
 
68 68
 /**
69
- * pre-calculated table for hammsinc function
69
+ * Pre-calculated table for hammsinc function.
70 70
  * Only half of the table is needed because of symmetry.
71 71
  *
72 72
  * TIA/EIA/IS-733 2.4.5.2-2/3
... ...
@@ -82,7 +82,7 @@ typedef struct QCELPBitmap {
82 82
 #define QCELP_OF(variable, bit, len) {offsetof(QCELPFrame, variable), bit, len}
83 83
 
84 84
 /**
85
- * bitmap unpacking tables for RATE_FULL
85
+ * Bitmap unpacking tables for RATE_FULL
86 86
  *
87 87
  * TIA/EIA/IS-733 Table 2.4.7.1-1
88 88
  */
... ...
@@ -169,7 +169,7 @@ static const QCELPBitmap qcelp_rate_full_bitmap[] = {
169 169
 };
170 170
 
171 171
 /**
172
- * bitmap unpacking tables for RATE_HALF
172
+ * Bitmap unpacking tables for RATE_HALF
173 173
  *
174 174
  * TIA/EIA/IS-733 Table 2.4.7.2-1
175 175
  */
... ...
@@ -211,7 +211,7 @@ static const QCELPBitmap qcelp_rate_half_bitmap[] = {
211 211
 };
212 212
 
213 213
 /**
214
- * bitmap unpacking tables for RATE_QUARTER
214
+ * Bitmap unpacking tables for RATE_QUARTER
215 215
  *
216 216
  * TIA/EIA/IS-733 Table 2.4.7.3-1
217 217
  */
... ...
@@ -232,7 +232,7 @@ static const QCELPBitmap qcelp_rate_quarter_bitmap[] = {
232 232
 };
233 233
 
234 234
 /**
235
- * bitmap unpacking tables for RATE_OCTAVE
235
+ * Bitmap unpacking tables for RATE_OCTAVE
236 236
  *
237 237
  * trick: CBSEED is written into QCELPContext.cbsign[15],
238 238
  * which is not used for RATE_OCTAVE.
... ...
@@ -262,7 +262,7 @@ static const QCELPBitmap qcelp_rate_octave_bitmap[] = {
262 262
 };
263 263
 
264 264
 /**
265
- * position of the bitmapping data for each packet type in
265
+ * Bitmapping data position for each packet type in
266 266
  * the QCELPContext
267 267
  */
268 268
 static const QCELPBitmap * const qcelp_unpacking_bitmaps_per_rate[5] = {
... ...
@@ -420,12 +420,12 @@ static const qcelp_vector * const qcelp_lspvq[5] = {
420 420
 };
421 421
 
422 422
 /**
423
- * the final gain scalefactor before clipping into a usable output float
423
+ * The final gain scalefactor before clipping into a usable output float
424 424
  */
425 425
 #define QCELP_SCALE 8192.
426 426
 
427 427
 /**
428
- * table for computing Ga (decoded linear codebook gain magnitude)
428
+ * Table for computing Ga (decoded linear codebook gain magnitude)
429 429
  *
430 430
  * @note The table could fit in int16_t in x*8 form, but it seems
431 431
  *       to be slower on x86
... ...
@@ -452,7 +452,7 @@ static const float qcelp_g12ga[61] = {
452 452
  1000.000/QCELP_SCALE};
453 453
 
454 454
 /**
455
- * circular codebook for rate 1 frames in x*100 form
455
+ * Circular codebook for rate 1 frames in x*100 form
456 456
  *
457 457
  * TIA/EIA/IS-733 2.4.6.1-2
458 458
  */
... ...
@@ -477,7 +477,7 @@ static const int16_t qcelp_rate_full_codebook[128] = {
477 477
 #define QCELP_RATE_FULL_CODEBOOK_RATIO .01
478 478
 
479 479
 /**
480
- * circular codebook for rate 1/2 frames in x*2 form
480
+ * Circular codebook for rate 1/2 frames in x*2 form
481 481
  *
482 482
  * TIA/EIA/IS-733 2.4.6.1-1
483 483
  */
... ...
@@ -511,7 +511,7 @@ static const int8_t qcelp_rate_half_codebook[128] = {
511 511
 #define QCELP_SQRT1887 1.373681186
512 512
 
513 513
 /**
514
- * table for impulse response of BPF used to filter
514
+ * Table for impulse response of BPF used to filter
515 515
  * the white excitation for bitrate 1/4 synthesis
516 516
  *
517 517
  * Only half the tables are needed because of symmetry.
... ...
@@ -526,14 +526,14 @@ static const double qcelp_rnd_fir_coefs[11] = {
526 526
 
527 527
 /**
528 528
  * This spread factor is used, for bitrate 1/8 and I_F_Q,
529
- * to force the LSP frequencies to be at least 80 Hz apart.
529
+ * to force LSP frequencies to be at least 80 Hz apart.
530 530
  *
531 531
  * TIA/EIA/IS-733 2.4.3.3.2
532 532
  */
533 533
 #define QCELP_LSP_SPREAD_FACTOR 0.02
534 534
 
535 535
 /**
536
- * predictor coefficient for the conversion of LSP codes
536
+ * Predictor coefficient for the conversion of LSP codes
537 537
  * to LSP frequencies for 1/8 and I_F_Q
538 538
  *
539 539
  * TIA/EIA/IS-733 2.4.3.2.7-2
... ...
@@ -541,7 +541,7 @@ static const double qcelp_rnd_fir_coefs[11] = {
541 541
 #define QCELP_LSP_OCTAVE_PREDICTOR 29.0/32
542 542
 
543 543
 /**
544
- * initial coefficient to perform bandwidth expansion on LPC
544
+ * Initial coefficient to perform bandwidth expansion on LPC
545 545
  *
546 546
  * @note: 0.9883 looks like an approximation of 253/256.
547 547
  *
... ...
@@ -633,7 +633,7 @@ static qcelp_packet_rate determine_bitrate(AVCodecContext *avctx,
633 633
         (*buf)++;
634 634
     } else if ((bitrate = buf_size2bitrate(buf_size + 1)) >= 0) {
635 635
         av_log(avctx, AV_LOG_WARNING,
636
-               "Bitrate byte is missing, guessing the bitrate from packet size.\n");
636
+               "Bitrate byte missing, guessing bitrate from packet size.\n");
637 637
     } else
638 638
         return I_F_Q;
639 639
 
... ...
@@ -703,7 +703,7 @@ static int qcelp_decode_frame(AVCodecContext *avctx, void *data,
703 703
     outbuffer = (float *)frame->data[0];
704 704
 
705 705
     if ((q->bitrate = determine_bitrate(avctx, buf_size, &buf)) == I_F_Q) {
706
-        warn_insufficient_frame_quality(avctx, "bitrate cannot be determined.");
706
+        warn_insufficient_frame_quality(avctx, "Bitrate cannot be determined.");
707 707
         goto erasure;
708 708
     }
709 709