Mercurial > libavcodec.hg
annotate ac3.h @ 6207:7346bcbb3d53 libavcodec
revert r11677, it is considered speed critical
author | bcoudurier |
---|---|
date | Thu, 31 Jan 2008 01:25:29 +0000 |
parents | 4f8fcb40bf2c |
children | 5542d0c04a55 |
rev | line source |
---|---|
782 | 1 /* |
2 * Common code between AC3 encoder and decoder | |
3 * Copyright (c) 2000, 2001, 2002 Fabrice Bellard. | |
4 * | |
3947
c8c591fe26f8
Change license headers to say 'FFmpeg' instead of 'this program/this library'
diego
parents:
3036
diff
changeset
|
5 * This file is part of FFmpeg. |
c8c591fe26f8
Change license headers to say 'FFmpeg' instead of 'this program/this library'
diego
parents:
3036
diff
changeset
|
6 * |
c8c591fe26f8
Change license headers to say 'FFmpeg' instead of 'this program/this library'
diego
parents:
3036
diff
changeset
|
7 * FFmpeg is free software; you can redistribute it and/or |
782 | 8 * modify it under the terms of the GNU Lesser General Public |
9 * License as published by the Free Software Foundation; either | |
3947
c8c591fe26f8
Change license headers to say 'FFmpeg' instead of 'this program/this library'
diego
parents:
3036
diff
changeset
|
10 * version 2.1 of the License, or (at your option) any later version. |
782 | 11 * |
3947
c8c591fe26f8
Change license headers to say 'FFmpeg' instead of 'this program/this library'
diego
parents:
3036
diff
changeset
|
12 * FFmpeg is distributed in the hope that it will be useful, |
782 | 13 * but WITHOUT ANY WARRANTY; without even the implied warranty of |
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | |
15 * Lesser General Public License for more details. | |
16 * | |
17 * You should have received a copy of the GNU Lesser General Public | |
3947
c8c591fe26f8
Change license headers to say 'FFmpeg' instead of 'this program/this library'
diego
parents:
3036
diff
changeset
|
18 * License along with FFmpeg; if not, write to the Free Software |
3036
0b546eab515d
Update licensing information: The FSF changed postal address.
diego
parents:
2967
diff
changeset
|
19 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA |
782 | 20 */ |
21 | |
1106 | 22 /** |
23 * @file ac3.h | |
24 * Common code between AC3 encoder and decoder. | |
25 */ | |
26 | |
5830
1d83e9c34641
Add FFMPEG_ prefix to all multiple inclusion guards.
diego
parents:
5331
diff
changeset
|
27 #ifndef FFMPEG_AC3_H |
1d83e9c34641
Add FFMPEG_ prefix to all multiple inclusion guards.
diego
parents:
5331
diff
changeset
|
28 #define FFMPEG_AC3_H |
4940 | 29 |
4879 | 30 #include "ac3tab.h" |
31 | |
782 | 32 #define AC3_MAX_CODED_FRAME_SIZE 3840 /* in bytes */ |
33 #define AC3_MAX_CHANNELS 6 /* including LFE channel */ | |
34 | |
35 #define NB_BLOCKS 6 /* number of PCM blocks inside an AC3 frame */ | |
36 #define AC3_FRAME_SIZE (NB_BLOCKS * 256) | |
37 | |
38 /* exponent encoding strategy */ | |
39 #define EXP_REUSE 0 | |
40 #define EXP_NEW 1 | |
41 | |
42 #define EXP_D15 1 | |
43 #define EXP_D25 2 | |
44 #define EXP_D45 3 | |
45 | |
5331 | 46 /** Delta bit allocation strategy */ |
47 typedef enum { | |
48 DBA_REUSE = 0, | |
49 DBA_NEW, | |
50 DBA_NONE, | |
51 DBA_RESERVED | |
52 } AC3DeltaStrategy; | |
53 | |
54 /** Channel mode (audio coding mode) */ | |
55 typedef enum { | |
6005 | 56 AC3_CHMODE_DUALMONO = 0, |
57 AC3_CHMODE_MONO, | |
58 AC3_CHMODE_STEREO, | |
59 AC3_CHMODE_3F, | |
60 AC3_CHMODE_2F1R, | |
61 AC3_CHMODE_3F1R, | |
62 AC3_CHMODE_2F2R, | |
63 AC3_CHMODE_3F2R | |
5331 | 64 } AC3ChannelMode; |
65 | |
782 | 66 typedef struct AC3BitAllocParameters { |
6003 | 67 int sr_code; |
68 int sr_shift; | |
69 int slow_gain, slow_decay, fast_decay, db_per_bit, floor; | |
70 int cpl_fast_leak, cpl_slow_leak; | |
782 | 71 } AC3BitAllocParameters; |
72 | |
4648 | 73 /** |
74 * @struct AC3HeaderInfo | |
75 * Coded AC-3 header values up to the lfeon element, plus derived values. | |
76 */ | |
77 typedef struct { | |
78 /** @defgroup coded Coded elements | |
79 * @{ | |
80 */ | |
81 uint16_t sync_word; | |
82 uint16_t crc1; | |
6003 | 83 uint8_t sr_code; |
6005 | 84 uint8_t bitstream_id; |
85 uint8_t channel_mode; | |
86 uint8_t lfe_on; | |
4648 | 87 /** @} */ |
88 | |
89 /** @defgroup derived Derived values | |
90 * @{ | |
91 */ | |
6003 | 92 uint8_t sr_shift; |
4648 | 93 uint16_t sample_rate; |
94 uint32_t bit_rate; | |
95 uint8_t channels; | |
96 uint16_t frame_size; | |
97 /** @} */ | |
98 } AC3HeaderInfo; | |
99 | |
782 | 100 |
4197 | 101 void ac3_common_init(void); |
4684
6ec0afffc572
split ac3_parametric_bit_allocation into 3 separate functions
jbr
parents:
4679
diff
changeset
|
102 |
6ec0afffc572
split ac3_parametric_bit_allocation into 3 separate functions
jbr
parents:
4679
diff
changeset
|
103 /** |
6ec0afffc572
split ac3_parametric_bit_allocation into 3 separate functions
jbr
parents:
4679
diff
changeset
|
104 * Calculates the log power-spectral density of the input signal. |
6ec0afffc572
split ac3_parametric_bit_allocation into 3 separate functions
jbr
parents:
4679
diff
changeset
|
105 * This gives a rough estimate of signal power in the frequency domain by using |
6ec0afffc572
split ac3_parametric_bit_allocation into 3 separate functions
jbr
parents:
4679
diff
changeset
|
106 * the spectral envelope (exponents). The psd is also separately grouped |
6ec0afffc572
split ac3_parametric_bit_allocation into 3 separate functions
jbr
parents:
4679
diff
changeset
|
107 * into critical bands for use in the calculating the masking curve. |
6ec0afffc572
split ac3_parametric_bit_allocation into 3 separate functions
jbr
parents:
4679
diff
changeset
|
108 * 128 units in psd = -6 dB. The dbknee parameter in AC3BitAllocParameters |
6ec0afffc572
split ac3_parametric_bit_allocation into 3 separate functions
jbr
parents:
4679
diff
changeset
|
109 * determines the reference level. |
6ec0afffc572
split ac3_parametric_bit_allocation into 3 separate functions
jbr
parents:
4679
diff
changeset
|
110 * |
6ec0afffc572
split ac3_parametric_bit_allocation into 3 separate functions
jbr
parents:
4679
diff
changeset
|
111 * @param[in] exp frequency coefficient exponents |
6ec0afffc572
split ac3_parametric_bit_allocation into 3 separate functions
jbr
parents:
4679
diff
changeset
|
112 * @param[in] start starting bin location |
6ec0afffc572
split ac3_parametric_bit_allocation into 3 separate functions
jbr
parents:
4679
diff
changeset
|
113 * @param[in] end ending bin location |
6ec0afffc572
split ac3_parametric_bit_allocation into 3 separate functions
jbr
parents:
4679
diff
changeset
|
114 * @param[out] psd signal power for each frequency bin |
6003 | 115 * @param[out] band_psd signal power for each critical band |
4684
6ec0afffc572
split ac3_parametric_bit_allocation into 3 separate functions
jbr
parents:
4679
diff
changeset
|
116 */ |
6ec0afffc572
split ac3_parametric_bit_allocation into 3 separate functions
jbr
parents:
4679
diff
changeset
|
117 void ff_ac3_bit_alloc_calc_psd(int8_t *exp, int start, int end, int16_t *psd, |
6003 | 118 int16_t *band_psd); |
4684
6ec0afffc572
split ac3_parametric_bit_allocation into 3 separate functions
jbr
parents:
4679
diff
changeset
|
119 |
6ec0afffc572
split ac3_parametric_bit_allocation into 3 separate functions
jbr
parents:
4679
diff
changeset
|
120 /** |
6ec0afffc572
split ac3_parametric_bit_allocation into 3 separate functions
jbr
parents:
4679
diff
changeset
|
121 * Calculates the masking curve. |
6ec0afffc572
split ac3_parametric_bit_allocation into 3 separate functions
jbr
parents:
4679
diff
changeset
|
122 * First, the excitation is calculated using parameters in \p s and the signal |
6ec0afffc572
split ac3_parametric_bit_allocation into 3 separate functions
jbr
parents:
4679
diff
changeset
|
123 * power in each critical band. The excitation is compared with a predefined |
6ec0afffc572
split ac3_parametric_bit_allocation into 3 separate functions
jbr
parents:
4679
diff
changeset
|
124 * hearing threshold table to produce the masking curve. If delta bit |
6ec0afffc572
split ac3_parametric_bit_allocation into 3 separate functions
jbr
parents:
4679
diff
changeset
|
125 * allocation information is provided, it is used for adjusting the masking |
6ec0afffc572
split ac3_parametric_bit_allocation into 3 separate functions
jbr
parents:
4679
diff
changeset
|
126 * curve, usually to give a closer match to a better psychoacoustic model. |
6ec0afffc572
split ac3_parametric_bit_allocation into 3 separate functions
jbr
parents:
4679
diff
changeset
|
127 * |
6004 | 128 * @param[in] s adjustable bit allocation parameters |
6003 | 129 * @param[in] band_psd signal power for each critical band |
6004 | 130 * @param[in] start starting bin location |
131 * @param[in] end ending bin location | |
132 * @param[in] fast_gain fast gain (estimated signal-to-mask ratio) | |
133 * @param[in] is_lfe whether or not the channel being processed is the LFE | |
6003 | 134 * @param[in] dba_mode delta bit allocation mode (none, reuse, or new) |
135 * @param[in] dba_nsegs number of delta segments | |
136 * @param[in] dba_offsets location offsets for each segment | |
137 * @param[in] dba_lengths length of each segment | |
138 * @param[in] dba_values delta bit allocation for each segment | |
6004 | 139 * @param[out] mask calculated masking curve |
4684
6ec0afffc572
split ac3_parametric_bit_allocation into 3 separate functions
jbr
parents:
4679
diff
changeset
|
140 */ |
6003 | 141 void ff_ac3_bit_alloc_calc_mask(AC3BitAllocParameters *s, int16_t *band_psd, |
142 int start, int end, int fast_gain, int is_lfe, | |
143 int dba_mode, int dba_nsegs, uint8_t *dba_offsets, | |
144 uint8_t *dba_lengths, uint8_t *dba_values, | |
4684
6ec0afffc572
split ac3_parametric_bit_allocation into 3 separate functions
jbr
parents:
4679
diff
changeset
|
145 int16_t *mask); |
6ec0afffc572
split ac3_parametric_bit_allocation into 3 separate functions
jbr
parents:
4679
diff
changeset
|
146 |
6ec0afffc572
split ac3_parametric_bit_allocation into 3 separate functions
jbr
parents:
4679
diff
changeset
|
147 /** |
6ec0afffc572
split ac3_parametric_bit_allocation into 3 separate functions
jbr
parents:
4679
diff
changeset
|
148 * Calculates bit allocation pointers. |
6ec0afffc572
split ac3_parametric_bit_allocation into 3 separate functions
jbr
parents:
4679
diff
changeset
|
149 * The SNR is the difference between the masking curve and the signal. AC-3 |
6ec0afffc572
split ac3_parametric_bit_allocation into 3 separate functions
jbr
parents:
4679
diff
changeset
|
150 * uses this value for each frequency bin to allocate bits. The \p snroffset |
6ec0afffc572
split ac3_parametric_bit_allocation into 3 separate functions
jbr
parents:
4679
diff
changeset
|
151 * parameter is a global adjustment to the SNR for all bins. |
6ec0afffc572
split ac3_parametric_bit_allocation into 3 separate functions
jbr
parents:
4679
diff
changeset
|
152 * |
6ec0afffc572
split ac3_parametric_bit_allocation into 3 separate functions
jbr
parents:
4679
diff
changeset
|
153 * @param[in] mask masking curve |
6ec0afffc572
split ac3_parametric_bit_allocation into 3 separate functions
jbr
parents:
4679
diff
changeset
|
154 * @param[in] psd signal power for each frequency bin |
6ec0afffc572
split ac3_parametric_bit_allocation into 3 separate functions
jbr
parents:
4679
diff
changeset
|
155 * @param[in] start starting bin location |
6ec0afffc572
split ac3_parametric_bit_allocation into 3 separate functions
jbr
parents:
4679
diff
changeset
|
156 * @param[in] end ending bin location |
6003 | 157 * @param[in] snr_offset SNR adjustment |
4684
6ec0afffc572
split ac3_parametric_bit_allocation into 3 separate functions
jbr
parents:
4679
diff
changeset
|
158 * @param[in] floor noise floor |
6ec0afffc572
split ac3_parametric_bit_allocation into 3 separate functions
jbr
parents:
4679
diff
changeset
|
159 * @param[out] bap bit allocation pointers |
6ec0afffc572
split ac3_parametric_bit_allocation into 3 separate functions
jbr
parents:
4679
diff
changeset
|
160 */ |
6ec0afffc572
split ac3_parametric_bit_allocation into 3 separate functions
jbr
parents:
4679
diff
changeset
|
161 void ff_ac3_bit_alloc_calc_bap(int16_t *mask, int16_t *psd, int start, int end, |
6003 | 162 int snr_offset, int floor, uint8_t *bap); |
4684
6ec0afffc572
split ac3_parametric_bit_allocation into 3 separate functions
jbr
parents:
4679
diff
changeset
|
163 |
4197 | 164 void ac3_parametric_bit_allocation(AC3BitAllocParameters *s, uint8_t *bap, |
165 int8_t *exp, int start, int end, | |
6003 | 166 int snr_offset, int fast_gain, int is_lfe, |
167 int dba_mode, int dba_nsegs, | |
168 uint8_t *dba_offsets, uint8_t *dba_lengths, | |
169 uint8_t *dba_values); | |
4940 | 170 |
5830
1d83e9c34641
Add FFMPEG_ prefix to all multiple inclusion guards.
diego
parents:
5331
diff
changeset
|
171 #endif /* FFMPEG_AC3_H */ |