FFmpeg
af_ladspa.c
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2013 Paul B Mahol
3  * Copyright (c) 2011 Mina Nagy Zaki
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 /**
23  * @file
24  * LADSPA wrapper
25  */
26 
27 #include <dlfcn.h>
28 #include <ladspa.h>
29 #include "libavutil/avassert.h"
30 #include "libavutil/avstring.h"
32 #include "libavutil/fifo.h"
33 #include "libavutil/opt.h"
34 #include "audio.h"
35 #include "avfilter.h"
36 #include "internal.h"
37 
38 typedef struct MetaItem {
39  int64_t pts;
40  int nb_samples;
41 } MetaItem;
42 
43 typedef struct LADSPAContext {
44  const AVClass *class;
45  char *dl_name;
46  char *plugin;
47  char *options;
48  void *dl_handle;
49 
50  unsigned long nb_inputs;
51  unsigned long *ipmap; /* map input number to port number */
52 
53  unsigned long nb_inputcontrols;
54  unsigned long *icmap; /* map input control number to port number */
55  LADSPA_Data *ictlv; /* input controls values */
56 
57  unsigned long nb_outputs;
58  unsigned long *opmap; /* map output number to port number */
59 
60  unsigned long nb_outputcontrols;
61  unsigned long *ocmap; /* map output control number to port number */
62  LADSPA_Data *octlv; /* output controls values */
63 
64  const LADSPA_Descriptor *desc;
67  LADSPA_Handle *handles;
68 
71  int64_t next_in_pts;
72  int64_t next_out_pts;
73  int64_t pts;
74  int64_t duration;
75  int in_trim;
76  int out_pad;
77  int latency;
78 
81 
82 #define OFFSET(x) offsetof(LADSPAContext, x)
83 #define FLAGS AV_OPT_FLAG_AUDIO_PARAM | AV_OPT_FLAG_FILTERING_PARAM
84 static const AVOption ladspa_options[] = {
85  { "file", "set library name or full path", OFFSET(dl_name), AV_OPT_TYPE_STRING, .flags = FLAGS },
86  { "f", "set library name or full path", OFFSET(dl_name), AV_OPT_TYPE_STRING, .flags = FLAGS },
87  { "plugin", "set plugin name", OFFSET(plugin), AV_OPT_TYPE_STRING, .flags = FLAGS },
88  { "p", "set plugin name", OFFSET(plugin), AV_OPT_TYPE_STRING, .flags = FLAGS },
89  { "controls", "set plugin options", OFFSET(options), AV_OPT_TYPE_STRING, .flags = FLAGS },
90  { "c", "set plugin options", OFFSET(options), AV_OPT_TYPE_STRING, .flags = FLAGS },
91  { "sample_rate", "set sample rate", OFFSET(sample_rate), AV_OPT_TYPE_INT, {.i64=44100}, 1, INT32_MAX, FLAGS },
92  { "s", "set sample rate", OFFSET(sample_rate), AV_OPT_TYPE_INT, {.i64=44100}, 1, INT32_MAX, FLAGS },
93  { "nb_samples", "set the number of samples per requested frame", OFFSET(nb_samples), AV_OPT_TYPE_INT, {.i64=1024}, 1, INT_MAX, FLAGS },
94  { "n", "set the number of samples per requested frame", OFFSET(nb_samples), AV_OPT_TYPE_INT, {.i64=1024}, 1, INT_MAX, FLAGS },
95  { "duration", "set audio duration", OFFSET(duration), AV_OPT_TYPE_DURATION, {.i64=-1}, -1, INT64_MAX, FLAGS },
96  { "d", "set audio duration", OFFSET(duration), AV_OPT_TYPE_DURATION, {.i64=-1}, -1, INT64_MAX, FLAGS },
97  { "latency", "enable latency compensation", OFFSET(latency), AV_OPT_TYPE_BOOL, {.i64=0}, 0, 1, FLAGS },
98  { "l", "enable latency compensation", OFFSET(latency), AV_OPT_TYPE_BOOL, {.i64=0}, 0, 1, FLAGS },
99  { NULL }
100 };
101 
102 AVFILTER_DEFINE_CLASS(ladspa);
103 
105 {
106  int latency = 0;
107 
108  for (int ctl = 0; ctl < s->nb_outputcontrols; ctl++) {
109  if (av_strcasecmp("latency", s->desc->PortNames[s->ocmap[ctl]]))
110  continue;
111 
112  latency = lrintf(s->octlv[ctl]);
113  break;
114  }
115 
116  return latency;
117 }
118 
120  LADSPAContext *s, int ctl, unsigned long *map,
121  LADSPA_Data *values, int print)
122 {
123  const LADSPA_PortRangeHint *h = s->desc->PortRangeHints + map[ctl];
124 
125  av_log(ctx, level, "c%i: %s [", ctl, s->desc->PortNames[map[ctl]]);
126 
127  if (LADSPA_IS_HINT_TOGGLED(h->HintDescriptor)) {
128  av_log(ctx, level, "toggled (1 or 0)");
129 
130  if (LADSPA_IS_HINT_HAS_DEFAULT(h->HintDescriptor))
131  av_log(ctx, level, " (default %i)", (int)values[ctl]);
132  } else {
133  if (LADSPA_IS_HINT_INTEGER(h->HintDescriptor)) {
134  av_log(ctx, level, "<int>");
135 
136  if (LADSPA_IS_HINT_BOUNDED_BELOW(h->HintDescriptor))
137  av_log(ctx, level, ", min: %i", (int)h->LowerBound);
138 
139  if (LADSPA_IS_HINT_BOUNDED_ABOVE(h->HintDescriptor))
140  av_log(ctx, level, ", max: %i", (int)h->UpperBound);
141 
142  if (print)
143  av_log(ctx, level, " (value %d)", (int)values[ctl]);
144  else if (LADSPA_IS_HINT_HAS_DEFAULT(h->HintDescriptor))
145  av_log(ctx, level, " (default %d)", (int)values[ctl]);
146  } else {
147  av_log(ctx, level, "<float>");
148 
149  if (LADSPA_IS_HINT_BOUNDED_BELOW(h->HintDescriptor))
150  av_log(ctx, level, ", min: %f", h->LowerBound);
151 
152  if (LADSPA_IS_HINT_BOUNDED_ABOVE(h->HintDescriptor))
153  av_log(ctx, level, ", max: %f", h->UpperBound);
154 
155  if (print)
156  av_log(ctx, level, " (value %f)", values[ctl]);
157  else if (LADSPA_IS_HINT_HAS_DEFAULT(h->HintDescriptor))
158  av_log(ctx, level, " (default %f)", values[ctl]);
159  }
160 
161  if (LADSPA_IS_HINT_SAMPLE_RATE(h->HintDescriptor))
162  av_log(ctx, level, ", multiple of sample rate");
163 
164  if (LADSPA_IS_HINT_LOGARITHMIC(h->HintDescriptor))
165  av_log(ctx, level, ", logarithmic scale");
166  }
167 
168  av_log(ctx, level, "]\n");
169 }
170 
172 {
173  AVFilterContext *ctx = inlink->dst;
174  LADSPAContext *s = ctx->priv;
175  AVFrame *out;
176  int i, h, p, new_out_samples;
177  int64_t out_duration;
178  int64_t in_duration;
179  int64_t in_pts;
180  MetaItem meta;
181 
182  av_assert0(in->ch_layout.nb_channels == (s->nb_inputs * s->nb_handles));
183 
184  if (!s->nb_outputs ||
185  (av_frame_is_writable(in) && s->nb_inputs == s->nb_outputs &&
186  s->in_trim == 0 && s->out_pad == 0 &&
187  !(s->desc->Properties & LADSPA_PROPERTY_INPLACE_BROKEN))) {
188  out = in;
189  } else {
190  out = ff_get_audio_buffer(ctx->outputs[0], in->nb_samples);
191  if (!out) {
192  av_frame_free(&in);
193  return AVERROR(ENOMEM);
194  }
196  }
197 
198  av_assert0(!s->nb_outputs || out->ch_layout.nb_channels == (s->nb_outputs * s->nb_handles));
199 
200  for (h = 0; h < s->nb_handles; h++) {
201  for (i = 0; i < s->nb_inputs; i++) {
202  p = s->nb_handles > 1 ? h : i;
203  s->desc->connect_port(s->handles[h], s->ipmap[i],
204  (LADSPA_Data*)in->extended_data[p]);
205  }
206 
207  for (i = 0; i < s->nb_outputs; i++) {
208  p = s->nb_handles > 1 ? h : i;
209  s->desc->connect_port(s->handles[h], s->opmap[i],
210  (LADSPA_Data*)out->extended_data[p]);
211  }
212 
213  s->desc->run(s->handles[h], in->nb_samples);
214  if (s->latency)
215  s->in_trim = s->out_pad = find_latency(ctx, s);
216  s->latency = 0;
217  }
218 
219  for (i = 0; i < s->nb_outputcontrols; i++)
220  print_ctl_info(ctx, AV_LOG_VERBOSE, s, i, s->ocmap, s->octlv, 1);
221 
222  meta = (MetaItem){ in->pts, in->nb_samples };
223  av_fifo_write(s->fifo, &meta, 1);
224 
225  if (out != in)
226  av_frame_free(&in);
227 
228  new_out_samples = out->nb_samples;
229  if (s->in_trim > 0) {
230  int trim = FFMIN(new_out_samples, s->in_trim);
231 
232  new_out_samples -= trim;
233  s->in_trim -= trim;
234  }
235 
236  if (new_out_samples <= 0) {
237  av_frame_free(&out);
238  return 0;
239  } else if (new_out_samples < out->nb_samples) {
240  int offset = out->nb_samples - new_out_samples;
241  for (int ch = 0; ch < out->ch_layout.nb_channels; ch++)
242  memmove(out->extended_data[ch], out->extended_data[ch] + sizeof(float) * offset,
243  sizeof(float) * new_out_samples);
244  out->nb_samples = new_out_samples;
245  }
246 
247  av_fifo_read(s->fifo, &meta, 1);
248 
249  out_duration = av_rescale_q(out->nb_samples, inlink->time_base, av_make_q(1, out->sample_rate));
250  in_duration = av_rescale_q(meta.nb_samples, inlink->time_base, av_make_q(1, out->sample_rate));
251  in_pts = meta.pts;
252 
253  if (s->next_out_pts != AV_NOPTS_VALUE && out->pts != s->next_out_pts &&
254  s->next_in_pts != AV_NOPTS_VALUE && in_pts == s->next_in_pts) {
255  out->pts = s->next_out_pts;
256  } else {
257  out->pts = in_pts;
258  }
259  s->next_in_pts = in_pts + in_duration;
260  s->next_out_pts = out->pts + out_duration;
261 
262  return ff_filter_frame(ctx->outputs[0], out);
263 }
264 
265 static int request_frame(AVFilterLink *outlink)
266 {
267  AVFilterContext *ctx = outlink->src;
268  LADSPAContext *s = ctx->priv;
269  AVFrame *out;
270  int64_t t;
271  int i;
272 
273  if (ctx->nb_inputs) {
274  int ret = ff_request_frame(ctx->inputs[0]);
275 
276  if (ret == AVERROR_EOF && s->out_pad > 0) {
277  AVFrame *frame = ff_get_audio_buffer(outlink, FFMIN(2048, s->out_pad));
278  if (!frame)
279  return AVERROR(ENOMEM);
280 
281  s->out_pad -= frame->nb_samples;
282  frame->pts = s->next_in_pts;
283  return filter_frame(ctx->inputs[0], frame);
284  }
285  return ret;
286  }
287 
288  t = av_rescale(s->pts, AV_TIME_BASE, s->sample_rate);
289  if (s->duration >= 0 && t >= s->duration)
290  return AVERROR_EOF;
291 
292  out = ff_get_audio_buffer(outlink, s->nb_samples);
293  if (!out)
294  return AVERROR(ENOMEM);
295 
296  for (i = 0; i < s->nb_outputs; i++)
297  s->desc->connect_port(s->handles[0], s->opmap[i],
298  (LADSPA_Data*)out->extended_data[i]);
299 
300  s->desc->run(s->handles[0], s->nb_samples);
301 
302  for (i = 0; i < s->nb_outputcontrols; i++)
303  print_ctl_info(ctx, AV_LOG_INFO, s, i, s->ocmap, s->octlv, 1);
304 
305  out->sample_rate = s->sample_rate;
306  out->pts = s->pts;
307  s->pts += s->nb_samples;
308 
309  return ff_filter_frame(outlink, out);
310 }
311 
312 static void set_default_ctl_value(LADSPAContext *s, int ctl,
313  unsigned long *map, LADSPA_Data *values)
314 {
315  const LADSPA_PortRangeHint *h = s->desc->PortRangeHints + map[ctl];
316  const LADSPA_Data lower = h->LowerBound;
317  const LADSPA_Data upper = h->UpperBound;
318 
319  if (LADSPA_IS_HINT_DEFAULT_MINIMUM(h->HintDescriptor)) {
320  values[ctl] = lower;
321  } else if (LADSPA_IS_HINT_DEFAULT_MAXIMUM(h->HintDescriptor)) {
322  values[ctl] = upper;
323  } else if (LADSPA_IS_HINT_DEFAULT_0(h->HintDescriptor)) {
324  values[ctl] = 0.0;
325  } else if (LADSPA_IS_HINT_DEFAULT_1(h->HintDescriptor)) {
326  values[ctl] = 1.0;
327  } else if (LADSPA_IS_HINT_DEFAULT_100(h->HintDescriptor)) {
328  values[ctl] = 100.0;
329  } else if (LADSPA_IS_HINT_DEFAULT_440(h->HintDescriptor)) {
330  values[ctl] = 440.0;
331  } else if (LADSPA_IS_HINT_DEFAULT_LOW(h->HintDescriptor)) {
332  if (LADSPA_IS_HINT_LOGARITHMIC(h->HintDescriptor))
333  values[ctl] = exp(log(lower) * 0.75 + log(upper) * 0.25);
334  else
335  values[ctl] = lower * 0.75 + upper * 0.25;
336  } else if (LADSPA_IS_HINT_DEFAULT_MIDDLE(h->HintDescriptor)) {
337  if (LADSPA_IS_HINT_LOGARITHMIC(h->HintDescriptor))
338  values[ctl] = exp(log(lower) * 0.5 + log(upper) * 0.5);
339  else
340  values[ctl] = lower * 0.5 + upper * 0.5;
341  } else if (LADSPA_IS_HINT_DEFAULT_HIGH(h->HintDescriptor)) {
342  if (LADSPA_IS_HINT_LOGARITHMIC(h->HintDescriptor))
343  values[ctl] = exp(log(lower) * 0.25 + log(upper) * 0.75);
344  else
345  values[ctl] = lower * 0.25 + upper * 0.75;
346  }
347 }
348 
350 {
351  LADSPAContext *s = ctx->priv;
352  int i, j;
353 
354  s->nb_handles = s->nb_inputs == 1 && s->nb_outputs == 1 ? link->ch_layout.nb_channels : 1;
355  s->handles = av_calloc(s->nb_handles, sizeof(*s->handles));
356  if (!s->handles)
357  return AVERROR(ENOMEM);
358 
359  for (i = 0; i < s->nb_handles; i++) {
360  s->handles[i] = s->desc->instantiate(s->desc, link->sample_rate);
361  if (!s->handles[i]) {
362  av_log(ctx, AV_LOG_ERROR, "Could not instantiate plugin.\n");
363  return AVERROR_EXTERNAL;
364  }
365 
366  // Connect the input control ports
367  for (j = 0; j < s->nb_inputcontrols; j++)
368  s->desc->connect_port(s->handles[i], s->icmap[j], s->ictlv + j);
369 
370  // Connect the output control ports
371  for (j = 0; j < s->nb_outputcontrols; j++)
372  s->desc->connect_port(s->handles[i], s->ocmap[j], &s->octlv[j]);
373 
374  if (s->desc->activate)
375  s->desc->activate(s->handles[i]);
376  }
377 
378  av_log(ctx, AV_LOG_DEBUG, "handles: %d\n", s->nb_handles);
379 
380  return 0;
381 }
382 
384 {
385  AVFilterContext *ctx = inlink->dst;
386 
387  return connect_ports(ctx, inlink);
388 }
389 
390 static int config_output(AVFilterLink *outlink)
391 {
392  AVFilterContext *ctx = outlink->src;
393  LADSPAContext *s = ctx->priv;
394  int ret;
395 
396  if (ctx->nb_inputs) {
397  AVFilterLink *inlink = ctx->inputs[0];
398 
399  outlink->format = inlink->format;
400  outlink->sample_rate = inlink->sample_rate;
401  if (s->nb_inputs == s->nb_outputs) {
402  if ((ret = av_channel_layout_copy(&outlink->ch_layout, &inlink->ch_layout)) < 0)
403  return ret;
404 #if FF_API_OLD_CHANNEL_LAYOUT
406  outlink->channel_layout = inlink->channel_layout;
408 #endif
409  }
410 
411  ret = 0;
412  } else {
413  outlink->sample_rate = s->sample_rate;
414  outlink->time_base = (AVRational){1, s->sample_rate};
415 
416  ret = connect_ports(ctx, outlink);
417  }
418 
419  return ret;
420 }
421 
422 static void count_ports(const LADSPA_Descriptor *desc,
423  unsigned long *nb_inputs, unsigned long *nb_outputs)
424 {
425  LADSPA_PortDescriptor pd;
426  int i;
427 
428  for (i = 0; i < desc->PortCount; i++) {
429  pd = desc->PortDescriptors[i];
430 
431  if (LADSPA_IS_PORT_AUDIO(pd)) {
432  if (LADSPA_IS_PORT_INPUT(pd)) {
433  (*nb_inputs)++;
434  } else if (LADSPA_IS_PORT_OUTPUT(pd)) {
435  (*nb_outputs)++;
436  }
437  }
438  }
439 }
440 
441 static void *try_load(const char *dir, const char *soname)
442 {
443  char *path = av_asprintf("%s/%s.so", dir, soname);
444  void *ret = NULL;
445 
446  if (path) {
447  ret = dlopen(path, RTLD_LOCAL|RTLD_NOW);
448  av_free(path);
449  }
450 
451  return ret;
452 }
453 
454 static int set_control(AVFilterContext *ctx, unsigned long port, LADSPA_Data value)
455 {
456  LADSPAContext *s = ctx->priv;
457  const char *label = s->desc->Label;
458  LADSPA_PortRangeHint *h = (LADSPA_PortRangeHint *)s->desc->PortRangeHints +
459  s->icmap[port];
460 
461  if (port >= s->nb_inputcontrols) {
462  av_log(ctx, AV_LOG_ERROR, "Control c%ld is out of range [0 - %lu].\n",
463  port, s->nb_inputcontrols);
464  return AVERROR(EINVAL);
465  }
466 
467  if (LADSPA_IS_HINT_BOUNDED_BELOW(h->HintDescriptor) &&
468  value < h->LowerBound) {
470  "%s: input control c%ld is below lower boundary of %0.4f.\n",
471  label, port, h->LowerBound);
472  return AVERROR(EINVAL);
473  }
474 
475  if (LADSPA_IS_HINT_BOUNDED_ABOVE(h->HintDescriptor) &&
476  value > h->UpperBound) {
478  "%s: input control c%ld is above upper boundary of %0.4f.\n",
479  label, port, h->UpperBound);
480  return AVERROR(EINVAL);
481  }
482 
483  s->ictlv[port] = value;
484 
485  return 0;
486 }
487 
489 {
490  LADSPAContext *s = ctx->priv;
491  LADSPA_Descriptor_Function descriptor_fn;
492  const LADSPA_Descriptor *desc;
493  LADSPA_PortDescriptor pd;
494  AVFilterPad pad = { NULL };
495  char *p, *arg, *saveptr = NULL;
496  unsigned long nb_ports;
497  int i, j = 0, ret;
498 
499  if (!s->dl_name) {
500  av_log(ctx, AV_LOG_ERROR, "No plugin name provided\n");
501  return AVERROR(EINVAL);
502  }
503 
504  if (s->dl_name[0] == '/' || s->dl_name[0] == '.') {
505  // argument is a path
506  s->dl_handle = dlopen(s->dl_name, RTLD_LOCAL|RTLD_NOW);
507  } else {
508  // argument is a shared object name
509  char *paths = av_strdup(getenv("LADSPA_PATH"));
510  const char *home_path = getenv("HOME");
511  const char *separator = ":";
512 
513  if (paths) {
514  p = paths;
515  while ((arg = av_strtok(p, separator, &saveptr)) && !s->dl_handle) {
516  s->dl_handle = try_load(arg, s->dl_name);
517  p = NULL;
518  }
519  }
520 
521  av_free(paths);
522  if (!s->dl_handle && home_path && (paths = av_asprintf("%s/.ladspa", home_path))) {
523  s->dl_handle = try_load(paths, s->dl_name);
524  av_free(paths);
525  }
526 
527  if (!s->dl_handle && home_path && (paths = av_asprintf("%s/.ladspa/lib", home_path))) {
528  s->dl_handle = try_load(paths, s->dl_name);
529  av_free(paths);
530  }
531 
532  if (!s->dl_handle)
533  s->dl_handle = try_load("/usr/local/lib/ladspa", s->dl_name);
534 
535  if (!s->dl_handle)
536  s->dl_handle = try_load("/usr/lib/ladspa", s->dl_name);
537  }
538  if (!s->dl_handle) {
539  av_log(ctx, AV_LOG_ERROR, "Failed to load '%s'\n", s->dl_name);
540  return AVERROR(EINVAL);
541  }
542 
543  descriptor_fn = dlsym(s->dl_handle, "ladspa_descriptor");
544  if (!descriptor_fn) {
545  av_log(ctx, AV_LOG_ERROR, "Could not find ladspa_descriptor: %s\n", dlerror());
546  return AVERROR(EINVAL);
547  }
548 
549  // Find the requested plugin, or list plugins
550  if (!s->plugin) {
551  av_log(ctx, AV_LOG_INFO, "The '%s' library contains the following plugins:\n", s->dl_name);
552  av_log(ctx, AV_LOG_INFO, "I = Input Channels\n");
553  av_log(ctx, AV_LOG_INFO, "O = Output Channels\n");
554  av_log(ctx, AV_LOG_INFO, "I:O %-25s %s\n", "Plugin", "Description");
555  av_log(ctx, AV_LOG_INFO, "\n");
556  for (i = 0; desc = descriptor_fn(i); i++) {
557  unsigned long inputs = 0, outputs = 0;
558 
560  av_log(ctx, AV_LOG_INFO, "%lu:%lu %-25s %s\n", inputs, outputs, desc->Label,
561  (char *)av_x_if_null(desc->Name, "?"));
562  av_log(ctx, AV_LOG_VERBOSE, "Maker: %s\n",
563  (char *)av_x_if_null(desc->Maker, "?"));
564  av_log(ctx, AV_LOG_VERBOSE, "Copyright: %s\n",
565  (char *)av_x_if_null(desc->Copyright, "?"));
566  }
567  return AVERROR_EXIT;
568  } else {
569  for (i = 0;; i++) {
570  desc = descriptor_fn(i);
571  if (!desc) {
572  av_log(ctx, AV_LOG_ERROR, "Could not find plugin: %s\n", s->plugin);
573  return AVERROR(EINVAL);
574  }
575 
576  if (desc->Label && !strcmp(desc->Label, s->plugin))
577  break;
578  }
579  }
580 
581  s->desc = desc;
582  nb_ports = desc->PortCount;
583 
584  s->ipmap = av_calloc(nb_ports, sizeof(*s->ipmap));
585  s->opmap = av_calloc(nb_ports, sizeof(*s->opmap));
586  s->icmap = av_calloc(nb_ports, sizeof(*s->icmap));
587  s->ocmap = av_calloc(nb_ports, sizeof(*s->ocmap));
588  s->ictlv = av_calloc(nb_ports, sizeof(*s->ictlv));
589  s->octlv = av_calloc(nb_ports, sizeof(*s->octlv));
590  s->ctl_needs_value = av_calloc(nb_ports, sizeof(*s->ctl_needs_value));
591  if (!s->ipmap || !s->opmap || !s->icmap ||
592  !s->ocmap || !s->ictlv || !s->octlv || !s->ctl_needs_value)
593  return AVERROR(ENOMEM);
594 
595  for (i = 0; i < nb_ports; i++) {
596  pd = desc->PortDescriptors[i];
597 
598  if (LADSPA_IS_PORT_AUDIO(pd)) {
599  if (LADSPA_IS_PORT_INPUT(pd)) {
600  s->ipmap[s->nb_inputs] = i;
601  s->nb_inputs++;
602  } else if (LADSPA_IS_PORT_OUTPUT(pd)) {
603  s->opmap[s->nb_outputs] = i;
604  s->nb_outputs++;
605  }
606  } else if (LADSPA_IS_PORT_CONTROL(pd)) {
607  if (LADSPA_IS_PORT_INPUT(pd)) {
608  s->icmap[s->nb_inputcontrols] = i;
609 
610  if (LADSPA_IS_HINT_HAS_DEFAULT(desc->PortRangeHints[i].HintDescriptor))
611  set_default_ctl_value(s, s->nb_inputcontrols, s->icmap, s->ictlv);
612  else
613  s->ctl_needs_value[s->nb_inputcontrols] = 1;
614 
615  s->nb_inputcontrols++;
616  } else if (LADSPA_IS_PORT_OUTPUT(pd)) {
617  s->ocmap[s->nb_outputcontrols] = i;
618  s->nb_outputcontrols++;
619  }
620  }
621  }
622 
623  // List Control Ports if "help" is specified
624  if (s->options && !strcmp(s->options, "help")) {
625  if (!s->nb_inputcontrols) {
627  "The '%s' plugin does not have any input controls.\n",
628  desc->Label);
629  } else {
631  "The '%s' plugin has the following input controls:\n",
632  desc->Label);
633  for (i = 0; i < s->nb_inputcontrols; i++)
634  print_ctl_info(ctx, AV_LOG_INFO, s, i, s->icmap, s->ictlv, 0);
635  }
636  return AVERROR_EXIT;
637  }
638 
639  // Parse control parameters
640  p = s->options;
641  while (s->options) {
642  LADSPA_Data val;
643  int ret;
644 
645  if (!(arg = av_strtok(p, " |", &saveptr)))
646  break;
647  p = NULL;
648 
649  if (av_sscanf(arg, "c%d=%f", &i, &val) != 2) {
650  if (av_sscanf(arg, "%f", &val) != 1) {
651  av_log(ctx, AV_LOG_ERROR, "Invalid syntax.\n");
652  return AVERROR(EINVAL);
653  }
654  i = j++;
655  }
656 
657  if ((ret = set_control(ctx, i, val)) < 0)
658  return ret;
659  s->ctl_needs_value[i] = 0;
660  }
661 
662  // Check if any controls are not set
663  for (i = 0; i < s->nb_inputcontrols; i++) {
664  if (s->ctl_needs_value[i]) {
665  av_log(ctx, AV_LOG_ERROR, "Control c%d must be set.\n", i);
666  print_ctl_info(ctx, AV_LOG_ERROR, s, i, s->icmap, s->ictlv, 0);
667  return AVERROR(EINVAL);
668  }
669  }
670 
671  pad.type = AVMEDIA_TYPE_AUDIO;
672 
673  if (s->nb_inputs) {
674  pad.name = av_asprintf("in0:%s%lu", desc->Label, s->nb_inputs);
675  if (!pad.name)
676  return AVERROR(ENOMEM);
677 
680  if ((ret = ff_append_inpad_free_name(ctx, &pad)) < 0)
681  return ret;
682  }
683 
684  av_log(ctx, AV_LOG_DEBUG, "ports: %lu\n", nb_ports);
685  av_log(ctx, AV_LOG_DEBUG, "inputs: %lu outputs: %lu\n",
686  s->nb_inputs, s->nb_outputs);
687  av_log(ctx, AV_LOG_DEBUG, "input controls: %lu output controls: %lu\n",
688  s->nb_inputcontrols, s->nb_outputcontrols);
689 
690  s->next_out_pts = AV_NOPTS_VALUE;
691  s->next_in_pts = AV_NOPTS_VALUE;
692 
693  s->fifo = av_fifo_alloc2(8, sizeof(MetaItem), AV_FIFO_FLAG_AUTO_GROW);
694  if (!s->fifo)
695  return AVERROR(ENOMEM);
696 
697  return 0;
698 }
699 
701 {
702  LADSPAContext *s = ctx->priv;
704  static const enum AVSampleFormat sample_fmts[] = {
707  if (ret < 0)
708  return ret;
709 
710  if (s->nb_inputs) {
712  if (ret < 0)
713  return ret;
714  } else {
715  int sample_rates[] = { s->sample_rate, -1 };
716 
718  if (ret < 0)
719  return ret;
720  }
721 
722  if (s->nb_inputs == 1 && s->nb_outputs == 1) {
723  // We will instantiate multiple LADSPA_Handle, one over each channel
725  if (ret < 0)
726  return ret;
727  } else if (s->nb_inputs == 2 && s->nb_outputs == 2) {
728  layouts = NULL;
730  if (ret < 0)
731  return ret;
733  if (ret < 0)
734  return ret;
735  } else {
736  AVFilterLink *outlink = ctx->outputs[0];
737 
738  if (s->nb_inputs >= 1) {
739  AVFilterLink *inlink = ctx->inputs[0];
740  AVChannelLayout inlayout = FF_COUNT2LAYOUT(s->nb_inputs);
741 
742  layouts = NULL;
743  ret = ff_add_channel_layout(&layouts, &inlayout);
744  if (ret < 0)
745  return ret;
746  ret = ff_channel_layouts_ref(layouts, &inlink->outcfg.channel_layouts);
747  if (ret < 0)
748  return ret;
749 
750  if (!s->nb_outputs) {
752  if (ret < 0)
753  return ret;
754  }
755  }
756 
757  if (s->nb_outputs >= 1) {
758  AVChannelLayout outlayout = FF_COUNT2LAYOUT(s->nb_outputs);
759 
760  layouts = NULL;
761  ret = ff_add_channel_layout(&layouts, &outlayout);
762  if (ret < 0)
763  return ret;
765  if (ret < 0)
766  return ret;
767  }
768  }
769 
770  return 0;
771 }
772 
774 {
775  LADSPAContext *s = ctx->priv;
776  int i;
777 
778  for (i = 0; i < s->nb_handles; i++) {
779  if (s->desc->deactivate)
780  s->desc->deactivate(s->handles[i]);
781  if (s->desc->cleanup)
782  s->desc->cleanup(s->handles[i]);
783  }
784 
785  if (s->dl_handle)
786  dlclose(s->dl_handle);
787 
788  av_freep(&s->ipmap);
789  av_freep(&s->opmap);
790  av_freep(&s->icmap);
791  av_freep(&s->ocmap);
792  av_freep(&s->ictlv);
793  av_freep(&s->octlv);
794  av_freep(&s->handles);
795  av_freep(&s->ctl_needs_value);
796 
797  av_fifo_freep2(&s->fifo);
798 }
799 
800 static int process_command(AVFilterContext *ctx, const char *cmd, const char *args,
801  char *res, int res_len, int flags)
802 {
803  LADSPA_Data value;
804  unsigned long port;
805 
806  if (av_sscanf(cmd, "c%ld", &port) + av_sscanf(args, "%f", &value) != 2)
807  return AVERROR(EINVAL);
808 
809  return set_control(ctx, port, value);
810 }
811 
812 static const AVFilterPad ladspa_outputs[] = {
813  {
814  .name = "default",
815  .type = AVMEDIA_TYPE_AUDIO,
816  .config_props = config_output,
817  .request_frame = request_frame,
818  },
819 };
820 
822  .name = "ladspa",
823  .description = NULL_IF_CONFIG_SMALL("Apply LADSPA effect."),
824  .priv_size = sizeof(LADSPAContext),
825  .priv_class = &ladspa_class,
826  .init = init,
827  .uninit = uninit,
829  .inputs = 0,
833 };
LADSPAContext::nb_inputs
unsigned long nb_inputs
Definition: af_ladspa.c:50
try_load
static void * try_load(const char *dir, const char *soname)
Definition: af_ladspa.c:441
ff_get_audio_buffer
AVFrame * ff_get_audio_buffer(AVFilterLink *link, int nb_samples)
Request an audio samples buffer with a specific set of permissions.
Definition: audio.c:100
FF_ENABLE_DEPRECATION_WARNINGS
#define FF_ENABLE_DEPRECATION_WARNINGS
Definition: internal.h:82
AV_SAMPLE_FMT_FLTP
@ AV_SAMPLE_FMT_FLTP
float, planar
Definition: samplefmt.h:66
AVFilterChannelLayouts
A list of supported channel layouts.
Definition: formats.h:85
level
uint8_t level
Definition: svq3.c:204
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
AVFilterFormatsConfig::channel_layouts
AVFilterChannelLayouts * channel_layouts
Lists of supported channel layouts, only for audio.
Definition: avfilter.h:506
out
FILE * out
Definition: movenc.c:54
AV_CHANNEL_LAYOUT_STEREO
#define AV_CHANNEL_LAYOUT_STEREO
Definition: channel_layout.h:369
ff_filter_frame
int ff_filter_frame(AVFilterLink *link, AVFrame *frame)
Send a frame of data to the next filter.
Definition: avfilter.c:969
sample_fmts
static enum AVSampleFormat sample_fmts[]
Definition: adpcmenc.c:947
ff_channel_layouts_ref
int ff_channel_layouts_ref(AVFilterChannelLayouts *f, AVFilterChannelLayouts **ref)
Add *ref as a new reference to f.
Definition: formats.c:591
layouts
enum MovChannelLayoutTag * layouts
Definition: mov_chan.c:326
AVERROR_EOF
#define AVERROR_EOF
End of file.
Definition: error.h:57
ff_set_common_samplerates_from_list
int ff_set_common_samplerates_from_list(AVFilterContext *ctx, const int *samplerates)
Equivalent to ff_set_common_samplerates(ctx, ff_make_format_list(samplerates))
Definition: formats.c:733
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
av_asprintf
char * av_asprintf(const char *fmt,...)
Definition: avstring.c:116
av_strcasecmp
int av_strcasecmp(const char *a, const char *b)
Locale-independent case-insensitive compare.
Definition: avstring.c:208
AVFILTER_DEFINE_CLASS
AVFILTER_DEFINE_CLASS(ladspa)
av_frame_free
void av_frame_free(AVFrame **frame)
Free the frame and any dynamically allocated objects in it, e.g.
Definition: frame.c:99
AVFrame
This structure describes decoded (raw) audio or video data.
Definition: frame.h:330
AVFrame::pts
int64_t pts
Presentation timestamp in time_base units (time when frame should be shown to user).
Definition: frame.h:437
AVOption
AVOption.
Definition: opt.h:251
FILTER_QUERY_FUNC
#define FILTER_QUERY_FUNC(func)
Definition: internal.h:171
AV_OPT_TYPE_DURATION
@ AV_OPT_TYPE_DURATION
Definition: opt.h:239
ff_request_frame
int ff_request_frame(AVFilterLink *link)
Request an input frame from the filter at the other end of the link.
Definition: avfilter.c:415
LADSPAContext::handles
LADSPA_Handle * handles
Definition: af_ladspa.c:67
LADSPAContext::ctl_needs_value
int * ctl_needs_value
Definition: af_ladspa.c:65
AV_LOG_VERBOSE
#define AV_LOG_VERBOSE
Detailed information.
Definition: log.h:196
ff_set_common_all_samplerates
int ff_set_common_all_samplerates(AVFilterContext *ctx)
Equivalent to ff_set_common_samplerates(ctx, ff_all_samplerates())
Definition: formats.c:739
LADSPAContext
Definition: af_ladspa.c:43
config_output
static int config_output(AVFilterLink *outlink)
Definition: af_ladspa.c:390
AVFilter::name
const char * name
Filter name.
Definition: avfilter.h:165
uninit
static av_cold void uninit(AVFilterContext *ctx)
Definition: af_ladspa.c:773
AVChannelLayout::nb_channels
int nb_channels
Number of channels in this layout.
Definition: channel_layout.h:311
sample_rate
sample_rate
Definition: ffmpeg_filter.c:156
LADSPAContext::options
char * options
Definition: af_ladspa.c:47
LADSPAContext::icmap
unsigned long * icmap
Definition: af_ladspa.c:54
process_command
static int process_command(AVFilterContext *ctx, const char *cmd, const char *args, char *res, int res_len, int flags)
Definition: af_ladspa.c:800
LADSPAContext::nb_outputs
unsigned long nb_outputs
Definition: af_ladspa.c:57
connect_ports
static int connect_ports(AVFilterContext *ctx, AVFilterLink *link)
Definition: af_ladspa.c:349
LADSPAContext::next_in_pts
int64_t next_in_pts
Definition: af_ladspa.c:71
fifo.h
filter_frame
static int filter_frame(AVFilterLink *inlink, AVFrame *in)
Definition: af_ladspa.c:171
av_fifo_write
int av_fifo_write(AVFifo *f, const void *buf, size_t nb_elems)
Write data into a FIFO.
Definition: fifo.c:188
LADSPAContext::nb_handles
int nb_handles
Definition: af_ladspa.c:66
LADSPAContext::desc
const LADSPA_Descriptor * desc
Definition: af_ladspa.c:64
val
static double val(void *priv, double ch)
Definition: aeval.c:77
request_frame
static int request_frame(AVFilterLink *outlink)
Definition: af_ladspa.c:265
AVFrame::ch_layout
AVChannelLayout ch_layout
Channel layout of the audio data.
Definition: frame.h:723
AVFILTER_FLAG_DYNAMIC_INPUTS
#define AVFILTER_FLAG_DYNAMIC_INPUTS
The number of the filter inputs is not determined just by AVFilter.inputs.
Definition: avfilter.h:106
LADSPAContext::plugin
char * plugin
Definition: af_ladspa.c:46
AVFilterPad
A filter pad used for either input or output.
Definition: internal.h:49
LADSPAContext::out_pad
int out_pad
Definition: af_ladspa.c:76
avassert.h
AV_LOG_ERROR
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
Definition: log.h:180
av_cold
#define av_cold
Definition: attributes.h:90
av_fifo_read
int av_fifo_read(AVFifo *f, void *buf, size_t nb_elems)
Read data from a FIFO.
Definition: fifo.c:240
duration
int64_t duration
Definition: movenc.c:64
s
#define s(width, name)
Definition: cbs_vp9.c:256
LADSPAContext::sample_rate
int sample_rate
Definition: af_ladspa.c:69
AVMEDIA_TYPE_AUDIO
@ AVMEDIA_TYPE_AUDIO
Definition: avutil.h:202
av_strtok
char * av_strtok(char *s, const char *delim, char **saveptr)
Split the string into several tokens which can be accessed by successive calls to av_strtok().
Definition: avstring.c:179
ff_set_common_formats_from_list
int ff_set_common_formats_from_list(AVFilterContext *ctx, const int *fmts)
Equivalent to ff_set_common_formats(ctx, ff_make_format_list(fmts))
Definition: formats.c:755
av_assert0
#define av_assert0(cond)
assert() equivalent, that is always enabled.
Definition: avassert.h:37
outputs
static const AVFilterPad outputs[]
Definition: af_acontrast.c:172
LADSPAContext::dl_handle
void * dl_handle
Definition: af_ladspa.c:48
AV_LOG_DEBUG
#define AV_LOG_DEBUG
Stuff which is only useful for libav* developers.
Definition: log.h:201
ctx
AVFormatContext * ctx
Definition: movenc.c:48
av_rescale_q
int64_t av_rescale_q(int64_t a, AVRational bq, AVRational cq)
Rescale a 64-bit integer by 2 rational numbers.
Definition: mathematics.c:142
LADSPAContext::ipmap
unsigned long * ipmap
Definition: af_ladspa.c:51
LADSPAContext::next_out_pts
int64_t next_out_pts
Definition: af_ladspa.c:72
link
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 link
Definition: filter_design.txt:23
arg
const char * arg
Definition: jacosubdec.c:67
if
if(ret)
Definition: filter_design.txt:179
av_sscanf
int av_sscanf(const char *string, const char *format,...)
See libc sscanf manual for more information.
Definition: avsscanf.c:962
AVClass
Describe the class of an AVClass context structure.
Definition: log.h:66
LADSPAContext::ictlv
LADSPA_Data * ictlv
Definition: af_ladspa.c:55
NULL
#define NULL
Definition: coverity.c:32
av_frame_copy_props
int av_frame_copy_props(AVFrame *dst, const AVFrame *src)
Copy only "metadata" fields from src to dst.
Definition: frame.c:594
LADSPAContext::in_trim
int in_trim
Definition: af_ladspa.c:75
AVRational
Rational number (pair of numerator and denominator).
Definition: rational.h:58
ff_append_inpad_free_name
int ff_append_inpad_free_name(AVFilterContext *f, AVFilterPad *p)
Definition: avfilter.c:131
OFFSET
#define OFFSET(x)
Definition: af_ladspa.c:82
count_ports
static void count_ports(const LADSPA_Descriptor *desc, unsigned long *nb_inputs, unsigned long *nb_outputs)
Definition: af_ladspa.c:422
AVFilterPad::filter_frame
int(* filter_frame)(AVFilterLink *link, AVFrame *frame)
Filtering callback.
Definition: internal.h:104
MetaItem::pts
int64_t pts
Definition: af_alimiter.c:38
inputs
these buffered frames must be flushed immediately if a new input produces new the filter must not call request_frame to get more It must just process the frame or queue it The task of requesting more frames is left to the filter s request_frame method or the application If a filter has several inputs
Definition: filter_design.txt:243
config_input
static int config_input(AVFilterLink *inlink)
Definition: af_ladspa.c:383
ff_set_common_all_channel_counts
int ff_set_common_all_channel_counts(AVFilterContext *ctx)
Equivalent to ff_set_common_channel_layouts(ctx, ff_all_channel_counts())
Definition: formats.c:721
ff_add_channel_layout
int ff_add_channel_layout(AVFilterChannelLayouts **l, const AVChannelLayout *channel_layout)
Definition: formats.c:466
exp
int8_t exp
Definition: eval.c:72
LADSPAContext::ocmap
unsigned long * ocmap
Definition: af_ladspa.c:61
print_ctl_info
static void print_ctl_info(AVFilterContext *ctx, int level, LADSPAContext *s, int ctl, unsigned long *map, LADSPA_Data *values, int print)
Definition: af_ladspa.c:119
AVFilterPad::config_props
int(* config_props)(AVFilterLink *link)
Link configuration callback.
Definition: internal.h:129
options
const OptionDef options[]
AVFifo
Definition: fifo.c:35
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:115
AVChannelLayout
An AVChannelLayout holds information about the channel layout of audio data.
Definition: channel_layout.h:301
LADSPAContext::nb_inputcontrols
unsigned long nb_inputcontrols
Definition: af_ladspa.c:53
set_control
static int set_control(AVFilterContext *ctx, unsigned long port, LADSPA_Data value)
Definition: af_ladspa.c:454
AVFrame::sample_rate
int sample_rate
Sample rate of the audio data.
Definition: frame.h:516
print
static void print(AVTreeNode *t, int depth)
Definition: tree.c:44
LADSPAContext::dl_name
char * dl_name
Definition: af_ladspa.c:45
AV_SAMPLE_FMT_NONE
@ AV_SAMPLE_FMT_NONE
Definition: samplefmt.h:56
av_make_q
static AVRational av_make_q(int num, int den)
Create an AVRational.
Definition: rational.h:71
AV_NOPTS_VALUE
#define AV_NOPTS_VALUE
Undefined timestamp value.
Definition: avutil.h:248
av_frame_is_writable
int av_frame_is_writable(AVFrame *frame)
Check if the frame data is writable.
Definition: frame.c:524
AVERROR_EXTERNAL
#define AVERROR_EXTERNAL
Generic error in an external library.
Definition: error.h:59
offset
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 offset
Definition: writing_filters.txt:86
AV_LOG_INFO
#define AV_LOG_INFO
Standard information.
Definition: log.h:191
sample_rates
sample_rates
Definition: ffmpeg_filter.c:156
internal.h
AVFrame::nb_samples
int nb_samples
number of audio samples (per channel) described by this frame
Definition: frame.h:410
query_formats
static int query_formats(AVFilterContext *ctx)
Definition: af_ladspa.c:700
lrintf
#define lrintf(x)
Definition: libm_mips.h:72
i
#define i(width, name, range_min, range_max)
Definition: cbs_h2645.c:269
LADSPAContext::latency
int latency
Definition: af_ladspa.c:77
AV_TIME_BASE
#define AV_TIME_BASE
Internal time base represented as integer.
Definition: avutil.h:254
AVFrame::extended_data
uint8_t ** extended_data
pointers to the data planes/channels.
Definition: frame.h:391
AVSampleFormat
AVSampleFormat
Audio sample formats.
Definition: samplefmt.h:55
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
FFMIN
#define FFMIN(a, b)
Definition: macros.h:49
AVFilterPad::name
const char * name
Pad name.
Definition: internal.h:55
av_rescale
int64_t av_rescale(int64_t a, int64_t b, int64_t c)
Rescale a 64-bit integer with rounding to nearest.
Definition: mathematics.c:129
av_calloc
void * av_calloc(size_t nmemb, size_t size)
Definition: mem.c:262
AVFilter
Filter definition.
Definition: avfilter.h:161
ret
ret
Definition: filter_design.txt:187
AVFilterPad::type
enum AVMediaType type
AVFilterPad type.
Definition: internal.h:60
frame
these buffered frames must be flushed immediately if a new input produces new the filter must not call request_frame to get more It must just process the frame or queue it The task of requesting more frames is left to the filter s request_frame method or the application If a filter has several the filter must be ready for frames arriving randomly on any input any filter with several inputs will most likely require some kind of queuing mechanism It is perfectly acceptable to have a limited queue and to drop frames when the inputs are too unbalanced request_frame For filters that do not use the this method is called when a frame is wanted on an output For a it should directly call filter_frame on the corresponding output For a if there are queued frames already one of these frames should be pushed If the filter should request a frame on one of its repeatedly until at least one frame has been pushed Return or at least make progress towards producing a frame
Definition: filter_design.txt:264
FF_COUNT2LAYOUT
#define FF_COUNT2LAYOUT(c)
Encode a channel count as a channel layout.
Definition: formats.h:102
ff_af_ladspa
const AVFilter ff_af_ladspa
Definition: af_ladspa.c:821
av_fifo_alloc2
AVFifo * av_fifo_alloc2(size_t nb_elems, size_t elem_size, unsigned int flags)
Allocate and initialize an AVFifo with a given element size.
Definition: fifo.c:47
LADSPAContext::duration
int64_t duration
Definition: af_ladspa.c:74
channel_layout.h
AV_OPT_TYPE_INT
@ AV_OPT_TYPE_INT
Definition: opt.h:225
avfilter.h
values
these buffered frames must be flushed immediately if a new input produces new the filter must not call request_frame to get more It must just process the frame or queue it The task of requesting more frames is left to the filter s request_frame method or the application If a filter has several the filter must be ready for frames arriving randomly on any input any filter with several inputs will most likely require some kind of queuing mechanism It is perfectly acceptable to have a limited queue and to drop frames when the inputs are too unbalanced request_frame For filters that do not use the this method is called when a frame is wanted on an output For a it should directly call filter_frame on the corresponding output For a if there are queued frames already one of these frames should be pushed If the filter should request a frame on one of its repeatedly until at least one frame has been pushed Return values
Definition: filter_design.txt:263
MetaItem
Definition: af_alimiter.c:37
AVFilterContext
An instance of a filter.
Definition: avfilter.h:392
MetaItem::nb_samples
int nb_samples
Definition: af_alimiter.c:39
av_channel_layout_copy
int av_channel_layout_copy(AVChannelLayout *dst, const AVChannelLayout *src)
Make a copy of a channel layout.
Definition: channel_layout.c:639
find_latency
static int find_latency(AVFilterContext *ctx, LADSPAContext *s)
Definition: af_ladspa.c:104
FF_DISABLE_DEPRECATION_WARNINGS
#define FF_DISABLE_DEPRECATION_WARNINGS
Definition: internal.h:81
av_strdup
char * av_strdup(const char *s)
Duplicate a string.
Definition: mem.c:270
set_default_ctl_value
static void set_default_ctl_value(LADSPAContext *s, int ctl, unsigned long *map, LADSPA_Data *values)
Definition: af_ladspa.c:312
desc
const char * desc
Definition: libsvtav1.c:83
audio.h
LADSPAContext::octlv
LADSPA_Data * octlv
Definition: af_ladspa.c:62
LADSPAContext::opmap
unsigned long * opmap
Definition: af_ladspa.c:58
map
const VDPAUPixFmtMap * map
Definition: hwcontext_vdpau.c:71
av_free
#define av_free(p)
Definition: tableprint_vlc.h:33
ladspa_options
static const AVOption ladspa_options[]
Definition: af_ladspa.c:84
AV_OPT_TYPE_BOOL
@ AV_OPT_TYPE_BOOL
Definition: opt.h:244
FILTER_OUTPUTS
#define FILTER_OUTPUTS(array)
Definition: internal.h:195
ladspa_outputs
static const AVFilterPad ladspa_outputs[]
Definition: af_ladspa.c:812
av_freep
#define av_freep(p)
Definition: tableprint_vlc.h:34
FLAGS
#define FLAGS
Definition: af_ladspa.c:83
flags
#define flags(name, subs,...)
Definition: cbs_av1.c:561
av_log
#define av_log(a,...)
Definition: tableprint_vlc.h:27
av_fifo_freep2
void av_fifo_freep2(AVFifo **f)
Free an AVFifo and reset pointer to NULL.
Definition: fifo.c:286
h
h
Definition: vp9dsp_template.c:2038
AVERROR_EXIT
#define AVERROR_EXIT
Immediate exit was requested; the called function should not be restarted.
Definition: error.h:58
avstring.h
AV_OPT_TYPE_STRING
@ AV_OPT_TYPE_STRING
Definition: opt.h:229
LADSPAContext::fifo
AVFifo * fifo
Definition: af_ladspa.c:79
init
static av_cold int init(AVFilterContext *ctx)
Definition: af_ladspa.c:488
LADSPAContext::pts
int64_t pts
Definition: af_ladspa.c:73
LADSPAContext::nb_outputcontrols
unsigned long nb_outputcontrols
Definition: af_ladspa.c:60
AV_FIFO_FLAG_AUTO_GROW
#define AV_FIFO_FLAG_AUTO_GROW
Automatically resize the FIFO on writes, so that the data fits.
Definition: fifo.h:67
av_x_if_null
static void * av_x_if_null(const void *p, const void *x)
Return x default pointer in case p is NULL.
Definition: avutil.h:308
LADSPAContext::nb_samples
int nb_samples
Definition: af_ladspa.c:70
ff_set_common_channel_layouts
int ff_set_common_channel_layouts(AVFilterContext *ctx, AVFilterChannelLayouts *channel_layouts)
Helpers for query_formats() which set all free audio links to the same list of channel layouts/sample...
Definition: formats.c:708