31 #include "libavutil/intreadwrite.h"
32 #include "libavutil/channel_layout.h"
35 #include "libavutil/crc.h"
77 #define PARAM_BLOCKSIZE (1 << 7)
78 #define PARAM_MATRIX (1 << 6)
79 #define PARAM_OUTSHIFT (1 << 5)
80 #define PARAM_QUANTSTEP (1 << 4)
81 #define PARAM_FIR (1 << 3)
82 #define PARAM_IIR (1 << 2)
83 #define PARAM_HUFFOFFSET (1 << 1)
84 #define PARAM_PRESENCE (1 << 0)
191 if (!huff_vlc[0].
bits) {
207 unsigned int substr,
unsigned int ch)
216 sign_huff_offset -= 7 << lsb_bits;
219 sign_huff_offset -= 1 << sign_shift;
221 return sign_huff_offset;
228 unsigned int substr,
unsigned int pos)
231 unsigned int mat, channel;
237 for (channel = s->
min_channel; channel <= s->max_channel; channel++) {
241 int lsb_bits = cp->
huff_lsbs - quant_step_size;
252 result = (result << lsb_bits) +
get_bits(gbp, lsb_bits);
255 result <<= quant_step_size;
296 "Channel group 2 cannot have more bits per sample than group 1.\n");
302 "Channel groups with differing sample rates are not currently supported.\n");
312 "Sampling rate %d is greater than the supported maximum (%d).\n",
318 "Block size %d is greater than the supported maximum (%d).\n",
324 "Block size pow2 %d is greater than the supported maximum (%d).\n",
337 "%d substreams (more than the "
338 "maximum supported by the decoder)",
405 int min_channel, max_channel, max_matrix_channel;
412 if (sync_word != 0x31ea >> 1) {
414 "restart header sync incorrect (got 0x%04x)\n", sync_word);
429 max_matrix_channel =
get_bits(gbp, 4);
431 if (max_matrix_channel > std_max_matrix_channel) {
433 "Max matrix channel cannot be greater than %d.\n",
434 std_max_matrix_channel);
438 if (max_channel != max_matrix_channel) {
440 "Max channel must be equal max matrix channel.\n");
448 "%d channels (more than the "
449 "maximum supported by the decoder)",
454 if (min_channel > max_channel) {
456 "Substream min channel cannot be greater than max channel.\n");
464 #if FF_API_REQUEST_CHANNELS
470 "Extracting %d-channel downmix from substream %d. "
471 "Further substreams will be skipped.\n",
480 "Extracting %d-channel downmix (0x%"PRIx64
") from substream %d. "
481 "Further substreams will be skipped.\n",
496 if (tmp != lossless_check)
498 "Lossless check failed - expected %02x, calculated %02x.\n",
499 lossless_check, tmp);
516 "Assignment of matrix channel %d to invalid output channel %d",
537 for (ch = s->
min_channel; ch <= s->max_channel; ch++) {
576 unsigned int substr,
unsigned int channel,
582 const char fchar = filter ?
'I' :
'F';
594 if (order > max_order) {
596 "%cIR filter order %d is greater than maximum %d.\n",
597 fchar, order, max_order);
604 int coeff_bits, coeff_shift;
610 if (coeff_bits < 1 || coeff_bits > 16) {
612 "%cIR filter coeff_bits must be between 1 and 16.\n",
616 if (coeff_bits + coeff_shift > 16) {
618 "Sum of coeff_bits and coeff_shift for %cIR filter must be 16 or less.\n",
623 for (i = 0; i < order; i++)
624 fcoeff[i] =
get_sbits(gbp, coeff_bits) << coeff_shift;
627 int state_bits, state_shift;
631 "FIR filter has state data specified.\n");
640 for (i = 0; i < order; i++)
641 fp->
state[i] = state_bits ?
get_sbits(gbp, state_bits) << state_shift : 0;
653 unsigned int mat, ch;
667 "Number of primitive matrices cannot be greater than %d.\n",
668 max_primitive_matrices);
673 int frac_bits, max_chan;
680 "Invalid channel %d specified as output from matrix.\n",
684 if (frac_bits > 14) {
686 "Too many fractional bits specified.\n");
694 for (ch = 0; ch <= max_chan; ch++) {
697 coeff_val =
get_sbits(gbp, frac_bits + 2);
699 s->
matrix_coeff[mat][ch] = coeff_val << (14 - frac_bits);
740 "FIR and IIR filters must use the same precision.\n");
813 for (ch = s->
min_channel; ch <= s->max_channel; ch++)
821 #define MSB_MASK(bits) (-1u << bits)
827 unsigned int channel)
836 unsigned int filter_shift = fir->
shift;
857 unsigned int i, ch, expected_stream_pos = 0;
862 expected_stream_pos +=
get_bits(gbp, 16);
864 "Substreams with VLC block size check info");
879 for (ch = s->
min_channel; ch <= s->max_channel; ch++)
896 30, 51, 22, 54, 3, 7, -4, 38, 14, 55, 46, 81, 22, 58, -3, 2,
897 52, 31, -7, 51, 15, 44, 74, 30, 85, -17, 10, 33, 18, 80, 28, 62,
898 10, 32, 23, 69, 72, 26, 35, 17, 73, 60, 8, 56, 2, 6, -2, -5,
899 51, 4, 11, 50, 66, 76, 21, 44, 33, 47, 1, 26, 64, 48, 57, 40,
900 38, 16, -10, -28, 92, 22, -18, 29, -10, 5, -13, 49, 19, 24, 70, 34,
901 61, 48, 30, 14, -6, 25, 58, 33, 42, 60, 67, 17, 54, 17, 22, 30,
902 67, 44, -9, 50, -11, 43, 40, 32, 59, 82, 13, 49, -14, 55, 60, 36,
903 48, 49, 31, 47, 15, 12, 4, 65, 1, 23, 29, 39, 45, -2, 84, 69,
904 0, 72, 37, 57, 27, 41, -15, -16, 35, 31, 14, 61, 24, 0, 27, 24,
905 16, 41, 55, 34, 53, 9, 56, 12, 25, 29, 53, 5, 20, -20, -8, 20,
906 13, 28, -3, 78, 38, 16, 11, 62, 46, 29, 21, 24, 46, 65, 43, -23,
907 89, 18, 74, 21, 38, -12, 19, 12, -19, 8, 15, 33, 4, 57, 9, -8,
908 36, 35, 26, 28, 7, 83, 63, 79, 75, 11, 3, 87, 37, 47, 34, 40,
909 39, 19, 20, 42, 27, 34, 39, 77, 13, 42, 59, 64, 45, -1, 32, 37,
910 45, -5, 53, -6, 7, 36, 50, 23, 6, 32, 9, -21, 18, 71, 27, 52,
911 -25, 31, 35, 42, -1, 68, 63, 52, 26, 43, 66, 37, 41, 25, 40, 70,
932 uint16_t seed_shr7 = seed >> 7;
936 seed = (seed << 16) ^ seed_shr7 ^ (seed_shr7 << 5);
951 uint8_t seed_shr15 = seed >> 15;
953 seed = (seed << 8) ^ seed_shr15 ^ (seed_shr15 << 5);
966 unsigned int mat, src_ch, i;
967 unsigned int maxchan;
983 int index2 = 2 * index + 1;
992 for (src_ch = 0; src_ch <= maxchan; src_ch++)
993 accum += (int64_t) samples[src_ch] * coeffs[src_ch];
995 if (matrix_noise_shift) {
1001 samples[dest_ch] = ((accum >> 14) & mask) + bypassed_lsb;
1013 unsigned int i, out_ch = 0;
1034 data_16 = (int16_t *)frame->
data[0];
1036 for (i = 0; i < s->
blockpos; i++) {
1042 if (is32) *data_32++ = sample << 8;
1043 else *data_16++ = sample >> 8;
1057 int *got_frame_ptr,
AVPacket *avpkt)
1060 int buf_size = avpkt->
size;
1063 unsigned int length, substr;
1064 unsigned int substream_start;
1065 unsigned int header_size = 4;
1066 unsigned int substr_header_size = 0;
1075 length = (
AV_RB16(buf) & 0xfff) * 2;
1077 if (length < 4 || length > buf_size)
1092 "Stream parameters not seen; skipping frame.\n");
1097 substream_start = 0;
1100 int extraword_present, checkdata_present,
end, nonrestart_substr;
1109 substr_header_size += 2;
1111 if (extraword_present) {
1117 substr_header_size += 2;
1125 if (end + header_size + substr_header_size > length) {
1127 "Indicated length of substream %d data goes off end of "
1128 "packet.\n", substr);
1129 end = length - header_size - substr_header_size;
1132 if (end < substream_start) {
1134 "Indicated end offset of substream %d data "
1135 "is smaller than calculated start offset.\n",
1143 substream_parity_present[substr] = checkdata_present;
1144 substream_data_len[substr] = end - substream_start;
1145 substream_start =
end;
1151 if ((((parity_bits >> 4) ^ parity_bits) & 0xF) != 0xF) {
1156 buf += header_size + substr_header_size;
1188 goto substream_length_mismatch;
1194 if (substream_data_len[substr] * 8 -
get_bits_count(&gb) >= 32) {
1210 if (substream_parity_present[substr]) {
1214 goto substream_length_mismatch;
1219 if ((
get_bits(&gb, 8) ^ parity) != 0xa9 )
1226 goto substream_length_mismatch;
1231 "No restart header present in substream %d.\n", substr);
1233 buf += substream_data_len[substr];
1243 substream_length_mismatch:
1252 #if CONFIG_MLP_DECODER
1264 #if CONFIG_TRUEHD_DECODER
uint8_t shift
Right shift to apply to output of filter.
static const uint64_t thd_channel_order[]
static unsigned int show_bits_long(GetBitContext *s, int n)
Show 0-32 bits.
static const int16_t coeffs[28]
#define AVERROR_PATCHWELCOME
FilterParams filter_params[NUM_FILTERS]
This structure describes decoded (raw) audio or video data.
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. ...
#define AV_CH_TOP_FRONT_RIGHT
int8_t noise_buffer[MAX_BLOCKSIZE_POW2]
uint8_t param_presence_flags
Bitmask of which parameter sets are conveyed in a decoding parameter block.
static void generate_2_noise_channels(MLPDecodeContext *m, unsigned int substr)
Noise generation functions.
uint8_t params_valid
Set if a valid major sync block has been read. Otherwise no decoding is possible. ...
static unsigned int get_bits(GetBitContext *s, int n)
Read 1-25 bits.
#define AV_LOG_WARNING
Something somehow does not look correct.
attribute_deprecated int request_channels
Decoder should decode to this many channels if it can (0 for default)
static av_cold int init(AVCodecContext *avctx)
static struct endianess table[]
#define AV_CH_TOP_FRONT_LEFT
#define AV_CH_TOP_FRONT_CENTER
#define AV_CH_LOW_FREQUENCY_2
const uint8_t ff_mlp_huffman_tables[3][18][2]
Tables defining the Huffman codes.
#define MAX_BLOCKSIZE_POW2
next power of two greater than MAX_BLOCKSIZE
void av_log(void *avcl, int level, const char *fmt,...) av_printf_format(3
Send the specified message to the log if the level is less than or equal to the current av_log_level...
#define MAX_SAMPLERATE
maximum sample frequency seen in files
int8_t output_shift[MAX_CHANNELS]
Left shift to apply to decoded PCM values to get final 24-bit output.
#define AV_CH_SURROUND_DIRECT_RIGHT
#define AV_CH_LAYOUT_STEREO
int bits_per_raw_sample
Bits per sample/pixel of internal libavcodec pixel/sample format.
static int get_sbits(GetBitContext *s, int n)
if((e=av_dict_get(options,"", NULL, AV_DICT_IGNORE_SUFFIX)))
int32_t matrix_coeff[MAX_MATRICES][MAX_CHANNELS]
Matrix coefficients, stored as 2.14 fixed point.
void void avpriv_request_sample(void *avc, const char *msg,...) av_printf_format(2
Log a generic warning message about a missing feature.
enum AVSampleFormat sample_fmt
audio sample format
#define INIT_VLC_STATIC(vlc, bits, a, b, c, d, e, f, g, static_size)
static uint8_t xor_32_to_8(uint32_t value)
XOR four bytes into one.
static av_cold int end(AVCodecContext *avctx)
#define MAX_FIR_ORDER
The maximum number of taps in IIR and FIR filters.
uint8_t ch_assign[MAX_CHANNELS]
For each channel output by the matrix, the output channel to map it to.
const char * name
Name of the codec implementation.
#define AV_CH_LOW_FREQUENCY
#define CODEC_CAP_DR1
Codec uses get_buffer() for allocating buffers and supports custom allocators.
static int get_bits_count(const GetBitContext *s)
static void fill_noise_buffer(MLPDecodeContext *m, unsigned int substr)
Generate a block of noise, used when restart sync word == 0x31eb.
int av_get_channel_layout_channel_index(uint64_t channel_layout, uint64_t channel)
Get the index of a channel in channel_layout.
uint8_t restart_seen
Set if a valid restart header has been read. Otherwise the substream cannot be decoded.
bitstream reader API header.
uint8_t min_channel
The index of the first channel coded in this substream.
#define FFSWAP(type, a, b)
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.
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.
static int read_matrix_params(MLPDecodeContext *m, unsigned int substr, GetBitContext *gbp)
Read parameters for primitive matrices.
static int read_access_unit(AVCodecContext *avctx, void *data, int *got_frame_ptr, AVPacket *avpkt)
Read an access unit from the stream.
int16_t huff_offset
Offset to apply to residual values.
#define NUM_FILTERS
number of allowed filters
uint8_t max_channel
The index of the last channel coded in this substream.
uint8_t ff_mlp_calculate_parity(const uint8_t *buf, unsigned int buf_size)
XOR together all the bytes of a buffer.
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
ChannelParams channel_params[MAX_CHANNELS]
Channel coding parameters for channels in the substream.
#define MAX_MATRIX_CHANNEL_TRUEHD
static const uint16_t mask[17]
static uint64_t thd_channel_layout_extract_channel(uint64_t channel_layout, int index)
uint8_t needs_reordering
Stream needs channel reordering to comply with FFmpeg's channel order.
int8_t bypassed_lsbs[MAX_BLOCKSIZE][MAX_CHANNELS]
uint8_t quant_step_size[MAX_CHANNELS]
Left shift to apply to Huffman-decoded residuals.
#define NULL_IF_CONFIG_SMALL(x)
Return NULL if CONFIG_SMALL is true, otherwise the argument without modification. ...
#define AV_LOG_DEBUG
Stuff which is only useful for libav* developers.
int av_get_channel_layout_nb_channels(uint64_t channel_layout)
Return the number of channels in the channel layout.
#define AV_CH_LAYOUT_QUAD
uint8_t num_substreams
Number of substreams contained within this stream.
Libavcodec external API header.
uint8_t max_matrix_channel
The number of channels input into the rematrix stage.
uint64_t channel_layout
Audio channel layout.
static av_cold int mlp_decode_init(AVCodecContext *avctx)
common internal API header
static void filter(MpegAudioContext *s, int ch, const short *samples, int incr)
#define FF_ARRAY_ELEMS(a)
#define MAX_MATRIX_CHANNEL_MLP
Last possible matrix channel for each codec.
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...
uint16_t noise_type
restart header data
static int read_channel_params(MLPDecodeContext *m, unsigned int substr, GetBitContext *gbp, unsigned int ch)
Read channel parameters.
int32_t lossless_check_data
Running XOR of all output samples.
static av_always_inline int get_vlc2(GetBitContext *s, VLC_TYPE(*table)[2], int bits, int max_depth)
Parse a vlc code.
#define AV_CH_FRONT_LEFT_OF_CENTER
#define AV_CH_FRONT_CENTER
int filter_changed[MAX_CHANNELS][NUM_FILTERS]
uint8_t lsb_bypass[MAX_MATRICES]
Whether the LSBs of the matrix output are encoded in the bitstream.
int32_t coeff[NUM_FILTERS][MAX_FIR_ORDER]
#define AV_CH_LAYOUT_5POINT1_BACK
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...
int access_unit_size
number of PCM samples contained in each frame
#define AV_CH_FRONT_RIGHT_OF_CENTER
static int32_t calculate_sign_huff(MLPDecodeContext *m, unsigned int substr, unsigned int ch)
int frame_size
Number of samples per channel in an audio frame.
#define AV_LOG_INFO
Standard information.
uint16_t blocksize
number of PCM samples in current audio block
uint8_t codebook
Which VLC codebook to use to read residuals.
#define MAX_MATRICES_TRUEHD
uint8_t data_check_present
Set if the substream contains extra info to check the size of VLC blocks.
int32_t state[MAX_FIR_ORDER]
int sample_rate
samples per second
av_cold void ff_mlpdsp_init(MLPDSPContext *c)
#define VLC_BITS
number of bits used for VLC lookup - longest Huffman code is 9
SubStream substream[MAX_SUBSTREAMS]
uint8_t order
number of taps in filter
main external API structure.
int is_major_sync_unit
Current access unit being read has a major sync.
int ff_get_buffer(AVCodecContext *avctx, AVFrame *frame, int flags)
Get a buffer for a frame.
int32_t sample_buffer[MAX_BLOCKSIZE][MAX_CHANNELS]
static unsigned int get_bits1(GetBitContext *s)
static void skip_bits1(GetBitContext *s)
static void skip_bits(GetBitContext *s, int n)
uint64_t ch_layout
The channel layout for this substream.
static void rematrix_channels(MLPDecodeContext *m, unsigned int substr)
Apply the channel matrices in turn to reconstruct the original audio samples.
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).
static int init_get_bits(GetBitContext *s, const uint8_t *buffer, int bit_size)
Initialize GetBitContext.
uint8_t num_primitive_matrices
matrix data
#define AV_CH_LAYOUT_5POINT0_BACK
uint8_t max_decoded_substream
Index of the last substream to decode - further substreams are skipped.
static const int8_t noise_table[256]
Data table used for TrueHD noise generation function.
static int read_major_sync(MLPDecodeContext *m, GetBitContext *gb)
Read a major sync info header - contains high level information about the stream - sample rate...
uint8_t huff_lsbs
Size of residual suffix not encoded using VLC.
uint16_t blockpos
Number of PCM samples decoded so far in this frame.
#define AV_CH_BACK_CENTER
static av_cold void init_static(void)
Initialize static data, constant between all invocations of the codec.
uint32_t noisegen_seed
The current seed value for the pseudorandom noise generator(s).
#define FF_DISABLE_DEPRECATION_WARNINGS
common internal api header.
uint8_t matrix_out_ch[MAX_MATRICES]
matrix output channel
int access_unit_size_pow2
next power of two above the number of samples in each frame
#define MAX_SUBSTREAMS
Maximum number of substreams that can be decoded.
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...
uint8_t matrix_noise_shift[MAX_MATRICES]
Left shift to apply to noise values in 0x31eb substreams.
uint8_t noise_shift
The left shift applied to random noise in 0x31ea substreams.
static int output_data(MLPDecodeContext *m, unsigned int substr, AVFrame *frame, int *got_frame_ptr)
Write the audio data into the output buffer.
#define AVERROR_INVALIDDATA
#define FF_ENABLE_DEPRECATION_WARNINGS
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...
sample data coding information
int channels
number of audio channels
av_cold void ff_mlp_init_crc(void)
#define AV_CH_SURROUND_DIRECT_LEFT
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)
#define AV_CH_FRONT_RIGHT
#define MAX_MATRICES_MLP
Maximum number of matrices used in decoding; most streams have one matrix per output channel...
static int decode(AVCodecContext *avctx, void *data, int *got_frame, AVPacket *avpkt)
#define av_assert0(cond)
assert() equivalent, that is always enabled.
#define AV_CH_LAYOUT_MONO
uint64_t request_channel_layout
Request decoder to use this channel layout if it can (0 for default)
This structure stores compressed data.
int nb_samples
number of audio samples (per channel) described by this frame
uint8_t * data[AV_NUM_DATA_POINTERS]
pointer to the picture/channel planes.
int32_t sign_huff_offset
sign/rounding-corrected version of huff_offset
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...