EBU R.128 implementation. More...

#include <math.h>
#include "libavutil/avassert.h"
#include "libavutil/avstring.h"
#include "libavutil/channel_layout.h"
#include "libavutil/xga_font_data.h"
#include "libavutil/opt.h"
#include "libavutil/timestamp.h"
#include "audio.h"
#include "avfilter.h"
#include "formats.h"
#include "internal.h"

Data Structures
struct	hist_entry
	An histogram is an array of HIST_SIZE hist_entry storing all the energies recorded (with an accuracy of 1/HIST_GRAIN) of the loudnesses from ABS_THRES (at 0) to ABS_UP_THRES (at HIST_SIZE-1). More...

struct	integrator

struct	rect

struct	EBUR128Context

Macros
#define	MAX_CHANNELS 63

#define	PRE_B0 1.53512485958697

#define	PRE_B1 -2.69169618940638

#define	PRE_B2 1.19839281085285

#define	PRE_A1 -1.69065929318241

#define	PRE_A2 0.73248077421585

#define	RLB_B0 1.0

#define	RLB_B1 -2.0

#define	RLB_B2 1.0

#define	RLB_A1 -1.99004745483398

#define	RLB_A2 0.99007225036621

#define	ABS_THRES -70
	silence gate: we discard anything below this absolute (LUFS) threshold

#define	ABS_UP_THRES 10
	upper loud limit to consider (ABS_THRES being the minimum)

#define	HIST_GRAIN 100
	defines histogram precision

#define	HIST_SIZE ((ABS_UP_THRES - ABS_THRES) * HIST_GRAIN + 1)

#define	I400_BINS (48000 * 4 / 10)

#define	I3000_BINS (48000 * 3)

#define	OFFSET(x) offsetof(EBUR128Context, x)

#define	A AV_OPT_FLAG_AUDIO_PARAM

#define	V AV_OPT_FLAG_VIDEO_PARAM

#define	F AV_OPT_FLAG_FILTERING_PARAM

#define	FONT8 0

#define	FONT16 1

#define	PAD 8

#define	DRAW_RECT(r)

#define	BACK_MASK

#define	ENERGY(loudness) (pow(10, ((loudness) + 0.691) / 10.))

#define	LOUDNESS(energy) (-0.691 + 10 * log10(energy))

#define	HIST_POS(power) (int)(((power) - ABS_THRES) * HIST_GRAIN)

#define	MOVE_TO_NEXT_CACHED_ENTRY(time)

#define	FILTER(Y, X, name)

#define	COMPUTE_LOUDNESS(m, time)

#define	I_GATE_THRES -10

#define	LRA_GATE_THRES -20

#define	LRA_LOWER_PRC 10

#define	LRA_HIGHER_PRC 95

#define	LOG_FMT "M:%6.1f S:%6.1f I:%6.1f LUFS LRA:%6.1f LU"

Functions
	AVFILTER_DEFINE_CLASS (ebur128)

static const uint8_t *	get_graph_color (const EBUR128Context *ebur128, int v, int y)

static int	lu_to_y (const EBUR128Context *ebur128, double v)

static void	drawtext (AVFilterBufferRef pic, int x, int y, int ftid, const uint8_t color, const char *fmt,...)

static void	drawline (AVFilterBufferRef *pic, int x, int y, int len, int step)

static int	config_video_output (AVFilterLink *outlink)

static int	config_audio_output (AVFilterLink *outlink)

static struct hist_entry *	get_histogram (void)

static av_cold int	init (AVFilterContext ctx, const char args)

static int	gate_update (struct integrator *integ, double power, double loudness, int gate_thres)

static int	filter_frame (AVFilterLink inlink, AVFilterBufferRef insamples)

static int	query_formats (AVFilterContext *ctx)

static av_cold void	uninit (AVFilterContext *ctx)

Variables
static const AVOption	ebur128_options []

static const uint8_t	graph_colors []

static const uint8_t	font_colors []

static const AVFilterPad	ebur128_inputs []

AVFilter	avfilter_af_ebur128

Detailed Description

EBU R.128 implementation.

See Also: http://tech.ebu.ch/loudness; https://www.youtube.com/watch?v=iuEtQqC-Sqo "EBU R128 Introduction - Florian Camerer"

Todo:

True Peak

implement start/stop/reset through filter command injection

support other frequencies to avoid resampling

Definition in file f_ebur128.c.

Macro Definition Documentation

#define MAX_CHANNELS 63

Definition at line 44 of file f_ebur128.c.

#define PRE_B0 1.53512485958697

Definition at line 47 of file f_ebur128.c.

#define PRE_B1 -2.69169618940638

Definition at line 48 of file f_ebur128.c.

#define PRE_B2 1.19839281085285

Definition at line 49 of file f_ebur128.c.

#define PRE_A1 -1.69065929318241

Definition at line 50 of file f_ebur128.c.

#define PRE_A2 0.73248077421585

Definition at line 51 of file f_ebur128.c.

#define RLB_B0 1.0

Definition at line 54 of file f_ebur128.c.

#define RLB_B1 -2.0

Definition at line 55 of file f_ebur128.c.

#define RLB_B2 1.0

Definition at line 56 of file f_ebur128.c.

#define RLB_A1 -1.99004745483398

Definition at line 57 of file f_ebur128.c.

#define RLB_A2 0.99007225036621

Definition at line 58 of file f_ebur128.c.

#define ABS_THRES -70

silence gate: we discard anything below this absolute (LUFS) threshold

Definition at line 60 of file f_ebur128.c.

Referenced by filter_frame(), get_histogram(), and init().

#define ABS_UP_THRES 10

upper loud limit to consider (ABS_THRES being the minimum)

Definition at line 61 of file f_ebur128.c.

#define HIST_GRAIN 100

defines histogram precision

Definition at line 62 of file f_ebur128.c.

Referenced by get_histogram().

#define HIST_SIZE ((ABS_UP_THRES - ABS_THRES) * HIST_GRAIN + 1)

Definition at line 63 of file f_ebur128.c.

Referenced by filter_frame(), gate_update(), and get_histogram().

#define I400_BINS (48000 * 4 / 10)

Definition at line 117 of file f_ebur128.c.

Referenced by config_audio_output().

#define I3000_BINS (48000 * 3)

Definition at line 118 of file f_ebur128.c.

Referenced by config_audio_output().

#define OFFSET ( x ) offsetof(EBUR128Context, x)

Definition at line 128 of file f_ebur128.c.

#define A AV_OPT_FLAG_AUDIO_PARAM

Definition at line 129 of file f_ebur128.c.

#define V AV_OPT_FLAG_VIDEO_PARAM

Definition at line 130 of file f_ebur128.c.

#define F AV_OPT_FLAG_FILTERING_PARAM

Definition at line 131 of file f_ebur128.c.

#define FONT8 0

Definition at line 169 of file f_ebur128.c.

Referenced by config_video_output(), and drawtext().

#define FONT16 1

Definition at line 170 of file f_ebur128.c.

Referenced by drawtext(), and filter_frame().

#define PAD 8

Referenced by avfilter_register_all(), config_video_output(), and filter_frame().

#define DRAW_RECT ( r )

Value:

do { \
    drawline(outpicref, r.x,       r.y - 1,   r.w, 3); \
    drawline(outpicref, r.x,       r.y + r.h, r.w, 3); \
    drawline(outpicref, r.x - 1,   r.y,       r.h, outpicref->linesize[0]); \
    drawline(outpicref, r.x + r.w, r.y,       r.h, outpicref->linesize[0]); \
} while (0)

Referenced by config_video_output().

#define BACK_MASK

Value:

(AV_CH_BACK_LEFT    |AV_CH_BACK_CENTER    |AV_CH_BACK_RIGHT| \
                   AV_CH_TOP_BACK_LEFT|AV_CH_TOP_BACK_CENTER|AV_CH_TOP_BACK_RIGHT| \
                   AV_CH_SIDE_LEFT                          |AV_CH_SIDE_RIGHT| \
                   AV_CH_SURROUND_DIRECT_LEFT               |AV_CH_SURROUND_DIRECT_RIGHT)

Referenced by config_audio_output().

#define ENERGY ( loudness ) (pow(10, ((loudness) + 0.691) / 10.))

Definition at line 363 of file f_ebur128.c.

Referenced by get_histogram().

#define LOUDNESS ( energy ) (-0.691 + 10 * log10(energy))

Definition at line 364 of file f_ebur128.c.

Referenced by filter_frame(), and gate_update().

#define HIST_POS ( power ) (int)(((power) - ABS_THRES) * HIST_GRAIN)

Definition at line 426 of file f_ebur128.c.

Referenced by gate_update().

#define MOVE_TO_NEXT_CACHED_ENTRY ( time )

Value:

do {                \
    ebur128->i##time.cache_pos++;                           \
    if (ebur128->i##time.cache_pos == I##time##_BINS) {     \
        ebur128->i##time.filled    = 1;                     \
        ebur128->i##time.cache_pos = 0;                     \
    }                                                       \
} while (0)

Referenced by filter_frame().

#define FILTER	(	Y,
		X,
		name
	)

Value:

do {                                                 \
            double *dst = ebur128->Y + ch*3;                                    \
            double *src = ebur128->X + ch*3;                                    \
            dst[2] = dst[1];                                                    \
            dst[1] = dst[0];                                                    \
            dst[0] = src[0]*name##_B0 + src[1]*name##_B1 + src[2]*name##_B2     \
                                      - dst[1]*name##_A1 - dst[2]*name##_A2;    \
} while (0)

#define COMPUTE_LOUDNESS	(	m,
		time
	)

Value:

do {                                              \
    if (ebur128->i##time.filled) {                                                  \
        /* weighting sum of the last <time> ms */                                   \
        for (ch = 0; ch < nb_channels; ch++)                                        \
            power_##time += ebur128->ch_weighting[ch] * ebur128->i##time.sum[ch];   \
        power_##time /= I##time##_BINS;                                             \
    }                                                                               \
    loudness_##time = LOUDNESS(power_##time);                                       \
} while (0)

Referenced by filter_frame().

#define I_GATE_THRES -10

Referenced by filter_frame().

#define LRA_GATE_THRES -20

Referenced by filter_frame().

#define LRA_LOWER_PRC 10

Referenced by filter_frame().

#define LRA_HIGHER_PRC 95

Referenced by filter_frame().

#define LOG_FMT "M:%6.1f S:%6.1f I:%6.1f LUFS LRA:%6.1f LU"

Referenced by filter_frame().

Function Documentation

AVFILTER_DEFINE_CLASS ( ebur128 )

static const uint8_t* get_graph_color	(	const EBUR128Context *	ebur128,
		int	v,
		int	y
	)

static

Definition at line 152 of file f_ebur128.c.

Referenced by config_video_output(), and filter_frame().

static int lu_to_y	(	const EBUR128Context *	ebur128,
		double	v
	)

inlinestatic

Definition at line 161 of file f_ebur128.c.

Referenced by config_video_output(), and filter_frame().

static void drawtext	(	AVFilterBufferRef *	pic,
		int	x,
		int	y,
		int	ftid,
		const uint8_t *	color,
		const char *	fmt,
			...
	)

static

Definition at line 177 of file f_ebur128.c.

Referenced by avfilter_register_all(), config_video_output(), and filter_frame().

static void drawline	(	AVFilterBufferRef *	pic,
		int	x,
		int	y,
		int	len,
		int	step
	)

static

Definition at line 210 of file f_ebur128.c.

static int config_video_output ( AVFilterLink * outlink )

static

Definition at line 221 of file f_ebur128.c.

Referenced by init().

static int config_audio_output ( AVFilterLink * outlink )

static

Definition at line 314 of file f_ebur128.c.

Referenced by init().

static struct hist_entry* get_histogram ( void )

staticread

Definition at line 366 of file f_ebur128.c.

Referenced by init().

static av_cold int init	(	AVFilterContext *	ctx,
		const char *	args
	)

static

Definition at line 378 of file f_ebur128.c.

static int gate_update	(	struct integrator *	integ,
		double	power,
		double	loudness,
		int	gate_thres
	)

static

Definition at line 430 of file f_ebur128.c.

Referenced by filter_frame().

static int filter_frame	(	AVFilterLink *	inlink,
		AVFilterBufferRef *	insamples
	)

static

Definition at line 453 of file f_ebur128.c.

static int query_formats ( AVFilterContext * ctx )

static

Definition at line 657 of file f_ebur128.c.

static av_cold void uninit ( AVFilterContext * ctx )

static

Definition at line 713 of file f_ebur128.c.

Variable Documentation

const AVOption ebur128_options[]

static

Initial value:

= {
    { "video", "set video output", OFFSET(do_video), AV_OPT_TYPE_INT, {.i64 = 0}, 0, 1, V|F },
    { "size",  "set video size",   OFFSET(w), AV_OPT_TYPE_IMAGE_SIZE, {.str = "640x480"}, 0, 0, V|F },
    { "meter", "set scale meter (+9 to +18)",  OFFSET(meter), AV_OPT_TYPE_INT, {.i64 = 9}, 9, 18, V|F },
    { NULL },
}

Definition at line 132 of file f_ebur128.c.

const uint8_t graph_colors[]

static

Initial value:

= {
    0xdd, 0x66, 0x66,   
    0x66, 0x66, 0xdd,   
    0x96, 0x33, 0x33,   
    0x33, 0x33, 0x96,   
    0xdd, 0x96, 0x96,   
    0x96, 0x96, 0xdd,   
    0xdd, 0x33, 0x33,   
    0x33, 0x33, 0xdd,   
}

Definition at line 141 of file f_ebur128.c.

Referenced by get_graph_color().

const uint8_t font_colors[]

static

Initial value:

= {
    0xdd, 0xdd, 0x00,
    0x00, 0x96, 0x96,
}

Definition at line 172 of file f_ebur128.c.

Referenced by config_video_output(), and filter_frame().

const AVFilterPad ebur128_inputs[]

static

Initial value:

= {
    {
        .name             = "default",
        .type             = AVMEDIA_TYPE_AUDIO,
        .get_audio_buffer = ff_null_get_audio_buffer,
        .filter_frame     = filter_frame,
    },
    { NULL }
}

Definition at line 744 of file f_ebur128.c.

AVFilter avfilter_af_ebur128

Initial value:

= {
    .name          = "ebur128",
    .description   = NULL_IF_CONFIG_SMALL("EBU R128 scanner."),
    .priv_size     = sizeof(EBUR128Context),
    .init          = init,
    .uninit        = uninit,
    .query_formats = query_formats,
    .inputs        = ebur128_inputs,
    .outputs       = NULL,
    .priv_class    = &ebur128_class,
}

Definition at line 754 of file f_ebur128.c.

Data Structures

Macros

Functions

Variables

Detailed Description

Macro Definition Documentation

Function Documentation

Variable Documentation