47 #define VLC_STATIC_SIZE 64 50 #define VLC_STATIC_SIZE 512 88 #define PARAM_BLOCKSIZE (1 << 7) 89 #define PARAM_MATRIX (1 << 6) 90 #define PARAM_OUTSHIFT (1 << 5) 91 #define PARAM_QUANTSTEP (1 << 4) 92 #define PARAM_FIR (1 << 3) 93 #define PARAM_IIR (1 << 2) 94 #define PARAM_HUFFOFFSET (1 << 1) 95 #define PARAM_PRESENCE (1 << 0) 187 return channel_layout && ((channel_layout &
mask) == channel_layout);
210 for (
int i = 0;
i < 3;
i++) {
223 unsigned int substr,
unsigned int ch)
232 sign_huff_offset -= 7 << lsb_bits;
235 sign_huff_offset -= 1 << sign_shift;
237 return sign_huff_offset;
244 unsigned int substr,
unsigned int pos)
268 result = (result << lsb_bits) +
get_bits_long(gbp, lsb_bits);
314 "Channel group 2 cannot have more bits per sample than group 1.\n");
320 "Channel groups with differing sample rates are not currently supported.\n");
330 "Sampling rate %d is greater than the supported maximum (%d).\n",
336 "Block size %d is greater than the supported maximum (%d).\n",
342 "Block size pow2 %d is greater than the supported maximum (%d).\n",
355 "%d substreams (more than the " 356 "maximum supported by the decoder)",
394 "unexpected stream_type %X in MLP",
404 "unexpected stream_type %X in !MLP",
475 const uint8_t *buf,
unsigned int substr)
490 if (sync_word != 0x31ea >> 1) {
492 "restart header sync incorrect (got 0x%04x)\n", sync_word);
507 max_matrix_channel =
get_bits(gbp, 4);
509 if (max_matrix_channel > std_max_matrix_channel) {
511 "Max matrix channel cannot be greater than %d.\n",
512 std_max_matrix_channel);
516 if (max_channel != max_matrix_channel) {
518 "Max channel must be equal max matrix channel.\n");
526 "%d channels (more than the " 527 "maximum supported by the decoder)",
532 if (min_channel > max_channel) {
534 "Substream min channel cannot be greater than max channel.\n");
546 "Extracting %d-channel downmix (0x%"PRIx64
") from substream %d. " 547 "Further substreams will be skipped.\n",
562 if (tmp != lossless_check)
564 "Lossless check failed - expected %02x, calculated %02x.\n",
565 lossless_check, tmp);
582 "Assignment of matrix channel %d to invalid output channel %d",
603 for (ch = s->
min_channel; ch <= s->max_channel; ch++) {
646 unsigned int substr,
unsigned int channel,
652 const char fchar = filter ?
'I' :
'F';
664 if (order > max_order) {
666 "%cIR filter order %d is greater than maximum %d.\n",
667 fchar, order, max_order);
674 int coeff_bits, coeff_shift;
680 if (coeff_bits < 1 || coeff_bits > 16) {
682 "%cIR filter coeff_bits must be between 1 and 16.\n",
686 if (coeff_bits + coeff_shift > 16) {
688 "Sum of coeff_bits and coeff_shift for %cIR filter must be 16 or less.\n",
693 for (i = 0; i < order; i++)
694 fcoeff[i] =
get_sbits(gbp, coeff_bits) * (1 << coeff_shift);
697 int state_bits, state_shift;
701 "FIR filter has state data specified.\n");
710 for (i = 0; i < order; i++)
711 fp->
state[i] = state_bits ?
get_sbits(gbp, state_bits) * (1 << state_shift) : 0;
723 unsigned int mat, ch;
737 "Number of primitive matrices cannot be greater than %d.\n",
738 max_primitive_matrices);
743 int frac_bits, max_chan;
750 "Invalid channel %d specified as output from matrix.\n",
754 if (frac_bits > 14) {
756 "Too many fractional bits specified.\n");
764 for (ch = 0; ch <= max_chan; ch++) {
767 coeff_val =
get_sbits(gbp, frac_bits + 2);
769 s->
matrix_coeff[mat][ch] = coeff_val * (1 << (14 - frac_bits));
815 "FIR and IIR filters must use the same precision.\n");
851 unsigned recompute_sho = 0;
893 recompute_sho |= 1<<ch;
898 recompute_sho |= 1<<ch;
906 if (recompute_sho & (1<<ch)) {
923 #define MSB_MASK(bits) (-1u << (bits)) 938 unsigned int filter_shift = fir->
shift;
959 unsigned int i, ch, expected_stream_pos = 0;
964 expected_stream_pos +=
get_bits(gbp, 16);
966 "Substreams with VLC block size check info");
998 30, 51, 22, 54, 3, 7, -4, 38, 14, 55, 46, 81, 22, 58, -3, 2,
999 52, 31, -7, 51, 15, 44, 74, 30, 85, -17, 10, 33, 18, 80, 28, 62,
1000 10, 32, 23, 69, 72, 26, 35, 17, 73, 60, 8, 56, 2, 6, -2, -5,
1001 51, 4, 11, 50, 66, 76, 21, 44, 33, 47, 1, 26, 64, 48, 57, 40,
1002 38, 16, -10, -28, 92, 22, -18, 29, -10, 5, -13, 49, 19, 24, 70, 34,
1003 61, 48, 30, 14, -6, 25, 58, 33, 42, 60, 67, 17, 54, 17, 22, 30,
1004 67, 44, -9, 50, -11, 43, 40, 32, 59, 82, 13, 49, -14, 55, 60, 36,
1005 48, 49, 31, 47, 15, 12, 4, 65, 1, 23, 29, 39, 45, -2, 84, 69,
1006 0, 72, 37, 57, 27, 41, -15, -16, 35, 31, 14, 61, 24, 0, 27, 24,
1007 16, 41, 55, 34, 53, 9, 56, 12, 25, 29, 53, 5, 20, -20, -8, 20,
1008 13, 28, -3, 78, 38, 16, 11, 62, 46, 29, 21, 24, 46, 65, 43, -23,
1009 89, 18, 74, 21, 38, -12, 19, 12, -19, 8, 15, 33, 4, 57, 9, -8,
1010 36, 35, 26, 28, 7, 83, 63, 79, 75, 11, 3, 87, 37, 47, 34, 40,
1011 39, 19, 20, 42, 27, 34, 39, 77, 13, 42, 59, 64, 45, -1, 32, 37,
1012 45, -5, 53, -6, 7, 36, 50, 23, 6, 32, 9, -21, 18, 71, 27, 52,
1013 -25, 31, 35, 42, -1, 68, 63, 52, 26, 43, 66, 37, 41, 25, 40, 70,
1033 for (i = 0; i < s->
blockpos; i++) {
1034 uint16_t seed_shr7 = seed >> 7;
1038 seed = (seed << 16) ^ seed_shr7 ^ (seed_shr7 << 5);
1053 uint8_t seed_shr15 = seed >> 15;
1055 seed = (seed << 8) ^ seed_shr15 ^ (seed_shr15 << 5);
1069 unsigned int maxchan;
1135 int *got_frame_ptr,
AVPacket *avpkt)
1138 int buf_size = avpkt->
size;
1141 unsigned int length, substr;
1142 unsigned int substream_start;
1143 unsigned int header_size = 4;
1144 unsigned int substr_header_size = 0;
1153 length = (
AV_RB16(buf) & 0xfff) * 2;
1170 "Stream parameters not seen; skipping frame.\n");
1175 substream_start = 0;
1178 int extraword_present, checkdata_present,
end, nonrestart_substr;
1187 substr_header_size += 2;
1189 if (extraword_present) {
1195 substr_header_size += 2;
1198 if (length < header_size + substr_header_size) {
1208 if (end + header_size + substr_header_size > length) {
1210 "Indicated length of substream %d data goes off end of " 1211 "packet.\n", substr);
1212 end = length - header_size - substr_header_size;
1215 if (end < substream_start) {
1217 "Indicated end offset of substream %d data " 1218 "is smaller than calculated start offset.\n",
1226 substream_parity_present[substr] = checkdata_present;
1227 substream_data_len[substr] = end - substream_start;
1228 substream_start =
end;
1234 if ((((parity_bits >> 4) ^ parity_bits) & 0xF) != 0xF) {
1239 buf += header_size + substr_header_size;
1271 goto substream_length_mismatch;
1277 if (substream_data_len[substr] * 8 -
get_bits_count(&gb) >= 32) {
1293 if (substream_parity_present[substr]) {
1297 goto substream_length_mismatch;
1302 if ((
get_bits(&gb, 8) ^ parity) != 0xa9 )
1309 goto substream_length_mismatch;
1314 "No restart header present in substream %d.\n", substr);
1316 buf += substream_data_len[substr];
1324 substream_length_mismatch:
1333 #if CONFIG_MLP_DECODER 1346 #if CONFIG_TRUEHD_DECODER uint8_t shift
Right shift to apply to output of filter.
static unsigned int show_bits_long(GetBitContext *s, int n)
Show 0-32 bits.
static uint64_t thd_channel_layout_extract_channel(uint64_t channel_layout, int index)
int major_sync_header_size
Size of the major sync unit, in bytes.
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)
#define AVERROR_INVALIDDATA
Invalid data found when processing input.
static const unsigned codebook[256][2]
FilterParams filter_params[NUM_FILTERS]
This structure describes decoded (raw) audio or video data.
int32_t(*(* mlp_select_pack_output)(uint8_t *ch_assign, int8_t *output_shift, uint8_t max_matrix_channel, int is32))(int32_t
static av_cold int mlp_decode_init(AVCodecContext *avctx)
#define AV_CH_TOP_FRONT_RIGHT
int8_t noise_buffer[MAX_BLOCKSIZE_POW2]
ptrdiff_t const GLvoid * data
uint8_t param_presence_flags
Bitmask of which parameter sets are conveyed in a decoding parameter block.
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.
uint64_t mask
The channel layout for this substream.
static av_cold int init(AVCodecContext *avctx)
#define avpriv_request_sample(...)
#define AV_CH_TOP_FRONT_LEFT
static int mlp_channel_layout_subset(uint64_t channel_layout, uint64_t mask)
#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
enum AVMatrixEncoding matrix_encoding
The matrix encoding mode for this substream.
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.
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...
#define MAX_SAMPLERATE
maximum sample frequency seen in files
#define AV_CODEC_CAP_CHANNEL_CONF
Codec should fill in channel configuration and samplerate instead of container.
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 void error(const char *err)
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
static int get_sbits(GetBitContext *s, int n)
static void decode(AVCodecContext *dec_ctx, AVPacket *pkt, AVFrame *frame, FILE *outfile)
int av_get_channel_layout_nb_channels(uint64_t channel_layout)
Return the number of channels in the channel layout.
int32_t matrix_coeff[MAX_MATRICES][MAX_CHANNELS]
Matrix coefficients, stored as 2.14 fixed point.
#define av_assert0(cond)
assert() equivalent, that is always enabled.
#define FF_CODEC_CAP_INIT_THREADSAFE
The codec does not modify any global variables in the init function, allowing to call the init functi...
enum AVSampleFormat sample_fmt
audio sample format
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.
#define AV_CH_LOW_FREQUENCY
Public header for CRC hash function implementation.
static void fill_noise_buffer(MLPDecodeContext *m, unsigned int substr)
Generate a block of noise, used when restart sync word == 0x31eb.
#define DECLARE_ALIGNED(n, t, v)
Declare a variable that is aligned in memory.
static int get_bits_count(const GetBitContext *s)
uint8_t restart_seen
Set if a valid restart header has been read. Otherwise the substream cannot be decoded.
bitstream reader API header.
static void generate_2_noise_channels(MLPDecodeContext *m, unsigned int substr)
Noise generation functions.
uint8_t min_channel
The index of the first channel coded in this substream.
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 const uint16_t table[]
int16_t huff_offset
Offset to apply to residual values.
static int read_channel_params(MLPDecodeContext *m, unsigned int substr, GetBitContext *gbp, unsigned int ch)
Read channel parameters.
#define VLC_BITS
number of bits used for VLC lookup - longest Huffman code is 9
#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.
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
ChannelParams channel_params[MAX_CHANNELS]
Channel coding parameters for channels in the substream.
#define MAX_MATRIX_CHANNEL_TRUEHD
#define init_vlc(vlc, nb_bits, nb_codes,bits, bits_wrap, bits_size,codes, codes_wrap, codes_size,flags)
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.
static const uint64_t thd_channel_order[]
#define AV_CH_LAYOUT_QUAD
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...
const char * name
Name of the codec implementation.
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)
uint8_t num_substreams
Number of substreams contained within this stream.
static int read_access_unit(AVCodecContext *avctx, void *data, int *got_frame_ptr, AVPacket *avpkt)
Read an access unit from the stream.
uint8_t max_matrix_channel
The number of channels input into the rematrix stage.
uint64_t channel_layout
Audio channel layout.
common internal API header
static int read_matrix_params(MLPDecodeContext *m, unsigned int substr, GetBitContext *gbp)
Read parameters for primitive matrices.
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...
audio channel layout utility functions
#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...
static int output_data(MLPDecodeContext *m, unsigned int substr, AVFrame *frame, int *got_frame_ptr)
Write the audio data into the output buffer.
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)
uint16_t noise_type
restart header data
static int read_major_sync(MLPDecodeContext *m, GetBitContext *gb)
Read a major sync info header - contains high level information about the stream - sample rate...
int32_t lossless_check_data
Running XOR of all output 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).
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
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
static const int8_t noise_table[256]
Data table used for TrueHD noise generation function.
int filter_changed[MAX_CHANNELS][NUM_FILTERS]
#define AV_CH_FRONT_CENTER
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]
static volatile int checksum
#define AV_CH_LAYOUT_5POINT1_BACK
int access_unit_size
number of PCM samples contained in each frame
#define FF_ARRAY_ELEMS(a)
#define AV_CH_FRONT_RIGHT_OF_CENTER
int ff_side_data_update_matrix_encoding(AVFrame *frame, enum AVMatrixEncoding matrix_encoding)
Add or update AV_FRAME_DATA_MATRIXENCODING side data.
#define AVERROR_PATCHWELCOME
Not yet implemented in FFmpeg, patches welcome.
int frame_size
Number of samples per channel in an audio frame.
#define AV_LOG_INFO
Standard information.
AVCodec ff_truehd_decoder
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
Libavcodec external API header.
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)
SubStream substream[MAX_SUBSTREAMS]
uint8_t order
number of taps in filter
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. ...
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)
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 unsigned int get_bits_long(GetBitContext *s, int n)
Read 0-32 bits.
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 huff_lsbs
Size of residual suffix not encoded using VLC.
static av_cold void init_static(void)
Initialize static data, constant between all invocations of the codec.
uint16_t blockpos
Number of PCM samples decoded so far in this frame.
#define AV_CH_BACK_CENTER
uint8_t * data[AV_NUM_DATA_POINTERS]
pointer to the picture/channel planes.
uint32_t noisegen_seed
The current seed value for the pseudorandom noise generator(s).
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
channel
Use these values when setting the channel map with ebur128_set_channel().
#define INIT_VLC_USE_NEW_STATIC
#define MAX_SUBSTREAMS
Maximum number of substreams that can be decoded.
static int32_t calculate_sign_huff(MLPDecodeContext *m, unsigned int substr, unsigned int ch)
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.
sample data coding information
int channels
number of audio channels
static int ff_thread_once(char *control, void(*routine)(void))
VLC_TYPE(* table)[2]
code, bits
av_cold void ff_mlp_init_crc(void)
#define AV_CH_SURROUND_DIRECT_LEFT
static VLC_TYPE vlc_buf[16716][2]
and forward the result(frame or status change) to the corresponding input.If nothing is possible
#define AV_CH_FRONT_RIGHT
#define MAX_MATRICES_MLP
Maximum number of matrices used in decoding; most streams have one matrix per output channel...
#define FFSWAP(type, a, b)
#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
#define AV_CODEC_CAP_DR1
Codec uses get_buffer() for allocating buffers and supports custom allocators.
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...