alsdec.c File Reference

MPEG-4 ALS decoder. More...

#include <inttypes.h>
#include "avcodec.h"
#include "get_bits.h"
#include "unary.h"
#include "mpeg4audio.h"
#include "bgmc.h"
#include "bswapdsp.h"
#include "codec_internal.h"
#include "decode.h"
#include "internal.h"
#include "mlz.h"
#include "libavutil/mem.h"
#include "libavutil/opt.h"
#include "libavutil/samplefmt.h"
#include "libavutil/crc.h"
#include "libavutil/softfloat_ieee754.h"
#include "libavutil/intreadwrite.h"
#include <stdint.h>

Go to the source code of this file.

Data Structures
struct	ALSSpecificConfig
struct	ALSChannelData
struct	ALSDecContext
struct	ALSBlockData

Macros
#define	MISSING_ERR(cond, str, errval)
#define	INTERLEAVE_OUTPUT(bps)

Enumerations
enum	RA_Flag { RA_FLAG_NONE , RA_FLAG_FRAMES , RA_FLAG_HEADER }

Functions
static av_cold void	dprint_specific_config (ALSDecContext *ctx)
static av_cold int	read_specific_config (ALSDecContext *ctx)
	Read an ALSSpecificConfig from a buffer into the output struct.
static int	check_specific_config (ALSDecContext *ctx)
	Check the ALSSpecificConfig for unsupported features.
static void	parse_bs_info (const uint32_t bs_info, unsigned int n, unsigned int div, unsigned int **div_blocks, unsigned int *num_blocks)
	Parse the bs_info field to extract the block partitioning used in block switching mode, refer to ISO/IEC 14496-3, section 11.6.2.
static int32_t	decode_rice (GetBitContext *gb, unsigned int k)
	Read and decode a Rice codeword.
static void	parcor_to_lpc (unsigned int k, const int32_t *par, int32_t *cof)
	Convert PARCOR coefficient k to direct filter coefficient.
static void	get_block_sizes (ALSDecContext *ctx, unsigned int *div_blocks, uint32_t *bs_info)
	Read block switching field if necessary and set actual block sizes.
static int	read_const_block_data (ALSDecContext *ctx, ALSBlockData *bd)
	Read the block data for a constant block.
static void	decode_const_block_data (ALSDecContext *ctx, ALSBlockData *bd)
	Decode the block data for a constant block.
static int	read_var_block_data (ALSDecContext *ctx, ALSBlockData *bd)
	Read the block data for a non-constant block.
static int	decode_var_block_data (ALSDecContext *ctx, ALSBlockData *bd)
	Decode the block data for a non-constant block.
static int	read_block (ALSDecContext *ctx, ALSBlockData *bd)
	Read the block data.
static int	decode_block (ALSDecContext *ctx, ALSBlockData *bd)
	Decode the block data.
static int	read_decode_block (ALSDecContext *ctx, ALSBlockData *bd)
	Read and decode block data successively.
static void	zero_remaining (unsigned int b, unsigned int b_max, const unsigned int *div_blocks, int32_t *buf)
	Compute the number of samples left to decode for the current frame and sets these samples to zero.
static int	decode_blocks_ind (ALSDecContext *ctx, unsigned int ra_frame, unsigned int c, const unsigned int *div_blocks, unsigned int *js_blocks)
	Decode blocks independently.
static int	decode_blocks (ALSDecContext *ctx, unsigned int ra_frame, unsigned int c, const unsigned int *div_blocks, unsigned int *js_blocks)
	Decode blocks dependently.
static int	als_weighting (GetBitContext *gb, int k, int off)
static int	read_channel_data (ALSDecContext *ctx, ALSChannelData *cd, int c)
	Read the channel data.
static int	revert_channel_correlation (ALSDecContext *ctx, ALSBlockData *bd, ALSChannelData **cd, int *reverted, unsigned int offset, int c)
	Recursively reverts the inter-channel correlation for a block.
static SoftFloat_IEEE754	multiply (SoftFloat_IEEE754 a, SoftFloat_IEEE754 b)
	multiply two softfloats and handle the rounding off
static int	read_diff_float_data (ALSDecContext *ctx, unsigned int ra_frame)
	Read and decode the floating point sample data.
static int	read_frame_data (ALSDecContext *ctx, unsigned int ra_frame)
	Read the frame data.
static int	decode_frame (AVCodecContext *avctx, AVFrame *frame, int *got_frame_ptr, AVPacket *avpkt)
	Decode an ALS frame.
static av_cold int	decode_end (AVCodecContext *avctx)
	Uninitialize the ALS decoder.
static av_cold int	decode_init (AVCodecContext *avctx)
	Initialize the ALS decoder.
static av_cold void	flush (AVCodecContext *avctx)
	Flush (reset) the frame ID after seeking.

Variables
static const int8_t	parcor_rice_table [3][20][2]
	Rice parameters and corresponding index offsets for decoding the indices of scaled PARCOR values.
static const int16_t	parcor_scaled_values []
	Scaled PARCOR values used for the first two PARCOR coefficients.
static const uint8_t	ltp_gain_values [4][4]
	Gain values of p(0) for long-term prediction.
static const int16_t	mcc_weightings []
	Inter-channel weighting factors for multi-channel correlation.
static const uint8_t	tail_code [16][6]
	Tail codes used in arithmetic coding using block Gilbert-Moore codes.
static const AVOption	options []
static const AVClass	als_class
const FFCodec	ff_als_decoder

Detailed Description

MPEG-4 ALS decoder.

Author

Thilo Borgmann <thilo.borgmann at mail.de>

Definition in file alsdec.c.

Macro Definition Documentation

MISSING_ERR

#define MISSING_ERR	(		cond,
			str,
			errval )

Value:

    {                                                   \
        if (cond) {                                     \
            avpriv_report_missing_feature(ctx->avctx,   \
                                          str);         \
            error = errval;                             \
        }                                               \
    }

Referenced by check_specific_config().

INTERLEAVE_OUTPUT

#define INTERLEAVE_OUTPUT

(

bps

)

Value:

    {                                                                                \
        int##bps##_t *dest = (int##bps##_t*)frame->data[0];                          \
        int32_t *raw_samples = ctx->raw_samples[0];                                  \
        int raw_step = channels > 1 ? ctx->raw_samples[1] - raw_samples : 1;         \
        shift = bps - ctx->avctx->bits_per_raw_sample;                               \
        if (!ctx->cs_switch) {                                                       \
            for (sample = 0; sample < ctx->cur_frame_length; sample++)               \
                for (c = 0; c < channels; c++)                                       \
                    *dest++ = raw_samples[c*raw_step + sample] * (1U << shift);      \
        } else {                                                                     \
            for (sample = 0; sample < ctx->cur_frame_length; sample++)               \
                for (c = 0; c < channels; c++)                                       \
                    *dest++ = raw_samples[sconf->chan_pos[c]*raw_step + sample] * (1U << shift);\
        }                                                                            \
    }

Referenced by decode_frame().

Enumeration Type Documentation

RA_Flag

enum RA_Flag

Enumerator
RA_FLAG_NONE
RA_FLAG_FRAMES
RA_FLAG_HEADER

Definition at line 154 of file alsdec.c.

Function Documentation

dprint_specific_config()

static av_cold void dprint_specific_config ( ALSDecContext * ctx )

static

Definition at line 267 of file alsdec.c.

Referenced by read_specific_config().

read_specific_config()

static av_cold int read_specific_config ( ALSDecContext * ctx )

static

Read an ALSSpecificConfig from a buffer into the output struct.

Definition at line 297 of file alsdec.c.

Referenced by decode_init().

check_specific_config()

static int check_specific_config ( ALSDecContext * ctx )

static

Check the ALSSpecificConfig for unsupported features.

Definition at line 465 of file alsdec.c.

Referenced by decode_init().

parse_bs_info()

static void parse_bs_info ( const uint32_t bs_info, unsigned int n, unsigned int div, unsigned int ** div_blocks, unsigned int * num_blocks )

static

Parse the bs_info field to extract the block partitioning used in block switching mode, refer to ISO/IEC 14496-3, section 11.6.2.

Definition at line 489 of file alsdec.c.

Referenced by get_block_sizes(), and parse_bs_info().

decode_rice()

static int32_t decode_rice ( GetBitContext * gb, unsigned int k )

static

Read and decode a Rice codeword.

Definition at line 512 of file alsdec.c.

Referenced by als_weighting(), and read_var_block_data().

parcor_to_lpc()

static void parcor_to_lpc ( unsigned int k, const int32_t * par, int32_t * cof )

static

Convert PARCOR coefficient k to direct filter coefficient.

Definition at line 530 of file alsdec.c.

Referenced by decode_var_block_data().

get_block_sizes()

static void get_block_sizes ( ALSDecContext * ctx, unsigned int * div_blocks, uint32_t * bs_info )

static

Read block switching field if necessary and set actual block sizes.

Also assure that the block sizes of the last frame correspond to the actual number of samples.

Definition at line 550 of file alsdec.c.

Referenced by read_frame_data().

read_const_block_data()

static int read_const_block_data ( ALSDecContext * ctx, ALSBlockData * bd )

static

Read the block data for a constant block.

Definition at line 603 of file alsdec.c.

Referenced by read_block().

decode_const_block_data()

static void decode_const_block_data ( ALSDecContext * ctx, ALSBlockData * bd )

static

Decode the block data for a constant block.

Definition at line 633 of file alsdec.c.

Referenced by decode_block().

read_var_block_data()

static int read_var_block_data ( ALSDecContext * ctx, ALSBlockData * bd )

static

Read the block data for a non-constant block.

Definition at line 647 of file alsdec.c.

Referenced by read_block().

decode_var_block_data()

static int decode_var_block_data ( ALSDecContext * ctx, ALSBlockData * bd )

static

Decode the block data for a non-constant block.

Definition at line 922 of file alsdec.c.

Referenced by decode_block().

read_block()

static int read_block ( ALSDecContext * ctx, ALSBlockData * bd )

static

Read the block data.

Definition at line 1031 of file alsdec.c.

Referenced by read_decode_block(), read_frame_data(), and shared_read().

decode_block()

static int decode_block ( ALSDecContext * ctx, ALSBlockData * bd )

static

Decode the block data.

Definition at line 1058 of file alsdec.c.

Referenced by decode_frame(), read_decode_block(), and read_frame_data().

read_decode_block()

static int read_decode_block ( ALSDecContext * ctx, ALSBlockData * bd )

static

Read and decode block data successively.

Definition at line 1084 of file alsdec.c.

Referenced by decode_blocks(), and decode_blocks_ind().

zero_remaining()

static void zero_remaining ( unsigned int b, unsigned int b_max, const unsigned int * div_blocks, int32_t * buf )

static

Compute the number of samples left to decode for the current frame and sets these samples to zero.

Definition at line 1098 of file alsdec.c.

Referenced by decode_blocks(), and decode_blocks_ind().

decode_blocks_ind()

static int decode_blocks_ind ( ALSDecContext * ctx, unsigned int ra_frame, unsigned int c, const unsigned int * div_blocks, unsigned int * js_blocks )

static

Decode blocks independently.

Definition at line 1113 of file alsdec.c.

Referenced by read_frame_data().

decode_blocks()

static int decode_blocks ( ALSDecContext * ctx, unsigned int ra_frame, unsigned int c, const unsigned int * div_blocks, unsigned int * js_blocks )

static

Decode blocks dependently.

Definition at line 1153 of file alsdec.c.

Referenced by read_frame_data().

als_weighting()

static int als_weighting ( GetBitContext * gb, int k, int off )

inlinestatic

Definition at line 1237 of file alsdec.c.

Referenced by read_channel_data().

read_channel_data()

static int read_channel_data ( ALSDecContext * ctx, ALSChannelData * cd, int c )

static

Read the channel data.

Definition at line 1246 of file alsdec.c.

Referenced by read_frame_data().

revert_channel_correlation()

static int revert_channel_correlation ( ALSDecContext * ctx, ALSBlockData * bd, ALSChannelData ** cd, int * reverted, unsigned int offset, int c )

static

Recursively reverts the inter-channel correlation for a block.

Definition at line 1293 of file alsdec.c.

Referenced by read_frame_data(), and revert_channel_correlation().

multiply()

static SoftFloat_IEEE754 multiply ( SoftFloat_IEEE754 a, SoftFloat_IEEE754 b )

static

multiply two softfloats and handle the rounding off

Definition at line 1406 of file alsdec.c.

Referenced by AVFILTER_DEFINE_CLASS(), checkasm_check_blend(), and read_diff_float_data().

read_diff_float_data()

static int read_diff_float_data ( ALSDecContext * ctx, unsigned int ra_frame )

static

Read and decode the floating point sample data.

Definition at line 1465 of file alsdec.c.

Referenced by read_frame_data().

read_frame_data()

static int read_frame_data ( ALSDecContext * ctx, unsigned int ra_frame )

static

Read the frame data.

< block sizes.

Definition at line 1655 of file alsdec.c.

Referenced by decode_frame().

decode_frame()

static int decode_frame ( AVCodecContext * avctx, AVFrame * frame, int * got_frame_ptr, AVPacket * avpkt )

static

Decode an ALS frame.

Definition at line 1816 of file alsdec.c.

decode_end()

static av_cold int decode_end ( AVCodecContext * avctx )

static

Uninitialize the ALS decoder.

Definition at line 1954 of file alsdec.c.

decode_init()

static av_cold int decode_init ( AVCodecContext * avctx )

static

Initialize the ALS decoder.

Definition at line 2006 of file alsdec.c.

flush()

static av_cold void flush ( AVCodecContext * avctx )

static

Flush (reset) the frame ID after seeking.

Definition at line 2196 of file alsdec.c.

Variable Documentation

parcor_rice_table

const int8_t parcor_rice_table[3][20][2]

static

Initial value:

= {
    { {-52, 4}, {-29, 5}, {-31, 4}, { 19, 4}, {-16, 4},
      { 12, 3}, { -7, 3}, {  9, 3}, { -5, 3}, {  6, 3},
      { -4, 3}, {  3, 3}, { -3, 2}, {  3, 2}, { -2, 2},
      {  3, 2}, { -1, 2}, {  2, 2}, { -1, 2}, {  2, 2} },
    { {-58, 3}, {-42, 4}, {-46, 4}, { 37, 5}, {-36, 4},
      { 29, 4}, {-29, 4}, { 25, 4}, {-23, 4}, { 20, 4},
      {-17, 4}, { 16, 4}, {-12, 4}, { 12, 3}, {-10, 4},
      {  7, 3}, { -4, 4}, {  3, 3}, { -1, 3}, {  1, 3} },
    { {-59, 3}, {-45, 5}, {-50, 4}, { 38, 4}, {-39, 4},
      { 32, 4}, {-30, 4}, { 25, 3}, {-23, 3}, { 20, 3},
      {-20, 3}, { 16, 3}, {-13, 3}, { 10, 3}, { -7, 3},
      {  3, 3}, {  0, 3}, { -1, 3}, {  2, 3}, { -1, 2} }
}

Rice parameters and corresponding index offsets for decoding the indices of scaled PARCOR values.

The table chosen is set globally by the encoder and stored in ALSSpecificConfig.

Definition at line 53 of file alsdec.c.

Referenced by read_var_block_data().

parcor_scaled_values

const int16_t parcor_scaled_values[]

static

Scaled PARCOR values used for the first two PARCOR coefficients.

To be indexed by the Rice coded indices. Generated by: parcor_scaled_values[i] = 32 + ((i * (i+1)) << 7) - (1 << 20) Actual values are divided by 32 in order to be stored in 16 bits.

Definition at line 74 of file alsdec.c.

Referenced by read_var_block_data().

ltp_gain_values

const uint8_t ltp_gain_values[4][4]

static

Initial value:

= {
    { 0,  8, 16,  24},
    {32, 40, 48,  56},
    {64, 70, 76,  82},
    {88, 92, 96, 100}
}

Gain values of p(0) for long-term prediction.

To be indexed by the Rice coded indices.

Definition at line 113 of file alsdec.c.

Referenced by read_var_block_data().

mcc_weightings

const int16_t mcc_weightings[]

static

Initial value:

= {
    204,  192,  179,  166,  153,  140,  128,  115,
    102,   89,   76,   64,   51,   38,   25,   12,
      0,  -12,  -25,  -38,  -51,  -64,  -76,  -89,
   -102, -115, -128, -140, -153, -166, -179, -192
}

Inter-channel weighting factors for multi-channel correlation.

To be indexed by the Rice coded indices.

Definition at line 124 of file alsdec.c.

Referenced by als_weighting().

tail_code

const uint8_t tail_code[16][6]

static

Initial value:

= {
    { 74, 44, 25, 13,  7, 3},
    { 68, 42, 24, 13,  7, 3},
    { 58, 39, 23, 13,  7, 3},
    {126, 70, 37, 19, 10, 5},
    {132, 70, 37, 20, 10, 5},
    {124, 70, 38, 20, 10, 5},
    {120, 69, 37, 20, 11, 5},
    {116, 67, 37, 20, 11, 5},
    {108, 66, 36, 20, 10, 5},
    {102, 62, 36, 20, 10, 5},
    { 88, 58, 34, 19, 10, 5},
    {162, 89, 49, 25, 13, 7},
    {156, 87, 49, 26, 14, 7},
    {150, 86, 47, 26, 14, 7},
    {142, 84, 47, 26, 14, 7},
    {131, 79, 46, 26, 14, 7}
}

Tail codes used in arithmetic coding using block Gilbert-Moore codes.

Definition at line 134 of file alsdec.c.

Referenced by read_var_block_data().

options

const AVOption options[]

static

Initial value:

= {
    { "max_order", "Sets the maximum order (ALS simple profile allows max 15)",  0x42 , AV_OPT_TYPE_INT, { .i64 = 1023 }, 0, 1023, AV_OPT_FLAG_AUDIO_PARAM | AV_OPT_FLAG_DECODING_PARAM },
    { NULL }
}

Definition at line 2203 of file alsdec.c.

als_class

const AVClass als_class

static

Initial value:

= {
    .class_name = "als",
    .item_name  = av_default_item_name,
    .option     = options,
    .version    = LIBAVUTIL_VERSION_INT,
}

Definition at line 2208 of file alsdec.c.

ff_als_decoder

const FFCodec ff_als_decoder

Initial value:

= {
    .p.name         = "als",
    CODEC_LONG_NAME("MPEG-4 Audio Lossless Coding (ALS)"),
    .p.type         = AVMEDIA_TYPE_AUDIO,
    .p.id           = AV_CODEC_ID_MP4ALS,
    .priv_data_size = sizeof(ALSDecContext),
    .init           = decode_init,
    .close          = decode_end,
    FF_CODEC_DECODE_CB(decode_frame),
    .p.priv_class   = &als_class,
    .flush          = flush,
    .p.capabilities = AV_CODEC_CAP_DR1 | AV_CODEC_CAP_CHANNEL_CONF,
    .caps_internal  = FF_CODEC_CAP_INIT_CLEANUP,
}

Definition at line 2215 of file alsdec.c.