EBU R.128 implementation. More...

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

Classes
struct	hist_entry
	A 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) (ff_exp10(((loudness) + 0.691) / 10.))

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

#define	DBFS(energy) (20 * 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"

#define	META_PREFIX "lavfi.r128."

#define	SET_META(name, var)

#define	SET_META_PEAK(name, ptype)

#define	PRINT_PEAKS(str, sp, ptype)

#define	PRINT_PEAK_SUMMARY(str, sp, ptype)

Typedefs
typedef struct EBUR128Context	EBUR128Context

Enumerations
enum	{ PEAK_MODE_NONE = 0, PEAK_MODE_SAMPLES_PEAKS = 1<<1, PEAK_MODE_TRUE_PEAKS = 1<<2 }

Functions
	AVFILTER_DEFINE_CLASS (ebur128)

Variables
AVFilter	ff_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:

implement start/stop/reset through filter command injection

support other frequencies to avoid resampling

Macro Definition Documentation

§ BACK_MASK

#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)

§ COMPUTE_LOUDNESS

#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)

§ DRAW_RECT

#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)

§ FILTER

#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)

§ MOVE_TO_NEXT_CACHED_ENTRY

#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)

§ PRINT_PEAK_SUMMARY

#define PRINT_PEAK_SUMMARY	(	str,
		sp,
		ptype
	)

Value:

do {                  \
    int ch;                                                      \
    double maxpeak;                                              \
    maxpeak = 0.0;                                               \
    if (ebur128->peak_mode & PEAK_MODE_ ## ptype ## _PEAKS) {    \
        for (ch = 0; ch < ebur128->nb_channels; ch++)            \
            maxpeak = FFMAX(maxpeak, sp[ch]);                    \
        av_log(ctx, AV_LOG_INFO, "\n\n  " str " peak:\n"         \
               "    Peak:      %5.1f dBFS",                      \
               DBFS(maxpeak));                                   \
    }                                                            \
} while (0)

§ PRINT_PEAKS

#define PRINT_PEAKS	(	str,
		sp,
		ptype
	)

Value:

do {                            \
    if (ebur128->peak_mode & PEAK_MODE_ ## ptype ## _PEAKS) {       \
        av_log(ctx, ebur128->loglevel, "  " str ":");               \
        for (ch = 0; ch < nb_channels; ch++)                        \
            av_log(ctx, ebur128->loglevel, " %5.1f", DBFS(sp[ch])); \
        av_log(ctx, ebur128->loglevel, " dBFS");                    \
    }                                                               \
} while (0)

§ SET_META

#define SET_META	(	name,
		var
	)

Value:

do {                                            \
    snprintf(metabuf, sizeof(metabuf), "%.3f", var);                        \
    av_dict_set(&insamples->metadata, name, metabuf, 0);                    \
} while (0)

§ SET_META_PEAK

#define SET_META_PEAK	(	name,
		ptype
	)

Value:

do {                                     \
    if (ebur128->peak_mode & PEAK_MODE_ ## ptype ## _PEAKS) {               \
        char key[64];                                                       \
        for (ch = 0; ch < nb_channels; ch++) {                              \
            snprintf(key, sizeof(key),                                      \
                     META_PREFIX AV_STRINGIFY(name) "_peaks_ch%d", ch);     \
            SET_META(key, ebur128->name##_peaks[ch]);                       \
        }                                                                   \
    }                                                                       \
} while (0)

Variable Documentation

§ ff_af_ebur128

AVFilter ff_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,
    .flags         = AVFILTER_FLAG_DYNAMIC_OUTPUTS,
}

Classes

Macros

Typedefs

Enumerations

Functions

Variables

Detailed Description

Macro Definition Documentation

§ BACK_MASK

§ COMPUTE_LOUDNESS

§ DRAW_RECT

§ FILTER

§ MOVE_TO_NEXT_CACHED_ENTRY

§ PRINT_PEAK_SUMMARY

§ PRINT_PEAKS

§ SET_META

§ SET_META_PEAK

Variable Documentation

§ ff_af_ebur128