Libav
dca.h
Go to the documentation of this file.
1 /*
2  * DCA compatible decoder
3  * Copyright (C) 2004 Gildas Bazin
4  * Copyright (C) 2004 Benjamin Zores
5  * Copyright (C) 2006 Benjamin Larsson
6  * Copyright (C) 2007 Konstantin Shishkov
7  *
8  * This file is part of Libav.
9  *
10  * Libav is free software; you can redistribute it and/or
11  * modify it under the terms of the GNU Lesser General Public
12  * License as published by the Free Software Foundation; either
13  * version 2.1 of the License, or (at your option) any later version.
14  *
15  * Libav is distributed in the hope that it will be useful,
16  * but WITHOUT ANY WARRANTY; without even the implied warranty of
17  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
18  * Lesser General Public License for more details.
19  *
20  * You should have received a copy of the GNU Lesser General Public
21  * License along with Libav; if not, write to the Free Software
22  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
23  */
24 
25 #ifndef AVCODEC_DCA_H
26 #define AVCODEC_DCA_H
27 
28 #include <stdint.h>
29 
30 #include "libavutil/float_dsp.h"
31 #include "libavutil/internal.h"
32 
33 #include "avcodec.h"
34 #include "dcadsp.h"
35 #include "fmtconvert.h"
36 #include "get_bits.h"
37 
38 #define DCA_PRIM_CHANNELS_MAX (7)
39 #define DCA_ABITS_MAX (32) /* Should be 28 */
40 #define DCA_SUBSUBFRAMES_MAX (4)
41 #define DCA_SUBFRAMES_MAX (16)
42 #define DCA_BLOCKS_MAX (16)
43 #define DCA_LFE_MAX (3)
44 
45 #define DCA_PRIM_CHANNELS_MAX (7)
46 #define DCA_ABITS_MAX (32) /* Should be 28 */
47 #define DCA_SUBSUBFRAMES_MAX (4)
48 #define DCA_SUBFRAMES_MAX (16)
49 #define DCA_BLOCKS_MAX (16)
50 #define DCA_LFE_MAX (3)
51 #define DCA_XLL_FBANDS_MAX (4)
52 #define DCA_XLL_SEGMENTS_MAX (16)
53 #define DCA_XLL_CHSETS_MAX (16)
54 #define DCA_XLL_CHANNELS_MAX (16)
55 #define DCA_XLL_AORDER_MAX (15)
56 
57 /* Arbitrary limit; not sure what the maximum really is, but much larger. */
58 #define DCA_XLL_DMIX_NCOEFFS_MAX (18)
59 
60 #define DCA_MAX_FRAME_SIZE 16384
61 #define DCA_MAX_EXSS_HEADER_SIZE 4096
62 
63 #define DCA_BUFFER_PADDING_SIZE 1024
64 
66  DCA_EXT_CORE = 0x001,
67  DCA_EXT_XXCH = 0x002,
68  DCA_EXT_X96 = 0x004,
69  DCA_EXT_XCH = 0x008,
71  DCA_EXT_EXSS_XBR = 0x020,
73  DCA_EXT_EXSS_X96 = 0x080,
74  DCA_EXT_EXSS_LBR = 0x100,
75  DCA_EXT_EXSS_XLL = 0x200,
76 };
77 
78 typedef struct XllChSetSubHeader {
79  int channels;
82  int bit_width;
91  int hier_chset;
95  int ch_mask;
98 
99  /* m_nOrigChanOrder */
102  /* Coefficients for channel pairs (at most 8), m_anPWChPairsCoeffs */
104  /* m_nCurrHighestLPCOrder */
106  /* m_pnAdaptPredOrder */
108  /* m_pnFixedPredOrder */
110  /* m_pnLPCReflCoeffsQInd, unsigned version */
113 
118 
119 typedef struct XllNavi {
120  GetBitContext gb; // Context for parsing the data segments
121  unsigned band_size[DCA_XLL_FBANDS_MAX];
122  unsigned segment_size[DCA_XLL_FBANDS_MAX][DCA_XLL_SEGMENTS_MAX];
124 } XllNavi;
125 
126 typedef struct QMF64_table {
127  float dct4_coeff[32][32];
128  float dct2_coeff[32][32];
129  float rcos[32];
130  float rsin[32];
131 } QMF64_table;
132 
133 /* Primary audio coding header */
134 typedef struct DCAAudioHeader {
135  int subband_activity[DCA_PRIM_CHANNELS_MAX];
136  int vq_start_subband[DCA_PRIM_CHANNELS_MAX];
137  int joint_intensity[DCA_PRIM_CHANNELS_MAX];
138  int transient_huffman[DCA_PRIM_CHANNELS_MAX];
139  int scalefactor_huffman[DCA_PRIM_CHANNELS_MAX];
140  int bitalloc_huffman[DCA_PRIM_CHANNELS_MAX];
141  int quant_index_huffman[DCA_PRIM_CHANNELS_MAX][DCA_ABITS_MAX];
142  uint32_t scalefactor_adj[DCA_PRIM_CHANNELS_MAX][DCA_ABITS_MAX];
143 
144  int subframes;
148 
149 typedef struct DCAChan {
151 
152  /* Subband samples history (for ADPCM) */
153  DECLARE_ALIGNED(32, int32_t, subband_samples_hist)[DCA_SUBBANDS][4];
155 
156  /* Half size is sufficient for core decoding, but for 96 kHz data
157  * we need QMF with 64 subbands and 1024 samples. */
158  DECLARE_ALIGNED(32, float, subband_fir_hist)[1024];
159  DECLARE_ALIGNED(32, float, subband_fir_noidea)[64];
160 
161  /* Primary audio coding side information */
162  int prediction_mode[DCA_SUBBANDS];
163  int prediction_vq[DCA_SUBBANDS];
164  int bitalloc[DCA_SUBBANDS];
165  int transition_mode[DCA_SUBBANDS];
166  int32_t scale_factor[DCA_SUBBANDS][2];
168  int joint_scale_factor[DCA_SUBBANDS];
169 
170  int32_t high_freq_vq[DCA_SUBBANDS];
171 } DCAChan;
172 
173 
174 typedef struct DCAContext {
175  AVClass *class;
177  /* Frame header */
183  int amode;
185  int bit_rate;
187 
188  int dynrange;
189  int timestamp;
190  int aux_data;
191  int hdcd;
192  int ext_descr;
194  int aspf;
195  int lfe;
199  int version;
202  int front_sum;
205 
206  /* Primary audio coding header */
208 
209  /* Primary audio coding side information */
210  int subsubframes[DCA_SUBFRAMES_MAX];
211  int partial_samples[DCA_SUBFRAMES_MAX];
212  float downmix_coef[DCA_PRIM_CHANNELS_MAX + 1][2];
214 
215  /* Core substream's embedded downmix coefficients (cf. ETSI TS 102 114 V1.4.1)
216  * Input: primary audio channels (incl. LFE if present)
217  * Output: downmix audio channels (up to 4, no LFE) */
220  uint16_t core_downmix_codes[DCA_PRIM_CHANNELS_MAX + 1][4];
221 
222 
223  float lfe_data[2 * DCA_LFE_MAX * (DCA_BLOCKS_MAX + 4)];
225 
226  /* Subband samples history (for ADPCM) */
227  DECLARE_ALIGNED(32, float, raXin)[32];
228 
230 
231  int output;
232 
233  float *samples_chanptr[DCA_PRIM_CHANNELS_MAX + 1];
234  float *extra_channels[DCA_PRIM_CHANNELS_MAX + 1];
237 
240 
241  const int8_t *channel_order_tab;
243  /* Current position in DCA frame */
246 
249 
250  /* XCh extension information */
254 
255  /* XLL extension information */
271  unsigned int xll_sample_buf_size;
272 
273  /* ExSS header parser */
277  int mix_config_num_ch[4];
278 
279  int profile;
281 
289 } DCAContext;
290 
291 extern av_export const uint32_t avpriv_dca_sample_rates[16];
292 
296 int ff_dca_convert_bitstream(const uint8_t *src, int src_size, uint8_t *dst,
297  int max_size);
298 
300 
302 int ff_dca_xll_decode_navi(DCAContext *s, int asset_end);
304 
305 #endif /* AVCODEC_DCA_H */
uint8_t adapt_order[DCA_XLL_FBANDS_MAX][DCA_XLL_CHANNELS_MAX]
Definition: dca.h:107
uint8_t adapt_order_max[DCA_XLL_FBANDS_MAX]
Definition: dca.h:105
int ext_descr
extension audio descriptor flag
Definition: dca.h:192
int samp_freq_interp
sampling frequency interpolation multiplier
Definition: dca.h:84
int downmix_coeff_code_embedded
Definition: dca.h:88
int ff_dca_xll_decode_header(DCAContext *s)
Definition: dca_xll.c:77
int crc_present
crc is present in the bitstream
Definition: dca.h:180
This structure describes decoded (raw) audio or video data.
Definition: frame.h:140
int one2one_map_chtospkr
Definition: dca.h:280
int timestamp
embedded time stamp flag
Definition: dca.h:189
int amode
audio channels arrangement
Definition: dca.h:183
lossless extension in ExSS
Definition: dca.h:75
int hier_chset
hierarchical channel set
Definition: dca.h:91
FmtConvertContext fmt_conv
Definition: dca.h:288
int xll_fixed_lsb_width
Definition: dca.h:267
int total_channels
number of channels including extensions
Definition: dca.h:145
int prim_channels
number of primary audio channels
Definition: dca.h:146
int samples_deficit
deficit sample count
Definition: dca.h:179
#define DECLARE_ALIGNED(n, t, v)
Definition: mem.h:58
uint8_t core_downmix
embedded downmix coefficients available
Definition: dca.h:218
#define DCA_MAX_FRAME_SIZE
Definition: dca.h:60
int dynrange
embedded dynamic range flag
Definition: dca.h:188
int8_t bit_width_adj_per_ch[DCA_XLL_FBANDS_MAX][DCA_XLL_CHANNELS_MAX]
Definition: dca.h:116
int version
encoder software revision
Definition: dca.h:199
int ch_mask
Definition: dca.h:95
int xll_bits4ch_mask
channel position mask
Definition: dca.h:266
int primary_ch_set
Definition: dca.h:87
int ch_mask_enabled
Definition: dca.h:94
SynthFilterContext synth
Definition: dca.h:285
int mapping_coeffs_present
Definition: dca.h:96
#define DCA_XLL_DMIX_NCOEFFS_MAX
Definition: dca.h:58
int xll_channels
total number of channels (in all channel sets)
Definition: dca.h:258
#define DCA_MAX_EXSS_HEADER_SIZE
Definition: dca.h:61
int xll_nch_sets
number of channel sets per frame
Definition: dca.h:257
uint8_t
#define DCA_BLOCKS_MAX
Definition: dca.h:49
XllNavi xll_navi
Definition: dca.h:269
int xch_base_channel
index of first (only) channel containing XCH data
Definition: dca.h:252
#define DCA_ABITS_MAX
Definition: dca.h:46
int xll_residual_channels
number of residual channels
Definition: dca.h:259
unsigned int xll_sample_buf_size
Definition: dca.h:271
int dca_buffer_size
how much data is in the dca_buffer
Definition: dca.h:239
96/24 extension in core substream
Definition: dca.h:68
int header_crc
header crc check bytes
Definition: dca.h:197
int8_t pw_ch_pairs_coeffs[DCA_XLL_FBANDS_MAX][DCA_XLL_CHANNELS_MAX/2]
Definition: dca.h:103
int sample_rate
audio sampling rate
Definition: dca.h:184
bitstream reader API header.
AVCodecContext * avctx
Definition: dca.h:176
int lfe
low frequency effects flag
Definition: dca.h:195
uint8_t orig_chan_order[DCA_XLL_FBANDS_MAX][DCA_XLL_CHANNELS_MAX]
Definition: dca.h:100
int xll_disable
Definition: dca.h:256
int predictor_history
predictor history flag
Definition: dca.h:196
#define src
Definition: vp8dsp.c:254
int dynrange_coef
dynamic range coefficient
Definition: dca.h:213
uint8_t orig_chan_order_inv[DCA_XLL_FBANDS_MAX][DCA_XLL_CHANNELS_MAX]
Definition: dca.h:101
#define DCA_XLL_CHANNELS_MAX
Definition: dca.h:54
FFTContext imdct
Definition: dca.h:284
int downmix_embedded
Definition: dca.h:89
int current_subsubframe
Definition: dca.h:245
int hdcd
source material is mastered in HDCD
Definition: dca.h:191
int xll_log_smpl_in_seg
supposedly this is "nBits4SamplLoci"
Definition: dca.h:261
#define DCA_XLL_FBANDS_MAX
Definition: dca.h:51
int mix_metadata
mixing metadata present
Definition: dca.h:275
#define DCA_XLL_CHSETS_MAX
Definition: dca.h:53
int channels
number of channels in channel set, at most 16
Definition: dca.h:79
int downmix_type
Definition: dca.h:90
core in ExSS (extension substream)
Definition: dca.h:70
int8_t scalable_lsbs[DCA_XLL_FBANDS_MAX][DCA_XLL_CHANNELS_MAX]
Definition: dca.h:115
int debug_flag
used for suppressing repeated error messages output
Definition: dca.h:282
#define DCA_BUFFER_PADDING_SIZE
Definition: dca.h:63
#define DCA_XLL_SEGMENTS_MAX
Definition: dca.h:52
int replacement_set
replacement channel set group
Definition: dca.h:85
const int8_t * channel_order_tab
channel reordering table, lfe and non lfe
Definition: dca.h:241
common internal API header
int front_sum
front sum/difference flag
Definition: dca.h:202
int xch_disable
whether the XCh extension should be decoded or not
Definition: dca.h:253
int source_pcm_res
source pcm resolution
Definition: dca.h:201
low bitrate component in ExSS
Definition: dca.h:74
int * xll_sample_buf
Definition: dca.h:270
Definition: fft.h:73
int subframes
number of subframes
Definition: dca.h:144
XXCh channels extension in ExSS.
Definition: dca.h:72
#define DCA_LFE_MAX
Definition: dca.h:50
av_export const uint32_t avpriv_dca_sample_rates[16]
Definition: dca.c:30
96/24 extension in ExSS
Definition: dca.h:73
int surround_sum
surround sum/difference flag
Definition: dca.h:203
int32_t
int ff_dca_convert_bitstream(const uint8_t *src, int src_size, uint8_t *dst, int max_size)
Convert bitstream to one representation based on sync marker.
Definition: dca.c:35
int multirate_inter
multirate interpolator switch
Definition: dca.h:198
uint8_t core_downmix_amode
audio channel arrangement of embedded downmix
Definition: dca.h:219
int ff_dca_xll_decode_navi(DCAContext *s, int asset_end)
Definition: dca_xll.c:291
int joint_huff
joint subband scale factors codebook
Definition: dca.h:167
int bit_rate
transmission bit rate
Definition: dca.h:185
uint8_t fixed_order[DCA_XLL_FBANDS_MAX][DCA_XLL_CHANNELS_MAX]
Definition: dca.h:109
int xch_present
XCh extension present and valid.
Definition: dca.h:251
int core_ext_mask
present extensions in the core substream
Definition: dca.h:247
int ff_dca_xll_decode_audio(DCAContext *s, AVFrame *frame)
Definition: dca_xll.c:409
int lfe_scale_factor
Definition: dca.h:224
#define av_export
Definition: internal.h:62
Libavcodec external API header.
int aux_data
auxiliary data flag
Definition: dca.h:190
int ext_coding
extended coding flag
Definition: dca.h:193
main external API structure.
Definition: avcodec.h:1409
GetBitContext gb
Definition: dca.h:120
int copy_history
copy history
Definition: dca.h:200
int xll_bits4seg_size
number of bits used to read segment size
Definition: dca.h:263
Describe the class of an AVClass context structure.
Definition: log.h:34
int exss_ext_mask
Non-core extensions.
Definition: dca.h:248
core in core substream
Definition: dca.h:66
extended bitrate extension in ExSS
Definition: dca.h:71
int sampling_frequency
sampling frequency
Definition: dca.h:83
int sample_blocks
number of PCM sample blocks
Definition: dca.h:181
DCAAudioHeader audio_header
Definition: dca.h:207
int residual_encode
residual channel encoding
Definition: dca.h:80
#define DCA_SUBFRAMES_MAX
Definition: dca.h:48
int xll_segments
number of segments per frame
Definition: dca.h:260
GetBitContext gb
Definition: dca.h:242
int current_subframe
Definition: dca.h:244
int num_freq_bands
Definition: dca.h:97
int num_mix_configs
number of mix out configurations
Definition: dca.h:276
int xll_banddata_crc
presence of CRC16 within each frequency band
Definition: dca.h:264
DCADSPContext dcadsp
Definition: dca.h:286
int hist_index
Definition: dca.h:154
uint8_t * extra_channels_buffer
Definition: dca.h:235
DCAExtensionMask
Definition: dca.h:65
int dialog_norm
dialog normalisation parameter
Definition: dca.h:204
int xll_smpl_in_seg
samples in segment per one frequency band for the first channel set
Definition: dca.h:262
#define DCA_SUBBANDS
Definition: dcadsp.h:26
int bit_rate_index
transmission bit rate index
Definition: dca.h:186
void ff_dca_exss_parse_header(DCAContext *s)
Parse extension substream header (HD)
Definition: dca_exss.c:245
int xll_scalable_lsb
Definition: dca.h:265
AVFloatDSPContext fdsp
Definition: dca.h:283
QMF64_table * qmf64_table
Definition: dca.h:287
XCh channel extension in core substream.
Definition: dca.h:69
int frame_size
primary frame byte size
Definition: dca.h:182
Definition: dca.h:149
int aspf
audio sync word insertion flag
Definition: dca.h:194
int bit_width
original input sample bit-width
Definition: dca.h:82
int bit_resolution
input sample bit-width
Definition: dca.h:81
int downmix_ncoeffs
Definition: dca.h:92
Definition: dca.h:119
int output
type of output
Definition: dca.h:231
int active_replace_set
current channel set is active channel set
Definition: dca.h:86
#define DCA_XLL_AORDER_MAX
Definition: dca.h:55
uint8_t lpc_refl_coeffs_q_ind[DCA_XLL_FBANDS_MAX][DCA_XLL_CHANNELS_MAX][DCA_XLL_AORDER_MAX]
Definition: dca.h:112
int lsb_fsize[DCA_XLL_FBANDS_MAX]
Definition: dca.h:114
int downmix_coeffs[DCA_XLL_DMIX_NCOEFFS_MAX]
Definition: dca.h:93
#define SAMPLES_PER_SUBBAND
Definition: dcadsp.h:27
unsigned int extra_channels_buffer_size
Definition: dca.h:236
#define DCA_PRIM_CHANNELS_MAX
Definition: dca.h:45
int static_fields
static fields present
Definition: dca.h:274
int frame_type
type of the current frame
Definition: dca.h:178
XXCh channels extension in core substream.
Definition: dca.h:67
int profile
Definition: dca.h:279