FFmpeg
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
Data Structures | Macros | Functions | Variables
f_ebur128.c File Reference

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/xga_font_data.h"
#include "libavutil/opt.h"
#include "libavutil/timestamp.h"
#include "audio.h"
#include "avfilter.h"
#include "formats.h"
#include "internal.h"

Go to the source code of this file.

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"
 
#define SET_META(name, var)
 

Functions

 AVFILTER_DEFINE_CLASS (ebur128)
 
static const uint8_tget_graph_color (const EBUR128Context *ebur128, int v, int y)
 
static int lu_to_y (const EBUR128Context *ebur128, double v)
 
static void drawtext (AVFrame *pic, int x, int y, int ftid, const uint8_t *color, const char *fmt,...)
 
static void drawline (AVFrame *pic, int x, int y, int len, int step)
 
static int config_video_output (AVFilterLink *outlink)
 
static int config_audio_input (AVFilterLink *inlink)
 
static int config_audio_output (AVFilterLink *outlink)
 
static struct hist_entryget_histogram (void)
 
static av_cold int init (AVFilterContext *ctx)
 
static int gate_update (struct integrator *integ, double power, double loudness, int gate_thres)
 
static int filter_frame (AVFilterLink *inlink, AVFrame *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 45 of file f_ebur128.c.

#define PRE_B0   1.53512485958697

Definition at line 48 of file f_ebur128.c.

#define PRE_B1   -2.69169618940638

Definition at line 49 of file f_ebur128.c.

#define PRE_B2   1.19839281085285

Definition at line 50 of file f_ebur128.c.

#define PRE_A1   -1.69065929318241

Definition at line 51 of file f_ebur128.c.

#define PRE_A2   0.73248077421585

Definition at line 52 of file f_ebur128.c.

#define RLB_B0   1.0

Definition at line 55 of file f_ebur128.c.

#define RLB_B1   -2.0

Definition at line 56 of file f_ebur128.c.

#define RLB_B2   1.0

Definition at line 57 of file f_ebur128.c.

#define RLB_A1   -1.99004745483398

Definition at line 58 of file f_ebur128.c.

#define RLB_A2   0.99007225036621

Definition at line 59 of file f_ebur128.c.

#define ABS_THRES   -70

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

Definition at line 61 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 62 of file f_ebur128.c.

#define HIST_GRAIN   100

defines histogram precision

Definition at line 63 of file f_ebur128.c.

Referenced by get_histogram().

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

Definition at line 64 of file f_ebur128.c.

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

#define I400_BINS   (48000 * 4 / 10)

Definition at line 118 of file f_ebur128.c.

Referenced by config_audio_output().

#define I3000_BINS   (48000 * 3)

Definition at line 119 of file f_ebur128.c.

Referenced by config_audio_output().

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

Definition at line 133 of file f_ebur128.c.

#define A   AV_OPT_FLAG_AUDIO_PARAM

Definition at line 134 of file f_ebur128.c.

#define V   AV_OPT_FLAG_VIDEO_PARAM

Definition at line 135 of file f_ebur128.c.

Definition at line 136 of file f_ebur128.c.

#define FONT8   0

Definition at line 178 of file f_ebur128.c.

Referenced by config_video_output(), and drawtext().

#define FONT16   1

Definition at line 179 of file f_ebur128.c.

Referenced by drawtext(), and filter_frame().

#define PAD   8
#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:

Referenced by config_audio_output().

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

Definition at line 389 of file f_ebur128.c.

Referenced by get_histogram().

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

Definition at line 390 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 457 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().

#define SET_META (   name,
  var 
)
Value:
do { \
snprintf(metabuf, sizeof(metabuf), "%.3f", var); \
av_dict_set(&insamples->metadata, "lavfi.r128." name, metabuf, 0); \
} while (0)

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 161 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 170 of file f_ebur128.c.

Referenced by config_video_output(), and filter_frame().

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

Definition at line 186 of file f_ebur128.c.

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

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

Definition at line 219 of file f_ebur128.c.

static int config_video_output ( AVFilterLink outlink)
static

Definition at line 230 of file f_ebur128.c.

Referenced by init().

static int config_audio_input ( AVFilterLink inlink)
static

Definition at line 324 of file f_ebur128.c.

static int config_audio_output ( AVFilterLink outlink)
static

Definition at line 338 of file f_ebur128.c.

Referenced by init().

static struct hist_entry* get_histogram ( void  )
staticread

Definition at line 392 of file f_ebur128.c.

Referenced by init().

static av_cold int init ( AVFilterContext ctx)
static

Definition at line 406 of file f_ebur128.c.

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

Definition at line 461 of file f_ebur128.c.

Referenced by filter_frame().

static int filter_frame ( AVFilterLink inlink,
AVFrame insamples 
)
static

Definition at line 484 of file f_ebur128.c.

static int query_formats ( AVFilterContext ctx)
static

Definition at line 702 of file f_ebur128.c.

static av_cold void uninit ( AVFilterContext ctx)
static

Definition at line 747 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 },
{ "framelog", "force frame logging level", OFFSET(loglevel), AV_OPT_TYPE_INT, {.i64 = -1}, INT_MIN, INT_MAX, A|V|F, "level" },
{ "info", "information logging level", 0, AV_OPT_TYPE_CONST, {.i64 = AV_LOG_INFO}, INT_MIN, INT_MAX, A|V|F, "level" },
{ "verbose", "verbose logging level", 0, AV_OPT_TYPE_CONST, {.i64 = AV_LOG_VERBOSE}, INT_MIN, INT_MAX, A|V|F, "level" },
{ "metadata", "inject metadata in the filtergraph", OFFSET(metadata), AV_OPT_TYPE_INT, {.i64 = 0}, 0, 1, A|V|F },
{ NULL },
}

Definition at line 137 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 150 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 181 of file f_ebur128.c.

Referenced by config_video_output(), and filter_frame().

const AVFilterPad ebur128_inputs[]
static
Initial value:
= {
{
.name = "default",
.get_audio_buffer = ff_null_get_audio_buffer,
.filter_frame = filter_frame,
.config_props = config_audio_input,
},
{ NULL }
}

Definition at line 778 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,
.outputs = NULL,
.priv_class = &ebur128_class,
}

Definition at line 789 of file f_ebur128.c.