af_firequalizer.c File Reference

#include "libavutil/channel_layout.h"
#include "libavutil/file_open.h"
#include "libavutil/mem.h"
#include "libavutil/opt.h"
#include "libavutil/eval.h"
#include "libavutil/avassert.h"
#include "libavutil/tx.h"
#include "avfilter.h"
#include "filters.h"
#include "audio.h"

Go to the source code of this file.

Data Structures
struct	GainEntry
struct	OverlapIndex
struct	FIREqualizerContext

Macros
#define	RDFT_BITS_MIN   4
#define	RDFT_BITS_MAX   16
#define	NB_GAIN_ENTRY_MAX   4096
#define	OFFSET(x)
#define	FLAGS   AV_OPT_FLAG_AUDIO_PARAM|AV_OPT_FLAG_FILTERING_PARAM
#define	TFLAGS   AV_OPT_FLAG_AUDIO_PARAM|AV_OPT_FLAG_FILTERING_PARAM|AV_OPT_FLAG_RUNTIME_PARAM
#define	SELECT_GAIN(s)
#define	SELECT_GAIN_ENTRY(s)

Enumerations
enum	WindowFunc {   WFUNC_RECTANGULAR , WFUNC_HANN , WFUNC_HAMMING , WFUNC_BLACKMAN ,   WFUNC_NUTTALL3 , WFUNC_MNUTTALL3 , WFUNC_NUTTALL , WFUNC_BNUTTALL ,   WFUNC_BHARRIS , WFUNC_TUKEY , NB_WFUNC }
enum	Scale {   SCALE_LINLIN , SCALE_LINLOG , SCALE_LOGLIN , SCALE_LOGLOG ,   NB_SCALE }
enum	VarOffset {   VAR_F , VAR_SR , VAR_CH , VAR_CHID ,   VAR_CHS , VAR_CHLAYOUT , VAR_NB }

Functions
	AVFILTER_DEFINE_CLASS (firequalizer)
static void	common_uninit (FIREqualizerContext *s)
static av_cold void	uninit (AVFilterContext *ctx)
static void	fast_convolute (FIREqualizerContext *restrict s, const float *restrict kernel_buf, float *restrict conv_buf, OverlapIndex *restrict idx, float *restrict data, int nsamples)
static void	fast_convolute_nonlinear (FIREqualizerContext *restrict s, const float *restrict kernel_buf, float *restrict conv_buf, OverlapIndex *restrict idx, float *restrict data, int nsamples)
static void	fast_convolute2 (FIREqualizerContext *restrict s, const float *restrict kernel_buf, AVComplexFloat *restrict conv_buf, OverlapIndex *restrict idx, float *restrict data0, float *restrict data1, int nsamples)
static void	dump_fir (AVFilterContext *ctx, FILE *fp, int ch)
static double	entry_func (void *p, double freq, double gain)
static int	gain_entry_compare (const void *key, const void *memb)
static double	gain_interpolate_func (void *p, double freq)
static double	cubic_interpolate_func (void *p, double freq)
static void	generate_min_phase_kernel (FIREqualizerContext *s, float *rdft_buf)
static int	generate_kernel (AVFilterContext *ctx, const char *gain, const char *gain_entry)
static int	config_input (AVFilterLink *inlink)
static int	filter_frame (AVFilterLink *inlink, AVFrame *frame)
static int	request_frame (AVFilterLink *outlink)
static int	process_command (AVFilterContext *ctx, const char *cmd, const char *args, char *res, int res_len, int flags)

Variables
static const AVOption	firequalizer_options []
static const char *const	var_names []
static const AVFilterPad	firequalizer_inputs []
static const AVFilterPad	firequalizer_outputs []
const FFFilter	ff_af_firequalizer

Macro Definition Documentation

RDFT_BITS_MIN

#define RDFT_BITS_MIN   4

Definition at line 32 of file af_firequalizer.c.

Referenced by config_input().

RDFT_BITS_MAX

#define RDFT_BITS_MAX   16

Definition at line 33 of file af_firequalizer.c.

Referenced by config_input().

NB_GAIN_ENTRY_MAX

#define NB_GAIN_ENTRY_MAX   4096

Definition at line 57 of file af_firequalizer.c.

Referenced by entry_func().

OFFSET

#define OFFSET

(

x

)

Value:

offsetof(FIREqualizerContext, x)

Definition at line 127 of file af_firequalizer.c.

FLAGS

#define FLAGS   AV_OPT_FLAG_AUDIO_PARAM|AV_OPT_FLAG_FILTERING_PARAM

Definition at line 128 of file af_firequalizer.c.

TFLAGS

#define TFLAGS   AV_OPT_FLAG_AUDIO_PARAM|AV_OPT_FLAG_FILTERING_PARAM|AV_OPT_FLAG_RUNTIME_PARAM

Definition at line 129 of file af_firequalizer.c.

SELECT_GAIN

#define SELECT_GAIN

(

s

)

Value:

(s->gain_cmd ? s->gain_cmd : s->gain)

Definition at line 723 of file af_firequalizer.c.

Referenced by config_input(), and process_command().

SELECT_GAIN_ENTRY

#define SELECT_GAIN_ENTRY

(

s

)

Value:

(s->gain_entry_cmd ? s->gain_entry_cmd : s->gain_entry)

Definition at line 724 of file af_firequalizer.c.

Referenced by config_input(), and process_command().

Enumeration Type Documentation

WindowFunc

enum WindowFunc

Enumerator
WFUNC_RECTANGULAR
WFUNC_HANN
WFUNC_HAMMING
WFUNC_BLACKMAN
WFUNC_NUTTALL3
WFUNC_MNUTTALL3
WFUNC_NUTTALL
WFUNC_BNUTTALL
WFUNC_BHARRIS
WFUNC_TUKEY
NB_WFUNC

Definition at line 35 of file af_firequalizer.c.

Scale

enum Scale

Enumerator
SCALE_LINLIN
SCALE_LINLOG
SCALE_LOGLIN
SCALE_LOGLOG
NB_SCALE

Definition at line 49 of file af_firequalizer.c.

VarOffset

enum VarOffset

Enumerator
VAR_F
VAR_SR
VAR_CH
VAR_CHID
VAR_CHS
VAR_CHLAYOUT
VAR_NB

Definition at line 529 of file af_firequalizer.c.

Function Documentation

AVFILTER_DEFINE_CLASS()

AVFILTER_DEFINE_CLASS

(

firequalizer

)

common_uninit()

static void common_uninit ( FIREqualizerContext * s )

static

Definition at line 164 of file af_firequalizer.c.

Referenced by config_input(), and uninit().

uninit()

static av_cold void uninit ( AVFilterContext * ctx )

static

Definition at line 191 of file af_firequalizer.c.

fast_convolute()

static void fast_convolute ( FIREqualizerContext *restrict s, const float *restrict kernel_buf, float *restrict conv_buf, OverlapIndex *restrict idx, float *restrict data, int nsamples )

static

Definition at line 200 of file af_firequalizer.c.

Referenced by fast_convolute(), and filter_frame().

fast_convolute_nonlinear()

static void fast_convolute_nonlinear ( FIREqualizerContext *restrict s, const float *restrict kernel_buf, float *restrict conv_buf, OverlapIndex *restrict idx, float *restrict data, int nsamples )

static

Definition at line 237 of file af_firequalizer.c.

Referenced by fast_convolute_nonlinear(), and filter_frame().

fast_convolute2()

static void fast_convolute2 ( FIREqualizerContext *restrict s, const float *restrict kernel_buf, AVComplexFloat *restrict conv_buf, OverlapIndex *restrict idx, float *restrict data0, float *restrict data1, int nsamples )

static

Definition at line 276 of file af_firequalizer.c.

Referenced by fast_convolute2(), and filter_frame().

dump_fir()

static void dump_fir ( AVFilterContext * ctx, FILE * fp, int ch )

static

Definition at line 339 of file af_firequalizer.c.

Referenced by generate_kernel().

entry_func()

static double entry_func ( void * p, double freq, double gain )

static

Definition at line 398 of file af_firequalizer.c.

Referenced by generate_kernel().

gain_entry_compare()

static int gain_entry_compare ( const void * key, const void * memb )

static

Definition at line 427 of file af_firequalizer.c.

Referenced by cubic_interpolate_func(), and gain_interpolate_func().

gain_interpolate_func()

static double gain_interpolate_func ( void * p, double freq )

static

Definition at line 439 of file af_firequalizer.c.

Referenced by generate_kernel().

cubic_interpolate_func()

static double cubic_interpolate_func ( void * p, double freq )

static

Definition at line 474 of file af_firequalizer.c.

Referenced by generate_kernel().

generate_min_phase_kernel()

static void generate_min_phase_kernel ( FIREqualizerContext * s, float * rdft_buf )

static

Definition at line 539 of file af_firequalizer.c.

Referenced by generate_kernel().

generate_kernel()

static int generate_kernel ( AVFilterContext * ctx, const char * gain, const char * gain_entry )

static

Definition at line 582 of file af_firequalizer.c.

Referenced by config_input(), and process_command().

config_input()

static int config_input ( AVFilterLink * inlink )

static

Definition at line 726 of file af_firequalizer.c.

filter_frame()

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

static

Definition at line 835 of file af_firequalizer.c.

Referenced by request_frame().

request_frame()

static int request_frame ( AVFilterLink * outlink )

static

Definition at line 871 of file af_firequalizer.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 893 of file af_firequalizer.c.

Variable Documentation

firequalizer_options

const AVOption firequalizer_options[]

static

Initial value:

= {
    { "gain", "set gain curve", OFFSET(gain), AV_OPT_TYPE_STRING, { .str = "gain_interpolate(f)" }, 0, 0, TFLAGS },
    { "gain_entry", "set gain entry", OFFSET(gain_entry), AV_OPT_TYPE_STRING, { .str = NULL }, 0, 0, TFLAGS },
    { "delay", "set delay", OFFSET(delay), AV_OPT_TYPE_DOUBLE, { .dbl = 0.01 }, 0.0, 1e10, FLAGS },
    { "accuracy", "set accuracy", OFFSET(accuracy), AV_OPT_TYPE_DOUBLE, { .dbl = 5.0 }, 0.0, 1e10, FLAGS },
    { "wfunc", "set window function", OFFSET(wfunc), AV_OPT_TYPE_INT, { .i64 = WFUNC_HANN }, 0, NB_WFUNC-1, FLAGS, .unit = "wfunc" },
        { "rectangular", "rectangular window", 0, AV_OPT_TYPE_CONST, { .i64 = WFUNC_RECTANGULAR }, 0, 0, FLAGS, .unit = "wfunc" },
        { "hann", "hann window", 0, AV_OPT_TYPE_CONST, { .i64 = WFUNC_HANN }, 0, 0, FLAGS, .unit = "wfunc" },
        { "hamming", "hamming window", 0, AV_OPT_TYPE_CONST, { .i64 = WFUNC_HAMMING }, 0, 0, FLAGS, .unit = "wfunc" },
        { "blackman", "blackman window", 0, AV_OPT_TYPE_CONST, { .i64 = WFUNC_BLACKMAN }, 0, 0, FLAGS, .unit = "wfunc" },
        { "nuttall3", "3-term nuttall window", 0, AV_OPT_TYPE_CONST, { .i64 = WFUNC_NUTTALL3 }, 0, 0, FLAGS, .unit = "wfunc" },
        { "mnuttall3", "minimum 3-term nuttall window", 0, AV_OPT_TYPE_CONST, { .i64 = WFUNC_MNUTTALL3 }, 0, 0, FLAGS, .unit = "wfunc" },
        { "nuttall", "nuttall window", 0, AV_OPT_TYPE_CONST, { .i64 = WFUNC_NUTTALL }, 0, 0, FLAGS, .unit = "wfunc" },
        { "bnuttall", "blackman-nuttall window", 0, AV_OPT_TYPE_CONST, { .i64 = WFUNC_BNUTTALL }, 0, 0, FLAGS, .unit = "wfunc" },
        { "bharris", "blackman-harris window", 0, AV_OPT_TYPE_CONST, { .i64 = WFUNC_BHARRIS }, 0, 0, FLAGS, .unit = "wfunc" },
        { "tukey", "tukey window", 0, AV_OPT_TYPE_CONST, { .i64 = WFUNC_TUKEY }, 0, 0, FLAGS, .unit = "wfunc" },
    { "fixed", "set fixed frame samples", OFFSET(fixed), AV_OPT_TYPE_BOOL, { .i64 = 0 }, 0, 1, FLAGS },
    { "multi", "set multi channels mode", OFFSET(multi), AV_OPT_TYPE_BOOL, { .i64 = 0 }, 0, 1, FLAGS },
    { "zero_phase", "set zero phase mode", OFFSET(zero_phase), AV_OPT_TYPE_BOOL, { .i64 = 0 }, 0, 1, FLAGS },
    { "scale", "set gain scale", OFFSET(scale), AV_OPT_TYPE_INT, { .i64 = SCALE_LINLOG }, 0, NB_SCALE-1, FLAGS, .unit = "scale" },
        { "linlin", "linear-freq linear-gain", 0, AV_OPT_TYPE_CONST, { .i64 = SCALE_LINLIN }, 0, 0, FLAGS, .unit = "scale" },
        { "linlog", "linear-freq logarithmic-gain", 0, AV_OPT_TYPE_CONST, { .i64 = SCALE_LINLOG }, 0, 0, FLAGS, .unit = "scale" },
        { "loglin", "logarithmic-freq linear-gain", 0, AV_OPT_TYPE_CONST, { .i64 = SCALE_LOGLIN }, 0, 0, FLAGS, .unit = "scale" },
        { "loglog", "logarithmic-freq logarithmic-gain", 0, AV_OPT_TYPE_CONST, { .i64 = SCALE_LOGLOG }, 0, 0, FLAGS, .unit = "scale" },
    { "dumpfile", "set dump file", OFFSET(dumpfile), AV_OPT_TYPE_STRING, { .str = NULL }, 0, 0, FLAGS },
    { "dumpscale", "set dump scale", OFFSET(dumpscale), AV_OPT_TYPE_INT, { .i64 = SCALE_LINLOG }, 0, NB_SCALE-1, FLAGS, .unit = "scale" },
    { "fft2", "set 2-channels fft", OFFSET(fft2), AV_OPT_TYPE_BOOL, { .i64 = 0 }, 0, 1, FLAGS },
    { "min_phase", "set minimum phase mode", OFFSET(min_phase), AV_OPT_TYPE_BOOL, { .i64 = 0 }, 0, 1, FLAGS },
    { NULL }
}

Definition at line 131 of file af_firequalizer.c.

var_names

const char* const var_names[]

static

Initial value:

= {
    "f",
    "sr",
    "ch",
    "chid",
    "chs",
    "chlayout",
    NULL
}

Definition at line 519 of file af_firequalizer.c.

firequalizer_inputs

const AVFilterPad firequalizer_inputs[]

static

Initial value:

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

Definition at line 942 of file af_firequalizer.c.

firequalizer_outputs

const AVFilterPad firequalizer_outputs[]

static

Initial value:

= {
    {
        .name           = "default",
        .request_frame  = request_frame,
        .type           = AVMEDIA_TYPE_AUDIO,
    },
}

Definition at line 952 of file af_firequalizer.c.

ff_af_firequalizer

const FFFilter ff_af_firequalizer

Initial value:

= {
    .p.name             = "firequalizer",
    .p.description      = NULL_IF_CONFIG_SMALL("Finite Impulse Response Equalizer."),
    .p.priv_class       = &firequalizer_class,
    .uninit             = uninit,
    .process_command    = process_command,
    .priv_size          = sizeof(FIREqualizerContext),
    FILTER_INPUTS(firequalizer_inputs),
    FILTER_OUTPUTS(firequalizer_outputs),
    FILTER_SINGLE_SAMPLEFMT(AV_SAMPLE_FMT_FLTP),
}

Definition at line 960 of file af_firequalizer.c.