1 /*
2 * AC-3 Audio Decoder
3 * This code was developed as part of Google Summer of Code 2006.
4 * E-AC-3 support was added as part of Google Summer of Code 2007.
5 *
6 * Copyright (c) 2006 Kartikey Mahendra BHATT (bhattkm at gmail dot com)
7 * Copyright (c) 2007-2008 Bartlomiej Wolowiec <bartek.wolowiec@gmail.com>
8 * Copyright (c) 2007 Justin Ruggles <justin.ruggles@gmail.com>
9 *
10 * This file is part of FFmpeg.
11 *
12 * FFmpeg is free software; you can redistribute it and/or
13 * modify it under the terms of the GNU Lesser General Public
14 * License as published by the Free Software Foundation; either
15 * version 2.1 of the License, or (at your option) any later version.
16 *
17 * FFmpeg is distributed in the hope that it will be useful,
18 * but WITHOUT ANY WARRANTY; without even the implied warranty of
19 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
20 * Lesser General Public License for more details.
21 *
22 * You should have received a copy of the GNU Lesser General Public
23 * License along with FFmpeg; if not, write to the Free Software
24 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
25 */
26
27 #include <stdio.h>
28 #include <stddef.h>
29 #include <math.h>
30 #include <string.h>
31
40
41 /**
42 * table for ungrouping 3 values in 7 bits.
43 * used for exponents and bap=2 mantissas
44 */
46
47 /** tables for ungrouping mantissas */
53
54 /**
55 * Quantization table: levels for symmetric. bits for asymmetric.
56 * reference: Table 7.18 Mapping of bap to Quantizer
57 */
59 0, 3, 5, 7, 11, 15,
60 5, 6, 7, 8, 9, 10, 11, 12, 14, 16
61 };
62
63 /** dynamic range table. converts codes to scale factors. */
65
66 /** Adjustments in dB gain */
77 };
78
79 /**
80 * Table for default stereo downmixing coefficients
81 * reference: Section 7.8.2 Downmixing Into Two Channels
82 */
84 { { 2, 7 }, { 7, 2 }, },
85 { { 4, 4 }, },
86 { { 2, 7 }, { 7, 2 }, },
87 { { 2, 7 }, { 5, 5 }, { 7, 2 }, },
88 { { 2, 7 }, { 7, 2 }, { 6, 6 }, },
89 { { 2, 7 }, { 5, 5 }, { 7, 2 }, { 8, 8 }, },
90 { { 2, 7 }, { 7, 2 }, { 6, 7 }, { 7, 6 }, },
91 { { 2, 7 }, { 5, 5 }, { 7, 2 }, { 6, 7 }, { 7, 6 }, },
92 };
93
94 /**
95 * Symmetrical Dequantization
96 * reference: Section 7.3.3 Expansion of Mantissas for Symmetrical Quantization
97 * Tables 7.19 to 7.23
98 */
99 static inline int
101 {
102 return ((code - (levels >> 1)) << 24) / levels;
103 }
104
105 /*
106 * Initialize tables at runtime.
107 */
109 {
110 int i;
111
112 /* generate table for ungrouping 3 values in 7 bits
113 reference: Section 7.1.3 Exponent Decoding */
114 for (i = 0; i < 128; i++) {
118 }
119
120 /* generate grouped mantissa tables
121 reference: Section 7.3.5 Ungrouping of Mantissas */
122 for (i = 0; i < 32; i++) {
123 /* bap=1 mantissas */
127 }
128 for (i = 0; i < 128; i++) {
129 /* bap=2 mantissas */
133
134 /* bap=4 mantissas */
137 }
138 /* generate ungrouped mantissa tables
139 reference: Tables 7.21 and 7.23 */
140 for (i = 0; i < 7; i++) {
141 /* bap=3 mantissas */
143 }
144 for (i = 0; i < 15; i++) {
145 /* bap=5 mantissas */
147 }
148
149 /* generate dynamic range table
150 reference: Section 7.7.1 Dynamic Range Control */
151 for (i = 0; i < 256; i++) {
152 int v = (i >> 5) - ((i >> 7) << 3) - 5;
154 }
155 }
156
157 /**
158 * AVCodec initialization
159 */
161 {
163 int i;
164
166
177
179
180 /* allow downmixing to stereo or mono */
181 if (avctx->
channels > 0 && avctx->request_channels > 0 &&
182 avctx->request_channels < avctx->
channels &&
183 avctx->request_channels <= 2) {
184 avctx->
channels = avctx->request_channels;
185 }
187
191 }
192
193 return 0;
194 }
195
196 /**
197 * Parse the 'sync info' and 'bit stream info' from the AC-3 bitstream.
198 * GetBitContext within AC3DecodeContext must point to
199 * the start of the synchronized AC-3 bitstream.
200 */
202 {
204 int i;
205
206 /* read the rest of the bsi. read twice for dual mono mode. */
208 do {
209 skip_bits(gbc, 5);
// skip dialog normalization
215 skip_bits(gbc, 7);
//skip audio production information
216 } while (i--);
217
218 skip_bits(gbc, 2);
//skip copyright bit and original bitstream bit
219
220 /* skip the timecodes (or extra bitstream information for Alternate Syntax)
221 TODO: read & use the xbsi1 downmix levels */
223 skip_bits(gbc, 14);
//skip timecode1 / xbsi1
225 skip_bits(gbc, 14);
//skip timecode2 / xbsi2
226
227 /* skip additional bitstream info */
230 do {
232 } while (i--);
233 }
234
235 return 0;
236 }
237
238 /**
239 * Common function to parse AC-3 or E-AC-3 frame header
240 */
242 {
244 int err;
245
247 if (err)
248 return err;
249
250 /* get decoding parameters from header info */
268
274 }
275
288 } else if (CONFIG_EAC3_DECODER) {
291 } else {
293 return -1;
294 }
295 }
296
297 /**
298 * Set stereo downmixing coefficients based on frame header info.
299 * reference: Section 7.8.2 Downmixing Into Two Channels
300 */
302 {
303 int i;
306 float norm0, norm1;
307
311 }
314 }
318 }
322 }
323
324 /* renormalize */
325 norm0 = norm1 = 0.0;
329 }
330 norm0 = 1.0f / norm0;
331 norm1 = 1.0f / norm1;
335 }
336
341 }
342 }
343
344 /**
345 * Decode the grouped exponents according to exponent strategy.
346 * reference: Section 7.1.3 Exponent Decoding
347 */
350 {
351 int i, j, grp, group_size;
352 int dexp[256];
353 int expacc, prevexp;
354
355 /* unpack groups */
356 group_size = exp_strategy + (exp_strategy ==
EXP_D45);
357 for (grp = 0, i = 0; grp < ngrps; grp++) {
362 }
363
364 /* convert to absolute exps and expand groups */
365 prevexp = absexp;
366 for (i = 0, j = 0; i < ngrps * 3; i++) {
367 prevexp += dexp[i] - 2;
369 return -1;
370 switch (group_size) {
371 case 4: dexps[j++] = prevexp;
372 dexps[j++] = prevexp;
373 case 2: dexps[j++] = prevexp;
374 case 1: dexps[j++] = prevexp;
375 }
376 }
377 return 0;
378 }
379
380 /**
381 * Generate transform coefficients for each coupled channel in the coupling
382 * range using the coupling coefficients and coupling coordinates.
383 * reference: Section 7.4.3 Coupling Coordinate Format
384 */
386 {
388
391 int band_start = bin;
396 for (bin = band_start; bin < band_end; bin++) {
399 }
401 for (bin = band_start; bin < band_end; bin++)
403 }
404 }
405 }
406 bin = band_end;
407 }
408 }
409
410 /**
411 * Grouped mantissas for 3-level 5-level and 11-level quantization
412 */
421
422 /**
423 * Decode the transform coefficients for a particular channel
424 * reference: Section 7.3 Quantization and Decoding of Mantissas
425 */
427 {
429 int end_freq = s->
end_freq[ch_index];
431 int8_t *exps = s->
dexps[ch_index];
435 int freq;
436
437 for (freq = start_freq; freq < end_freq; freq++) {
438 int bap = baps[freq];
439 int mantissa;
440 switch (bap) {
441 case 0:
442 /* random noise with approximate range of -0.707 to 0.707 */
443 if (dither)
445 else
446 mantissa = 0;
447 break;
448 case 1:
452 } else {
458 }
459 break;
460 case 2:
464 } else {
470 }
471 break;
472 case 3:
474 break;
475 case 4:
479 } else {
484 }
485 break;
486 case 5:
488 break;
489 default: /* 6 to 15 */
490 /* Shift mantissa and sign-extend it. */
493 break;
494 }
495 coeffs[freq] = mantissa >> exps[freq];
496 }
497 }
498
499 /**
500 * Remove random dithering from coupling range coefficients with zero-bit
501 * mantissas for coupled channels which do not use dithering.
502 * reference: Section 7.3.4 Dither for Zero Bit Mantissas (bap=0)
503 */
505 int ch, i;
506
512 }
513 }
514 }
515 }
516
519 {
522 } else {
523 /* if AHT is used, mantissas for all blocks are encoded in the first
524 block of the frame. */
525 int bin;
526 if (!blk && CONFIG_EAC3_DECODER)
528 for (bin = s->
start_freq[ch]; bin < s->end_freq[ch]; bin++) {
530 }
531 }
532 }
533
534 /**
535 * Decode the transform coefficients.
536 */
538 {
540 int got_cplchan = 0;
542
544
545 for (ch = 1; ch <= s->
channels; ch++) {
546 /* transform coefficients for full-bandwidth channel */
548 /* transform coefficients for coupling channel come right after the
549 coefficients for the first coupled channel*/
551 if (!got_cplchan) {
554 got_cplchan = 1;
555 }
557 } else {
559 }
560 do
562 while (++end < 256);
563 }
564
565 /* zero the dithered coefficients for appropriate channels */
567 }
568
569 /**
570 * Stereo rematrixing.
571 * reference: Section 7.5.4 Rematrixing : Decoding Technique
572 */
574 {
575 int bnd, i;
577
579
587 }
588 }
589 }
590 }
591
592 /**
593 * Inverse MDCT Transform.
594 * Convert frequency domain coefficients to time-domain audio samples.
595 * reference: Section 7.9.4 Transformation Equations
596 */
598 {
599 int ch;
600
601 for (ch = 1; ch <= channels; ch++) {
603 int i;
605 for (i = 0; i < 128; i++)
610 for (i = 0; i < 128; i++)
613 } else {
618 }
619 }
620 }
621
622 /**
623 * Upmix delay samples from stereo to original channel layout.
624 */
626 {
627 int channel_data_size =
sizeof(s->
delay[0]);
631 /* upmix mono to stereo */
632 memcpy(s->
delay[1], s->
delay[0], channel_data_size);
633 break;
635 memset(s->
delay[3], 0, channel_data_size);
637 memset(s->
delay[2], 0, channel_data_size);
638 break;
640 memset(s->
delay[4], 0, channel_data_size);
642 memset(s->
delay[3], 0, channel_data_size);
644 memcpy(s->
delay[2], s->
delay[1], channel_data_size);
645 memset(s->
delay[1], 0, channel_data_size);
646 break;
647 }
648 }
649
650 /**
651 * Decode band structure for coupling, spectral extension, or enhanced coupling.
652 * The band structure defines how many subbands are in each band. For each
653 * subband in the range, 1 means it is combined with the previous band, and 0
654 * means that it starts a new band.
655 *
656 * @param[in] gbc bit reader context
657 * @param[in] blk block number
658 * @param[in] eac3 flag to indicate E-AC-3
659 * @param[in] ecpl flag to indicate enhanced coupling
660 * @param[in] start_subband subband number for start of range
661 * @param[in] end_subband subband number for end of range
662 * @param[in] default_band_struct default band structure table
663 * @param[out] num_bands number of bands (optionally NULL)
664 * @param[out] band_sizes array containing the number of bins in each band (optionally NULL)
665 */
667 int ecpl, int start_subband, int end_subband,
668 const uint8_t *default_band_struct,
669 int *num_bands,
uint8_t *band_sizes)
670 {
671 int subbnd, bnd, n_subbands, n_bands=0;
675
676 n_subbands = end_subband - start_subband;
677
678 /* decode band structure from bitstream or use default */
680 for (subbnd = 0; subbnd < n_subbands - 1; subbnd++) {
681 coded_band_struct[subbnd] =
get_bits1(gbc);
682 }
683 band_struct = coded_band_struct;
684 } else if (!blk) {
685 band_struct = &default_band_struct[start_subband+1];
686 } else {
687 /* no change in band structure */
688 return;
689 }
690
691 /* calculate number of bands and band sizes based on band structure.
692 note that the first 4 subbands in enhanced coupling span only 6 bins
693 instead of 12. */
694 if (num_bands || band_sizes ) {
695 n_bands = n_subbands;
696 bnd_sz[0] = ecpl ? 6 : 12;
697 for (bnd = 0, subbnd = 1; subbnd < n_subbands; subbnd++) {
698 int subbnd_size = (ecpl && subbnd < 4) ? 6 : 12;
699 if (band_struct[subbnd - 1]) {
700 n_bands--;
701 bnd_sz[bnd] += subbnd_size;
702 } else {
703 bnd_sz[++bnd] = subbnd_size;
704 }
705 }
706 }
707
708 /* set optional output params */
709 if (num_bands)
710 *num_bands = n_bands;
711 if (band_sizes)
712 memcpy(band_sizes, bnd_sz, n_bands);
713 }
714
715 /**
716 * Decode a single audio block from the AC-3 bitstream.
717 */
719 {
722 int i, bnd, seg, ch;
723 int different_transforms;
724 int downmix_output;
725 int cpl_in_use;
728
729 /* block switch flags */
730 different_transforms = 0;
732 for (ch = 1; ch <= fbw_channels; ch++) {
735 different_transforms = 1;
736 }
737 }
738
739 /* dithering flags */
741 for (ch = 1; ch <= fbw_channels; ch++) {
743 }
744 }
745
746 /* dynamic range */
748 do {
752 } else if (blk == 0) {
754 }
755 } while (i--);
756
757 /* spectral extension strategy */
761 int dst_start_freq, dst_end_freq, src_start_freq,
762 start_subband, end_subband;
763
764 /* determine which channels use spx */
767 } else {
768 for (ch = 1; ch <= fbw_channels; ch++)
770 }
771
772 /* get the frequency bins of the spx copy region and the spx start
773 and end subbands */
775 start_subband =
get_bits(gbc, 3) + 2;
776 if (start_subband > 7)
777 start_subband += start_subband - 7;
779 if (end_subband > 7)
780 end_subband += end_subband - 7;
781 dst_start_freq = dst_start_freq * 12 + 25;
782 src_start_freq = start_subband * 12 + 25;
783 dst_end_freq = end_subband * 12 + 25;
784
785 /* check validity of spx ranges */
786 if (start_subband >= end_subband) {
788 "range (%d >= %d)\n", start_subband, end_subband);
789 return -1;
790 }
791 if (dst_start_freq >= src_start_freq) {
793 "copy start bin (%d >= %d)\n", dst_start_freq, src_start_freq);
794 return -1;
795 }
796
800
802 start_subband, end_subband,
806 } else {
807 for (ch = 1; ch <= fbw_channels; ch++) {
810 }
811 }
812 }
813
814 /* spectral extension coordinates */
816 for (ch = 1; ch <= fbw_channels; ch++) {
819 float spx_blend;
820 int bin, master_spx_coord;
821
823 spx_blend =
get_bits(gbc, 5) * (1.0f/32);
824 master_spx_coord =
get_bits(gbc, 2) * 3;
825
828 int bandsize;
829 int spx_coord_exp, spx_coord_mant;
830 float nratio, sblend, nblend, spx_coord;
831
832 /* calculate blending factors */
834 nratio = ((float)((bin + (bandsize >> 1))) / s->
spx_dst_end_freq) - spx_blend;
835 nratio = av_clipf(nratio, 0.0f, 1.0f);
836 nblend = sqrtf(3.0f * nratio); // noise is scaled by sqrt(3)
837 // to give unity variance
838 sblend = sqrtf(1.0f - nratio);
839 bin += bandsize;
840
841 /* decode spx coordinates */
844 if (spx_coord_exp == 15) spx_coord_mant <<= 1;
845 else spx_coord_mant += 4;
846 spx_coord_mant <<= (25 - spx_coord_exp - master_spx_coord);
847 spx_coord = spx_coord_mant * (1.0f / (1 << 23));
848
849 /* multiply noise and signal blending factors by spx coordinate */
852 }
853 }
854 } else {
856 }
857 }
858 }
859
860 /* coupling strategy */
866 /* coupling in use */
867 int cpl_start_subband, cpl_end_subband;
868
871 return -1;
872 }
873
874 /* check for enhanced coupling */
876 /* TODO: parse enhanced coupling strategy info */
879 }
880
881 /* determine which channels are coupled */
885 } else {
886 for (ch = 1; ch <= fbw_channels; ch++)
888 }
889
890 /* phase flags in use */
893
894 /* coupling frequency range */
895 cpl_start_subband =
get_bits(gbc, 4);
898 if (cpl_start_subband >= cpl_end_subband) {
900 cpl_start_subband, cpl_end_subband);
901 return -1;
902 }
905
907 cpl_end_subband,
910 } else {
911 /* coupling not in use */
912 for (ch = 1; ch <= fbw_channels; ch++) {
915 }
918 }
919 }
else if (!s->
eac3) {
920 if (!blk) {
922 "be present in block 0\n");
923 return -1;
924 } else {
926 }
927 }
929
930 /* coupling coordinates */
931 if (cpl_in_use) {
932 int cpl_coords_exist = 0;
933
934 for (ch = 1; ch <= fbw_channels; ch++) {
937 int master_cpl_coord, cpl_coord_exp, cpl_coord_mant;
939 cpl_coords_exist = 1;
940 master_cpl_coord = 3 *
get_bits(gbc, 2);
944 if (cpl_coord_exp == 15)
945 s->
cpl_coords[ch][bnd] = cpl_coord_mant << 22;
946 else
947 s->
cpl_coords[ch][bnd] = (cpl_coord_mant + 16) << 21;
948 s->
cpl_coords[ch][bnd] >>= (cpl_coord_exp + master_cpl_coord);
949 }
950 } else if (!blk) {
952 "be present in block 0\n");
953 return -1;
954 }
955 } else {
956 /* channel not in coupling */
958 }
959 }
960 /* phase flags */
964 }
965 }
966 }
967
968 /* stereo rematrixing strategy and band structure */
976 }
979 } else if (!blk) {
981 "new rematrixing strategy not present in block 0\n");
983 }
984 }
985
986 /* exponent strategies for each channel */
987 for (ch = !cpl_in_use; ch <= s->
channels; ch++) {
991 bit_alloc_stages[ch] = 3;
992 }
993
994 /* channel bandwidth */
995 for (ch = 1; ch <= fbw_channels; ch++) {
998 int group_size;
1004 else {
1005 int bandwidth_code =
get_bits(gbc, 6);
1006 if (bandwidth_code > 60) {
1008 return -1;
1009 }
1010 s->
end_freq[ch] = bandwidth_code * 3 + 73;
1011 }
1014 if (blk > 0 && s->
end_freq[ch] != prev)
1016 }
1017 }
1021 }
1022
1023 /* decode exponents for each channel */
1024 for (ch = !cpl_in_use; ch <= s->
channels; ch++) {
1031 return -1;
1032 }
1035 }
1036 }
1037
1038 /* bit allocation information */
1046 for (ch = !cpl_in_use; ch <= s->
channels; ch++)
1047 bit_alloc_stages[ch] =
FFMAX(bit_alloc_stages[ch], 2);
1048 } else if (!blk) {
1050 "be present in block 0\n");
1051 return -1;
1052 }
1053 }
1054
1055 /* signal-to-noise ratio offsets and fast gains (signal-to-mask ratios) */
1056 if (!s->
eac3 || !blk) {
1058 int snr = 0;
1059 int csnr;
1060 csnr = (
get_bits(gbc, 6) - 15) << 4;
1061 for (i = ch = !cpl_in_use; ch <= s->
channels; ch++) {
1062 /* snr offset */
1064 snr = (csnr +
get_bits(gbc, 4)) << 2;
1065 /* run at least last bit allocation stage if snr offset changes */
1067 bit_alloc_stages[ch] =
FFMAX(bit_alloc_stages[ch], 1);
1068 }
1070
1071 /* fast gain (normal AC-3 only) */
1075 /* run last 2 bit allocation stages if fast gain changes */
1077 bit_alloc_stages[ch] =
FFMAX(bit_alloc_stages[ch], 2);
1078 }
1079 }
1080 }
else if (!s->
eac3 && !blk) {
1082 return -1;
1083 }
1084 }
1085
1086 /* fast gain (E-AC-3 only) */
1088 for (ch = !cpl_in_use; ch <= s->
channels; ch++) {
1091 /* run last 2 bit allocation stages if fast gain changes */
1093 bit_alloc_stages[ch] =
FFMAX(bit_alloc_stages[ch], 2);
1094 }
1095 }
else if (s->
eac3 && !blk) {
1096 for (ch = !cpl_in_use; ch <= s->
channels; ch++)
1098 }
1099
1100 /* E-AC-3 to AC-3 converter SNR offset */
1102 skip_bits(gbc, 10);
// skip converter snr offset
1103 }
1104
1105 /* coupling leak information */
1106 if (cpl_in_use) {
1110 /* run last 2 bit allocation stages for coupling channel if
1111 coupling leak changes */
1115 }
1118 }
else if (!s->
eac3 && !blk) {
1120 "be present in block 0\n");
1121 return -1;
1122 }
1124 }
1125
1126 /* delta bit allocation information */
1128 /* delta bit allocation exists (strategy) */
1129 for (ch = !cpl_in_use; ch <= fbw_channels; ch++) {
1133 return -1;
1134 }
1135 bit_alloc_stages[ch] =
FFMAX(bit_alloc_stages[ch], 2);
1136 }
1137 /* channel delta offset, len and bit allocation */
1138 for (ch = !cpl_in_use; ch <= fbw_channels; ch++) {
1141 for (seg = 0; seg < s->
dba_nsegs[ch]; seg++) {
1145 }
1146 /* run last 2 bit allocation stages if new dba values */
1147 bit_alloc_stages[ch] =
FFMAX(bit_alloc_stages[ch], 2);
1148 }
1149 }
1150 } else if (blk == 0) {
1151 for (ch = 0; ch <= s->
channels; ch++) {
1153 }
1154 }
1155
1156 /* Bit allocation */
1157 for (ch = !cpl_in_use; ch <= s->
channels; ch++) {
1158 if (bit_alloc_stages[ch] > 2) {
1159 /* Exponent mapping into PSD and PSD integration */
1163 }
1164 if (bit_alloc_stages[ch] > 1) {
1165 /* Compute excitation function, Compute masking curve, and
1166 Apply delta bit allocation */
1174 return -1;
1175 }
1176 }
1177 if (bit_alloc_stages[ch] > 0) {
1178 /* Compute bit allocation */
1185 bap_tab, s->
bap[ch]);
1186 }
1187 }
1188
1189 /* unused dummy data */
1192 while (skipl--)
1194 }
1195
1196 /* unpack the transform coefficients
1197 this also uncouples channels if coupling is in use. */
1199
1200 /* TODO: generate enhanced coupling coordinates and uncouple */
1201
1202 /* recover coefficients if rematrixing is in use */
1205
1206 /* apply scaling to coefficients (headroom, dynrng) */
1207 for (ch = 1; ch <= s->
channels; ch++) {
1208 float gain = 1.0 / 4194304.0f;
1211 } else {
1213 }
1216 }
1217
1218 /* apply spectral extension to high frequency bins */
1221 }
1222
1223 /* downmix and MDCT. order depends on whether block switching is used for
1224 any channel in this block. this is because coefficients for the long
1225 and short transforms cannot be mixed. */
1229 if (different_transforms) {
1230 /* the delay samples have already been downmixed, so we upmix the delay
1231 samples in order to reconstruct all channels before downmixing. */
1235 }
1236
1238
1239 if (downmix_output) {
1242 }
1243 } else {
1244 if (downmix_output) {
1247 }
1248
1253 }
1254
1256 }
1257
1258 return 0;
1259 }
1260
1261 /**
1262 * Decode a single AC-3 frame.
1263 */
1265 int *got_frame_ptr,
AVPacket *avpkt)
1266 {
1269 int buf_size = avpkt->
size;
1274
1275 /* copy input buffer to decoder context to avoid reading past the end
1276 of the buffer, which can be caused by a damaged input stream. */
1277 if (buf_size >= 2 &&
AV_RB16(buf) == 0x770B) {
1278 // seems to be byte-swapped AC-3
1281 } else
1284 /* initialize the GetBitContext with the start of valid AC-3 Frame */
1286
1287 /* parse the syncinfo */
1289
1290 if (err) {
1291 switch (err) {
1294 return -1;
1297 break;
1300 break;
1303 break;
1305 /* skip frame if CRC is ok. otherwise use error concealment. */
1306 /* TODO: add support for substreams and dependent frames */
1309 "skipping frame\n");
1310 *got_frame_ptr = 0;
1312 } else {
1314 }
1315 break;
1316 default:
1318 break;
1319 }
1320 } else {
1321 /* check that reported frame size fits in input buffer */
1326 /* check for crc mismatch */
1331 }
1332 }
1333 }
1334
1335 /* if frame is ok, set audio parameters */
1336 if (!err) {
1339 }
1340
1341 /* channel config */
1347 if (avctx->request_channels > 0 && avctx->request_channels <= 2 &&
1348 avctx->request_channels < s->
channels) {
1352 }
1355
1360 /* set downmixing coefficients if needed */
1364 }
1368 }
1370
1371 /* set audio service type based on bitstream mode for AC-3 */
1375
1376 /* get output buffer */
1380
1381 /* decode the audio blocks */
1384 output[ch] = s->
output[ch];
1386 }
1387 for (ch = 0; ch < s->
channels; ch++) {
1388 if (ch < s->out_channels)
1389 s->
outptr[channel_map[ch]] = (
float *)frame->
data[ch];
1390 }
1394 err = 1;
1395 }
1396 if (err)
1400 output[ch] = s->
outptr[channel_map[ch]];
1402 if (!ch || channel_map[ch])
1404 }
1405 }
1406
1408
1409 /* keep last block for error concealment in next frame */
1411 memcpy(s->
output[ch], output[ch], 1024);
1412
1413 *got_frame_ptr = 1;
1414
1416 }
1417
1418 /**
1419 * Uninitialize the AC-3 decoder.
1420 */
1422 {
1426
1427 return 0;
1428 }
1429
1430 #define OFFSET(x) offsetof(AC3DecodeContext, x)
1431 #define PAR (AV_OPT_FLAG_DECODING_PARAM | AV_OPT_FLAG_AUDIO_PARAM)
1433 {
"drc_scale",
"percentage of dynamic range compression to apply",
OFFSET(drc_scale),
AV_OPT_TYPE_FLOAT, {.dbl = 1.0}, 0.0, 1.0,
PAR },
1434
1435 {
"dmix_mode",
"Preferred Stereo Downmix Mode",
OFFSET(preferred_stereo_downmix),
AV_OPT_TYPE_INT, {.i64 = -1 }, -1, 2, 0,
"dmix_mode"},
1436 {
"ltrt_cmixlev",
"Lt/Rt Center Mix Level",
OFFSET(ltrt_center_mix_level),
AV_OPT_TYPE_FLOAT, {.dbl = -1.0 }, -1.0, 2.0, 0},
1437 {
"ltrt_surmixlev",
"Lt/Rt Surround Mix Level",
OFFSET(ltrt_surround_mix_level),
AV_OPT_TYPE_FLOAT, {.dbl = -1.0 }, -1.0, 2.0, 0},
1438 {
"loro_cmixlev",
"Lo/Ro Center Mix Level",
OFFSET(loro_center_mix_level),
AV_OPT_TYPE_FLOAT, {.dbl = -1.0 }, -1.0, 2.0, 0},
1439 {
"loro_surmixlev",
"Lo/Ro Surround Mix Level",
OFFSET(loro_surround_mix_level),
AV_OPT_TYPE_FLOAT, {.dbl = -1.0 }, -1.0, 2.0, 0},
1440
1441 { NULL},
1442 };
1443
1449 };
1450
1464 };
1465
1466 #if CONFIG_EAC3_DECODER
1467 static const AVClass eac3_decoder_class = {
1472 };
1473
1486 .priv_class = &eac3_decoder_class,
1487 };
1488 #endif