FFmpeg
af_astats.c
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2009 Rob Sykes <robs@users.sourceforge.net>
3  * Copyright (c) 2013 Paul B Mahol
4  *
5  * This file is part of FFmpeg.
6  *
7  * FFmpeg is free software; you can redistribute it and/or
8  * modify it under the terms of the GNU Lesser General Public
9  * License as published by the Free Software Foundation; either
10  * version 2.1 of the License, or (at your option) any later version.
11  *
12  * FFmpeg is distributed in the hope that it will be useful,
13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15  * Lesser General Public License for more details.
16  *
17  * You should have received a copy of the GNU Lesser General Public
18  * License along with FFmpeg; if not, write to the Free Software
19  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
20  */
21 
22 #include <float.h>
23 #include <math.h>
24 
25 #include "libavutil/opt.h"
26 #include "audio.h"
27 #include "avfilter.h"
28 #include "internal.h"
29 
30 #define HISTOGRAM_SIZE 8192
31 #define HISTOGRAM_MAX (HISTOGRAM_SIZE-1)
32 
33 #define MEASURE_ALL UINT_MAX
34 #define MEASURE_NONE 0
35 
36 #define MEASURE_DC_OFFSET (1 << 0)
37 #define MEASURE_MIN_LEVEL (1 << 1)
38 #define MEASURE_MAX_LEVEL (1 << 2)
39 #define MEASURE_MIN_DIFFERENCE (1 << 3)
40 #define MEASURE_MAX_DIFFERENCE (1 << 4)
41 #define MEASURE_MEAN_DIFFERENCE (1 << 5)
42 #define MEASURE_RMS_DIFFERENCE (1 << 6)
43 #define MEASURE_PEAK_LEVEL (1 << 7)
44 #define MEASURE_RMS_LEVEL (1 << 8)
45 #define MEASURE_RMS_PEAK (1 << 9)
46 #define MEASURE_RMS_TROUGH (1 << 10)
47 #define MEASURE_CREST_FACTOR (1 << 11)
48 #define MEASURE_FLAT_FACTOR (1 << 12)
49 #define MEASURE_PEAK_COUNT (1 << 13)
50 #define MEASURE_BIT_DEPTH (1 << 14)
51 #define MEASURE_DYNAMIC_RANGE (1 << 15)
52 #define MEASURE_ZERO_CROSSINGS (1 << 16)
53 #define MEASURE_ZERO_CROSSINGS_RATE (1 << 17)
54 #define MEASURE_NUMBER_OF_SAMPLES (1 << 18)
55 #define MEASURE_NUMBER_OF_NANS (1 << 19)
56 #define MEASURE_NUMBER_OF_INFS (1 << 20)
57 #define MEASURE_NUMBER_OF_DENORMALS (1 << 21)
58 #define MEASURE_NOISE_FLOOR (1 << 22)
59 #define MEASURE_NOISE_FLOOR_COUNT (1 << 23)
60 #define MEASURE_ENTROPY (1 << 24)
61 #define MEASURE_ABS_PEAK_COUNT (1 << 25)
62 
63 #define MEASURE_MINMAXPEAK (MEASURE_MIN_LEVEL | MEASURE_MAX_LEVEL | MEASURE_PEAK_LEVEL)
64 
65 typedef struct ChannelStats {
66  double last;
67  double last_non_zero;
68  double min_non_zero;
69  double sigma_x, sigma_x2;
71  double min, max;
72  double nmin, nmax;
73  double min_run, max_run;
74  double min_runs, max_runs;
75  double min_diff, max_diff;
76  double diff1_sum;
77  double diff1_sum_x2;
78  double abs_peak;
79  uint64_t mask[4];
80  uint64_t min_count, max_count;
81  uint64_t abs_peak_count;
83  uint64_t zero_runs;
84  uint64_t nb_samples;
85  uint64_t nb_nans;
86  uint64_t nb_infs;
87  uint64_t nb_denormals;
88  double *win_samples;
89  double *sorted_samples;
94  int win_pos;
95  int max_index;
96  double noise_floor;
97  double entropy;
98 } ChannelStats;
99 
100 typedef struct AudioStatsContext {
101  const AVClass *class;
104  uint64_t tc_samples;
106  double mult;
107  int metadata;
108  int used;
114  int is_float;
117 
118 #define OFFSET(x) offsetof(AudioStatsContext, x)
119 #define FLAGS AV_OPT_FLAG_AUDIO_PARAM|AV_OPT_FLAG_FILTERING_PARAM
120 
121 static const AVOption astats_options[] = {
122  { "length", "set the window length", OFFSET(time_constant), AV_OPT_TYPE_DOUBLE, {.dbl=.05}, 0, 10, FLAGS },
123  { "metadata", "inject metadata in the filtergraph", OFFSET(metadata), AV_OPT_TYPE_BOOL, {.i64=0}, 0, 1, FLAGS },
124  { "reset", "Set the number of frames over which cumulative stats are calculated before being reset", OFFSET(reset_count), AV_OPT_TYPE_INT, {.i64=0}, 0, INT_MAX, FLAGS },
125  { "measure_perchannel", "Select the parameters which are measured per channel", OFFSET(measure_perchannel), AV_OPT_TYPE_FLAGS, {.i64=MEASURE_ALL}, 0, UINT_MAX, FLAGS, .unit = "measure" },
126  { "none" , "", 0, AV_OPT_TYPE_CONST, {.i64=MEASURE_NONE }, 0, 0, FLAGS, .unit = "measure" },
127  { "all" , "", 0, AV_OPT_TYPE_CONST, {.i64=MEASURE_ALL }, 0, 0, FLAGS, .unit = "measure" },
128  { "Bit_depth" , "", 0, AV_OPT_TYPE_CONST, {.i64=MEASURE_BIT_DEPTH }, 0, 0, FLAGS, .unit = "measure" },
129  { "Crest_factor" , "", 0, AV_OPT_TYPE_CONST, {.i64=MEASURE_CREST_FACTOR }, 0, 0, FLAGS, .unit = "measure" },
130  { "DC_offset" , "", 0, AV_OPT_TYPE_CONST, {.i64=MEASURE_DC_OFFSET }, 0, 0, FLAGS, .unit = "measure" },
131  { "Dynamic_range" , "", 0, AV_OPT_TYPE_CONST, {.i64=MEASURE_DYNAMIC_RANGE }, 0, 0, FLAGS, .unit = "measure" },
132  { "Entropy" , "", 0, AV_OPT_TYPE_CONST, {.i64=MEASURE_ENTROPY }, 0, 0, FLAGS, .unit = "measure" },
133  { "Flat_factor" , "", 0, AV_OPT_TYPE_CONST, {.i64=MEASURE_FLAT_FACTOR }, 0, 0, FLAGS, .unit = "measure" },
134  { "Max_difference" , "", 0, AV_OPT_TYPE_CONST, {.i64=MEASURE_MAX_DIFFERENCE }, 0, 0, FLAGS, .unit = "measure" },
135  { "Max_level" , "", 0, AV_OPT_TYPE_CONST, {.i64=MEASURE_MAX_LEVEL }, 0, 0, FLAGS, .unit = "measure" },
136  { "Mean_difference" , "", 0, AV_OPT_TYPE_CONST, {.i64=MEASURE_MEAN_DIFFERENCE }, 0, 0, FLAGS, .unit = "measure" },
137  { "Min_difference" , "", 0, AV_OPT_TYPE_CONST, {.i64=MEASURE_MIN_DIFFERENCE }, 0, 0, FLAGS, .unit = "measure" },
138  { "Min_level" , "", 0, AV_OPT_TYPE_CONST, {.i64=MEASURE_MIN_LEVEL }, 0, 0, FLAGS, .unit = "measure" },
139  { "Noise_floor" , "", 0, AV_OPT_TYPE_CONST, {.i64=MEASURE_NOISE_FLOOR }, 0, 0, FLAGS, .unit = "measure" },
140  { "Noise_floor_count" , "", 0, AV_OPT_TYPE_CONST, {.i64=MEASURE_NOISE_FLOOR_COUNT }, 0, 0, FLAGS, .unit = "measure" },
141  { "Number_of_Infs" , "", 0, AV_OPT_TYPE_CONST, {.i64=MEASURE_NUMBER_OF_INFS }, 0, 0, FLAGS, .unit = "measure" },
142  { "Number_of_NaNs" , "", 0, AV_OPT_TYPE_CONST, {.i64=MEASURE_NUMBER_OF_NANS }, 0, 0, FLAGS, .unit = "measure" },
143  { "Number_of_denormals" , "", 0, AV_OPT_TYPE_CONST, {.i64=MEASURE_NUMBER_OF_DENORMALS }, 0, 0, FLAGS, .unit = "measure" },
144  { "Number_of_samples" , "", 0, AV_OPT_TYPE_CONST, {.i64=MEASURE_NUMBER_OF_SAMPLES }, 0, 0, FLAGS, .unit = "measure" },
145  { "Peak_count" , "", 0, AV_OPT_TYPE_CONST, {.i64=MEASURE_PEAK_COUNT }, 0, 0, FLAGS, .unit = "measure" },
146  { "Peak_level" , "", 0, AV_OPT_TYPE_CONST, {.i64=MEASURE_PEAK_LEVEL }, 0, 0, FLAGS, .unit = "measure" },
147  { "RMS_difference" , "", 0, AV_OPT_TYPE_CONST, {.i64=MEASURE_RMS_DIFFERENCE }, 0, 0, FLAGS, .unit = "measure" },
148  { "RMS_level" , "", 0, AV_OPT_TYPE_CONST, {.i64=MEASURE_RMS_LEVEL }, 0, 0, FLAGS, .unit = "measure" },
149  { "RMS_peak" , "", 0, AV_OPT_TYPE_CONST, {.i64=MEASURE_RMS_PEAK }, 0, 0, FLAGS, .unit = "measure" },
150  { "RMS_trough" , "", 0, AV_OPT_TYPE_CONST, {.i64=MEASURE_RMS_TROUGH }, 0, 0, FLAGS, .unit = "measure" },
151  { "Zero_crossings" , "", 0, AV_OPT_TYPE_CONST, {.i64=MEASURE_ZERO_CROSSINGS }, 0, 0, FLAGS, .unit = "measure" },
152  { "Zero_crossings_rate" , "", 0, AV_OPT_TYPE_CONST, {.i64=MEASURE_ZERO_CROSSINGS_RATE }, 0, 0, FLAGS, .unit = "measure" },
153  { "Abs_Peak_count" , "", 0, AV_OPT_TYPE_CONST, {.i64=MEASURE_ABS_PEAK_COUNT }, 0, 0, FLAGS, .unit = "measure" },
154  { "measure_overall", "Select the parameters which are measured overall", OFFSET(measure_overall), AV_OPT_TYPE_FLAGS, {.i64=MEASURE_ALL}, 0, UINT_MAX, FLAGS, .unit = "measure" },
155  { NULL }
156 };
157 
158 AVFILTER_DEFINE_CLASS(astats);
159 
161 {
162  int c;
163 
164  for (c = 0; c < s->nb_channels; c++) {
165  ChannelStats *p = &s->chstats[c];
166 
167  p->min = p->nmin = p->min_sigma_x2 = DBL_MAX;
168  p->max = p->nmax = p->max_sigma_x2 =-DBL_MAX;
169  p->abs_peak = 0;
170  p->min_non_zero = DBL_MAX;
171  p->min_diff = DBL_MAX;
172  p->max_diff = 0;
173  p->sigma_x = 0;
174  p->sigma_x2 = 0;
175  p->avg_sigma_x2 = 0;
176  p->min_run = 0;
177  p->max_run = 0;
178  p->min_runs = 0;
179  p->max_runs = 0;
180  p->diff1_sum = 0;
181  p->diff1_sum_x2 = 0;
182  p->mask[0] = 0;
183  p->mask[1] = 0;
184  p->mask[2] =~0;
185  p->mask[3] = 0;
186  p->min_count = 0;
187  p->max_count = 0;
188  p->abs_peak_count = 0;
189  p->zero_runs = 0;
190  p->nb_samples = 0;
191  p->nb_nans = 0;
192  p->nb_infs = 0;
193  p->nb_denormals = 0;
194  p->last = NAN;
195  p->noise_floor = NAN;
196  p->noise_floor_count = 0;
197  p->entropy = 0;
198  p->win_pos = 0;
199  p->sorted_front = 0;
200  p->sorted_back = 0;
201  memset(p->win_samples, 0, s->tc_samples * sizeof(*p->win_samples));
202  memset(p->ehistogram, 0, sizeof(p->ehistogram));
203  for (int n = 0; n < s->tc_samples; n++)
204  p->sorted_samples[n] = -1.0;
205  }
206 }
207 
208 static int config_output(AVFilterLink *outlink)
209 {
210  AudioStatsContext *s = outlink->src->priv;
211 
212  s->chstats = av_calloc(sizeof(*s->chstats), outlink->ch_layout.nb_channels);
213  if (!s->chstats)
214  return AVERROR(ENOMEM);
215 
216  s->tc_samples = FFMAX(s->time_constant * outlink->sample_rate + .5, 1);
217  s->nb_channels = outlink->ch_layout.nb_channels;
218 
219  for (int i = 0; i < s->nb_channels; i++) {
220  ChannelStats *p = &s->chstats[i];
221 
222  p->win_samples = av_calloc(s->tc_samples, sizeof(*p->win_samples));
223  if (!p->win_samples)
224  return AVERROR(ENOMEM);
225 
226  p->sorted_samples = av_calloc(s->tc_samples, sizeof(*p->sorted_samples));
227  if (!p->sorted_samples)
228  return AVERROR(ENOMEM);
229  }
230 
231  s->mult = exp((-1 / s->time_constant / outlink->sample_rate));
232  s->nb_frames = 0;
233  s->maxbitdepth = av_get_bytes_per_sample(outlink->format) * 8;
234  s->is_double = outlink->format == AV_SAMPLE_FMT_DBL ||
235  outlink->format == AV_SAMPLE_FMT_DBLP;
236 
237  s->is_float = outlink->format == AV_SAMPLE_FMT_FLT ||
238  outlink->format == AV_SAMPLE_FMT_FLTP;
239 
240  reset_stats(s);
241 
242  return 0;
243 }
244 
245 static void bit_depth(AudioStatsContext *s, const uint64_t *const mask, uint8_t *depth)
246 {
247  unsigned result = s->maxbitdepth;
248  uint64_t amask = mask[1] & (~mask[2]);
249 
250  depth[0] = 0;
251  for (int i = 0; i < result; i++)
252  depth[0] += !!(mask[0] & (1ULL << i));
253 
254  depth[1] = 0;
255  for (int i = 0; i < result; i++)
256  depth[1] += !!(mask[1] & (1ULL << i));
257 
258  depth[2] = result;
259  for (int i = 0; i < result && !(amask & 1); i++) {
260  depth[2]--;
261  amask >>= 1;
262  }
263 
264  depth[3] = 0;
265  for (int i = 0; i < result; i++)
266  depth[3] += !!(mask[3] & (1ULL << i));
267 }
268 
270 {
271  double entropy = 0.;
272 
273  for (int i = 0; i < HISTOGRAM_SIZE; i++) {
274  double entry = p->ehistogram[i] / ((double)p->nb_samples);
275 
276  if (entry > 1e-8)
277  entropy += entry * log2(entry);
278  }
279 
280  return -entropy / log2(HISTOGRAM_SIZE);
281 }
282 
283 static double calc_noise_floor(double *ss, double x, double px,
284  int n, int *ffront, int *bback)
285 {
286  double r, ax = fabs(x);
287  int front = *ffront;
288  int back = *bback;
289  int empty = front == back && ss[front] == -1.0;
290 
291  if (!empty && fabs(px) == ss[front]) {
292  ss[front] = -1.0;
293  if (back != front) {
294  front--;
295  if (front < 0)
296  front = n - 1;
297  }
298  empty = front == back;
299  }
300 
301  if (!empty && ax >= ss[front]) {
302  while (1) {
303  ss[front] = -1.0;
304  if (back == front) {
305  empty = 1;
306  break;
307  }
308  front--;
309  if (front < 0)
310  front = n - 1;
311  }
312  }
313 
314  while (!empty && ax >= ss[back]) {
315  ss[back] = -1.0;
316  if (back == front) {
317  empty = 1;
318  break;
319  }
320  back++;
321  if (back >= n)
322  back = 0;
323  }
324 
325  if (!empty) {
326  back--;
327  if (back < 0)
328  back = n - 1;
329  }
330 
331  ss[back] = ax;
332  r = ss[front];
333 
334  *ffront = front;
335  *bback = back;
336 
337  return r;
338 }
339 
340 static inline void update_minmax(AudioStatsContext *s, ChannelStats *p, double d)
341 {
342  if (d < p->min)
343  p->min = d;
344  if (d > p->max)
345  p->max = d;
346 }
347 
348 static inline void update_stat(AudioStatsContext *s, ChannelStats *p, double d, double nd, int64_t i)
349 {
350  double abs_d = FFABS(d);
351  double drop, noise_floor;
352  int index;
353 
354  if (p->abs_peak < abs_d) {
355  p->abs_peak = abs_d;
356  p->abs_peak_count = 1;
357  } else if (p->abs_peak == abs_d) {
358  p->abs_peak_count++;
359  }
360  if (d < p->min) {
361  p->min = d;
362  p->nmin = nd;
363  p->min_run = 1;
364  p->min_runs = 0;
365  p->min_count = 1;
366  } else if (d == p->min) {
367  p->min_count++;
368  p->min_run = d == p->last ? p->min_run + 1 : 1;
369  } else if (p->last == p->min) {
370  p->min_runs += p->min_run * p->min_run;
371  }
372 
373  if (d != 0 && FFABS(d) < p->min_non_zero)
374  p->min_non_zero = FFABS(d);
375 
376  if (d > p->max) {
377  p->max = d;
378  p->nmax = nd;
379  p->max_run = 1;
380  p->max_runs = 0;
381  p->max_count = 1;
382  } else if (d == p->max) {
383  p->max_count++;
384  p->max_run = d == p->last ? p->max_run + 1 : 1;
385  } else if (p->last == p->max) {
386  p->max_runs += p->max_run * p->max_run;
387  }
388 
389  if (d != 0) {
390  p->zero_runs += FFSIGN(d) != FFSIGN(p->last_non_zero);
391  p->last_non_zero = d;
392  }
393 
394  p->sigma_x += nd;
395  p->sigma_x2 += nd * nd;
396  p->avg_sigma_x2 = p->avg_sigma_x2 * s->mult + (1.0 - s->mult) * nd * nd;
397  if (!isnan(p->last)) {
398  p->min_diff = FFMIN(p->min_diff, fabs(d - p->last));
399  p->max_diff = FFMAX(p->max_diff, fabs(d - p->last));
400  p->diff1_sum += fabs(d - p->last);
401  p->diff1_sum_x2 += (d - p->last) * (d - p->last);
402  }
403  p->mask[0] |= (i < 0) ? -i : i;
404  p->mask[1] |= i;
405  p->mask[2] &= i;
406  if (!isnan(p->last))
407  p->mask[3] |= i ^ p->lasti;
408  p->lasti = i;
409  p->last = d;
410 
411  drop = p->win_samples[p->win_pos];
412  p->win_samples[p->win_pos] = nd;
413  index = av_clip(lrint(av_clipd(FFABS(nd), 0.0, 1.0) * HISTOGRAM_MAX), 0, HISTOGRAM_MAX);
414  p->max_index = FFMAX(p->max_index, index);
415  p->ehistogram[index]++;
416  p->win_pos++;
417 
418  if (p->win_pos >= s->tc_samples)
419  p->win_pos = 0;
420 
421  if (p->nb_samples >= s->tc_samples) {
424  }
425  p->nb_samples++;
426 
427  noise_floor = calc_noise_floor(p->sorted_samples, nd, drop,
428  s->tc_samples, &p->sorted_front, &p->sorted_back);
429  if (p->nb_samples >= s->tc_samples) {
430  if (isnan(p->noise_floor)) {
431  p->noise_floor = noise_floor;
432  p->noise_floor_count = 1;
433  } else {
434  if (noise_floor < p->noise_floor) {
435  p->noise_floor = noise_floor;
436  p->noise_floor_count = 1;
437  } else if (noise_floor == p->noise_floor) {
438  p->noise_floor_count++;
439  }
440  }
441  }
442 }
443 
444 static inline void update_float_stat(AudioStatsContext *s, ChannelStats *p, float d)
445 {
446  int type = fpclassify(d);
447 
448  p->nb_nans += type == FP_NAN;
449  p->nb_infs += type == FP_INFINITE;
450  p->nb_denormals += type == FP_SUBNORMAL;
451 }
452 
453 static inline void update_double_stat(AudioStatsContext *s, ChannelStats *p, double d)
454 {
455  int type = fpclassify(d);
456 
457  p->nb_nans += type == FP_NAN;
458  p->nb_infs += type == FP_INFINITE;
459  p->nb_denormals += type == FP_SUBNORMAL;
460 }
461 
462 static void set_meta(AVDictionary **metadata, int chan, const char *key,
463  const char *fmt, double val)
464 {
465  uint8_t value[128];
466  uint8_t key2[128];
467 
468  snprintf(value, sizeof(value), fmt, val);
469  if (chan)
470  snprintf(key2, sizeof(key2), "lavfi.astats.%d.%s", chan, key);
471  else
472  snprintf(key2, sizeof(key2), "lavfi.astats.%s", key);
473  av_dict_set(metadata, key2, value, 0);
474 }
475 
476 #define LINEAR_TO_DB(x) (log10(x) * 20)
477 
478 static void set_metadata(AudioStatsContext *s, AVDictionary **metadata)
479 {
480  uint64_t mask[4], min_count = 0, max_count = 0, nb_samples = 0, noise_floor_count = 0;
481  uint64_t nb_nans = 0, nb_infs = 0, nb_denormals = 0;
482  uint64_t abs_peak_count = 0;
483  double min_runs = 0, max_runs = 0,
484  min = DBL_MAX, max =-DBL_MAX, min_diff = DBL_MAX, max_diff = 0,
485  nmin = DBL_MAX, nmax =-DBL_MAX,
486  max_sigma_x = 0,
487  diff1_sum = 0,
488  diff1_sum_x2 = 0,
489  sigma_x2 = 0,
490  noise_floor = 0,
491  entropy = 0,
492  min_sigma_x2 = DBL_MAX,
493  max_sigma_x2 =-DBL_MAX;
494  uint8_t depth[4];
495  int c;
496 
497  mask[0] = 0;
498  mask[1] = 0;
499  mask[2] =~0;
500  mask[3] = 0;
501 
502  for (c = 0; c < s->nb_channels; c++) {
503  ChannelStats *p = &s->chstats[c];
504 
505  if (p->nb_samples < s->tc_samples)
506  p->min_sigma_x2 = p->max_sigma_x2 = p->sigma_x2 / p->nb_samples;
507 
508  min = FFMIN(min, p->min);
509  max = FFMAX(max, p->max);
510  nmin = FFMIN(nmin, p->nmin);
511  nmax = FFMAX(nmax, p->nmax);
512  min_diff = FFMIN(min_diff, p->min_diff);
513  max_diff = FFMAX(max_diff, p->max_diff);
514  diff1_sum += p->diff1_sum;
515  diff1_sum_x2 += p->diff1_sum_x2;
516  min_sigma_x2 = FFMIN(min_sigma_x2, p->min_sigma_x2);
517  max_sigma_x2 = FFMAX(max_sigma_x2, p->max_sigma_x2);
518  sigma_x2 += p->sigma_x2;
519  noise_floor = FFMAX(noise_floor, p->noise_floor);
520  noise_floor_count += p->noise_floor_count;
521  p->entropy = calc_entropy(s, p);
522  entropy += p->entropy;
523  min_count += p->min_count;
524  max_count += p->max_count;
525  abs_peak_count += p->abs_peak_count;
526  min_runs += p->min_runs;
527  max_runs += p->max_runs;
528  mask[0] |= p->mask[0];
529  mask[1] |= p->mask[1];
530  mask[2] &= p->mask[2];
531  mask[3] |= p->mask[3];
532  nb_samples += p->nb_samples;
533  nb_nans += p->nb_nans;
534  nb_infs += p->nb_infs;
535  nb_denormals += p->nb_denormals;
536  if (fabs(p->sigma_x) > fabs(max_sigma_x))
537  max_sigma_x = p->sigma_x;
538 
539  if (s->measure_perchannel & MEASURE_DC_OFFSET)
540  set_meta(metadata, c + 1, "DC_offset", "%f", p->sigma_x / p->nb_samples);
541  if (s->measure_perchannel & MEASURE_MIN_LEVEL)
542  set_meta(metadata, c + 1, "Min_level", "%f", p->min);
543  if (s->measure_perchannel & MEASURE_MAX_LEVEL)
544  set_meta(metadata, c + 1, "Max_level", "%f", p->max);
545  if (s->measure_perchannel & MEASURE_MIN_DIFFERENCE)
546  set_meta(metadata, c + 1, "Min_difference", "%f", p->min_diff);
547  if (s->measure_perchannel & MEASURE_MAX_DIFFERENCE)
548  set_meta(metadata, c + 1, "Max_difference", "%f", p->max_diff);
549  if (s->measure_perchannel & MEASURE_MEAN_DIFFERENCE)
550  set_meta(metadata, c + 1, "Mean_difference", "%f", p->diff1_sum / (p->nb_samples - 1));
551  if (s->measure_perchannel & MEASURE_RMS_DIFFERENCE)
552  set_meta(metadata, c + 1, "RMS_difference", "%f", sqrt(p->diff1_sum_x2 / (p->nb_samples - 1)));
553  if (s->measure_perchannel & MEASURE_PEAK_LEVEL)
554  set_meta(metadata, c + 1, "Peak_level", "%f", LINEAR_TO_DB(FFMAX(-p->nmin, p->nmax)));
555  if (s->measure_perchannel & MEASURE_RMS_LEVEL)
556  set_meta(metadata, c + 1, "RMS_level", "%f", LINEAR_TO_DB(sqrt(p->sigma_x2 / p->nb_samples)));
557  if (s->measure_perchannel & MEASURE_RMS_PEAK)
558  set_meta(metadata, c + 1, "RMS_peak", "%f", LINEAR_TO_DB(sqrt(p->max_sigma_x2)));
559  if (s->measure_perchannel & MEASURE_RMS_TROUGH)
560  set_meta(metadata, c + 1, "RMS_trough", "%f", LINEAR_TO_DB(sqrt(p->min_sigma_x2)));
561  if (s->measure_perchannel & MEASURE_CREST_FACTOR)
562  set_meta(metadata, c + 1, "Crest_factor", "%f", p->sigma_x2 ? FFMAX(-p->min, p->max) / sqrt(p->sigma_x2 / p->nb_samples) : 1);
563  if (s->measure_perchannel & MEASURE_FLAT_FACTOR)
564  set_meta(metadata, c + 1, "Flat_factor", "%f", LINEAR_TO_DB((p->min_runs + p->max_runs) / (p->min_count + p->max_count)));
565  if (s->measure_perchannel & MEASURE_PEAK_COUNT)
566  set_meta(metadata, c + 1, "Peak_count", "%f", (float)(p->min_count + p->max_count));
567  if (s->measure_perchannel & MEASURE_ABS_PEAK_COUNT)
568  set_meta(metadata, c + 1, "Peak_count", "%f", p->abs_peak_count);
569  if (s->measure_perchannel & MEASURE_NOISE_FLOOR)
570  set_meta(metadata, c + 1, "Noise_floor", "%f", LINEAR_TO_DB(p->noise_floor));
571  if (s->measure_perchannel & MEASURE_NOISE_FLOOR_COUNT)
572  set_meta(metadata, c + 1, "Noise_floor_count", "%f", p->noise_floor_count);
573  if (s->measure_perchannel & MEASURE_ENTROPY)
574  set_meta(metadata, c + 1, "Entropy", "%f", p->entropy);
575  if (s->measure_perchannel & MEASURE_BIT_DEPTH) {
576  bit_depth(s, p->mask, depth);
577  set_meta(metadata, c + 1, "Bit_depth", "%f", depth[0]);
578  set_meta(metadata, c + 1, "Bit_depth2", "%f", depth[1]);
579  set_meta(metadata, c + 1, "Bit_depth3", "%f", depth[2]);
580  set_meta(metadata, c + 1, "Bit_depth4", "%f", depth[3]);
581  }
582  if (s->measure_perchannel & MEASURE_DYNAMIC_RANGE)
583  set_meta(metadata, c + 1, "Dynamic_range", "%f", LINEAR_TO_DB(2 * FFMAX(FFABS(p->min), FFABS(p->max))/ p->min_non_zero));
584  if (s->measure_perchannel & MEASURE_ZERO_CROSSINGS)
585  set_meta(metadata, c + 1, "Zero_crossings", "%f", p->zero_runs);
586  if (s->measure_perchannel & MEASURE_ZERO_CROSSINGS_RATE)
587  set_meta(metadata, c + 1, "Zero_crossings_rate", "%f", p->zero_runs/(double)p->nb_samples);
588  if ((s->is_float || s->is_double) && s->measure_perchannel & MEASURE_NUMBER_OF_NANS)
589  set_meta(metadata, c + 1, "Number of NaNs", "%f", p->nb_nans);
590  if ((s->is_float || s->is_double) && s->measure_perchannel & MEASURE_NUMBER_OF_INFS)
591  set_meta(metadata, c + 1, "Number of Infs", "%f", p->nb_infs);
592  if ((s->is_float || s->is_double) && s->measure_perchannel & MEASURE_NUMBER_OF_DENORMALS)
593  set_meta(metadata, c + 1, "Number of denormals", "%f", p->nb_denormals);
594  }
595 
596  if (s->measure_overall & MEASURE_DC_OFFSET)
597  set_meta(metadata, 0, "Overall.DC_offset", "%f", max_sigma_x / (nb_samples / s->nb_channels));
598  if (s->measure_overall & MEASURE_MIN_LEVEL)
599  set_meta(metadata, 0, "Overall.Min_level", "%f", min);
600  if (s->measure_overall & MEASURE_MAX_LEVEL)
601  set_meta(metadata, 0, "Overall.Max_level", "%f", max);
602  if (s->measure_overall & MEASURE_MIN_DIFFERENCE)
603  set_meta(metadata, 0, "Overall.Min_difference", "%f", min_diff);
604  if (s->measure_overall & MEASURE_MAX_DIFFERENCE)
605  set_meta(metadata, 0, "Overall.Max_difference", "%f", max_diff);
606  if (s->measure_overall & MEASURE_MEAN_DIFFERENCE)
607  set_meta(metadata, 0, "Overall.Mean_difference", "%f", diff1_sum / (nb_samples - s->nb_channels));
608  if (s->measure_overall & MEASURE_RMS_DIFFERENCE)
609  set_meta(metadata, 0, "Overall.RMS_difference", "%f", sqrt(diff1_sum_x2 / (nb_samples - s->nb_channels)));
610  if (s->measure_overall & MEASURE_PEAK_LEVEL)
611  set_meta(metadata, 0, "Overall.Peak_level", "%f", LINEAR_TO_DB(FFMAX(-nmin, nmax)));
612  if (s->measure_overall & MEASURE_RMS_LEVEL)
613  set_meta(metadata, 0, "Overall.RMS_level", "%f", LINEAR_TO_DB(sqrt(sigma_x2 / nb_samples)));
614  if (s->measure_overall & MEASURE_RMS_PEAK)
615  set_meta(metadata, 0, "Overall.RMS_peak", "%f", LINEAR_TO_DB(sqrt(max_sigma_x2)));
616  if (s->measure_overall & MEASURE_RMS_TROUGH)
617  set_meta(metadata, 0, "Overall.RMS_trough", "%f", LINEAR_TO_DB(sqrt(min_sigma_x2)));
618  if (s->measure_overall & MEASURE_FLAT_FACTOR)
619  set_meta(metadata, 0, "Overall.Flat_factor", "%f", LINEAR_TO_DB((min_runs + max_runs) / (min_count + max_count)));
620  if (s->measure_overall & MEASURE_PEAK_COUNT)
621  set_meta(metadata, 0, "Overall.Peak_count", "%f", (float)(min_count + max_count) / (double)s->nb_channels);
622  if (s->measure_overall & MEASURE_ABS_PEAK_COUNT)
623  set_meta(metadata, 0, "Overall.Abs_Peak_count", "%f", (float)(abs_peak_count) / (double)s->nb_channels);
624  if (s->measure_overall & MEASURE_NOISE_FLOOR)
625  set_meta(metadata, 0, "Overall.Noise_floor", "%f", LINEAR_TO_DB(noise_floor));
626  if (s->measure_overall & MEASURE_NOISE_FLOOR_COUNT)
627  set_meta(metadata, 0, "Overall.Noise_floor_count", "%f", noise_floor_count / (double)s->nb_channels);
628  if (s->measure_overall & MEASURE_ENTROPY)
629  set_meta(metadata, 0, "Overall.Entropy", "%f", entropy / (double)s->nb_channels);
630  if (s->measure_overall & MEASURE_BIT_DEPTH) {
631  bit_depth(s, mask, depth);
632  set_meta(metadata, 0, "Overall.Bit_depth", "%f", depth[0]);
633  set_meta(metadata, 0, "Overall.Bit_depth2", "%f", depth[1]);
634  set_meta(metadata, 0, "Overall.Bit_depth3", "%f", depth[2]);
635  set_meta(metadata, 0, "Overall.Bit_depth4", "%f", depth[3]);
636  }
637  if (s->measure_overall & MEASURE_NUMBER_OF_SAMPLES)
638  set_meta(metadata, 0, "Overall.Number_of_samples", "%f", nb_samples / s->nb_channels);
639  if ((s->is_float || s->is_double) && s->measure_overall & MEASURE_NUMBER_OF_NANS)
640  set_meta(metadata, 0, "Number of NaNs", "%f", nb_nans / (float)s->nb_channels);
641  if ((s->is_float || s->is_double) && s->measure_overall & MEASURE_NUMBER_OF_INFS)
642  set_meta(metadata, 0, "Number of Infs", "%f", nb_infs / (float)s->nb_channels);
643  if ((s->is_float || s->is_double) && s->measure_overall & MEASURE_NUMBER_OF_DENORMALS)
644  set_meta(metadata, 0, "Number of denormals", "%f", nb_denormals / (float)s->nb_channels);
645 }
646 
647 #define UPDATE_STATS_P(type, update_func, update_float, channel_func) \
648  for (int c = start; c < end; c++) { \
649  ChannelStats *p = &s->chstats[c]; \
650  const type *src = (const type *)data[c]; \
651  const type * const srcend = src + samples; \
652  for (; src < srcend; src++) { \
653  update_func; \
654  update_float; \
655  } \
656  channel_func; \
657  }
658 
659 #define UPDATE_STATS_I(type, update_func, update_float, channel_func) \
660  for (int c = start; c < end; c++) { \
661  ChannelStats *p = &s->chstats[c]; \
662  const type *src = (const type *)data[0]; \
663  const type * const srcend = src + samples * channels; \
664  for (src += c; src < srcend; src += channels) { \
665  update_func; \
666  update_float; \
667  } \
668  channel_func; \
669  }
670 
671 #define UPDATE_STATS(planar, type, sample, normalizer_suffix, int_sample) \
672  if ((s->measure_overall | s->measure_perchannel) & ~MEASURE_MINMAXPEAK) { \
673  UPDATE_STATS_##planar(type, update_stat(s, p, sample, sample normalizer_suffix, int_sample), s->is_float ? update_float_stat(s, p, sample) : s->is_double ? update_double_stat(s, p, sample) : (void)NULL, ); \
674  } else { \
675  UPDATE_STATS_##planar(type, update_minmax(s, p, sample), , p->nmin = p->min normalizer_suffix; p->nmax = p->max normalizer_suffix;); \
676  }
677 
678 static int filter_channel(AVFilterContext *ctx, void *arg, int jobnr, int nb_jobs)
679 {
680  AudioStatsContext *s = ctx->priv;
681  AVFilterLink *inlink = ctx->inputs[0];
682  AVFrame *buf = arg;
683  const uint8_t * const * const data = (const uint8_t * const *)buf->extended_data;
684  const int channels = s->nb_channels;
685  const int samples = buf->nb_samples;
686  const int start = (buf->ch_layout.nb_channels * jobnr) / nb_jobs;
687  const int end = (buf->ch_layout.nb_channels * (jobnr+1)) / nb_jobs;
688 
689  switch (inlink->format) {
690  case AV_SAMPLE_FMT_DBLP:
691  UPDATE_STATS(P, double, *src, , llrint(*src * (UINT64_C(1) << 63)));
692  break;
693  case AV_SAMPLE_FMT_DBL:
694  UPDATE_STATS(I, double, *src, , llrint(*src * (UINT64_C(1) << 63)));
695  break;
696  case AV_SAMPLE_FMT_FLTP:
697  UPDATE_STATS(P, float, *src, , llrint(*src * (UINT64_C(1) << 31)));
698  break;
699  case AV_SAMPLE_FMT_FLT:
700  UPDATE_STATS(I, float, *src, , llrint(*src * (UINT64_C(1) << 31)));
701  break;
702  case AV_SAMPLE_FMT_S64P:
703  UPDATE_STATS(P, int64_t, *src, / (double)INT64_MAX, *src);
704  break;
705  case AV_SAMPLE_FMT_S64:
706  UPDATE_STATS(I, int64_t, *src, / (double)INT64_MAX, *src);
707  break;
708  case AV_SAMPLE_FMT_S32P:
709  UPDATE_STATS(P, int32_t, *src, / (double)INT32_MAX, *src);
710  break;
711  case AV_SAMPLE_FMT_S32:
712  UPDATE_STATS(I, int32_t, *src, / (double)INT32_MAX, *src);
713  break;
714  case AV_SAMPLE_FMT_S16P:
715  UPDATE_STATS(P, int16_t, *src, / (double)INT16_MAX, *src);
716  break;
717  case AV_SAMPLE_FMT_S16:
718  UPDATE_STATS(I, int16_t, *src, / (double)INT16_MAX, *src);
719  break;
720  }
721 
722  return 0;
723 }
724 
726 {
727  AVFilterContext *ctx = inlink->dst;
728  AudioStatsContext *s = ctx->priv;
729  AVDictionary **metadata = &buf->metadata;
730 
731  if (s->reset_count > 0) {
732  if (s->nb_frames >= s->reset_count) {
733  reset_stats(s);
734  s->nb_frames = 0;
735  }
736  s->nb_frames++;
737  }
738 
739  if (s->used == 0)
740  s->used = buf->nb_samples > 0;
742  FFMIN(inlink->ch_layout.nb_channels, ff_filter_get_nb_threads(ctx)));
743 
744  if (s->metadata)
745  set_metadata(s, metadata);
746 
747  return ff_filter_frame(inlink->dst->outputs[0], buf);
748 }
749 
751 {
752  AudioStatsContext *s = ctx->priv;
753  uint64_t mask[4], min_count = 0, max_count = 0, nb_samples = 0, noise_floor_count = 0;
754  uint64_t nb_nans = 0, nb_infs = 0, nb_denormals = 0, abs_peak_count = 0;
755  double min_runs = 0, max_runs = 0,
756  min = DBL_MAX, max =-DBL_MAX, min_diff = DBL_MAX, max_diff = 0,
757  nmin = DBL_MAX, nmax =-DBL_MAX,
758  max_sigma_x = 0,
759  diff1_sum_x2 = 0,
760  diff1_sum = 0,
761  sigma_x2 = 0,
762  noise_floor = 0,
763  entropy = 0,
764  min_sigma_x2 = DBL_MAX,
765  max_sigma_x2 =-DBL_MAX;
766  uint8_t depth[4];
767  int c;
768 
769  mask[0] = 0;
770  mask[1] = 0;
771  mask[2] =~0;
772  mask[3] = 0;
773 
774  for (c = 0; c < s->nb_channels; c++) {
775  ChannelStats *p = &s->chstats[c];
776 
777  if (p->nb_samples == 0 && !s->used)
778  continue;
779 
780  if (p->nb_samples < s->tc_samples)
781  p->min_sigma_x2 = p->max_sigma_x2 = p->sigma_x2 / p->nb_samples;
782 
783  min = FFMIN(min, p->min);
784  max = FFMAX(max, p->max);
785  nmin = FFMIN(nmin, p->nmin);
786  nmax = FFMAX(nmax, p->nmax);
787  min_diff = FFMIN(min_diff, p->min_diff);
788  max_diff = FFMAX(max_diff, p->max_diff);
789  diff1_sum_x2 += p->diff1_sum_x2;
790  diff1_sum += p->diff1_sum;
791  min_sigma_x2 = FFMIN(min_sigma_x2, p->min_sigma_x2);
792  max_sigma_x2 = FFMAX(max_sigma_x2, p->max_sigma_x2);
793  sigma_x2 += p->sigma_x2;
794  noise_floor = FFMAX(noise_floor, p->noise_floor);
795  p->entropy = calc_entropy(s, p);
796  entropy += p->entropy;
797  min_count += p->min_count;
798  max_count += p->max_count;
799  abs_peak_count += p->abs_peak_count;
800  noise_floor_count += p->noise_floor_count;
801  min_runs += p->min_runs;
802  max_runs += p->max_runs;
803  mask[0] |= p->mask[0];
804  mask[1] |= p->mask[1];
805  mask[2] &= p->mask[2];
806  mask[3] |= p->mask[3];
807  nb_samples += p->nb_samples;
808  nb_nans += p->nb_nans;
809  nb_infs += p->nb_infs;
810  nb_denormals += p->nb_denormals;
811  if (fabs(p->sigma_x) > fabs(max_sigma_x))
812  max_sigma_x = p->sigma_x;
813 
814  if (s->measure_perchannel != MEASURE_NONE)
815  av_log(ctx, AV_LOG_INFO, "Channel: %d\n", c + 1);
816  if (s->measure_perchannel & MEASURE_DC_OFFSET)
817  av_log(ctx, AV_LOG_INFO, "DC offset: %f\n", p->sigma_x / p->nb_samples);
818  if (s->measure_perchannel & MEASURE_MIN_LEVEL)
819  av_log(ctx, AV_LOG_INFO, "Min level: %f\n", p->min);
820  if (s->measure_perchannel & MEASURE_MAX_LEVEL)
821  av_log(ctx, AV_LOG_INFO, "Max level: %f\n", p->max);
822  if (s->measure_perchannel & MEASURE_MIN_DIFFERENCE)
823  av_log(ctx, AV_LOG_INFO, "Min difference: %f\n", p->min_diff);
824  if (s->measure_perchannel & MEASURE_MAX_DIFFERENCE)
825  av_log(ctx, AV_LOG_INFO, "Max difference: %f\n", p->max_diff);
826  if (s->measure_perchannel & MEASURE_MEAN_DIFFERENCE)
827  av_log(ctx, AV_LOG_INFO, "Mean difference: %f\n", p->diff1_sum / (p->nb_samples - 1));
828  if (s->measure_perchannel & MEASURE_RMS_DIFFERENCE)
829  av_log(ctx, AV_LOG_INFO, "RMS difference: %f\n", sqrt(p->diff1_sum_x2 / (p->nb_samples - 1)));
830  if (s->measure_perchannel & MEASURE_PEAK_LEVEL)
831  av_log(ctx, AV_LOG_INFO, "Peak level dB: %f\n", LINEAR_TO_DB(FFMAX(-p->nmin, p->nmax)));
832  if (s->measure_perchannel & MEASURE_RMS_LEVEL)
833  av_log(ctx, AV_LOG_INFO, "RMS level dB: %f\n", LINEAR_TO_DB(sqrt(p->sigma_x2 / p->nb_samples)));
834  if (s->measure_perchannel & MEASURE_RMS_PEAK)
835  av_log(ctx, AV_LOG_INFO, "RMS peak dB: %f\n", LINEAR_TO_DB(sqrt(p->max_sigma_x2)));
836  if (s->measure_perchannel & MEASURE_RMS_TROUGH)
837  if (p->min_sigma_x2 != 1)
838  av_log(ctx, AV_LOG_INFO, "RMS trough dB: %f\n",LINEAR_TO_DB(sqrt(p->min_sigma_x2)));
839  if (s->measure_perchannel & MEASURE_CREST_FACTOR)
840  av_log(ctx, AV_LOG_INFO, "Crest factor: %f\n", p->sigma_x2 ? FFMAX(-p->nmin, p->nmax) / sqrt(p->sigma_x2 / p->nb_samples) : 1);
841  if (s->measure_perchannel & MEASURE_FLAT_FACTOR)
842  av_log(ctx, AV_LOG_INFO, "Flat factor: %f\n", LINEAR_TO_DB((p->min_runs + p->max_runs) / (p->min_count + p->max_count)));
843  if (s->measure_perchannel & MEASURE_PEAK_COUNT)
844  av_log(ctx, AV_LOG_INFO, "Peak count: %"PRId64"\n", p->min_count + p->max_count);
845  if (s->measure_perchannel & MEASURE_ABS_PEAK_COUNT)
846  av_log(ctx, AV_LOG_INFO, "Abs Peak count: %"PRId64"\n", p->abs_peak_count);
847  if (s->measure_perchannel & MEASURE_NOISE_FLOOR)
848  av_log(ctx, AV_LOG_INFO, "Noise floor dB: %f\n", LINEAR_TO_DB(p->noise_floor));
849  if (s->measure_perchannel & MEASURE_NOISE_FLOOR_COUNT)
850  av_log(ctx, AV_LOG_INFO, "Noise floor count: %"PRId64"\n", p->noise_floor_count);
851  if (s->measure_perchannel & MEASURE_ENTROPY)
852  av_log(ctx, AV_LOG_INFO, "Entropy: %f\n", p->entropy);
853  if (s->measure_perchannel & MEASURE_BIT_DEPTH) {
854  bit_depth(s, p->mask, depth);
855  av_log(ctx, AV_LOG_INFO, "Bit depth: %u/%u/%u/%u\n", depth[0], depth[1], depth[2], depth[3]);
856  }
857  if (s->measure_perchannel & MEASURE_DYNAMIC_RANGE)
858  av_log(ctx, AV_LOG_INFO, "Dynamic range: %f\n", LINEAR_TO_DB(2 * FFMAX(FFABS(p->min), FFABS(p->max))/ p->min_non_zero));
859  if (s->measure_perchannel & MEASURE_ZERO_CROSSINGS)
860  av_log(ctx, AV_LOG_INFO, "Zero crossings: %"PRId64"\n", p->zero_runs);
861  if (s->measure_perchannel & MEASURE_ZERO_CROSSINGS_RATE)
862  av_log(ctx, AV_LOG_INFO, "Zero crossings rate: %f\n", p->zero_runs/(double)p->nb_samples);
863  if ((s->is_float || s->is_double) && s->measure_perchannel & MEASURE_NUMBER_OF_NANS)
864  av_log(ctx, AV_LOG_INFO, "Number of NaNs: %"PRId64"\n", p->nb_nans);
865  if ((s->is_float || s->is_double) && s->measure_perchannel & MEASURE_NUMBER_OF_INFS)
866  av_log(ctx, AV_LOG_INFO, "Number of Infs: %"PRId64"\n", p->nb_infs);
867  if ((s->is_float || s->is_double) && s->measure_perchannel & MEASURE_NUMBER_OF_DENORMALS)
868  av_log(ctx, AV_LOG_INFO, "Number of denormals: %"PRId64"\n", p->nb_denormals);
869  }
870 
871  if (nb_samples == 0 && !s->used)
872  return;
873 
874  if (s->measure_overall != MEASURE_NONE)
875  av_log(ctx, AV_LOG_INFO, "Overall\n");
876  if (s->measure_overall & MEASURE_DC_OFFSET)
877  av_log(ctx, AV_LOG_INFO, "DC offset: %f\n", max_sigma_x / (nb_samples / s->nb_channels));
878  if (s->measure_overall & MEASURE_MIN_LEVEL)
879  av_log(ctx, AV_LOG_INFO, "Min level: %f\n", min);
880  if (s->measure_overall & MEASURE_MAX_LEVEL)
881  av_log(ctx, AV_LOG_INFO, "Max level: %f\n", max);
882  if (s->measure_overall & MEASURE_MIN_DIFFERENCE)
883  av_log(ctx, AV_LOG_INFO, "Min difference: %f\n", min_diff);
884  if (s->measure_overall & MEASURE_MAX_DIFFERENCE)
885  av_log(ctx, AV_LOG_INFO, "Max difference: %f\n", max_diff);
886  if (s->measure_overall & MEASURE_MEAN_DIFFERENCE)
887  av_log(ctx, AV_LOG_INFO, "Mean difference: %f\n", diff1_sum / (nb_samples - s->nb_channels));
888  if (s->measure_overall & MEASURE_RMS_DIFFERENCE)
889  av_log(ctx, AV_LOG_INFO, "RMS difference: %f\n", sqrt(diff1_sum_x2 / (nb_samples - s->nb_channels)));
890  if (s->measure_overall & MEASURE_PEAK_LEVEL)
891  av_log(ctx, AV_LOG_INFO, "Peak level dB: %f\n", LINEAR_TO_DB(FFMAX(-nmin, nmax)));
892  if (s->measure_overall & MEASURE_RMS_LEVEL)
893  av_log(ctx, AV_LOG_INFO, "RMS level dB: %f\n", LINEAR_TO_DB(sqrt(sigma_x2 / nb_samples)));
894  if (s->measure_overall & MEASURE_RMS_PEAK)
895  av_log(ctx, AV_LOG_INFO, "RMS peak dB: %f\n", LINEAR_TO_DB(sqrt(max_sigma_x2)));
896  if (s->measure_overall & MEASURE_RMS_TROUGH)
897  if (min_sigma_x2 != 1)
898  av_log(ctx, AV_LOG_INFO, "RMS trough dB: %f\n", LINEAR_TO_DB(sqrt(min_sigma_x2)));
899  if (s->measure_overall & MEASURE_FLAT_FACTOR)
900  av_log(ctx, AV_LOG_INFO, "Flat factor: %f\n", LINEAR_TO_DB((min_runs + max_runs) / (min_count + max_count)));
901  if (s->measure_overall & MEASURE_PEAK_COUNT)
902  av_log(ctx, AV_LOG_INFO, "Peak count: %f\n", (min_count + max_count) / (double)s->nb_channels);
903  if (s->measure_overall & MEASURE_ABS_PEAK_COUNT)
904  av_log(ctx, AV_LOG_INFO, "Abs Peak count: %f\n", abs_peak_count / (double)s->nb_channels);
905  if (s->measure_overall & MEASURE_NOISE_FLOOR)
906  av_log(ctx, AV_LOG_INFO, "Noise floor dB: %f\n", LINEAR_TO_DB(noise_floor));
907  if (s->measure_overall & MEASURE_NOISE_FLOOR_COUNT)
908  av_log(ctx, AV_LOG_INFO, "Noise floor count: %f\n", noise_floor_count / (double)s->nb_channels);
909  if (s->measure_overall & MEASURE_ENTROPY)
910  av_log(ctx, AV_LOG_INFO, "Entropy: %f\n", entropy / (double)s->nb_channels);
911  if (s->measure_overall & MEASURE_BIT_DEPTH) {
912  bit_depth(s, mask, depth);
913  av_log(ctx, AV_LOG_INFO, "Bit depth: %u/%u/%u/%u\n", depth[0], depth[1], depth[2], depth[3]);
914  }
915  if (s->measure_overall & MEASURE_NUMBER_OF_SAMPLES)
916  av_log(ctx, AV_LOG_INFO, "Number of samples: %"PRId64"\n", nb_samples / s->nb_channels);
917  if ((s->is_float || s->is_double) && s->measure_overall & MEASURE_NUMBER_OF_NANS)
918  av_log(ctx, AV_LOG_INFO, "Number of NaNs: %f\n", nb_nans / (float)s->nb_channels);
919  if ((s->is_float || s->is_double) && s->measure_overall & MEASURE_NUMBER_OF_INFS)
920  av_log(ctx, AV_LOG_INFO, "Number of Infs: %f\n", nb_infs / (float)s->nb_channels);
921  if ((s->is_float || s->is_double) && s->measure_overall & MEASURE_NUMBER_OF_DENORMALS)
922  av_log(ctx, AV_LOG_INFO, "Number of denormals: %f\n", nb_denormals / (float)s->nb_channels);
923 }
924 
926 {
927  AudioStatsContext *s = ctx->priv;
928 
929  if (s->nb_channels)
930  print_stats(ctx);
931  if (s->chstats) {
932  for (int i = 0; i < s->nb_channels; i++) {
933  ChannelStats *p = &s->chstats[i];
934 
935  av_freep(&p->win_samples);
937  }
938  }
939  av_freep(&s->chstats);
940 }
941 
942 static const AVFilterPad astats_inputs[] = {
943  {
944  .name = "default",
945  .type = AVMEDIA_TYPE_AUDIO,
946  .filter_frame = filter_frame,
947  },
948 };
949 
950 static const AVFilterPad astats_outputs[] = {
951  {
952  .name = "default",
953  .type = AVMEDIA_TYPE_AUDIO,
954  .config_props = config_output,
955  },
956 };
957 
959  .name = "astats",
960  .description = NULL_IF_CONFIG_SMALL("Show time domain statistics about audio frames."),
961  .priv_size = sizeof(AudioStatsContext),
962  .priv_class = &astats_class,
963  .uninit = uninit,
972 };
ChannelStats::nmax
double nmax
Definition: af_astats.c:72
AV_SAMPLE_FMT_FLTP
@ AV_SAMPLE_FMT_FLTP
float, planar
Definition: samplefmt.h:66
entry
#define entry
Definition: aom_film_grain_template.c:66
av_clip
#define av_clip
Definition: common.h:98
AudioStatsContext::nb_channels
int nb_channels
Definition: af_astats.c:103
set_meta
static void set_meta(AVDictionary **metadata, int chan, const char *key, const char *fmt, double val)
Definition: af_astats.c:462
r
const char * r
Definition: vf_curves.c:126
AVERROR
Filter the word “frame” indicates either a video frame or a group of audio as stored in an AVFrame structure Format for each input and each output the list of supported formats For video that means pixel format For audio that means channel sample they are references to shared objects When the negotiation mechanism computes the intersection of the formats supported at each end of a all references to both lists are replaced with a reference to the intersection And when a single format is eventually chosen for a link amongst the remaining all references to the list are updated That means that if a filter requires that its input and output have the same format amongst a supported all it has to do is use a reference to the same list of formats query_formats can leave some formats unset and return AVERROR(EAGAIN) to cause the negotiation mechanism toagain later. That can be used by filters with complex requirements to use the format negotiated on one link to set the formats supported on another. Frame references ownership and permissions
opt.h
MEASURE_PEAK_COUNT
#define MEASURE_PEAK_COUNT
Definition: af_astats.c:49
AudioStatsContext::is_double
int is_double
Definition: af_astats.c:115
ff_filter_frame
int ff_filter_frame(AVFilterLink *link, AVFrame *frame)
Send a frame of data to the next filter.
Definition: avfilter.c:1018
astats_options
static const AVOption astats_options[]
Definition: af_astats.c:121
AudioStatsContext::maxbitdepth
int maxbitdepth
Definition: af_astats.c:111
int64_t
long long int64_t
Definition: coverity.c:34
inlink
The exact code depends on how similar the blocks are and how related they are to the and needs to apply these operations to the correct inlink or outlink if there are several Macros are available to factor that when no extra processing is inlink
Definition: filter_design.txt:212
MEASURE_RMS_TROUGH
#define MEASURE_RMS_TROUGH
Definition: af_astats.c:46
MEASURE_MIN_LEVEL
#define MEASURE_MIN_LEVEL
Definition: af_astats.c:37
ChannelStats::diff1_sum
double diff1_sum
Definition: af_astats.c:76
AVFrame
This structure describes decoded (raw) audio or video data.
Definition: frame.h:344
MEASURE_ALL
#define MEASURE_ALL
Definition: af_astats.c:33
MEASURE_NONE
#define MEASURE_NONE
Definition: af_astats.c:34
AudioStatsContext::is_float
int is_float
Definition: af_astats.c:114
AVOption
AVOption.
Definition: opt.h:346
ChannelStats::diff1_sum_x2
double diff1_sum_x2
Definition: af_astats.c:77
ChannelStats::sorted_back
int sorted_back
Definition: af_astats.c:93
AV_SAMPLE_FMT_S32P
@ AV_SAMPLE_FMT_S32P
signed 32 bits, planar
Definition: samplefmt.h:65
data
const char data[16]
Definition: mxf.c:148
config_output
static int config_output(AVFilterLink *outlink)
Definition: af_astats.c:208
AudioStatsContext::tc_samples
uint64_t tc_samples
Definition: af_astats.c:104
float.h
max
#define max(a, b)
Definition: cuda_runtime.h:33
AVDictionary
Definition: dict.c:34
FFMAX
#define FFMAX(a, b)
Definition: macros.h:47
AVFilter::name
const char * name
Filter name.
Definition: avfilter.h:170
ChannelStats::max_sigma_x2
double max_sigma_x2
Definition: af_astats.c:70
AVChannelLayout::nb_channels
int nb_channels
Number of channels in this layout.
Definition: channel_layout.h:313
ChannelStats::abs_peak_count
uint64_t abs_peak_count
Definition: af_astats.c:81
bit_depth
static void bit_depth(AudioStatsContext *s, const uint64_t *const mask, uint8_t *depth)
Definition: af_astats.c:245
reset_stats
static void reset_stats(AudioStatsContext *s)
Definition: af_astats.c:160
ChannelStats::last_non_zero
double last_non_zero
Definition: af_astats.c:67
ChannelStats::mask
uint64_t mask[4]
Definition: af_astats.c:79
update_stat
static void update_stat(AudioStatsContext *s, ChannelStats *p, double d, double nd, int64_t i)
Definition: af_astats.c:348
calc_noise_floor
static double calc_noise_floor(double *ss, double x, double px, int n, int *ffront, int *bback)
Definition: af_astats.c:283
AVFilterContext::priv
void * priv
private data for use by the filter
Definition: avfilter.h:422
FFSIGN
#define FFSIGN(a)
Definition: common.h:73
ChannelStats::nb_nans
uint64_t nb_nans
Definition: af_astats.c:85
update_minmax
static void update_minmax(AudioStatsContext *s, ChannelStats *p, double d)
Definition: af_astats.c:340
val
static double val(void *priv, double ch)
Definition: aeval.c:78
AVFrame::ch_layout
AVChannelLayout ch_layout
Channel layout of the audio data.
Definition: frame.h:745
type
it s the only field you need to keep assuming you have a context There is some magic you don t need to care about around this just let it vf type
Definition: writing_filters.txt:86
AV_SAMPLE_FMT_S64P
@ AV_SAMPLE_FMT_S64P
signed 64 bits, planar
Definition: samplefmt.h:69
ss
#define ss(width, name, subs,...)
Definition: cbs_vp9.c:202
ChannelStats::ehistogram
uint64_t ehistogram[HISTOGRAM_SIZE]
Definition: af_astats.c:90
OFFSET
#define OFFSET(x)
Definition: af_astats.c:118
ChannelStats::avg_sigma_x2
double avg_sigma_x2
Definition: af_astats.c:70
AVFilterPad
A filter pad used for either input or output.
Definition: internal.h:33
ChannelStats::nmin
double nmin
Definition: af_astats.c:72
LINEAR_TO_DB
#define LINEAR_TO_DB(x)
Definition: af_astats.c:476
lrint
#define lrint
Definition: tablegen.h:53
av_cold
#define av_cold
Definition: attributes.h:90
ChannelStats::win_pos
int win_pos
Definition: af_astats.c:94
mask
static const uint16_t mask[17]
Definition: lzw.c:38
ChannelStats::entropy
double entropy
Definition: af_astats.c:97
ChannelStats::last
double last
Definition: af_astats.c:66
AudioStatsContext::mult
double mult
Definition: af_astats.c:106
MEASURE_ABS_PEAK_COUNT
#define MEASURE_ABS_PEAK_COUNT
Definition: af_astats.c:61
s
#define s(width, name)
Definition: cbs_vp9.c:198
AudioStatsContext::measure_overall
int measure_overall
Definition: af_astats.c:113
AV_OPT_TYPE_DOUBLE
@ AV_OPT_TYPE_DOUBLE
Definition: opt.h:237
AVMEDIA_TYPE_AUDIO
@ AVMEDIA_TYPE_AUDIO
Definition: avutil.h:202
filter_frame
static int filter_frame(AVFilterLink *inlink, AVFrame *buf)
Definition: af_astats.c:725
calc_entropy
static double calc_entropy(AudioStatsContext *s, ChannelStats *p)
Definition: af_astats.c:269
ctx
AVFormatContext * ctx
Definition: movenc.c:48
UPDATE_STATS
#define UPDATE_STATS(planar, type, sample, normalizer_suffix, int_sample)
Definition: af_astats.c:671
channels
channels
Definition: aptx.h:31
ChannelStats::max
double max
Definition: af_astats.c:71
update_double_stat
static void update_double_stat(AudioStatsContext *s, ChannelStats *p, double d)
Definition: af_astats.c:453
ChannelStats::max_index
int max_index
Definition: af_astats.c:95
HISTOGRAM_MAX
#define HISTOGRAM_MAX
Definition: af_astats.c:31
update_float_stat
static void update_float_stat(AudioStatsContext *s, ChannelStats *p, float d)
Definition: af_astats.c:444
key
const char * key
Definition: hwcontext_opencl.c:189
uninit
static av_cold void uninit(AVFilterContext *ctx)
Definition: af_astats.c:925
NAN
#define NAN
Definition: mathematics.h:115
ChannelStats::min_diff
double min_diff
Definition: af_astats.c:75
FILTER_INPUTS
#define FILTER_INPUTS(array)
Definition: internal.h:182
arg
const char * arg
Definition: jacosubdec.c:67
FFABS
#define FFABS(a)
Absolute value, Note, INT_MIN / INT64_MIN result in undefined behavior as they are not representable ...
Definition: common.h:72
ChannelStats::min_count
uint64_t min_count
Definition: af_astats.c:80
MEASURE_RMS_DIFFERENCE
#define MEASURE_RMS_DIFFERENCE
Definition: af_astats.c:42
ChannelStats::sigma_x
double sigma_x
Definition: af_astats.c:69
ChannelStats::noise_floor_count
uint64_t noise_floor_count
Definition: af_astats.c:82
AVClass
Describe the class of an AVClass context structure.
Definition: log.h:66
result
and forward the result(frame or status change) to the corresponding input. If nothing is possible
fabs
static __device__ float fabs(float a)
Definition: cuda_runtime.h:182
NULL
#define NULL
Definition: coverity.c:32
MEASURE_NOISE_FLOOR_COUNT
#define MEASURE_NOISE_FLOOR_COUNT
Definition: af_astats.c:59
ChannelStats::win_samples
double * win_samples
Definition: af_astats.c:88
MEASURE_ZERO_CROSSINGS_RATE
#define MEASURE_ZERO_CROSSINGS_RATE
Definition: af_astats.c:53
MEASURE_DC_OFFSET
#define MEASURE_DC_OFFSET
Definition: af_astats.c:36
isnan
#define isnan(x)
Definition: libm.h:340
ChannelStats::min_runs
double min_runs
Definition: af_astats.c:74
AudioStatsContext::used
int used
Definition: af_astats.c:108
double
double
Definition: af_crystalizer.c:131
ChannelStats::sorted_front
int sorted_front
Definition: af_astats.c:92
exp
int8_t exp
Definition: eval.c:74
index
int index
Definition: gxfenc.c:89
c
Undefined Behavior In the C some operations are like signed integer dereferencing freed accessing outside allocated Undefined Behavior must not occur in a C it is not safe even if the output of undefined operations is unused The unsafety may seem nit picking but Optimizing compilers have in fact optimized code on the assumption that no undefined Behavior occurs Optimizing code based on wrong assumptions can and has in some cases lead to effects beyond the output of computations The signed integer overflow problem in speed critical code Code which is highly optimized and works with signed integers sometimes has the problem that often the output of the computation does not c
Definition: undefined.txt:32
FLAGS
#define FLAGS
Definition: af_astats.c:119
MEASURE_FLAT_FACTOR
#define MEASURE_FLAT_FACTOR
Definition: af_astats.c:48
AudioStatsContext::measure_perchannel
int measure_perchannel
Definition: af_astats.c:112
HISTOGRAM_SIZE
#define HISTOGRAM_SIZE
Definition: af_astats.c:30
AudioStatsContext
Definition: af_astats.c:100
NULL_IF_CONFIG_SMALL
#define NULL_IF_CONFIG_SMALL(x)
Return NULL if CONFIG_SMALL is true, otherwise the argument without modification.
Definition: internal.h:106
P
#define P
MEASURE_DYNAMIC_RANGE
#define MEASURE_DYNAMIC_RANGE
Definition: af_astats.c:51
ChannelStats::nb_samples
uint64_t nb_samples
Definition: af_astats.c:84
MEASURE_NUMBER_OF_SAMPLES
#define MEASURE_NUMBER_OF_SAMPLES
Definition: af_astats.c:54
MEASURE_ENTROPY
#define MEASURE_ENTROPY
Definition: af_astats.c:60
MEASURE_RMS_PEAK
#define MEASURE_RMS_PEAK
Definition: af_astats.c:45
ChannelStats::sorted_samples
double * sorted_samples
Definition: af_astats.c:89
AV_SAMPLE_FMT_S16P
@ AV_SAMPLE_FMT_S16P
signed 16 bits, planar
Definition: samplefmt.h:64
AV_LOG_INFO
#define AV_LOG_INFO
Standard information.
Definition: log.h:191
amask
#define amask(a)
Definition: asm.h:113
internal.h
ChannelStats::max_diff
double max_diff
Definition: af_astats.c:75
astats_inputs
static const AVFilterPad astats_inputs[]
Definition: af_astats.c:942
ChannelStats::min_sigma_x2
double min_sigma_x2
Definition: af_astats.c:70
MEASURE_MEAN_DIFFERENCE
#define MEASURE_MEAN_DIFFERENCE
Definition: af_astats.c:41
AVFrame::nb_samples
int nb_samples
number of audio samples (per channel) described by this frame
Definition: frame.h:424
ChannelStats::lasti
int64_t lasti
Definition: af_astats.c:91
ChannelStats
Definition: af_astats.c:65
i
#define i(width, name, range_min, range_max)
Definition: cbs_h2645.c:255
MEASURE_NUMBER_OF_DENORMALS
#define MEASURE_NUMBER_OF_DENORMALS
Definition: af_astats.c:57
av_get_bytes_per_sample
int av_get_bytes_per_sample(enum AVSampleFormat sample_fmt)
Return number of bytes per sample.
Definition: samplefmt.c:108
ff_af_astats
const AVFilter ff_af_astats
Definition: af_astats.c:958
ChannelStats::min_run
double min_run
Definition: af_astats.c:73
filter_channel
static int filter_channel(AVFilterContext *ctx, void *arg, int jobnr, int nb_jobs)
Definition: af_astats.c:678
AVFrame::extended_data
uint8_t ** extended_data
pointers to the data planes/channels.
Definition: frame.h:405
ff_filter_get_nb_threads
int ff_filter_get_nb_threads(AVFilterContext *ctx)
Get number of threads for current filter instance.
Definition: avfilter.c:825
value
it s the only field you need to keep assuming you have a context There is some magic you don t need to care about around this just let it vf default value
Definition: writing_filters.txt:86
MEASURE_PEAK_LEVEL
#define MEASURE_PEAK_LEVEL
Definition: af_astats.c:43
FFMIN
#define FFMIN(a, b)
Definition: macros.h:49
ChannelStats::max_run
double max_run
Definition: af_astats.c:73
AV_SAMPLE_FMT_S16
@ AV_SAMPLE_FMT_S16
signed 16 bits
Definition: samplefmt.h:58
set_metadata
static void set_metadata(AudioStatsContext *s, AVDictionary **metadata)
Definition: af_astats.c:478
AVFilterPad::name
const char * name
Pad name.
Definition: internal.h:39
av_calloc
void * av_calloc(size_t nmemb, size_t size)
Definition: mem.c:262
ChannelStats::max_runs
double max_runs
Definition: af_astats.c:74
log2
#define log2(x)
Definition: libm.h:404
AVFilter
Filter definition.
Definition: avfilter.h:166
MEASURE_RMS_LEVEL
#define MEASURE_RMS_LEVEL
Definition: af_astats.c:44
MEASURE_NUMBER_OF_NANS
#define MEASURE_NUMBER_OF_NANS
Definition: af_astats.c:55
MEASURE_BIT_DEPTH
#define MEASURE_BIT_DEPTH
Definition: af_astats.c:50
AudioStatsContext::nb_frames
int nb_frames
Definition: af_astats.c:110
ChannelStats::abs_peak
double abs_peak
Definition: af_astats.c:78
AV_OPT_TYPE_INT
@ AV_OPT_TYPE_INT
Definition: opt.h:235
avfilter.h
AVFrame::metadata
AVDictionary * metadata
metadata.
Definition: frame.h:662
AVFILTER_FLAG_METADATA_ONLY
#define AVFILTER_FLAG_METADATA_ONLY
The filter is a "metadata" filter - it does not modify the frame data in any way.
Definition: avfilter.h:133
AV_SAMPLE_FMT_DBLP
@ AV_SAMPLE_FMT_DBLP
double, planar
Definition: samplefmt.h:67
AudioStatsContext::reset_count
int reset_count
Definition: af_astats.c:109
samples
Filter the word “frame” indicates either a video frame or a group of audio samples
Definition: filter_design.txt:8
AVFilterContext
An instance of a filter.
Definition: avfilter.h:407
MEASURE_NUMBER_OF_INFS
#define MEASURE_NUMBER_OF_INFS
Definition: af_astats.c:56
AVFILTER_FLAG_SLICE_THREADS
#define AVFILTER_FLAG_SLICE_THREADS
The filter supports multithreading by splitting frames into multiple parts and processing them concur...
Definition: avfilter.h:117
ChannelStats::noise_floor
double noise_floor
Definition: af_astats.c:96
MEASURE_NOISE_FLOOR
#define MEASURE_NOISE_FLOOR
Definition: af_astats.c:58
audio.h
AudioStatsContext::metadata
int metadata
Definition: af_astats.c:107
llrint
#define llrint(x)
Definition: libm.h:394
ChannelStats::nb_denormals
uint64_t nb_denormals
Definition: af_astats.c:87
ChannelStats::sigma_x2
double sigma_x2
Definition: af_astats.c:69
AVFILTER_DEFINE_CLASS
AVFILTER_DEFINE_CLASS(astats)
print_stats
static void print_stats(AVFilterContext *ctx)
Definition: af_astats.c:750
MEASURE_MAX_LEVEL
#define MEASURE_MAX_LEVEL
Definition: af_astats.c:38
MEASURE_MIN_DIFFERENCE
#define MEASURE_MIN_DIFFERENCE
Definition: af_astats.c:39
AV_OPT_TYPE_BOOL
@ AV_OPT_TYPE_BOOL
Definition: opt.h:251
FILTER_OUTPUTS
#define FILTER_OUTPUTS(array)
Definition: internal.h:183
av_freep
#define av_freep(p)
Definition: tableprint_vlc.h:34
av_dict_set
int av_dict_set(AVDictionary **pm, const char *key, const char *value, int flags)
Set the given entry in *pm, overwriting an existing entry.
Definition: dict.c:88
src
INIT_CLIP pixel * src
Definition: h264pred_template.c:418
AudioStatsContext::chstats
ChannelStats * chstats
Definition: af_astats.c:102
d
d
Definition: ffmpeg_filter.c:409
AV_OPT_TYPE_FLAGS
@ AV_OPT_TYPE_FLAGS
Definition: opt.h:234
int32_t
int32_t
Definition: audioconvert.c:56
av_log
#define av_log(a,...)
Definition: tableprint_vlc.h:27
ChannelStats::zero_runs
uint64_t zero_runs
Definition: af_astats.c:83
MEASURE_CREST_FACTOR
#define MEASURE_CREST_FACTOR
Definition: af_astats.c:47
AV_SAMPLE_FMT_DBL
@ AV_SAMPLE_FMT_DBL
double
Definition: samplefmt.h:61
ff_filter_execute
static av_always_inline int ff_filter_execute(AVFilterContext *ctx, avfilter_action_func *func, void *arg, int *ret, int nb_jobs)
Definition: internal.h:134
ChannelStats::min
double min
Definition: af_astats.c:71
AudioStatsContext::time_constant
double time_constant
Definition: af_astats.c:105
AV_SAMPLE_FMT_S32
@ AV_SAMPLE_FMT_S32
signed 32 bits
Definition: samplefmt.h:59
ChannelStats::max_count
uint64_t max_count
Definition: af_astats.c:80
ChannelStats::min_non_zero
double min_non_zero
Definition: af_astats.c:68
AV_OPT_TYPE_CONST
@ AV_OPT_TYPE_CONST
Definition: opt.h:244
snprintf
#define snprintf
Definition: snprintf.h:34
AV_SAMPLE_FMT_FLT
@ AV_SAMPLE_FMT_FLT
float
Definition: samplefmt.h:60
MEASURE_MAX_DIFFERENCE
#define MEASURE_MAX_DIFFERENCE
Definition: af_astats.c:40
astats_outputs
static const AVFilterPad astats_outputs[]
Definition: af_astats.c:950
ChannelStats::nb_infs
uint64_t nb_infs
Definition: af_astats.c:86
AV_SAMPLE_FMT_S64
@ AV_SAMPLE_FMT_S64
signed 64 bits
Definition: samplefmt.h:68
av_clipd
av_clipd
Definition: af_crystalizer.c:131
MEASURE_ZERO_CROSSINGS
#define MEASURE_ZERO_CROSSINGS
Definition: af_astats.c:52
FILTER_SAMPLEFMTS
#define FILTER_SAMPLEFMTS(...)
Definition: internal.h:170
min
float min
Definition: vorbis_enc_data.h:429