FFmpeg
mlpdec.c
Go to the documentation of this file.
1 /*
2  * MLP decoder
3  * Copyright (c) 2007-2008 Ian Caulfield
4  *
5  * This file is part of FFmpeg.
6  *
7  * FFmpeg is free software; you can redistribute it and/or
8  * modify it under the terms of the GNU Lesser General Public
9  * License as published by the Free Software Foundation; either
10  * version 2.1 of the License, or (at your option) any later version.
11  *
12  * FFmpeg is distributed in the hope that it will be useful,
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
18  * License along with FFmpeg; if not, write to the Free Software
19  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
20  */
21 
22 /**
23  * @file
24  * MLP decoder
25  */
26 
27 #include <stdint.h>
28 
29 #include "avcodec.h"
30 #include "libavutil/internal.h"
31 #include "libavutil/intreadwrite.h"
33 #include "libavutil/mem_internal.h"
34 #include "libavutil/thread.h"
35 #include "get_bits.h"
36 #include "internal.h"
37 #include "libavutil/crc.h"
38 #include "parser.h"
39 #include "mlp_parse.h"
40 #include "mlpdsp.h"
41 #include "mlp.h"
42 #include "config.h"
43 
44 /** number of bits used for VLC lookup - longest Huffman code is 9 */
45 #if ARCH_ARM
46 #define VLC_BITS 5
47 #define VLC_STATIC_SIZE 64
48 #else
49 #define VLC_BITS 9
50 #define VLC_STATIC_SIZE 512
51 #endif
52 
53 typedef struct SubStream {
54  /// Set if a valid restart header has been read. Otherwise the substream cannot be decoded.
55  uint8_t restart_seen;
56  /// Set if end of stream is encountered
57  uint8_t end_of_stream;
58 
59  //@{
60  /** restart header data */
61  /// The type of noise to be used in the rematrix stage.
62  uint16_t noise_type;
63 
64  /// The index of the first channel coded in this substream.
65  uint8_t min_channel;
66  /// The index of the last channel coded in this substream.
67  uint8_t max_channel;
68  /// The number of channels input into the rematrix stage.
70  /// For each channel output by the matrix, the output channel to map it to
72  /// The channel layout for this substream
73  uint64_t mask;
74  /// The matrix encoding mode for this substream
77 
78  /// Channel coding parameters for channels in the substream
80 
81  /// The left shift applied to random noise in 0x31ea substreams.
82  uint8_t noise_shift;
83  /// The current seed value for the pseudorandom noise generator(s).
84  uint32_t noisegen_seed;
85 
86  /// Set if the substream contains extra info to check the size of VLC blocks.
88 
89  /// Bitmask of which parameter sets are conveyed in a decoding parameter block.
91 #define PARAM_BLOCKSIZE (1 << 7)
92 #define PARAM_MATRIX (1 << 6)
93 #define PARAM_OUTSHIFT (1 << 5)
94 #define PARAM_QUANTSTEP (1 << 4)
95 #define PARAM_FIR (1 << 3)
96 #define PARAM_IIR (1 << 2)
97 #define PARAM_HUFFOFFSET (1 << 1)
98 #define PARAM_PRESENCE (1 << 0)
99  //@}
100 
101  //@{
102  /** matrix data */
103 
104  /// Number of matrices to be applied.
106 
107  /// matrix output channel
109 
110  /// Whether the LSBs of the matrix output are encoded in the bitstream.
112  /// Matrix coefficients, stored as 2.14 fixed point.
114  /// Left shift to apply to noise values in 0x31eb substreams.
116  //@}
117 
118  /// Left shift to apply to Huffman-decoded residuals.
120 
121  /// number of PCM samples in current audio block
122  uint16_t blocksize;
123  /// Number of PCM samples decoded so far in this frame.
124  uint16_t blockpos;
125 
126  /// Left shift to apply to decoded PCM values to get final 24-bit output.
128 
129  /// Running XOR of all output samples.
131 
132 } SubStream;
133 
134 typedef struct MLPDecodeContext {
136 
137  /// Current access unit being read has a major sync.
139 
140  /// Size of the major sync unit, in bytes
142 
143  /// Set if a valid major sync block has been read. Otherwise no decoding is possible.
144  uint8_t params_valid;
145 
146  /// Number of substreams contained within this stream.
147  uint8_t num_substreams;
148 
149  /// Index of the last substream to decode - further substreams are skipped.
151 
152  /// Stream needs channel reordering to comply with FFmpeg's channel order
154 
155  /// number of PCM samples contained in each frame
157  /// next power of two above the number of samples in each frame
159 
161 
164 
168 
171 
172 static const uint64_t thd_channel_order[] = {
174  AV_CH_FRONT_CENTER, // C
175  AV_CH_LOW_FREQUENCY, // LFE
180  AV_CH_BACK_CENTER, // Cs
181  AV_CH_TOP_CENTER, // Ts
184  AV_CH_TOP_FRONT_CENTER, // Cvh
185  AV_CH_LOW_FREQUENCY_2, // LFE2
186 };
187 
188 static int mlp_channel_layout_subset(uint64_t channel_layout, uint64_t mask)
189 {
190  return channel_layout && ((channel_layout & mask) == channel_layout);
191 }
192 
193 static uint64_t thd_channel_layout_extract_channel(uint64_t channel_layout,
194  int index)
195 {
196  int i;
197 
198  if (av_get_channel_layout_nb_channels(channel_layout) <= index)
199  return 0;
200 
201  for (i = 0; i < FF_ARRAY_ELEMS(thd_channel_order); i++)
202  if (channel_layout & thd_channel_order[i] && !index--)
203  return thd_channel_order[i];
204  return 0;
205 }
206 
207 static VLC huff_vlc[3];
208 
209 /** Initialize static data, constant between all invocations of the codec. */
210 
211 static av_cold void init_static(void)
212 {
213  for (int i = 0; i < 3; i++) {
214  static VLC_TYPE vlc_buf[3 * VLC_STATIC_SIZE][2];
217  init_vlc(&huff_vlc[i], VLC_BITS, 18,
218  &ff_mlp_huffman_tables[i][0][1], 2, 1,
220  }
221 
222  ff_mlp_init_crc();
223 }
224 
226  unsigned int substr, unsigned int ch)
227 {
228  SubStream *s = &m->substream[substr];
229  ChannelParams *cp = &s->channel_params[ch];
230  int lsb_bits = cp->huff_lsbs - s->quant_step_size[ch];
231  int sign_shift = lsb_bits + (cp->codebook ? 2 - cp->codebook : -1);
232  int32_t sign_huff_offset = cp->huff_offset;
233 
234  if (cp->codebook > 0)
235  sign_huff_offset -= 7 << lsb_bits;
236 
237  if (sign_shift >= 0)
238  sign_huff_offset -= 1 << sign_shift;
239 
240  return sign_huff_offset;
241 }
242 
243 /** Read a sample, consisting of either, both or neither of entropy-coded MSBs
244  * and plain LSBs. */
245 
247  unsigned int substr, unsigned int pos)
248 {
249  SubStream *s = &m->substream[substr];
250  unsigned int mat, channel;
251 
252  for (mat = 0; mat < s->num_primitive_matrices; mat++)
253  if (s->lsb_bypass[mat])
254  m->bypassed_lsbs[pos + s->blockpos][mat] = get_bits1(gbp);
255 
256  for (channel = s->min_channel; channel <= s->max_channel; channel++) {
257  ChannelParams *cp = &s->channel_params[channel];
258  int codebook = cp->codebook;
259  int quant_step_size = s->quant_step_size[channel];
260  int lsb_bits = cp->huff_lsbs - quant_step_size;
261  int result = 0;
262 
263  if (codebook > 0)
265  VLC_BITS, (9 + VLC_BITS - 1) / VLC_BITS);
266 
267  if (result < 0)
268  return AVERROR_INVALIDDATA;
269 
270  if (lsb_bits > 0)
271  result = (result << lsb_bits) + get_bits_long(gbp, lsb_bits);
272 
273  result += cp->sign_huff_offset;
274  result *= 1 << quant_step_size;
275 
276  m->sample_buffer[pos + s->blockpos][channel] = result;
277  }
278 
279  return 0;
280 }
281 
283 {
284  static AVOnce init_static_once = AV_ONCE_INIT;
285  MLPDecodeContext *m = avctx->priv_data;
286  int substr;
287 
288  m->avctx = avctx;
289  for (substr = 0; substr < MAX_SUBSTREAMS; substr++)
290  m->substream[substr].lossless_check_data = 0xffffffff;
291  ff_mlpdsp_init(&m->dsp);
292 
293  ff_thread_once(&init_static_once, init_static);
294 
295  return 0;
296 }
297 
298 /** Read a major sync info header - contains high level information about
299  * the stream - sample rate, channel arrangement etc. Most of this
300  * information is not actually necessary for decoding, only for playback.
301  */
302 
304 {
306  int substr, ret;
307 
308  if ((ret = ff_mlp_read_major_sync(m->avctx, &mh, gb)) != 0)
309  return ret;
310 
311  if (mh.group1_bits == 0) {
312  av_log(m->avctx, AV_LOG_ERROR, "invalid/unknown bits per sample\n");
313  return AVERROR_INVALIDDATA;
314  }
315  if (mh.group2_bits > mh.group1_bits) {
317  "Channel group 2 cannot have more bits per sample than group 1.\n");
318  return AVERROR_INVALIDDATA;
319  }
320 
321  if (mh.group2_samplerate && mh.group2_samplerate != mh.group1_samplerate) {
323  "Channel groups with differing sample rates are not currently supported.\n");
324  return AVERROR_INVALIDDATA;
325  }
326 
327  if (mh.group1_samplerate == 0) {
328  av_log(m->avctx, AV_LOG_ERROR, "invalid/unknown sampling rate\n");
329  return AVERROR_INVALIDDATA;
330  }
331  if (mh.group1_samplerate > MAX_SAMPLERATE) {
333  "Sampling rate %d is greater than the supported maximum (%d).\n",
334  mh.group1_samplerate, MAX_SAMPLERATE);
335  return AVERROR_INVALIDDATA;
336  }
337  if (mh.access_unit_size > MAX_BLOCKSIZE) {
339  "Block size %d is greater than the supported maximum (%d).\n",
340  mh.access_unit_size, MAX_BLOCKSIZE);
341  return AVERROR_INVALIDDATA;
342  }
343  if (mh.access_unit_size_pow2 > MAX_BLOCKSIZE_POW2) {
345  "Block size pow2 %d is greater than the supported maximum (%d).\n",
346  mh.access_unit_size_pow2, MAX_BLOCKSIZE_POW2);
347  return AVERROR_INVALIDDATA;
348  }
349 
350  if (mh.num_substreams == 0)
351  return AVERROR_INVALIDDATA;
352  if (m->avctx->codec_id == AV_CODEC_ID_MLP && mh.num_substreams > 2) {
353  av_log(m->avctx, AV_LOG_ERROR, "MLP only supports up to 2 substreams.\n");
354  return AVERROR_INVALIDDATA;
355  }
356  if (mh.num_substreams > MAX_SUBSTREAMS) {
358  "%d substreams (more than the "
359  "maximum supported by the decoder)",
360  mh.num_substreams);
361  return AVERROR_PATCHWELCOME;
362  }
363 
364  m->major_sync_header_size = mh.header_size;
365 
366  m->access_unit_size = mh.access_unit_size;
367  m->access_unit_size_pow2 = mh.access_unit_size_pow2;
368 
369  m->num_substreams = mh.num_substreams;
370 
371  /* limit to decoding 3 substreams, as the 4th is used by Dolby Atmos for non-audio data */
373 
374  m->avctx->sample_rate = mh.group1_samplerate;
375  m->avctx->frame_size = mh.access_unit_size;
376 
377  m->avctx->bits_per_raw_sample = mh.group1_bits;
378  if (mh.group1_bits > 16)
380  else
386 
387  m->params_valid = 1;
388  for (substr = 0; substr < MAX_SUBSTREAMS; substr++)
389  m->substream[substr].restart_seen = 0;
390 
391  /* Set the layout for each substream. When there's more than one, the first
392  * substream is Stereo. Subsequent substreams' layouts are indicated in the
393  * major sync. */
394  if (m->avctx->codec_id == AV_CODEC_ID_MLP) {
395  if (mh.stream_type != SYNC_MLP) {
397  "unexpected stream_type %X in MLP",
398  mh.stream_type);
399  return AVERROR_PATCHWELCOME;
400  }
401  if ((substr = (mh.num_substreams > 1)))
403  m->substream[substr].mask = mh.channel_layout_mlp;
404  } else {
405  if (mh.stream_type != SYNC_TRUEHD) {
407  "unexpected stream_type %X in !MLP",
408  mh.stream_type);
409  return AVERROR_PATCHWELCOME;
410  }
411  if (mh.channel_modifier_thd_stream0 == THD_CH_MODIFIER_STEREO)
413  if ((substr = (mh.num_substreams > 1)))
415  if (mh.num_substreams > 2)
416  if (mh.channel_layout_thd_stream2)
417  m->substream[2].mask = mh.channel_layout_thd_stream2;
418  else
419  m->substream[2].mask = mh.channel_layout_thd_stream1;
420  m->substream[1].mask = mh.channel_layout_thd_stream1;
421 
422  if (m->avctx->channels<=2 && m->substream[substr].mask == AV_CH_LAYOUT_MONO && m->max_decoded_substream == 1) {
423  av_log(m->avctx, AV_LOG_DEBUG, "Mono stream with 2 substreams, ignoring 2nd\n");
424  m->max_decoded_substream = 0;
425  if (m->avctx->channels==2)
427  }
428  }
429 
430  m->needs_reordering = mh.channel_arrangement >= 18 && mh.channel_arrangement <= 20;
431 
432  /* Parse the TrueHD decoder channel modifiers and set each substream's
433  * AVMatrixEncoding accordingly.
434  *
435  * The meaning of the modifiers depends on the channel layout:
436  *
437  * - THD_CH_MODIFIER_LTRT, THD_CH_MODIFIER_LBINRBIN only apply to 2-channel
438  *
439  * - THD_CH_MODIFIER_MONO applies to 1-channel or 2-channel (dual mono)
440  *
441  * - THD_CH_MODIFIER_SURROUNDEX, THD_CH_MODIFIER_NOTSURROUNDEX only apply to
442  * layouts with an Ls/Rs channel pair
443  */
444  for (substr = 0; substr < MAX_SUBSTREAMS; substr++)
447  if (mh.num_substreams > 2 &&
448  mh.channel_layout_thd_stream2 & AV_CH_SIDE_LEFT &&
449  mh.channel_layout_thd_stream2 & AV_CH_SIDE_RIGHT &&
450  mh.channel_modifier_thd_stream2 == THD_CH_MODIFIER_SURROUNDEX)
452 
453  if (mh.num_substreams > 1 &&
454  mh.channel_layout_thd_stream1 & AV_CH_SIDE_LEFT &&
455  mh.channel_layout_thd_stream1 & AV_CH_SIDE_RIGHT &&
456  mh.channel_modifier_thd_stream1 == THD_CH_MODIFIER_SURROUNDEX)
458 
459  if (mh.num_substreams > 0)
460  switch (mh.channel_modifier_thd_stream0) {
463  break;
466  break;
467  default:
468  break;
469  }
470  }
471 
472  return 0;
473 }
474 
475 /** Read a restart header from a block in a substream. This contains parameters
476  * required to decode the audio that do not change very often. Generally
477  * (always) present only in blocks following a major sync. */
478 
480  const uint8_t *buf, unsigned int substr)
481 {
482  SubStream *s = &m->substream[substr];
483  unsigned int ch;
484  int sync_word, tmp;
485  uint8_t checksum;
486  uint8_t lossless_check;
487  int start_count = get_bits_count(gbp);
488  int min_channel, max_channel, max_matrix_channel, noise_type;
489  const int std_max_matrix_channel = m->avctx->codec_id == AV_CODEC_ID_MLP
492 
493  sync_word = get_bits(gbp, 13);
494 
495  if (sync_word != 0x31ea >> 1) {
497  "restart header sync incorrect (got 0x%04x)\n", sync_word);
498  return AVERROR_INVALIDDATA;
499  }
500 
501  noise_type = get_bits1(gbp);
502 
503  if (m->avctx->codec_id == AV_CODEC_ID_MLP && noise_type) {
504  av_log(m->avctx, AV_LOG_ERROR, "MLP must have 0x31ea sync word.\n");
505  return AVERROR_INVALIDDATA;
506  }
507 
508  skip_bits(gbp, 16); /* Output timestamp */
509 
510  min_channel = get_bits(gbp, 4);
511  max_channel = get_bits(gbp, 4);
512  max_matrix_channel = get_bits(gbp, 4);
513 
514  if (max_matrix_channel > std_max_matrix_channel) {
516  "Max matrix channel cannot be greater than %d.\n",
517  std_max_matrix_channel);
518  return AVERROR_INVALIDDATA;
519  }
520 
521  if (max_channel != max_matrix_channel) {
523  "Max channel must be equal max matrix channel.\n");
524  return AVERROR_INVALIDDATA;
525  }
526 
527  /* This should happen for TrueHD streams with >6 channels and MLP's noise
528  * type. It is not yet known if this is allowed. */
529  if (max_channel > MAX_MATRIX_CHANNEL_MLP && !noise_type) {
531  "%d channels (more than the "
532  "maximum supported by the decoder)",
533  max_channel + 2);
534  return AVERROR_PATCHWELCOME;
535  }
536 
537  if (min_channel > max_channel) {
539  "Substream min channel cannot be greater than max channel.\n");
540  return AVERROR_INVALIDDATA;
541  }
542 
543  s->min_channel = min_channel;
544  s->max_channel = max_channel;
545  s->max_matrix_channel = max_matrix_channel;
546  s->noise_type = noise_type;
547 
549  m->max_decoded_substream > substr) {
551  "Extracting %d-channel downmix (0x%"PRIx64") from substream %d. "
552  "Further substreams will be skipped.\n",
553  s->max_channel + 1, s->mask, substr);
554  m->max_decoded_substream = substr;
555  }
556 
557  s->noise_shift = get_bits(gbp, 4);
558  s->noisegen_seed = get_bits(gbp, 23);
559 
560  skip_bits(gbp, 19);
561 
562  s->data_check_present = get_bits1(gbp);
563  lossless_check = get_bits(gbp, 8);
564  if (substr == m->max_decoded_substream
565  && s->lossless_check_data != 0xffffffff) {
566  tmp = xor_32_to_8(s->lossless_check_data);
567  if (tmp != lossless_check)
569  "Lossless check failed - expected %02x, calculated %02x.\n",
570  lossless_check, tmp);
571  }
572 
573  skip_bits(gbp, 16);
574 
575  memset(s->ch_assign, 0, sizeof(s->ch_assign));
576 
577  for (ch = 0; ch <= s->max_matrix_channel; ch++) {
578  int ch_assign = get_bits(gbp, 6);
579  if (m->avctx->codec_id == AV_CODEC_ID_TRUEHD) {
581  ch_assign);
582  ch_assign = av_get_channel_layout_channel_index(s->mask,
583  channel);
584  }
585  if (ch_assign < 0 || ch_assign > s->max_matrix_channel) {
587  "Assignment of matrix channel %d to invalid output channel %d",
588  ch, ch_assign);
589  return AVERROR_PATCHWELCOME;
590  }
591  s->ch_assign[ch_assign] = ch;
592  }
593 
594  checksum = ff_mlp_restart_checksum(buf, get_bits_count(gbp) - start_count);
595 
596  if (checksum != get_bits(gbp, 8))
597  av_log(m->avctx, AV_LOG_ERROR, "restart header checksum error\n");
598 
599  /* Set default decoding parameters. */
600  s->param_presence_flags = 0xff;
601  s->num_primitive_matrices = 0;
602  s->blocksize = 8;
603  s->lossless_check_data = 0;
604 
605  memset(s->output_shift , 0, sizeof(s->output_shift ));
606  memset(s->quant_step_size, 0, sizeof(s->quant_step_size));
607 
608  for (ch = s->min_channel; ch <= s->max_channel; ch++) {
609  ChannelParams *cp = &s->channel_params[ch];
610  cp->filter_params[FIR].order = 0;
611  cp->filter_params[IIR].order = 0;
612  cp->filter_params[FIR].shift = 0;
613  cp->filter_params[IIR].shift = 0;
614 
615  /* Default audio coding is 24-bit raw PCM. */
616  cp->huff_offset = 0;
617  cp->sign_huff_offset = -(1 << 23);
618  cp->codebook = 0;
619  cp->huff_lsbs = 24;
620  }
621 
622  if (substr == m->max_decoded_substream) {
623  m->avctx->channels = s->max_matrix_channel + 1;
624  m->avctx->channel_layout = s->mask;
625  m->dsp.mlp_pack_output = m->dsp.mlp_select_pack_output(s->ch_assign,
626  s->output_shift,
627  s->max_matrix_channel,
629 
630  if (m->avctx->codec_id == AV_CODEC_ID_MLP && m->needs_reordering) {
633  int i = s->ch_assign[4];
634  s->ch_assign[4] = s->ch_assign[3];
635  s->ch_assign[3] = s->ch_assign[2];
636  s->ch_assign[2] = i;
637  } else if (m->avctx->channel_layout == AV_CH_LAYOUT_5POINT1_BACK) {
638  FFSWAP(int, s->ch_assign[2], s->ch_assign[4]);
639  FFSWAP(int, s->ch_assign[3], s->ch_assign[5]);
640  }
641  }
642 
643  }
644 
645  return 0;
646 }
647 
648 /** Read parameters for one of the prediction filters. */
649 
651  unsigned int substr, unsigned int channel,
652  unsigned int filter)
653 {
654  SubStream *s = &m->substream[substr];
655  FilterParams *fp = &s->channel_params[channel].filter_params[filter];
656  const int max_order = filter ? MAX_IIR_ORDER : MAX_FIR_ORDER;
657  const char fchar = filter ? 'I' : 'F';
658  int i, order;
659 
660  // Filter is 0 for FIR, 1 for IIR.
661  av_assert0(filter < 2);
662 
663  if (m->filter_changed[channel][filter]++ > 1) {
664  av_log(m->avctx, AV_LOG_ERROR, "Filters may change only once per access unit.\n");
665  return AVERROR_INVALIDDATA;
666  }
667 
668  order = get_bits(gbp, 4);
669  if (order > max_order) {
671  "%cIR filter order %d is greater than maximum %d.\n",
672  fchar, order, max_order);
673  return AVERROR_INVALIDDATA;
674  }
675  fp->order = order;
676 
677  if (order > 0) {
678  int32_t *fcoeff = s->channel_params[channel].coeff[filter];
679  int coeff_bits, coeff_shift;
680 
681  fp->shift = get_bits(gbp, 4);
682 
683  coeff_bits = get_bits(gbp, 5);
684  coeff_shift = get_bits(gbp, 3);
685  if (coeff_bits < 1 || coeff_bits > 16) {
687  "%cIR filter coeff_bits must be between 1 and 16.\n",
688  fchar);
689  return AVERROR_INVALIDDATA;
690  }
691  if (coeff_bits + coeff_shift > 16) {
693  "Sum of coeff_bits and coeff_shift for %cIR filter must be 16 or less.\n",
694  fchar);
695  return AVERROR_INVALIDDATA;
696  }
697 
698  for (i = 0; i < order; i++)
699  fcoeff[i] = get_sbits(gbp, coeff_bits) * (1 << coeff_shift);
700 
701  if (get_bits1(gbp)) {
702  int state_bits, state_shift;
703 
704  if (filter == FIR) {
706  "FIR filter has state data specified.\n");
707  return AVERROR_INVALIDDATA;
708  }
709 
710  state_bits = get_bits(gbp, 4);
711  state_shift = get_bits(gbp, 4);
712 
713  /* TODO: Check validity of state data. */
714 
715  for (i = 0; i < order; i++)
716  fp->state[i] = state_bits ? get_sbits(gbp, state_bits) * (1 << state_shift) : 0;
717  }
718  }
719 
720  return 0;
721 }
722 
723 /** Read parameters for primitive matrices. */
724 
725 static int read_matrix_params(MLPDecodeContext *m, unsigned int substr, GetBitContext *gbp)
726 {
727  SubStream *s = &m->substream[substr];
728  unsigned int mat, ch;
729  const int max_primitive_matrices = m->avctx->codec_id == AV_CODEC_ID_MLP
732 
733  if (m->matrix_changed++ > 1) {
734  av_log(m->avctx, AV_LOG_ERROR, "Matrices may change only once per access unit.\n");
735  return AVERROR_INVALIDDATA;
736  }
737 
738  s->num_primitive_matrices = get_bits(gbp, 4);
739 
740  if (s->num_primitive_matrices > max_primitive_matrices) {
742  "Number of primitive matrices cannot be greater than %d.\n",
743  max_primitive_matrices);
744  goto error;
745  }
746 
747  for (mat = 0; mat < s->num_primitive_matrices; mat++) {
748  int frac_bits, max_chan;
749  s->matrix_out_ch[mat] = get_bits(gbp, 4);
750  frac_bits = get_bits(gbp, 4);
751  s->lsb_bypass [mat] = get_bits1(gbp);
752 
753  if (s->matrix_out_ch[mat] > s->max_matrix_channel) {
755  "Invalid channel %d specified as output from matrix.\n",
756  s->matrix_out_ch[mat]);
757  goto error;
758  }
759  if (frac_bits > 14) {
761  "Too many fractional bits specified.\n");
762  goto error;
763  }
764 
765  max_chan = s->max_matrix_channel;
766  if (!s->noise_type)
767  max_chan+=2;
768 
769  for (ch = 0; ch <= max_chan; ch++) {
770  int coeff_val = 0;
771  if (get_bits1(gbp))
772  coeff_val = get_sbits(gbp, frac_bits + 2);
773 
774  s->matrix_coeff[mat][ch] = coeff_val * (1 << (14 - frac_bits));
775  }
776 
777  if (s->noise_type)
778  s->matrix_noise_shift[mat] = get_bits(gbp, 4);
779  else
780  s->matrix_noise_shift[mat] = 0;
781  }
782 
783  return 0;
784 error:
785  s->num_primitive_matrices = 0;
786  memset(s->matrix_out_ch, 0, sizeof(s->matrix_out_ch));
787 
788  return AVERROR_INVALIDDATA;
789 }
790 
791 /** Read channel parameters. */
792 
793 static int read_channel_params(MLPDecodeContext *m, unsigned int substr,
794  GetBitContext *gbp, unsigned int ch)
795 {
796  SubStream *s = &m->substream[substr];
797  ChannelParams *cp = &s->channel_params[ch];
798  FilterParams *fir = &cp->filter_params[FIR];
799  FilterParams *iir = &cp->filter_params[IIR];
800  int ret;
801 
802  if (s->param_presence_flags & PARAM_FIR)
803  if (get_bits1(gbp))
804  if ((ret = read_filter_params(m, gbp, substr, ch, FIR)) < 0)
805  return ret;
806 
807  if (s->param_presence_flags & PARAM_IIR)
808  if (get_bits1(gbp))
809  if ((ret = read_filter_params(m, gbp, substr, ch, IIR)) < 0)
810  return ret;
811 
812  if (fir->order + iir->order > 8) {
813  av_log(m->avctx, AV_LOG_ERROR, "Total filter orders too high.\n");
814  return AVERROR_INVALIDDATA;
815  }
816 
817  if (fir->order && iir->order &&
818  fir->shift != iir->shift) {
820  "FIR and IIR filters must use the same precision.\n");
821  return AVERROR_INVALIDDATA;
822  }
823  /* The FIR and IIR filters must have the same precision.
824  * To simplify the filtering code, only the precision of the
825  * FIR filter is considered. If only the IIR filter is employed,
826  * the FIR filter precision is set to that of the IIR filter, so
827  * that the filtering code can use it. */
828  if (!fir->order && iir->order)
829  fir->shift = iir->shift;
830 
831  if (s->param_presence_flags & PARAM_HUFFOFFSET)
832  if (get_bits1(gbp))
833  cp->huff_offset = get_sbits(gbp, 15);
834 
835  cp->codebook = get_bits(gbp, 2);
836  cp->huff_lsbs = get_bits(gbp, 5);
837 
838  if (cp->codebook > 0 && cp->huff_lsbs > 24) {
839  av_log(m->avctx, AV_LOG_ERROR, "Invalid huff_lsbs.\n");
840  cp->huff_lsbs = 0;
841  return AVERROR_INVALIDDATA;
842  }
843 
844  return 0;
845 }
846 
847 /** Read decoding parameters that change more often than those in the restart
848  * header. */
849 
851  unsigned int substr)
852 {
853  SubStream *s = &m->substream[substr];
854  unsigned int ch;
855  int ret = 0;
856  unsigned recompute_sho = 0;
857 
858  if (s->param_presence_flags & PARAM_PRESENCE)
859  if (get_bits1(gbp))
860  s->param_presence_flags = get_bits(gbp, 8);
861 
862  if (s->param_presence_flags & PARAM_BLOCKSIZE)
863  if (get_bits1(gbp)) {
864  s->blocksize = get_bits(gbp, 9);
865  if (s->blocksize < 8 || s->blocksize > m->access_unit_size) {
866  av_log(m->avctx, AV_LOG_ERROR, "Invalid blocksize.\n");
867  s->blocksize = 0;
868  return AVERROR_INVALIDDATA;
869  }
870  }
871 
872  if (s->param_presence_flags & PARAM_MATRIX)
873  if (get_bits1(gbp))
874  if ((ret = read_matrix_params(m, substr, gbp)) < 0)
875  return ret;
876 
877  if (s->param_presence_flags & PARAM_OUTSHIFT)
878  if (get_bits1(gbp)) {
879  for (ch = 0; ch <= s->max_matrix_channel; ch++) {
880  s->output_shift[ch] = get_sbits(gbp, 4);
881  if (s->output_shift[ch] < 0) {
882  avpriv_request_sample(m->avctx, "Negative output_shift");
883  s->output_shift[ch] = 0;
884  }
885  }
886  if (substr == m->max_decoded_substream)
887  m->dsp.mlp_pack_output = m->dsp.mlp_select_pack_output(s->ch_assign,
888  s->output_shift,
889  s->max_matrix_channel,
891  }
892 
893  if (s->param_presence_flags & PARAM_QUANTSTEP)
894  if (get_bits1(gbp))
895  for (ch = 0; ch <= s->max_channel; ch++) {
896  s->quant_step_size[ch] = get_bits(gbp, 4);
897 
898  recompute_sho |= 1<<ch;
899  }
900 
901  for (ch = s->min_channel; ch <= s->max_channel; ch++)
902  if (get_bits1(gbp)) {
903  recompute_sho |= 1<<ch;
904  if ((ret = read_channel_params(m, substr, gbp, ch)) < 0)
905  goto fail;
906  }
907 
908 
909 fail:
910  for (ch = 0; ch <= s->max_channel; ch++) {
911  if (recompute_sho & (1<<ch)) {
912  ChannelParams *cp = &s->channel_params[ch];
913 
914  if (cp->codebook > 0 && cp->huff_lsbs < s->quant_step_size[ch]) {
915  if (ret >= 0) {
916  av_log(m->avctx, AV_LOG_ERROR, "quant_step_size larger than huff_lsbs\n");
918  }
919  s->quant_step_size[ch] = 0;
920  }
921 
922  cp->sign_huff_offset = calculate_sign_huff(m, substr, ch);
923  }
924  }
925  return ret;
926 }
927 
928 #define MSB_MASK(bits) (-(1 << (bits)))
929 
930 /** Generate PCM samples using the prediction filters and residual values
931  * read from the data stream, and update the filter state. */
932 
933 static void filter_channel(MLPDecodeContext *m, unsigned int substr,
934  unsigned int channel)
935 {
936  SubStream *s = &m->substream[substr];
937  const int32_t *fircoeff = s->channel_params[channel].coeff[FIR];
939  int32_t *firbuf = state_buffer[FIR] + MAX_BLOCKSIZE;
940  int32_t *iirbuf = state_buffer[IIR] + MAX_BLOCKSIZE;
941  FilterParams *fir = &s->channel_params[channel].filter_params[FIR];
942  FilterParams *iir = &s->channel_params[channel].filter_params[IIR];
943  unsigned int filter_shift = fir->shift;
944  int32_t mask = MSB_MASK(s->quant_step_size[channel]);
945 
946  memcpy(firbuf, fir->state, MAX_FIR_ORDER * sizeof(int32_t));
947  memcpy(iirbuf, iir->state, MAX_IIR_ORDER * sizeof(int32_t));
948 
949  m->dsp.mlp_filter_channel(firbuf, fircoeff,
950  fir->order, iir->order,
951  filter_shift, mask, s->blocksize,
952  &m->sample_buffer[s->blockpos][channel]);
953 
954  memcpy(fir->state, firbuf - s->blocksize, MAX_FIR_ORDER * sizeof(int32_t));
955  memcpy(iir->state, iirbuf - s->blocksize, MAX_IIR_ORDER * sizeof(int32_t));
956 }
957 
958 /** Read a block of PCM residual data (or actual if no filtering active). */
959 
961  unsigned int substr)
962 {
963  SubStream *s = &m->substream[substr];
964  unsigned int i, ch, expected_stream_pos = 0;
965  int ret;
966 
967  if (s->data_check_present) {
968  expected_stream_pos = get_bits_count(gbp);
969  expected_stream_pos += get_bits(gbp, 16);
971  "Substreams with VLC block size check info");
972  }
973 
974  if (s->blockpos + s->blocksize > m->access_unit_size) {
975  av_log(m->avctx, AV_LOG_ERROR, "too many audio samples in frame\n");
976  return AVERROR_INVALIDDATA;
977  }
978 
979  memset(&m->bypassed_lsbs[s->blockpos][0], 0,
980  s->blocksize * sizeof(m->bypassed_lsbs[0]));
981 
982  for (i = 0; i < s->blocksize; i++)
983  if ((ret = read_huff_channels(m, gbp, substr, i)) < 0)
984  return ret;
985 
986  for (ch = s->min_channel; ch <= s->max_channel; ch++)
987  filter_channel(m, substr, ch);
988 
989  s->blockpos += s->blocksize;
990 
991  if (s->data_check_present) {
992  if (get_bits_count(gbp) != expected_stream_pos)
993  av_log(m->avctx, AV_LOG_ERROR, "block data length mismatch\n");
994  skip_bits(gbp, 8);
995  }
996 
997  return 0;
998 }
999 
1000 /** Data table used for TrueHD noise generation function. */
1001 
1002 static const int8_t noise_table[256] = {
1003  30, 51, 22, 54, 3, 7, -4, 38, 14, 55, 46, 81, 22, 58, -3, 2,
1004  52, 31, -7, 51, 15, 44, 74, 30, 85, -17, 10, 33, 18, 80, 28, 62,
1005  10, 32, 23, 69, 72, 26, 35, 17, 73, 60, 8, 56, 2, 6, -2, -5,
1006  51, 4, 11, 50, 66, 76, 21, 44, 33, 47, 1, 26, 64, 48, 57, 40,
1007  38, 16, -10, -28, 92, 22, -18, 29, -10, 5, -13, 49, 19, 24, 70, 34,
1008  61, 48, 30, 14, -6, 25, 58, 33, 42, 60, 67, 17, 54, 17, 22, 30,
1009  67, 44, -9, 50, -11, 43, 40, 32, 59, 82, 13, 49, -14, 55, 60, 36,
1010  48, 49, 31, 47, 15, 12, 4, 65, 1, 23, 29, 39, 45, -2, 84, 69,
1011  0, 72, 37, 57, 27, 41, -15, -16, 35, 31, 14, 61, 24, 0, 27, 24,
1012  16, 41, 55, 34, 53, 9, 56, 12, 25, 29, 53, 5, 20, -20, -8, 20,
1013  13, 28, -3, 78, 38, 16, 11, 62, 46, 29, 21, 24, 46, 65, 43, -23,
1014  89, 18, 74, 21, 38, -12, 19, 12, -19, 8, 15, 33, 4, 57, 9, -8,
1015  36, 35, 26, 28, 7, 83, 63, 79, 75, 11, 3, 87, 37, 47, 34, 40,
1016  39, 19, 20, 42, 27, 34, 39, 77, 13, 42, 59, 64, 45, -1, 32, 37,
1017  45, -5, 53, -6, 7, 36, 50, 23, 6, 32, 9, -21, 18, 71, 27, 52,
1018  -25, 31, 35, 42, -1, 68, 63, 52, 26, 43, 66, 37, 41, 25, 40, 70,
1019 };
1020 
1021 /** Noise generation functions.
1022  * I'm not sure what these are for - they seem to be some kind of pseudorandom
1023  * sequence generators, used to generate noise data which is used when the
1024  * channels are rematrixed. I'm not sure if they provide a practical benefit
1025  * to compression, or just obfuscate the decoder. Are they for some kind of
1026  * dithering? */
1027 
1028 /** Generate two channels of noise, used in the matrix when
1029  * restart sync word == 0x31ea. */
1030 
1031 static void generate_2_noise_channels(MLPDecodeContext *m, unsigned int substr)
1032 {
1033  SubStream *s = &m->substream[substr];
1034  unsigned int i;
1035  uint32_t seed = s->noisegen_seed;
1036  unsigned int maxchan = s->max_matrix_channel;
1037 
1038  for (i = 0; i < s->blockpos; i++) {
1039  uint16_t seed_shr7 = seed >> 7;
1040  m->sample_buffer[i][maxchan+1] = ((int8_t)(seed >> 15)) * (1 << s->noise_shift);
1041  m->sample_buffer[i][maxchan+2] = ((int8_t) seed_shr7) * (1 << s->noise_shift);
1042 
1043  seed = (seed << 16) ^ seed_shr7 ^ (seed_shr7 << 5);
1044  }
1045 
1046  s->noisegen_seed = seed;
1047 }
1048 
1049 /** Generate a block of noise, used when restart sync word == 0x31eb. */
1050 
1051 static void fill_noise_buffer(MLPDecodeContext *m, unsigned int substr)
1052 {
1053  SubStream *s = &m->substream[substr];
1054  unsigned int i;
1055  uint32_t seed = s->noisegen_seed;
1056 
1057  for (i = 0; i < m->access_unit_size_pow2; i++) {
1058  uint8_t seed_shr15 = seed >> 15;
1059  m->noise_buffer[i] = noise_table[seed_shr15];
1060  seed = (seed << 8) ^ seed_shr15 ^ (seed_shr15 << 5);
1061  }
1062 
1063  s->noisegen_seed = seed;
1064 }
1065 
1066 /** Write the audio data into the output buffer. */
1067 
1068 static int output_data(MLPDecodeContext *m, unsigned int substr,
1069  AVFrame *frame, int *got_frame_ptr)
1070 {
1071  AVCodecContext *avctx = m->avctx;
1072  SubStream *s = &m->substream[substr];
1073  unsigned int mat;
1074  unsigned int maxchan;
1075  int ret;
1076  int is32 = (m->avctx->sample_fmt == AV_SAMPLE_FMT_S32);
1077 
1078  if (m->avctx->channels != s->max_matrix_channel + 1) {
1079  av_log(m->avctx, AV_LOG_ERROR, "channel count mismatch\n");
1080  return AVERROR_INVALIDDATA;
1081  }
1082 
1083  if (!s->blockpos) {
1084  av_log(avctx, AV_LOG_ERROR, "No samples to output.\n");
1085  return AVERROR_INVALIDDATA;
1086  }
1087 
1088  maxchan = s->max_matrix_channel;
1089  if (!s->noise_type) {
1090  generate_2_noise_channels(m, substr);
1091  maxchan += 2;
1092  } else {
1093  fill_noise_buffer(m, substr);
1094  }
1095 
1096  /* Apply the channel matrices in turn to reconstruct the original audio
1097  * samples. */
1098  for (mat = 0; mat < s->num_primitive_matrices; mat++) {
1099  unsigned int dest_ch = s->matrix_out_ch[mat];
1100  m->dsp.mlp_rematrix_channel(&m->sample_buffer[0][0],
1101  s->matrix_coeff[mat],
1102  &m->bypassed_lsbs[0][mat],
1103  m->noise_buffer,
1104  s->num_primitive_matrices - mat,
1105  dest_ch,
1106  s->blockpos,
1107  maxchan,
1108  s->matrix_noise_shift[mat],
1110  MSB_MASK(s->quant_step_size[dest_ch]));
1111  }
1112 
1113  /* get output buffer */
1114  frame->nb_samples = s->blockpos;
1115  if ((ret = ff_get_buffer(avctx, frame, 0)) < 0)
1116  return ret;
1117  s->lossless_check_data = m->dsp.mlp_pack_output(s->lossless_check_data,
1118  s->blockpos,
1119  m->sample_buffer,
1120  frame->data[0],
1121  s->ch_assign,
1122  s->output_shift,
1123  s->max_matrix_channel,
1124  is32);
1125 
1126  /* Update matrix encoding side data */
1127  if (s->matrix_encoding != s->prev_matrix_encoding) {
1128  if ((ret = ff_side_data_update_matrix_encoding(frame, s->matrix_encoding)) < 0)
1129  return ret;
1130 
1131  s->prev_matrix_encoding = s->matrix_encoding;
1132  }
1133 
1134  *got_frame_ptr = 1;
1135 
1136  return 0;
1137 }
1138 
1139 /** Read an access unit from the stream.
1140  * @return negative on error, 0 if not enough data is present in the input stream,
1141  * otherwise the number of bytes consumed. */
1142 
1143 static int read_access_unit(AVCodecContext *avctx, void* data,
1144  int *got_frame_ptr, AVPacket *avpkt)
1145 {
1146  const uint8_t *buf = avpkt->data;
1147  int buf_size = avpkt->size;
1148  MLPDecodeContext *m = avctx->priv_data;
1149  GetBitContext gb;
1150  unsigned int length, substr;
1151  unsigned int substream_start;
1152  unsigned int header_size = 4;
1153  unsigned int substr_header_size = 0;
1154  uint8_t substream_parity_present[MAX_SUBSTREAMS];
1155  uint16_t substream_data_len[MAX_SUBSTREAMS];
1156  uint8_t parity_bits;
1157  int ret;
1158 
1159  if (buf_size < 4)
1160  return AVERROR_INVALIDDATA;
1161 
1162  length = (AV_RB16(buf) & 0xfff) * 2;
1163 
1164  if (length < 4 || length > buf_size)
1165  return AVERROR_INVALIDDATA;
1166 
1167  init_get_bits(&gb, (buf + 4), (length - 4) * 8);
1168 
1169  m->is_major_sync_unit = 0;
1170  if (show_bits_long(&gb, 31) == (0xf8726fba >> 1)) {
1171  if (read_major_sync(m, &gb) < 0)
1172  goto error;
1173  m->is_major_sync_unit = 1;
1174  header_size += m->major_sync_header_size;
1175  }
1176 
1177  if (!m->params_valid) {
1179  "Stream parameters not seen; skipping frame.\n");
1180  *got_frame_ptr = 0;
1181  return length;
1182  }
1183 
1184  substream_start = 0;
1185 
1186  for (substr = 0; substr < m->num_substreams; substr++) {
1187  int extraword_present, checkdata_present, end, nonrestart_substr;
1188 
1189  extraword_present = get_bits1(&gb);
1190  nonrestart_substr = get_bits1(&gb);
1191  checkdata_present = get_bits1(&gb);
1192  skip_bits1(&gb);
1193 
1194  end = get_bits(&gb, 12) * 2;
1195 
1196  substr_header_size += 2;
1197 
1198  if (extraword_present) {
1199  if (m->avctx->codec_id == AV_CODEC_ID_MLP) {
1200  av_log(m->avctx, AV_LOG_ERROR, "There must be no extraword for MLP.\n");
1201  goto error;
1202  }
1203  skip_bits(&gb, 16);
1204  substr_header_size += 2;
1205  }
1206 
1207  if (length < header_size + substr_header_size) {
1208  av_log(m->avctx, AV_LOG_ERROR, "Insufficient data for headers\n");
1209  goto error;
1210  }
1211 
1212  if (!(nonrestart_substr ^ m->is_major_sync_unit)) {
1213  av_log(m->avctx, AV_LOG_ERROR, "Invalid nonrestart_substr.\n");
1214  goto error;
1215  }
1216 
1217  if (end + header_size + substr_header_size > length) {
1219  "Indicated length of substream %d data goes off end of "
1220  "packet.\n", substr);
1221  end = length - header_size - substr_header_size;
1222  }
1223 
1224  if (end < substream_start) {
1225  av_log(avctx, AV_LOG_ERROR,
1226  "Indicated end offset of substream %d data "
1227  "is smaller than calculated start offset.\n",
1228  substr);
1229  goto error;
1230  }
1231 
1232  if (substr > m->max_decoded_substream)
1233  continue;
1234 
1235  substream_parity_present[substr] = checkdata_present;
1236  substream_data_len[substr] = end - substream_start;
1237  substream_start = end;
1238  }
1239 
1240  parity_bits = ff_mlp_calculate_parity(buf, 4);
1241  parity_bits ^= ff_mlp_calculate_parity(buf + header_size, substr_header_size);
1242 
1243  if ((((parity_bits >> 4) ^ parity_bits) & 0xF) != 0xF) {
1244  av_log(avctx, AV_LOG_ERROR, "Parity check failed.\n");
1245  goto error;
1246  }
1247 
1248  buf += header_size + substr_header_size;
1249 
1250  for (substr = 0; substr <= m->max_decoded_substream; substr++) {
1251  SubStream *s = &m->substream[substr];
1252 
1253  if (substr != m->max_decoded_substream &&
1255  m->substream[m->max_decoded_substream].max_channel == avctx->channels - 1)
1256  goto skip_substr;
1257 
1258  init_get_bits(&gb, buf, substream_data_len[substr] * 8);
1259 
1260  m->matrix_changed = 0;
1261  memset(m->filter_changed, 0, sizeof(m->filter_changed));
1262 
1263  s->blockpos = 0;
1264  do {
1265  if (get_bits1(&gb)) {
1266  if (get_bits1(&gb)) {
1267  /* A restart header should be present. */
1268  if (read_restart_header(m, &gb, buf, substr) < 0)
1269  goto next_substr;
1270  s->restart_seen = 1;
1271  }
1272 
1273  if (!s->restart_seen)
1274  goto next_substr;
1275  if (read_decoding_params(m, &gb, substr) < 0)
1276  goto next_substr;
1277  }
1278 
1279  if (!s->restart_seen)
1280  goto next_substr;
1281 
1282  if ((ret = read_block_data(m, &gb, substr)) < 0)
1283  return ret;
1284 
1285  if (get_bits_count(&gb) >= substream_data_len[substr] * 8)
1286  goto substream_length_mismatch;
1287 
1288  } while (!get_bits1(&gb));
1289 
1290  skip_bits(&gb, (-get_bits_count(&gb)) & 15);
1291 
1292  if (substream_data_len[substr] * 8 - get_bits_count(&gb) >= 32) {
1293  int shorten_by;
1294 
1295  if (get_bits(&gb, 16) != 0xD234)
1296  return AVERROR_INVALIDDATA;
1297 
1298  shorten_by = get_bits(&gb, 16);
1299  if (m->avctx->codec_id == AV_CODEC_ID_TRUEHD && shorten_by & 0x2000)
1300  s->blockpos -= FFMIN(shorten_by & 0x1FFF, s->blockpos);
1301  else if (m->avctx->codec_id == AV_CODEC_ID_MLP && shorten_by != 0xD234)
1302  return AVERROR_INVALIDDATA;
1303 
1304  av_log(m->avctx, AV_LOG_DEBUG, "End of stream indicated.\n");
1305  s->end_of_stream = 1;
1306  }
1307 
1308  if (substream_parity_present[substr]) {
1309  uint8_t parity, checksum;
1310 
1311  if (substream_data_len[substr] * 8 - get_bits_count(&gb) != 16)
1312  goto substream_length_mismatch;
1313 
1314  parity = ff_mlp_calculate_parity(buf, substream_data_len[substr] - 2);
1315  checksum = ff_mlp_checksum8 (buf, substream_data_len[substr] - 2);
1316 
1317  if ((get_bits(&gb, 8) ^ parity) != 0xa9 )
1318  av_log(m->avctx, AV_LOG_ERROR, "Substream %d parity check failed.\n", substr);
1319  if ( get_bits(&gb, 8) != checksum)
1320  av_log(m->avctx, AV_LOG_ERROR, "Substream %d checksum failed.\n" , substr);
1321  }
1322 
1323  if (substream_data_len[substr] * 8 != get_bits_count(&gb))
1324  goto substream_length_mismatch;
1325 
1326 next_substr:
1327  if (!s->restart_seen)
1329  "No restart header present in substream %d.\n", substr);
1330 
1331 skip_substr:
1332  buf += substream_data_len[substr];
1333  }
1334 
1335  if ((ret = output_data(m, m->max_decoded_substream, data, got_frame_ptr)) < 0)
1336  return ret;
1337 
1338  for (substr = 0; substr <= m->max_decoded_substream; substr++){
1339  SubStream *s = &m->substream[substr];
1340 
1341  if (s->end_of_stream) {
1342  s->lossless_check_data = 0xffffffff;
1343  s->end_of_stream = 0;
1344  m->params_valid = 0;
1345  }
1346  }
1347 
1348  return length;
1349 
1350 substream_length_mismatch:
1351  av_log(m->avctx, AV_LOG_ERROR, "substream %d length mismatch\n", substr);
1352  return AVERROR_INVALIDDATA;
1353 
1354 error:
1355  m->params_valid = 0;
1356  return AVERROR_INVALIDDATA;
1357 }
1358 
1360 {
1361  MLPDecodeContext *m = avctx->priv_data;
1362 
1363  m->params_valid = 0;
1364  for (int substr = 0; substr <= m->max_decoded_substream; substr++){
1365  SubStream *s = &m->substream[substr];
1366 
1367  s->lossless_check_data = 0xffffffff;
1368  s->prev_matrix_encoding = 0;
1369  }
1370 }
1371 
1372 #if CONFIG_MLP_DECODER
1373 const AVCodec ff_mlp_decoder = {
1374  .name = "mlp",
1375  .long_name = NULL_IF_CONFIG_SMALL("MLP (Meridian Lossless Packing)"),
1376  .type = AVMEDIA_TYPE_AUDIO,
1377  .id = AV_CODEC_ID_MLP,
1378  .priv_data_size = sizeof(MLPDecodeContext),
1379  .init = mlp_decode_init,
1382  .capabilities = AV_CODEC_CAP_DR1 | AV_CODEC_CAP_CHANNEL_CONF,
1383  .caps_internal = FF_CODEC_CAP_INIT_THREADSAFE,
1384 };
1385 #endif
1386 #if CONFIG_TRUEHD_DECODER
1387 const AVCodec ff_truehd_decoder = {
1388  .name = "truehd",
1389  .long_name = NULL_IF_CONFIG_SMALL("TrueHD"),
1390  .type = AVMEDIA_TYPE_AUDIO,
1391  .id = AV_CODEC_ID_TRUEHD,
1392  .priv_data_size = sizeof(MLPDecodeContext),
1393  .init = mlp_decode_init,
1396  .capabilities = AV_CODEC_CAP_DR1 | AV_CODEC_CAP_CHANNEL_CONF,
1397  .caps_internal = FF_CODEC_CAP_INIT_THREADSAFE,
1398 };
1399 #endif /* CONFIG_TRUEHD_DECODER */
MLPDecodeContext::params_valid
uint8_t params_valid
Set if a valid major sync block has been read. Otherwise no decoding is possible.
Definition: mlpdec.c:144
error
static void error(const char *err)
Definition: target_bsf_fuzzer.c:31
AVCodecContext::frame_size
int frame_size
Number of samples per channel in an audio frame.
Definition: avcodec.h:1012
PARAM_QUANTSTEP
#define PARAM_QUANTSTEP
Definition: mlpdec.c:94
AVCodec
AVCodec.
Definition: codec.h:202
AV_LOG_WARNING
#define AV_LOG_WARNING
Something somehow does not look correct.
Definition: log.h:186
FF_CODEC_CAP_INIT_THREADSAFE
#define FF_CODEC_CAP_INIT_THREADSAFE
The codec does not modify any global variables in the init function, allowing to call the init functi...
Definition: internal.h:42
noise_table
static const int8_t noise_table[256]
Data table used for TrueHD noise generation function.
Definition: mlpdec.c:1002
AV_CH_LAYOUT_5POINT0_BACK
#define AV_CH_LAYOUT_5POINT0_BACK
Definition: channel_layout.h:102
init
static av_cold int init(AVCodecContext *avctx)
Definition: avrndec.c:31
show_bits_long
static unsigned int show_bits_long(GetBitContext *s, int n)
Show 0-32 bits.
Definition: get_bits.h:603
ChannelParams::codebook
uint8_t codebook
Which VLC codebook to use to read residuals.
Definition: mlp.h:92
PARAM_IIR
#define PARAM_IIR
Definition: mlpdec.c:96
xor_32_to_8
static uint8_t xor_32_to_8(uint32_t value)
XOR four bytes into one.
Definition: mlp.h:161
SubStream::matrix_coeff
int32_t matrix_coeff[MAX_MATRICES][MAX_CHANNELS]
Matrix coefficients, stored as 2.14 fixed point.
Definition: mlpdec.c:113
AVCodecContext::channel_layout
uint64_t channel_layout
Audio channel layout.
Definition: avcodec.h:1043
mem_internal.h
SubStream::prev_matrix_encoding
enum AVMatrixEncoding prev_matrix_encoding
Definition: mlpdec.c:76
AV_CH_TOP_FRONT_CENTER
#define AV_CH_TOP_FRONT_CENTER
Definition: channel_layout.h:62
AVCodecContext::sample_rate
int sample_rate
samples per second
Definition: avcodec.h:992
AV_CH_LOW_FREQUENCY_2
#define AV_CH_LOW_FREQUENCY_2
Definition: channel_layout.h:73
thd_channel_order
static const uint64_t thd_channel_order[]
Definition: mlpdec.c:172
thread.h
SubStream::end_of_stream
uint8_t end_of_stream
Set if end of stream is encountered.
Definition: mlpdec.c:57
AV_CH_LAYOUT_MONO
#define AV_CH_LAYOUT_MONO
Definition: channel_layout.h:90
get_bits_long
static unsigned int get_bits_long(GetBitContext *s, int n)
Read 0-32 bits.
Definition: get_bits.h:547
SubStream::output_shift
int8_t output_shift[MAX_CHANNELS]
Left shift to apply to decoded PCM values to get final 24-bit output.
Definition: mlpdec.c:127
THD_CH_MODIFIER_SURROUNDEX
@ THD_CH_MODIFIER_SURROUNDEX
Definition: mlp.h:175
get_bits_count
static int get_bits_count(const GetBitContext *s)
Definition: get_bits.h:220
read_decoding_params
static int read_decoding_params(MLPDecodeContext *m, GetBitContext *gbp, unsigned int substr)
Read decoding parameters that change more often than those in the restart header.
Definition: mlpdec.c:850
MAX_SAMPLERATE
#define MAX_SAMPLERATE
maximum sample frequency seen in files
Definition: mlp.h:54
AV_CH_TOP_FRONT_RIGHT
#define AV_CH_TOP_FRONT_RIGHT
Definition: channel_layout.h:63
init_static
static av_cold void init_static(void)
Initialize static data, constant between all invocations of the codec.
Definition: mlpdec.c:211
AVFrame
This structure describes decoded (raw) audio or video data.
Definition: frame.h:303
tmp
static uint8_t tmp[11]
Definition: aes_ctr.c:26
index
fg index
Definition: ffmpeg_filter.c:168
internal.h
AVPacket::data
uint8_t * data
Definition: packet.h:373
ff_mlp_calculate_parity
uint8_t ff_mlp_calculate_parity(const uint8_t *buf, unsigned int buf_size)
XOR together all the bytes of a buffer.
Definition: mlp.c:124
init_vlc
#define init_vlc(vlc, nb_bits, nb_codes, bits, bits_wrap, bits_size, codes, codes_wrap, codes_size, flags)
Definition: vlc.h:38
mh
#define mh
Definition: vf_colormatrix.c:107
table
static const uint16_t table[]
Definition: prosumer.c:206
data
const char data[16]
Definition: mxf.c:143
filter_channel
static void filter_channel(MLPDecodeContext *m, unsigned int substr, unsigned int channel)
Generate PCM samples using the prediction filters and residual values read from the data stream,...
Definition: mlpdec.c:933
SubStream::restart_seen
uint8_t restart_seen
Set if a valid restart header has been read. Otherwise the substream cannot be decoded.
Definition: mlpdec.c:55
get_vlc2
static av_always_inline int get_vlc2(GetBitContext *s, VLC_TYPE(*table)[2], int bits, int max_depth)
Parse a vlc code.
Definition: get_bits.h:798
output_data
static int output_data(MLPDecodeContext *m, unsigned int substr, AVFrame *frame, int *got_frame_ptr)
Write the audio data into the output buffer.
Definition: mlpdec.c:1068
SubStream::mask
uint64_t mask
The channel layout for this substream.
Definition: mlpdec.c:73
SubStream::min_channel
uint8_t min_channel
The index of the first channel coded in this substream.
Definition: mlpdec.c:65
AV_CH_TOP_FRONT_LEFT
#define AV_CH_TOP_FRONT_LEFT
Definition: channel_layout.h:61
MLPDecodeContext::major_sync_header_size
int major_sync_header_size
Size of the major sync unit, in bytes.
Definition: mlpdec.c:141
SubStream
Definition: mlpdec.c:53
filter
filter_frame For filters that do not use the this method is called when a frame is pushed to the filter s input It can be called at any time except in a reentrant way If the input frame is enough to produce then the filter should push the output frames on the output link immediately As an exception to the previous rule if the input frame is enough to produce several output frames then the filter needs output only at least one per link The additional frames can be left buffered in the filter
Definition: filter_design.txt:228
AVCodecContext::request_channel_layout
uint64_t request_channel_layout
Request decoder to use this channel layout if it can (0 for default)
Definition: avcodec.h:1050
AV_CODEC_ID_TRUEHD
@ AV_CODEC_ID_TRUEHD
Definition: codec_id.h:467
AV_CH_WIDE_LEFT
#define AV_CH_WIDE_LEFT
Definition: channel_layout.h:69
ff_mlpdsp_init
av_cold void ff_mlpdsp_init(MLPDSPContext *c)
Definition: mlpdsp.c:128
init_get_bits
static int init_get_bits(GetBitContext *s, const uint8_t *buffer, int bit_size)
Initialize GetBitContext.
Definition: get_bits.h:660
SubStream::max_channel
uint8_t max_channel
The index of the last channel coded in this substream.
Definition: mlpdec.c:67
SubStream::ch_assign
uint8_t ch_assign[MAX_CHANNELS]
For each channel output by the matrix, the output channel to map it to.
Definition: mlpdec.c:71
AV_CH_SURROUND_DIRECT_RIGHT
#define AV_CH_SURROUND_DIRECT_RIGHT
Definition: channel_layout.h:72
AV_CH_WIDE_RIGHT
#define AV_CH_WIDE_RIGHT
Definition: channel_layout.h:70
MLPDSPContext::mlp_pack_output
int32_t(* mlp_pack_output)(int32_t lossless_check_data, uint16_t blockpos, int32_t(*sample_buffer)[MAX_CHANNELS], void *data, uint8_t *ch_assign, int8_t *output_shift, uint8_t max_matrix_channel, int is32)
Definition: mlpdsp.h:69
crc.h
skip_bits
static void skip_bits(GetBitContext *s, int n)
Definition: get_bits.h:468
get_bits
static unsigned int get_bits(GetBitContext *s, int n)
Read 1-25 bits.
Definition: get_bits.h:380
ChannelParams::filter_params
FilterParams filter_params[NUM_FILTERS]
Definition: mlp.h:87
ff_mlp_checksum8
uint8_t ff_mlp_checksum8(const uint8_t *buf, unsigned int buf_size)
MLP uses checksums that seem to be based on the standard CRC algorithm, but are not (in implementatio...
Definition: mlp.c:98
VLC_TYPE
#define VLC_TYPE
Definition: vlc.h:24
fail
#define fail()
Definition: checkasm.h:127
MAX_MATRICES
#define MAX_MATRICES
Definition: mlp.h:44
ChannelParams::huff_lsbs
uint8_t huff_lsbs
Size of residual suffix not encoded using VLC.
Definition: mlp.h:93
GetBitContext
Definition: get_bits.h:62
AV_CH_BACK_LEFT
#define AV_CH_BACK_LEFT
Definition: channel_layout.h:53
MAX_IIR_ORDER
#define MAX_IIR_ORDER
Definition: mlp.h:66
SYNC_TRUEHD
#define SYNC_TRUEHD
Definition: mlp.h:28
calculate_sign_huff
static int32_t calculate_sign_huff(MLPDecodeContext *m, unsigned int substr, unsigned int ch)
Definition: mlpdec.c:225
AV_CH_LAYOUT_STEREO
#define AV_CH_LAYOUT_STEREO
Definition: channel_layout.h:91
AV_CH_LAYOUT_QUAD
#define AV_CH_LAYOUT_QUAD
Definition: channel_layout.h:99
MAX_MATRICES_MLP
#define MAX_MATRICES_MLP
Maximum number of matrices used in decoding; most streams have one matrix per output channel,...
Definition: mlp.h:42
ff_thread_once
static int ff_thread_once(char *control, void(*routine)(void))
Definition: thread.h:175
AV_LOG_ERROR
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
Definition: log.h:180
MLPDecodeContext::needs_reordering
uint8_t needs_reordering
Stream needs channel reordering to comply with FFmpeg's channel order.
Definition: mlpdec.c:153
FIR
#define FIR
Definition: mlp.h:71
FF_ARRAY_ELEMS
#define FF_ARRAY_ELEMS(a)
Definition: sinewin_tablegen.c:29
av_cold
#define av_cold
Definition: attributes.h:90
AV_MATRIX_ENCODING_DOLBY
@ AV_MATRIX_ENCODING_DOLBY
Definition: channel_layout.h:122
MLPDecodeContext::dsp
MLPDSPContext dsp
Definition: mlpdec.c:169
SubStream::channel_params
ChannelParams channel_params[MAX_CHANNELS]
Channel coding parameters for channels in the substream.
Definition: mlpdec.c:79
AV_CH_LOW_FREQUENCY
#define AV_CH_LOW_FREQUENCY
Definition: channel_layout.h:52
mask
static const uint16_t mask[17]
Definition: lzw.c:38
PARAM_MATRIX
#define PARAM_MATRIX
Definition: mlpdec.c:92
decode
static void decode(AVCodecContext *dec_ctx, AVPacket *pkt, AVFrame *frame, FILE *outfile)
Definition: decode_audio.c:71
intreadwrite.h
s
#define s(width, name)
Definition: cbs_vp9.c:257
PARAM_FIR
#define PARAM_FIR
Definition: mlpdec.c:95
MLPDecodeContext::matrix_changed
int matrix_changed
Definition: mlpdec.c:162
AVMEDIA_TYPE_AUDIO
@ AVMEDIA_TYPE_AUDIO
Definition: avutil.h:202
MLPDSPContext::mlp_filter_channel
void(* mlp_filter_channel)(int32_t *state, const int32_t *coeff, int firorder, int iirorder, unsigned int filter_shift, int32_t mask, int blocksize, int32_t *sample_buffer)
Definition: mlpdsp.h:50
av_assert0
#define av_assert0(cond)
assert() equivalent, that is always enabled.
Definition: avassert.h:37
AVCodecContext::bits_per_raw_sample
int bits_per_raw_sample
Bits per sample/pixel of internal libavcodec pixel/sample format.
Definition: avcodec.h:1425
get_sbits
static int get_sbits(GetBitContext *s, int n)
Definition: get_bits.h:360
AV_LOG_DEBUG
#define AV_LOG_DEBUG
Stuff which is only useful for libav* developers.
Definition: log.h:201
get_bits.h
THD_CH_MODIFIER_LTRT
@ THD_CH_MODIFIER_LTRT
Definition: mlp.h:171
MLPDSPContext::mlp_select_pack_output
int32_t(*(* mlp_select_pack_output)(uint8_t *ch_assign, int8_t *output_shift, uint8_t max_matrix_channel, int is32))(int32_t
Definition: mlpdsp.h:65
AVCodecContext::codec_id
enum AVCodecID codec_id
Definition: avcodec.h:393
if
if(ret)
Definition: filter_design.txt:179
AVMatrixEncoding
AVMatrixEncoding
Definition: channel_layout.h:120
AV_MATRIX_ENCODING_DOLBYHEADPHONE
@ AV_MATRIX_ENCODING_DOLBYHEADPHONE
Definition: channel_layout.h:127
AV_ONCE_INIT
#define AV_ONCE_INIT
Definition: thread.h:173
result
and forward the result(frame or status change) to the corresponding input. If nothing is possible
AV_CH_TOP_CENTER
#define AV_CH_TOP_CENTER
Definition: channel_layout.h:60
flush
static void flush(AVCodecContext *avctx)
Definition: aacdec_template.c:593
AVERROR_PATCHWELCOME
#define AVERROR_PATCHWELCOME
Not yet implemented in FFmpeg, patches welcome.
Definition: error.h:64
thd_channel_layout_extract_channel
static uint64_t thd_channel_layout_extract_channel(uint64_t channel_layout, int index)
Definition: mlpdec.c:193
SubStream::lossless_check_data
int32_t lossless_check_data
Running XOR of all output samples.
Definition: mlpdec.c:130
MLPDecodeContext::bypassed_lsbs
int8_t bypassed_lsbs[MAX_BLOCKSIZE][MAX_CHANNELS]
Definition: mlpdec.c:166
SubStream::quant_step_size
uint8_t quant_step_size[MAX_CHANNELS]
Left shift to apply to Huffman-decoded residuals.
Definition: mlpdec.c:119
get_bits1
static unsigned int get_bits1(GetBitContext *s)
Definition: get_bits.h:499
quant_step_size
static const float quant_step_size[]
Definition: hca_data.h:125
INIT_VLC_USE_NEW_STATIC
#define INIT_VLC_USE_NEW_STATIC
Definition: vlc.h:95
MLPDecodeContext::filter_changed
int filter_changed[MAX_CHANNELS][NUM_FILTERS]
Definition: mlpdec.c:163
AV_CH_FRONT_CENTER
#define AV_CH_FRONT_CENTER
Definition: channel_layout.h:51
fp
#define fp
Definition: regdef.h:44
seed
static unsigned int seed
Definition: videogen.c:78
AV_CH_FRONT_LEFT_OF_CENTER
#define AV_CH_FRONT_LEFT_OF_CENTER
Definition: channel_layout.h:55
AVOnce
#define AVOnce
Definition: thread.h:172
MLPDecodeContext::access_unit_size
int access_unit_size
number of PCM samples contained in each frame
Definition: mlpdec.c:156
av_get_channel_layout_nb_channels
int av_get_channel_layout_nb_channels(uint64_t channel_layout)
Return the number of channels in the channel layout.
Definition: channel_layout.c:226
SubStream::max_matrix_channel
uint8_t max_matrix_channel
The number of channels input into the rematrix stage.
Definition: mlpdec.c:69
THD_CH_MODIFIER_LBINRBIN
@ THD_CH_MODIFIER_LBINRBIN
Definition: mlp.h:172
AV_CODEC_CAP_CHANNEL_CONF
#define AV_CODEC_CAP_CHANNEL_CONF
Codec should fill in channel configuration and samplerate instead of container.
Definition: codec.h:109
FilterParams
filter data
Definition: mlp.h:75
VLC::table_allocated
int table_allocated
Definition: vlc.h:29
MLPDecodeContext::sample_buffer
int32_t sample_buffer[MAX_BLOCKSIZE][MAX_CHANNELS]
Definition: mlpdec.c:167
huff_vlc
static VLC huff_vlc[3]
Definition: mlpdec.c:207
ff_mlp_restart_checksum
uint8_t ff_mlp_restart_checksum(const uint8_t *buf, unsigned int bit_size)
Calculate an 8-bit checksum over a restart header – a non-multiple-of-8 number of bits,...
Definition: mlp.c:105
ff_get_buffer
int ff_get_buffer(AVCodecContext *avctx, AVFrame *frame, int flags)
Get a buffer for a frame.
Definition: decode.c:1652
AV_CODEC_CAP_DR1
#define AV_CODEC_CAP_DR1
Codec uses get_buffer() or get_encode_buffer() for allocating buffers and supports custom allocators.
Definition: codec.h:52
AVPacket::size
int size
Definition: packet.h:374
MAX_MATRIX_CHANNEL_MLP
#define MAX_MATRIX_CHANNEL_MLP
Last possible matrix channel for each codec.
Definition: mlp.h:31
NULL_IF_CONFIG_SMALL
#define NULL_IF_CONFIG_SMALL(x)
Return NULL if CONFIG_SMALL is true, otherwise the argument without modification.
Definition: internal.h:117
SubStream::noise_type
uint16_t noise_type
restart header data
Definition: mlpdec.c:62
MLPDecodeContext::num_substreams
uint8_t num_substreams
Number of substreams contained within this stream.
Definition: mlpdec.c:147
MLPDecodeContext::avctx
AVCodecContext * avctx
Definition: mlpdec.c:135
MLPDecodeContext::substream
SubStream substream[MAX_SUBSTREAMS]
Definition: mlpdec.c:160
MSB_MASK
#define MSB_MASK(bits)
Definition: mlpdec.c:928
AV_MATRIX_ENCODING_NONE
@ AV_MATRIX_ENCODING_NONE
Definition: channel_layout.h:121
AVCodecContext::sample_fmt
enum AVSampleFormat sample_fmt
audio sample format
Definition: avcodec.h:1000
mlpdsp.h
MAX_SUBSTREAMS
#define MAX_SUBSTREAMS
Maximum number of substreams that can be decoded.
Definition: mlp.h:49
MLPDecodeContext::is_major_sync_unit
int is_major_sync_unit
Current access unit being read has a major sync.
Definition: mlpdec.c:138
MAX_MATRIX_CHANNEL_TRUEHD
#define MAX_MATRIX_CHANNEL_TRUEHD
Definition: mlp.h:32
mlp_decode_init
static av_cold int mlp_decode_init(AVCodecContext *avctx)
Definition: mlpdec.c:282
ff_mlp_decoder
const AVCodec ff_mlp_decoder
parity
mcdeint parity
Definition: vf_mcdeint.c:266
MAX_MATRICES_TRUEHD
#define MAX_MATRICES_TRUEHD
Definition: mlp.h:43
NUM_FILTERS
#define NUM_FILTERS
number of allowed filters
Definition: mlp.h:62
FilterParams::order
uint8_t order
number of taps in filter
Definition: mlp.h:76
MLPDecodeContext
Definition: mlpdec.c:134
ff_mlp_read_major_sync
int ff_mlp_read_major_sync(void *log, MLPHeaderInfo *mh, GetBitContext *gb)
Read a major sync info header - contains high level information about the stream - sample rate,...
Definition: mlp_parse.c:86
AV_CH_LAYOUT_5POINT1_BACK
#define AV_CH_LAYOUT_5POINT1_BACK
Definition: channel_layout.h:103
ChannelParams::huff_offset
int16_t huff_offset
Offset to apply to residual values.
Definition: mlp.h:90
skip_bits1
static void skip_bits1(GetBitContext *s)
Definition: get_bits.h:539
AV_CH_FRONT_RIGHT_OF_CENTER
#define AV_CH_FRONT_RIGHT_OF_CENTER
Definition: channel_layout.h:56
SubStream::noisegen_seed
uint32_t noisegen_seed
The current seed value for the pseudorandom noise generator(s).
Definition: mlpdec.c:84
MLPDecodeContext::max_decoded_substream
uint8_t max_decoded_substream
Index of the last substream to decode - further substreams are skipped.
Definition: mlpdec.c:150
SubStream::lsb_bypass
uint8_t lsb_bypass[MAX_MATRICES]
Whether the LSBs of the matrix output are encoded in the bitstream.
Definition: mlpdec.c:111
SubStream::matrix_out_ch
uint8_t matrix_out_ch[MAX_MATRICES]
matrix output channel
Definition: mlpdec.c:108
MAX_CHANNELS
#define MAX_CHANNELS
Definition: aac.h:48
MAX_FIR_ORDER
#define MAX_FIR_ORDER
The maximum number of taps in IIR and FIR filters.
Definition: mlp.h:65
MLPDSPContext::mlp_rematrix_channel
void(* mlp_rematrix_channel)(int32_t *samples, const int32_t *coeffs, const uint8_t *bypassed_lsbs, const int8_t *noise_buffer, int index, unsigned int dest_ch, uint16_t blockpos, unsigned int maxchan, int matrix_noise_shift, int access_unit_size_pow2, int32_t mask)
Definition: mlpdsp.h:54
mlp_channel_layout_subset
static int mlp_channel_layout_subset(uint64_t channel_layout, uint64_t mask)
Definition: mlpdec.c:188
AVCodecContext::channels
int channels
number of audio channels
Definition: avcodec.h:993
DECLARE_ALIGNED
#define DECLARE_ALIGNED(n, t, v)
Definition: mem.h:116
read_restart_header
static int read_restart_header(MLPDecodeContext *m, GetBitContext *gbp, const uint8_t *buf, unsigned int substr)
Read a restart header from a block in a substream.
Definition: mlpdec.c:479
mlp_parse.h
i
#define i(width, name, range_min, range_max)
Definition: cbs_h2645.c:271
SubStream::blockpos
uint16_t blockpos
Number of PCM samples decoded so far in this frame.
Definition: mlpdec.c:124
SubStream::noise_shift
uint8_t noise_shift
The left shift applied to random noise in 0x31ea substreams.
Definition: mlpdec.c:82
SubStream::blocksize
uint16_t blocksize
number of PCM samples in current audio block
Definition: mlpdec.c:122
internal.h
av_get_channel_layout_channel_index
int av_get_channel_layout_channel_index(uint64_t channel_layout, uint64_t channel)
Get the index of a channel in channel_layout.
Definition: channel_layout.c:239
AV_CH_BACK_CENTER
#define AV_CH_BACK_CENTER
Definition: channel_layout.h:57
FFMIN
#define FFMIN(a, b)
Definition: macros.h:49
MLPHeaderInfo
Definition: mlp_parse.h:30
AV_CH_FRONT_LEFT
#define AV_CH_FRONT_LEFT
Definition: channel_layout.h:49
AV_SAMPLE_FMT_S16
@ AV_SAMPLE_FMT_S16
signed 16 bits
Definition: samplefmt.h:61
read_channel_params
static int read_channel_params(MLPDecodeContext *m, unsigned int substr, GetBitContext *gbp, unsigned int ch)
Read channel parameters.
Definition: mlpdec.c:793
AVCodec::name
const char * name
Name of the codec implementation.
Definition: codec.h:209
parser.h
ChannelParams
sample data coding information
Definition: mlp.h:86
AV_CH_SIDE_RIGHT
#define AV_CH_SIDE_RIGHT
Definition: channel_layout.h:59
MAX_BLOCKSIZE
#define MAX_BLOCKSIZE
Definition: diracdec.c:55
fill_noise_buffer
static void fill_noise_buffer(MLPDecodeContext *m, unsigned int substr)
Generate a block of noise, used when restart sync word == 0x31eb.
Definition: mlpdec.c:1051
ff_mlp_init_crc
av_cold void ff_mlp_init_crc(void)
Definition: mlp.c:83
ChannelParams::sign_huff_offset
int32_t sign_huff_offset
sign/rounding-corrected version of huff_offset
Definition: mlp.h:91
MLPDecodeContext::access_unit_size_pow2
int access_unit_size_pow2
next power of two above the number of samples in each frame
Definition: mlpdec.c:158
avcodec.h
PARAM_HUFFOFFSET
#define PARAM_HUFFOFFSET
Definition: mlpdec.c:97
ret
ret
Definition: filter_design.txt:187
FFSWAP
#define FFSWAP(type, a, b)
Definition: macros.h:52
frame
these buffered frames must be flushed immediately if a new input produces new the filter must not call request_frame to get more It must just process the frame or queue it The task of requesting more frames is left to the filter s request_frame method or the application If a filter has several the filter must be ready for frames arriving randomly on any input any filter with several inputs will most likely require some kind of queuing mechanism It is perfectly acceptable to have a limited queue and to drop frames when the inputs are too unbalanced request_frame For filters that do not use the this method is called when a frame is wanted on an output For a it should directly call filter_frame on the corresponding output For a if there are queued frames already one of these frames should be pushed If the filter should request a frame on one of its repeatedly until at least one frame has been pushed Return or at least make progress towards producing a frame
Definition: filter_design.txt:264
mlp_decode_flush
static void mlp_decode_flush(AVCodecContext *avctx)
Definition: mlpdec.c:1359
SubStream::num_primitive_matrices
uint8_t num_primitive_matrices
matrix data
Definition: mlpdec.c:105
pos
unsigned int pos
Definition: spdifenc.c:412
checksum
static volatile int checksum
Definition: adler32.c:30
FilterParams::state
int32_t state[MAX_FIR_ORDER]
Definition: mlp.h:79
SYNC_MLP
#define SYNC_MLP
Definition: mlp.h:27
PARAM_PRESENCE
#define PARAM_PRESENCE
Definition: mlpdec.c:98
SubStream::data_check_present
uint8_t data_check_present
Set if the substream contains extra info to check the size of VLC blocks.
Definition: mlpdec.c:87
vlc_buf
static VLC_TYPE vlc_buf[16716][2]
Definition: clearvideo.c:86
SubStream::matrix_noise_shift
uint8_t matrix_noise_shift[MAX_MATRICES]
Left shift to apply to noise values in 0x31eb substreams.
Definition: mlpdec.c:115
AVCodecContext
main external API structure.
Definition: avcodec.h:383
PARAM_OUTSHIFT
#define PARAM_OUTSHIFT
Definition: mlpdec.c:93
ff_truehd_decoder
const AVCodec ff_truehd_decoder
VLC_BITS
#define VLC_BITS
number of bits used for VLC lookup - longest Huffman code is 9
Definition: mlpdec.c:49
PARAM_BLOCKSIZE
#define PARAM_BLOCKSIZE
Definition: mlpdec.c:91
THD_CH_MODIFIER_STEREO
@ THD_CH_MODIFIER_STEREO
Definition: mlp.h:170
channel_layout.h
read_access_unit
static int read_access_unit(AVCodecContext *avctx, void *data, int *got_frame_ptr, AVPacket *avpkt)
Read an access unit from the stream.
Definition: mlpdec.c:1143
VLC_STATIC_SIZE
#define VLC_STATIC_SIZE
Definition: mlpdec.c:50
AV_MATRIX_ENCODING_DOLBYEX
@ AV_MATRIX_ENCODING_DOLBYEX
Definition: channel_layout.h:126
VLC
Definition: vlc.h:26
IIR
#define IIR
Definition: mlp.h:72
AV_CH_SURROUND_DIRECT_LEFT
#define AV_CH_SURROUND_DIRECT_LEFT
Definition: channel_layout.h:71
AV_CH_FRONT_RIGHT
#define AV_CH_FRONT_RIGHT
Definition: channel_layout.h:50
ff_side_data_update_matrix_encoding
int ff_side_data_update_matrix_encoding(AVFrame *frame, enum AVMatrixEncoding matrix_encoding)
Add or update AV_FRAME_DATA_MATRIXENCODING side data.
Definition: utils.c:116
read_filter_params
static int read_filter_params(MLPDecodeContext *m, GetBitContext *gbp, unsigned int substr, unsigned int channel, unsigned int filter)
Read parameters for one of the prediction filters.
Definition: mlpdec.c:650
read_huff_channels
static int read_huff_channels(MLPDecodeContext *m, GetBitContext *gbp, unsigned int substr, unsigned int pos)
Read a sample, consisting of either, both or neither of entropy-coded MSBs and plain LSBs.
Definition: mlpdec.c:246
avpriv_request_sample
#define avpriv_request_sample(...)
Definition: tableprint_vlc.h:37
read_major_sync
static int read_major_sync(MLPDecodeContext *m, GetBitContext *gb)
Read a major sync info header - contains high level information about the stream - sample rate,...
Definition: mlpdec.c:303
mlp.h
ff_mlp_huffman_tables
const uint8_t ff_mlp_huffman_tables[3][18][2]
Tables defining the Huffman codes.
Definition: mlp.c:30
SubStream::param_presence_flags
uint8_t param_presence_flags
Bitmask of which parameter sets are conveyed in a decoding parameter block.
Definition: mlpdec.c:90
AVPacket
This structure stores compressed data.
Definition: packet.h:350
AVCodecContext::priv_data
void * priv_data
Definition: avcodec.h:410
int32_t
int32_t
Definition: audioconvert.c:56
av_log
#define av_log(a,...)
Definition: tableprint_vlc.h:28
read_matrix_params
static int read_matrix_params(MLPDecodeContext *m, unsigned int substr, GetBitContext *gbp)
Read parameters for primitive matrices.
Definition: mlpdec.c:725
AVERROR_INVALIDDATA
#define AVERROR_INVALIDDATA
Invalid data found when processing input.
Definition: error.h:61
AV_CH_BACK_RIGHT
#define AV_CH_BACK_RIGHT
Definition: channel_layout.h:54
MLPDSPContext
Definition: mlpdsp.h:49
FilterParams::shift
uint8_t shift
Right shift to apply to output of filter.
Definition: mlp.h:77
AV_SAMPLE_FMT_S32
@ AV_SAMPLE_FMT_S32
signed 32 bits
Definition: samplefmt.h:62
VLC::table
VLC_TYPE(* table)[2]
code, bits
Definition: vlc.h:28
generate_2_noise_channels
static void generate_2_noise_channels(MLPDecodeContext *m, unsigned int substr)
Noise generation functions.
Definition: mlpdec.c:1031
SubStream::matrix_encoding
enum AVMatrixEncoding matrix_encoding
The matrix encoding mode for this substream.
Definition: mlpdec.c:75
channel
channel
Definition: ebur128.h:39
MAX_BLOCKSIZE_POW2
#define MAX_BLOCKSIZE_POW2
next power of two greater than MAX_BLOCKSIZE
Definition: mlp.h:59
MLPDecodeContext::noise_buffer
int8_t noise_buffer[MAX_BLOCKSIZE_POW2]
Definition: mlpdec.c:165
codebook
static const unsigned codebook[256][2]
Definition: cfhdenc.c:42
AV_CODEC_ID_MLP
@ AV_CODEC_ID_MLP
Definition: codec_id.h:452
AV_CH_SIDE_LEFT
#define AV_CH_SIDE_LEFT
Definition: channel_layout.h:58
AV_RB16
uint64_t_TMPL AV_WL64 unsigned int_TMPL AV_WL32 unsigned int_TMPL AV_WL24 unsigned int_TMPL AV_WL16 uint64_t_TMPL AV_WB64 unsigned int_TMPL AV_WB32 unsigned int_TMPL AV_WB24 unsigned int_TMPL AV_RB16
Definition: bytestream.h:98
read_block_data
static int read_block_data(MLPDecodeContext *m, GetBitContext *gbp, unsigned int substr)
Read a block of PCM residual data (or actual if no filtering active).
Definition: mlpdec.c:960