af_dynaudnorm.c File Reference

Dynamic Audio Normalizer. More...

#include <float.h>
#include "libavutil/avassert.h"
#include "libavutil/channel_layout.h"
#include "libavutil/eval.h"
#include "libavutil/mem.h"
#include "libavutil/opt.h"
#include "libavfilter/bufferqueue.h"
#include "audio.h"
#include "avfilter.h"
#include "filters.h"

Go to the source code of this file.

Data Structures
struct	local_gain
struct	cqueue
struct	DynamicAudioNormalizerContext
struct	ThreadData
	Used for passing data between threads. More...

Macros
#define	MIN_FILTER_SIZE   3
#define	MAX_FILTER_SIZE   301
#define	FF_BUFQUEUE_SIZE   (MAX_FILTER_SIZE + 1)
#define	OFFSET(x)
#define	FLAGS   AV_OPT_FLAG_AUDIO_PARAM|AV_OPT_FLAG_FILTERING_PARAM|AV_OPT_FLAG_RUNTIME_PARAM

Enumerations
enum	var_name {   VAR_CH , VAR_SN , VAR_NB_CHANNELS , VAR_T ,   VAR_SR , VAR_P , VAR_VARS_NB }

Functions
	AVFILTER_DEFINE_CLASS (dynaudnorm)
static av_cold int	init (AVFilterContext *ctx)
static int	frame_size (int sample_rate, int frame_len_msec)
static cqueue *	cqueue_create (int size, int max_size)
static void	cqueue_free (cqueue *q)
static int	cqueue_size (cqueue *q)
static int	cqueue_empty (cqueue *q)
static int	cqueue_enqueue (cqueue *q, double element)
static double	cqueue_peek (cqueue *q, int index)
static int	cqueue_dequeue (cqueue *q, double *element)
static int	cqueue_pop (cqueue *q)
static void	cqueue_resize (cqueue *q, int new_size)
static void	init_gaussian_filter (DynamicAudioNormalizerContext *s)
static av_cold void	uninit (AVFilterContext *ctx)
static int	config_input (AVFilterLink *inlink)
static double	fade (double prev, double next, int pos, int length)
static double	pow_2 (const double value)
static double	bound (const double threshold, const double val)
static double	find_peak_magnitude (AVFrame *frame, int channel)
static double	compute_frame_rms (AVFrame *frame, int channel)
static local_gain	get_max_local_gain (DynamicAudioNormalizerContext *s, AVFrame *frame, int channel)
static double	minimum_filter (cqueue *q)
static double	gaussian_filter (DynamicAudioNormalizerContext *s, cqueue *q, cqueue *tq)
static void	update_gain_history (DynamicAudioNormalizerContext *s, int channel, local_gain gain)
static int	update_gain_histories (AVFilterContext *ctx, void *arg, int jobnr, int nb_jobs)
static double	update_value (double new, double old, double aggressiveness)
static int	bypass_channel (DynamicAudioNormalizerContext *s, AVFrame *frame, int ch)
static void	perform_dc_correction (DynamicAudioNormalizerContext *s, AVFrame *frame)
static double	setup_compress_thresh (double threshold)
static double	compute_frame_std_dev (DynamicAudioNormalizerContext *s, AVFrame *frame, int channel)
static void	perform_compression (DynamicAudioNormalizerContext *s, AVFrame *frame)
static int	analyze_frame (AVFilterContext *ctx, AVFilterLink *outlink, AVFrame **frame)
static void	amplify_channel (DynamicAudioNormalizerContext *s, AVFrame *in, AVFrame *frame, int enabled, int c)
static int	amplify_channels (AVFilterContext *ctx, void *arg, int jobnr, int nb_jobs)
static int	filter_frame (AVFilterLink *inlink, AVFrame *in)
static int	flush_buffer (DynamicAudioNormalizerContext *s, AVFilterLink *inlink, AVFilterLink *outlink)
static int	flush (AVFilterLink *outlink)
static int	activate (AVFilterContext *ctx)
static int	process_command (AVFilterContext *ctx, const char *cmd, const char *args, char *res, int res_len, int flags)

Variables
static const char *const	var_names []
static const AVOption	dynaudnorm_options []
static const AVFilterPad	avfilter_af_dynaudnorm_inputs []
const FFFilter	ff_af_dynaudnorm

Detailed Description

Dynamic Audio Normalizer.

Definition in file af_dynaudnorm.c.

Macro Definition Documentation

MIN_FILTER_SIZE

#define MIN_FILTER_SIZE   3

Definition at line 35 of file af_dynaudnorm.c.

Referenced by cqueue_resize().

MAX_FILTER_SIZE

#define MAX_FILTER_SIZE   301

Definition at line 36 of file af_dynaudnorm.c.

Referenced by config_input(), and initFilter().

FF_BUFQUEUE_SIZE

#define FF_BUFQUEUE_SIZE   (MAX_FILTER_SIZE + 1)

Definition at line 38 of file af_dynaudnorm.c.

OFFSET

#define OFFSET

(

x

)

Value:

offsetof(DynamicAudioNormalizerContext, x)

Definition at line 126 of file af_dynaudnorm.c.

FLAGS

#define FLAGS   AV_OPT_FLAG_AUDIO_PARAM|AV_OPT_FLAG_FILTERING_PARAM|AV_OPT_FLAG_RUNTIME_PARAM

Definition at line 127 of file af_dynaudnorm.c.

Enumeration Type Documentation

var_name

enum var_name

Enumerator
VAR_CH
VAR_SN
VAR_NB_CHANNELS
VAR_T
VAR_SR
VAR_P
VAR_VARS_NB

Definition at line 55 of file af_dynaudnorm.c.

Function Documentation

AVFILTER_DEFINE_CLASS()

AVFILTER_DEFINE_CLASS

(

dynaudnorm

)

init()

static av_cold int init ( AVFilterContext * ctx )

static

Definition at line 161 of file af_dynaudnorm.c.

frame_size()

static int frame_size ( int sample_rate, int frame_len_msec )

inlinestatic

Definition at line 173 of file af_dynaudnorm.c.

cqueue_create()

static cqueue * cqueue_create ( int size, int max_size )

static

Definition at line 181 of file af_dynaudnorm.c.

Referenced by config_input(), and ff_vk_exec_pool_init().

cqueue_free()

static void cqueue_free ( cqueue * q )

static

Definition at line 205 of file af_dynaudnorm.c.

Referenced by uninit().

cqueue_size()

static int cqueue_size ( cqueue * q )

static

Definition at line 212 of file af_dynaudnorm.c.

Referenced by gaussian_filter(), minimum_filter(), and update_gain_history().

cqueue_empty()

static int cqueue_empty ( cqueue * q )

static

Definition at line 217 of file af_dynaudnorm.c.

Referenced by cqueue_dequeue(), cqueue_pop(), filter_frame(), flush(), perform_compression(), perform_dc_correction(), and update_gain_history().

cqueue_enqueue()

static int cqueue_enqueue ( cqueue * q, double element )

static

Definition at line 222 of file af_dynaudnorm.c.

Referenced by filter_frame(), and update_gain_history().

cqueue_peek()

static double cqueue_peek ( cqueue * q, int index )

static

Definition at line 232 of file af_dynaudnorm.c.

Referenced by flush(), gaussian_filter(), minimum_filter(), and update_gain_history().

cqueue_dequeue()

static int cqueue_dequeue ( cqueue * q, double * element )

static

Definition at line 238 of file af_dynaudnorm.c.

Referenced by amplify_channel(), and filter_frame().

cqueue_pop()

static int cqueue_pop ( cqueue * q )

static

Definition at line 249 of file af_dynaudnorm.c.

Referenced by cqueue_resize(), and update_gain_history().

cqueue_resize()

static void cqueue_resize ( cqueue * q, int new_size )

static

Definition at line 259 of file af_dynaudnorm.c.

Referenced by process_command().

init_gaussian_filter()

static void init_gaussian_filter ( DynamicAudioNormalizerContext * s )

static

Definition at line 281 of file af_dynaudnorm.c.

Referenced by config_input(), and process_command().

uninit()

static av_cold void uninit ( AVFilterContext * ctx )

static

Definition at line 307 of file af_dynaudnorm.c.

Referenced by config_input().

config_input()

static int config_input ( AVFilterLink * inlink )

static

Definition at line 345 of file af_dynaudnorm.c.

fade()

static double fade ( double prev, double next, int pos, int length )

inlinestatic

Definition at line 404 of file af_dynaudnorm.c.

Referenced by amplify_channel(), perform_compression(), and perform_dc_correction().

pow_2()

static double pow_2 ( const double value )

inlinestatic

Definition at line 412 of file af_dynaudnorm.c.

Referenced by compute_frame_rms(), and compute_frame_std_dev().

bound()

static double bound ( const double threshold, const double val )

inlinestatic

Definition at line 417 of file af_dynaudnorm.c.

Referenced by add_icc_profile_size(), est_filter_radius(), ff_sws_op_list_update_comps(), get_max_local_gain(), mp_decode_layer1(), mp_decode_layer2(), perform_compression(), and setup_compress_thresh().

find_peak_magnitude()

static double find_peak_magnitude ( AVFrame * frame, int channel )

static

Definition at line 423 of file af_dynaudnorm.c.

Referenced by get_max_local_gain().

compute_frame_rms()

static double compute_frame_rms ( AVFrame * frame, int channel )

static

Definition at line 444 of file af_dynaudnorm.c.

Referenced by get_max_local_gain().

get_max_local_gain()

static local_gain get_max_local_gain ( DynamicAudioNormalizerContext * s, AVFrame * frame, int channel )

static

Definition at line 470 of file af_dynaudnorm.c.

Referenced by analyze_frame(), and update_gain_histories().

minimum_filter()

static double minimum_filter ( cqueue * q )

static

Definition at line 496 of file af_dynaudnorm.c.

Referenced by update_gain_history().

gaussian_filter()

static double gaussian_filter ( DynamicAudioNormalizerContext * s, cqueue * q, cqueue * tq )

static

Definition at line 507 of file af_dynaudnorm.c.

Referenced by update_gain_history().

update_gain_history()

static void update_gain_history ( DynamicAudioNormalizerContext * s, int channel, local_gain gain )

static

Definition at line 526 of file af_dynaudnorm.c.

Referenced by analyze_frame(), flush(), and update_gain_histories().

update_gain_histories()

static int update_gain_histories ( AVFilterContext * ctx, void * arg, int jobnr, int nb_jobs )

static

Definition at line 581 of file af_dynaudnorm.c.

Referenced by analyze_frame().

update_value()

static double update_value ( double new, double old, double aggressiveness )

inlinestatic

Definition at line 595 of file af_dynaudnorm.c.

Referenced by perform_compression(), and perform_dc_correction().

bypass_channel()

static int bypass_channel ( DynamicAudioNormalizerContext * s, AVFrame * frame, int ch )

inlinestatic

Definition at line 601 of file af_dynaudnorm.c.

Referenced by amplify_channel(), perform_compression(), and perform_dc_correction().

perform_dc_correction()

static void perform_dc_correction ( DynamicAudioNormalizerContext * s, AVFrame * frame )

static

Definition at line 608 of file af_dynaudnorm.c.

Referenced by analyze_frame().

setup_compress_thresh()

static double setup_compress_thresh ( double threshold )

static

Definition at line 631 of file af_dynaudnorm.c.

Referenced by perform_compression().

compute_frame_std_dev()

static double compute_frame_std_dev ( DynamicAudioNormalizerContext * s, AVFrame * frame, int channel )

static

Definition at line 653 of file af_dynaudnorm.c.

Referenced by perform_compression().

perform_compression()

static void perform_compression ( DynamicAudioNormalizerContext * s, AVFrame * frame )

static

Definition at line 679 of file af_dynaudnorm.c.

Referenced by analyze_frame().

analyze_frame()

static int analyze_frame ( AVFilterContext * ctx, AVFilterLink * outlink, AVFrame ** frame )

static

Definition at line 729 of file af_dynaudnorm.c.

Referenced by analyze_frame(), filter_frame(), and update_gain_histories().

amplify_channel()

static void amplify_channel ( DynamicAudioNormalizerContext * s, AVFrame * in, AVFrame * frame, int enabled, int c )

static

Definition at line 802 of file af_dynaudnorm.c.

Referenced by amplify_channels().

amplify_channels()

static int amplify_channels ( AVFilterContext * ctx, void * arg, int jobnr, int nb_jobs )

static

Definition at line 823 of file af_dynaudnorm.c.

Referenced by filter_frame().

filter_frame()

static int filter_frame ( AVFilterLink * inlink, AVFrame * in )

static

Definition at line 840 of file af_dynaudnorm.c.

Referenced by activate(), and flush_buffer().

flush_buffer()

static int flush_buffer ( DynamicAudioNormalizerContext * s, AVFilterLink * inlink, AVFilterLink * outlink )

static

Definition at line 896 of file af_dynaudnorm.c.

Referenced by flush().

flush()

static int flush ( AVFilterLink * outlink )

static

Definition at line 919 of file af_dynaudnorm.c.

activate()

static int activate ( AVFilterContext * ctx )

static

Definition at line 933 of file af_dynaudnorm.c.

process_command()

static int process_command ( AVFilterContext * ctx, const char * cmd, const char * args, char * res, int res_len, int flags )

static

Definition at line 985 of file af_dynaudnorm.c.

Variable Documentation

var_names

const char* const var_names[]

static

Initial value:

= {
    "ch",           
    "sn",           
    "nb_channels",
    "t",            
    "sr",           
    "p",            
    NULL
}

Definition at line 45 of file af_dynaudnorm.c.

dynaudnorm_options

const AVOption dynaudnorm_options[]

static

Initial value:

= {
    { "framelen",    "set the frame length in msec",     OFFSET(frame_len_msec),    AV_OPT_TYPE_INT,    {.i64 = 500},   10,  8000, FLAGS },
    { "f",           "set the frame length in msec",     OFFSET(frame_len_msec),    AV_OPT_TYPE_INT,    {.i64 = 500},   10,  8000, FLAGS },
    { "gausssize",   "set the filter size",              OFFSET(filter_size),       AV_OPT_TYPE_INT,    {.i64 = 31},     3,   301, FLAGS },
    { "g",           "set the filter size",              OFFSET(filter_size),       AV_OPT_TYPE_INT,    {.i64 = 31},     3,   301, FLAGS },
    { "peak",        "set the peak value",               OFFSET(peak_value),        AV_OPT_TYPE_DOUBLE, {.dbl = 0.95}, 0.0,   1.0, FLAGS },
    { "p",           "set the peak value",               OFFSET(peak_value),        AV_OPT_TYPE_DOUBLE, {.dbl = 0.95}, 0.0,   1.0, FLAGS },
    { "maxgain",     "set the max amplification",        OFFSET(max_amplification), AV_OPT_TYPE_DOUBLE, {.dbl = 10.0}, 1.0, 100.0, FLAGS },
    { "m",           "set the max amplification",        OFFSET(max_amplification), AV_OPT_TYPE_DOUBLE, {.dbl = 10.0}, 1.0, 100.0, FLAGS },
    { "targetrms",   "set the target RMS",               OFFSET(target_rms),        AV_OPT_TYPE_DOUBLE, {.dbl = 0.0},  0.0,   1.0, FLAGS },
    { "r",           "set the target RMS",               OFFSET(target_rms),        AV_OPT_TYPE_DOUBLE, {.dbl = 0.0},  0.0,   1.0, FLAGS },
    { "coupling",    "set channel coupling",             OFFSET(channels_coupled),  AV_OPT_TYPE_BOOL,   {.i64 = 1},      0,     1, FLAGS },
    { "n",           "set channel coupling",             OFFSET(channels_coupled),  AV_OPT_TYPE_BOOL,   {.i64 = 1},      0,     1, FLAGS },
    { "correctdc",   "set DC correction",                OFFSET(dc_correction),     AV_OPT_TYPE_BOOL,   {.i64 = 0},      0,     1, FLAGS },
    { "c",           "set DC correction",                OFFSET(dc_correction),     AV_OPT_TYPE_BOOL,   {.i64 = 0},      0,     1, FLAGS },
    { "altboundary", "set alternative boundary mode",    OFFSET(alt_boundary_mode), AV_OPT_TYPE_BOOL,   {.i64 = 0},      0,     1, FLAGS },
    { "b",           "set alternative boundary mode",    OFFSET(alt_boundary_mode), AV_OPT_TYPE_BOOL,   {.i64 = 0},      0,     1, FLAGS },
    { "compress",    "set the compress factor",          OFFSET(compress_factor),   AV_OPT_TYPE_DOUBLE, {.dbl = 0.0},  0.0,  30.0, FLAGS },
    { "s",           "set the compress factor",          OFFSET(compress_factor),   AV_OPT_TYPE_DOUBLE, {.dbl = 0.0},  0.0,  30.0, FLAGS },
    { "threshold",   "set the threshold value",          OFFSET(threshold),         AV_OPT_TYPE_DOUBLE, {.dbl = 0.0},  0.0,   1.0, FLAGS },
    { "t",           "set the threshold value",          OFFSET(threshold),         AV_OPT_TYPE_DOUBLE, {.dbl = 0.0},  0.0,   1.0, FLAGS },
    { "channels",    "set channels to filter",           OFFSET(channels_to_filter),AV_OPT_TYPE_STRING, {.str="all"},    0,     0, FLAGS },
    { "h",           "set channels to filter",           OFFSET(channels_to_filter),AV_OPT_TYPE_STRING, {.str="all"},    0,     0, FLAGS },
    { "overlap",     "set the frame overlap",            OFFSET(overlap),           AV_OPT_TYPE_DOUBLE, {.dbl=.0},     0.0,   1.0, FLAGS },
    { "o",           "set the frame overlap",            OFFSET(overlap),           AV_OPT_TYPE_DOUBLE, {.dbl=.0},     0.0,   1.0, FLAGS },
    { "curve",       "set the custom peak mapping curve",OFFSET(expr_str),          AV_OPT_TYPE_STRING, {.str=NULL},      .flags = FLAGS },
    { "v",           "set the custom peak mapping curve",OFFSET(expr_str),          AV_OPT_TYPE_STRING, {.str=NULL},      .flags = FLAGS },
    { NULL }
}

Definition at line 129 of file af_dynaudnorm.c.

avfilter_af_dynaudnorm_inputs

const AVFilterPad avfilter_af_dynaudnorm_inputs[]

static

Initial value:

= {
    {
        .name           = "default",
        .type           = AVMEDIA_TYPE_AUDIO,
        .config_props   = config_input,
    },
}

Definition at line 1029 of file af_dynaudnorm.c.

ff_af_dynaudnorm

const FFFilter ff_af_dynaudnorm

Initial value:

= {
    .p.name        = "dynaudnorm",
    .p.description = NULL_IF_CONFIG_SMALL("Dynamic Audio Normalizer."),
    .p.priv_class  = &dynaudnorm_class,
    .p.flags       = AVFILTER_FLAG_SUPPORT_TIMELINE_INTERNAL |
                     AVFILTER_FLAG_SLICE_THREADS,
    .priv_size     = sizeof(DynamicAudioNormalizerContext),
    .init          = init,
    .uninit        = uninit,
    .activate      = activate,
    FILTER_INPUTS(avfilter_af_dynaudnorm_inputs),
    FILTER_OUTPUTS(ff_audio_default_filterpad),
    FILTER_SINGLE_SAMPLEFMT(AV_SAMPLE_FMT_DBLP),
    .process_command = process_command,
}

Definition at line 1037 of file af_dynaudnorm.c.