FFmpeg
avfilter.c
Go to the documentation of this file.
1 /*
2  * filter layer
3  * Copyright (c) 2007 Bobby Bingham
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 "libavutil/avassert.h"
23 #include "libavutil/avstring.h"
24 #include "libavutil/buffer.h"
26 #include "libavutil/common.h"
27 #include "libavutil/eval.h"
28 #include "libavutil/hwcontext.h"
29 #include "libavutil/imgutils.h"
30 #include "libavutil/internal.h"
31 #include "libavutil/opt.h"
32 #include "libavutil/pixdesc.h"
33 #include "libavutil/rational.h"
34 #include "libavutil/samplefmt.h"
35 #include "libavutil/thread.h"
36 
37 #define FF_INTERNAL_FIELDS 1
38 #include "framequeue.h"
39 
40 #include "audio.h"
41 #include "avfilter.h"
42 #include "filters.h"
43 #include "formats.h"
44 #include "internal.h"
45 
46 #include "libavutil/ffversion.h"
47 const char av_filter_ffversion[] = "FFmpeg version " FFMPEG_VERSION;
48 
49 void ff_tlog_ref(void *ctx, AVFrame *ref, int end)
50 {
51  av_unused char buf[16];
52  ff_tlog(ctx,
53  "ref[%p buf:%p data:%p linesize[%d, %d, %d, %d] pts:%"PRId64" pos:%"PRId64,
54  ref, ref->buf, ref->data[0],
55  ref->linesize[0], ref->linesize[1], ref->linesize[2], ref->linesize[3],
56  ref->pts, ref->pkt_pos);
57 
58  if (ref->width) {
59  ff_tlog(ctx, " a:%d/%d s:%dx%d i:%c iskey:%d type:%c",
60  ref->sample_aspect_ratio.num, ref->sample_aspect_ratio.den,
61  ref->width, ref->height,
62  !ref->interlaced_frame ? 'P' : /* Progressive */
63  ref->top_field_first ? 'T' : 'B', /* Top / Bottom */
64  ref->key_frame,
65  av_get_picture_type_char(ref->pict_type));
66  }
67  if (ref->nb_samples) {
68  ff_tlog(ctx, " cl:%"PRId64"d n:%d r:%d",
69  ref->channel_layout,
70  ref->nb_samples,
71  ref->sample_rate);
72  }
73 
74  ff_tlog(ctx, "]%s", end ? "\n" : "");
75 }
76 
77 unsigned avfilter_version(void)
78 {
81 }
82 
83 const char *avfilter_configuration(void)
84 {
85  return FFMPEG_CONFIGURATION;
86 }
87 
88 const char *avfilter_license(void)
89 {
90 #define LICENSE_PREFIX "libavfilter license: "
91  return &LICENSE_PREFIX FFMPEG_LICENSE[sizeof(LICENSE_PREFIX) - 1];
92 }
93 
95 {
96  AVFilterCommand *c= filter->command_queue;
97  av_freep(&c->arg);
98  av_freep(&c->command);
99  filter->command_queue= c->next;
100  av_free(c);
101 }
102 
103 int ff_insert_pad(unsigned idx, unsigned *count, size_t padidx_off,
104  AVFilterPad **pads, AVFilterLink ***links,
105  AVFilterPad *newpad)
106 {
107  AVFilterLink **newlinks;
108  AVFilterPad *newpads;
109  unsigned i;
110 
111  idx = FFMIN(idx, *count);
112 
113  newpads = av_realloc_array(*pads, *count + 1, sizeof(AVFilterPad));
114  newlinks = av_realloc_array(*links, *count + 1, sizeof(AVFilterLink*));
115  if (newpads)
116  *pads = newpads;
117  if (newlinks)
118  *links = newlinks;
119  if (!newpads || !newlinks)
120  return AVERROR(ENOMEM);
121 
122  memmove(*pads + idx + 1, *pads + idx, sizeof(AVFilterPad) * (*count - idx));
123  memmove(*links + idx + 1, *links + idx, sizeof(AVFilterLink*) * (*count - idx));
124  memcpy(*pads + idx, newpad, sizeof(AVFilterPad));
125  (*links)[idx] = NULL;
126 
127  (*count)++;
128  for (i = idx + 1; i < *count; i++)
129  if ((*links)[i])
130  (*(unsigned *)((uint8_t *) (*links)[i] + padidx_off))++;
131 
132  return 0;
133 }
134 
135 int avfilter_link(AVFilterContext *src, unsigned srcpad,
136  AVFilterContext *dst, unsigned dstpad)
137 {
139 
140  av_assert0(src->graph);
141  av_assert0(dst->graph);
142  av_assert0(src->graph == dst->graph);
143 
144  if (src->nb_outputs <= srcpad || dst->nb_inputs <= dstpad ||
145  src->outputs[srcpad] || dst->inputs[dstpad])
146  return AVERROR(EINVAL);
147 
148  if (src->output_pads[srcpad].type != dst->input_pads[dstpad].type) {
150  "Media type mismatch between the '%s' filter output pad %d (%s) and the '%s' filter input pad %d (%s)\n",
151  src->name, srcpad, (char *)av_x_if_null(av_get_media_type_string(src->output_pads[srcpad].type), "?"),
152  dst->name, dstpad, (char *)av_x_if_null(av_get_media_type_string(dst-> input_pads[dstpad].type), "?"));
153  return AVERROR(EINVAL);
154  }
155 
156  link = av_mallocz(sizeof(*link));
157  if (!link)
158  return AVERROR(ENOMEM);
159 
160  src->outputs[srcpad] = dst->inputs[dstpad] = link;
161 
162  link->src = src;
163  link->dst = dst;
164  link->srcpad = &src->output_pads[srcpad];
165  link->dstpad = &dst->input_pads[dstpad];
166  link->type = src->output_pads[srcpad].type;
168  link->format = -1;
169  ff_framequeue_init(&link->fifo, &src->graph->internal->frame_queues);
170 
171  return 0;
172 }
173 
175 {
176  if (!*link)
177  return;
178 
179  av_frame_free(&(*link)->partial_buf);
180  ff_framequeue_free(&(*link)->fifo);
181  ff_frame_pool_uninit((FFFramePool**)&(*link)->frame_pool);
182 
183  av_freep(link);
184 }
185 
186 #if FF_API_FILTER_GET_SET
188 {
189  return link->channels;
190 }
191 #endif
192 
193 void ff_filter_set_ready(AVFilterContext *filter, unsigned priority)
194 {
195  filter->ready = FFMAX(filter->ready, priority);
196 }
197 
198 /**
199  * Clear frame_blocked_in on all outputs.
200  * This is necessary whenever something changes on input.
201  */
203 {
204  unsigned i;
205 
206  for (i = 0; i < filter->nb_outputs; i++)
207  filter->outputs[i]->frame_blocked_in = 0;
208 }
209 
210 
212 {
213  if (link->status_in == status)
214  return;
215  av_assert0(!link->status_in);
216  link->status_in = status;
217  link->status_in_pts = pts;
218  link->frame_wanted_out = 0;
219  link->frame_blocked_in = 0;
220  filter_unblock(link->dst);
221  ff_filter_set_ready(link->dst, 200);
222 }
223 
225 {
226  av_assert0(!link->frame_wanted_out);
227  av_assert0(!link->status_out);
228  link->status_out = status;
229  if (pts != AV_NOPTS_VALUE)
231  filter_unblock(link->dst);
232  ff_filter_set_ready(link->src, 200);
233 }
234 
235 #if FF_API_FILTER_LINK_SET_CLOSED
237 {
239 }
240 #endif
242  unsigned filt_srcpad_idx, unsigned filt_dstpad_idx)
243 {
244  int ret;
245  unsigned dstpad_idx = link->dstpad - link->dst->input_pads;
246 
247  av_log(link->dst, AV_LOG_VERBOSE, "auto-inserting filter '%s' "
248  "between the filter '%s' and the filter '%s'\n",
249  filt->name, link->src->name, link->dst->name);
250 
251  link->dst->inputs[dstpad_idx] = NULL;
252  if ((ret = avfilter_link(filt, filt_dstpad_idx, link->dst, dstpad_idx)) < 0) {
253  /* failed to link output filter to new filter */
254  link->dst->inputs[dstpad_idx] = link;
255  return ret;
256  }
257 
258  /* re-hookup the link to the new destination filter we inserted */
259  link->dst = filt;
260  link->dstpad = &filt->input_pads[filt_srcpad_idx];
261  filt->inputs[filt_srcpad_idx] = link;
262 
263  /* if any information on supported media formats already exists on the
264  * link, we need to preserve that */
265  if (link->outcfg.formats)
266  ff_formats_changeref(&link->outcfg.formats,
267  &filt->outputs[filt_dstpad_idx]->outcfg.formats);
268  if (link->outcfg.samplerates)
269  ff_formats_changeref(&link->outcfg.samplerates,
270  &filt->outputs[filt_dstpad_idx]->outcfg.samplerates);
271  if (link->outcfg.channel_layouts)
272  ff_channel_layouts_changeref(&link->outcfg.channel_layouts,
273  &filt->outputs[filt_dstpad_idx]->outcfg.channel_layouts);
274 
275  return 0;
276 }
277 
279 {
280  int (*config_link)(AVFilterLink *);
281  unsigned i;
282  int ret;
283 
284  for (i = 0; i < filter->nb_inputs; i ++) {
285  AVFilterLink *link = filter->inputs[i];
287 
288  if (!link) continue;
289  if (!link->src || !link->dst) {
291  "Not all input and output are properly linked (%d).\n", i);
292  return AVERROR(EINVAL);
293  }
294 
295  inlink = link->src->nb_inputs ? link->src->inputs[0] : NULL;
296  link->current_pts =
297  link->current_pts_us = AV_NOPTS_VALUE;
298 
299  switch (link->init_state) {
300  case AVLINK_INIT:
301  continue;
302  case AVLINK_STARTINIT:
303  av_log(filter, AV_LOG_INFO, "circular filter chain detected\n");
304  return 0;
305  case AVLINK_UNINIT:
306  link->init_state = AVLINK_STARTINIT;
307 
308  if ((ret = avfilter_config_links(link->src)) < 0)
309  return ret;
310 
311  if (!(config_link = link->srcpad->config_props)) {
312  if (link->src->nb_inputs != 1) {
313  av_log(link->src, AV_LOG_ERROR, "Source filters and filters "
314  "with more than one input "
315  "must set config_props() "
316  "callbacks on all outputs\n");
317  return AVERROR(EINVAL);
318  }
319  } else if ((ret = config_link(link)) < 0) {
320  av_log(link->src, AV_LOG_ERROR,
321  "Failed to configure output pad on %s\n",
322  link->src->name);
323  return ret;
324  }
325 
326  switch (link->type) {
327  case AVMEDIA_TYPE_VIDEO:
328  if (!link->time_base.num && !link->time_base.den)
329  link->time_base = inlink ? inlink->time_base : AV_TIME_BASE_Q;
330 
333  inlink->sample_aspect_ratio : (AVRational){1,1};
334 
335  if (inlink) {
336  if (!link->frame_rate.num && !link->frame_rate.den)
337  link->frame_rate = inlink->frame_rate;
338  if (!link->w)
339  link->w = inlink->w;
340  if (!link->h)
341  link->h = inlink->h;
342  } else if (!link->w || !link->h) {
343  av_log(link->src, AV_LOG_ERROR,
344  "Video source filters must set their output link's "
345  "width and height\n");
346  return AVERROR(EINVAL);
347  }
348  break;
349 
350  case AVMEDIA_TYPE_AUDIO:
351  if (inlink) {
352  if (!link->time_base.num && !link->time_base.den)
353  link->time_base = inlink->time_base;
354  }
355 
356  if (!link->time_base.num && !link->time_base.den)
357  link->time_base = (AVRational) {1, link->sample_rate};
358  }
359 
360  if (link->src->nb_inputs && link->src->inputs[0]->hw_frames_ctx &&
361  !(link->src->filter->flags_internal & FF_FILTER_FLAG_HWFRAME_AWARE)) {
363  "should not be set by non-hwframe-aware filter");
364  link->hw_frames_ctx = av_buffer_ref(link->src->inputs[0]->hw_frames_ctx);
365  if (!link->hw_frames_ctx)
366  return AVERROR(ENOMEM);
367  }
368 
369  if ((config_link = link->dstpad->config_props))
370  if ((ret = config_link(link)) < 0) {
371  av_log(link->dst, AV_LOG_ERROR,
372  "Failed to configure input pad on %s\n",
373  link->dst->name);
374  return ret;
375  }
376 
377  link->init_state = AVLINK_INIT;
378  }
379  }
380 
381  return 0;
382 }
383 
384 void ff_tlog_link(void *ctx, AVFilterLink *link, int end)
385 {
386  if (link->type == AVMEDIA_TYPE_VIDEO) {
387  ff_tlog(ctx,
388  "link[%p s:%dx%d fmt:%s %s->%s]%s",
389  link, link->w, link->h,
391  link->src ? link->src->filter->name : "",
392  link->dst ? link->dst->filter->name : "",
393  end ? "\n" : "");
394  } else {
395  char buf[128];
396  av_get_channel_layout_string(buf, sizeof(buf), -1, link->channel_layout);
397 
398  ff_tlog(ctx,
399  "link[%p r:%d cl:%s fmt:%s %s->%s]%s",
400  link, (int)link->sample_rate, buf,
402  link->src ? link->src->filter->name : "",
403  link->dst ? link->dst->filter->name : "",
404  end ? "\n" : "");
405  }
406 }
407 
409 {
411 
412  av_assert1(!link->dst->filter->activate);
413  if (link->status_out)
414  return link->status_out;
415  if (link->status_in) {
416  if (ff_framequeue_queued_frames(&link->fifo)) {
417  av_assert1(!link->frame_wanted_out);
418  av_assert1(link->dst->ready >= 300);
419  return 0;
420  } else {
421  /* Acknowledge status change. Filters using ff_request_frame() will
422  handle the change automatically. Filters can also check the
423  status directly but none do yet. */
424  ff_avfilter_link_set_out_status(link, link->status_in, link->status_in_pts);
425  return link->status_out;
426  }
427  }
428  link->frame_wanted_out = 1;
429  ff_filter_set_ready(link->src, 100);
430  return 0;
431 }
432 
433 static int64_t guess_status_pts(AVFilterContext *ctx, int status, AVRational link_time_base)
434 {
435  unsigned i;
436  int64_t r = INT64_MAX;
437 
438  for (i = 0; i < ctx->nb_inputs; i++)
439  if (ctx->inputs[i]->status_out == status)
440  r = FFMIN(r, av_rescale_q(ctx->inputs[i]->current_pts, ctx->inputs[i]->time_base, link_time_base));
441  if (r < INT64_MAX)
442  return r;
443  av_log(ctx, AV_LOG_WARNING, "EOF timestamp not reliable\n");
444  for (i = 0; i < ctx->nb_inputs; i++)
445  r = FFMIN(r, av_rescale_q(ctx->inputs[i]->status_in_pts, ctx->inputs[i]->time_base, link_time_base));
446  if (r < INT64_MAX)
447  return r;
448  return AV_NOPTS_VALUE;
449 }
450 
452 {
453  int ret = -1;
454 
455  FF_TPRINTF_START(NULL, request_frame_to_filter); ff_tlog_link(NULL, link, 1);
456  /* Assume the filter is blocked, let the method clear it if not */
457  link->frame_blocked_in = 1;
458  if (link->srcpad->request_frame)
459  ret = link->srcpad->request_frame(link);
460  else if (link->src->inputs[0])
461  ret = ff_request_frame(link->src->inputs[0]);
462  if (ret < 0) {
463  if (ret != AVERROR(EAGAIN) && ret != link->status_in)
465  if (ret == AVERROR_EOF)
466  ret = 0;
467  }
468  return ret;
469 }
470 
471 static const char *const var_names[] = {
472  "t",
473  "n",
474  "pos",
475  "w",
476  "h",
477  NULL
478 };
479 
480 enum {
487 };
488 
489 static int set_enable_expr(AVFilterContext *ctx, const char *expr)
490 {
491  int ret;
492  char *expr_dup;
493  AVExpr *old = ctx->enable;
494 
495  if (!(ctx->filter->flags & AVFILTER_FLAG_SUPPORT_TIMELINE)) {
496  av_log(ctx, AV_LOG_ERROR, "Timeline ('enable' option) not supported "
497  "with filter '%s'\n", ctx->filter->name);
498  return AVERROR_PATCHWELCOME;
499  }
500 
501  expr_dup = av_strdup(expr);
502  if (!expr_dup)
503  return AVERROR(ENOMEM);
504 
505  if (!ctx->var_values) {
506  ctx->var_values = av_calloc(VAR_VARS_NB, sizeof(*ctx->var_values));
507  if (!ctx->var_values) {
508  av_free(expr_dup);
509  return AVERROR(ENOMEM);
510  }
511  }
512 
513  ret = av_expr_parse((AVExpr**)&ctx->enable, expr_dup, var_names,
514  NULL, NULL, NULL, NULL, 0, ctx->priv);
515  if (ret < 0) {
516  av_log(ctx->priv, AV_LOG_ERROR,
517  "Error when evaluating the expression '%s' for enable\n",
518  expr_dup);
519  av_free(expr_dup);
520  return ret;
521  }
522 
523  av_expr_free(old);
524  av_free(ctx->enable_str);
525  ctx->enable_str = expr_dup;
526  return 0;
527 }
528 
530 {
531  if (pts == AV_NOPTS_VALUE)
532  return;
533  link->current_pts = pts;
534  link->current_pts_us = av_rescale_q(pts, link->time_base, AV_TIME_BASE_Q);
535  /* TODO use duration */
536  if (link->graph && link->age_index >= 0)
538 }
539 
540 int avfilter_process_command(AVFilterContext *filter, const char *cmd, const char *arg, char *res, int res_len, int flags)
541 {
542  if(!strcmp(cmd, "ping")){
543  char local_res[256] = {0};
544 
545  if (!res) {
546  res = local_res;
547  res_len = sizeof(local_res);
548  }
549  av_strlcatf(res, res_len, "pong from:%s %s\n", filter->filter->name, filter->name);
550  if (res == local_res)
551  av_log(filter, AV_LOG_INFO, "%s", res);
552  return 0;
553  }else if(!strcmp(cmd, "enable")) {
554  return set_enable_expr(filter, arg);
555  }else if(filter->filter->process_command) {
556  return filter->filter->process_command(filter, cmd, arg, res, res_len, flags);
557  }
558  return AVERROR(ENOSYS);
559 }
560 
562 {
563  int count;
564 
565  if (!pads)
566  return 0;
567 
568  for (count = 0; pads->name; count++)
569  pads++;
570  return count;
571 }
572 
573 static const char *default_filter_name(void *filter_ctx)
574 {
576  return ctx->name ? ctx->name : ctx->filter->name;
577 }
578 
579 static void *filter_child_next(void *obj, void *prev)
580 {
581  AVFilterContext *ctx = obj;
582  if (!prev && ctx->filter && ctx->filter->priv_class && ctx->priv)
583  return ctx->priv;
584  return NULL;
585 }
586 
587 #if FF_API_CHILD_CLASS_NEXT
588 static const AVClass *filter_child_class_next(const AVClass *prev)
589 {
590  void *opaque = NULL;
591  const AVFilter *f = NULL;
592 
593  /* find the filter that corresponds to prev */
594  while (prev && (f = av_filter_iterate(&opaque)))
595  if (f->priv_class == prev)
596  break;
597 
598  /* could not find filter corresponding to prev */
599  if (prev && !f)
600  return NULL;
601 
602  /* find next filter with specific options */
603  while ((f = av_filter_iterate(&opaque)))
604  if (f->priv_class)
605  return f->priv_class;
606 
607  return NULL;
608 }
609 #endif
610 
611 static const AVClass *filter_child_class_iterate(void **iter)
612 {
613  const AVFilter *f;
614 
615  while ((f = av_filter_iterate(iter)))
616  if (f->priv_class)
617  return f->priv_class;
618 
619  return NULL;
620 }
621 
622 #define OFFSET(x) offsetof(AVFilterContext, x)
623 #define FLAGS AV_OPT_FLAG_FILTERING_PARAM
624 #define TFLAGS AV_OPT_FLAG_FILTERING_PARAM|AV_OPT_FLAG_RUNTIME_PARAM
625 static const AVOption avfilter_options[] = {
626  { "thread_type", "Allowed thread types", OFFSET(thread_type), AV_OPT_TYPE_FLAGS,
627  { .i64 = AVFILTER_THREAD_SLICE }, 0, INT_MAX, FLAGS, "thread_type" },
628  { "slice", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = AVFILTER_THREAD_SLICE }, .flags = FLAGS, .unit = "thread_type" },
629  { "enable", "set enable expression", OFFSET(enable_str), AV_OPT_TYPE_STRING, {.str=NULL}, .flags = TFLAGS },
630  { "threads", "Allowed number of threads", OFFSET(nb_threads), AV_OPT_TYPE_INT,
631  { .i64 = 0 }, 0, INT_MAX, FLAGS },
632  { "extra_hw_frames", "Number of extra hardware frames to allocate for the user",
633  OFFSET(extra_hw_frames), AV_OPT_TYPE_INT, { .i64 = -1 }, -1, INT_MAX, FLAGS },
634  { NULL },
635 };
636 
637 static const AVClass avfilter_class = {
638  .class_name = "AVFilter",
639  .item_name = default_filter_name,
640  .version = LIBAVUTIL_VERSION_INT,
641  .category = AV_CLASS_CATEGORY_FILTER,
642  .child_next = filter_child_next,
643 #if FF_API_CHILD_CLASS_NEXT
644  .child_class_next = filter_child_class_next,
645 #endif
646  .child_class_iterate = filter_child_class_iterate,
648 };
649 
651  int *ret, int nb_jobs)
652 {
653  int i;
654 
655  for (i = 0; i < nb_jobs; i++) {
656  int r = func(ctx, arg, i, nb_jobs);
657  if (ret)
658  ret[i] = r;
659  }
660  return 0;
661 }
662 
663 AVFilterContext *ff_filter_alloc(const AVFilter *filter, const char *inst_name)
664 {
666  int preinited = 0;
667 
668  if (!filter)
669  return NULL;
670 
671  ret = av_mallocz(sizeof(AVFilterContext));
672  if (!ret)
673  return NULL;
674 
675  ret->av_class = &avfilter_class;
676  ret->filter = filter;
677  ret->name = inst_name ? av_strdup(inst_name) : NULL;
678  if (filter->priv_size) {
679  ret->priv = av_mallocz(filter->priv_size);
680  if (!ret->priv)
681  goto err;
682  }
683  if (filter->preinit) {
684  if (filter->preinit(ret) < 0)
685  goto err;
686  preinited = 1;
687  }
688 
690  if (filter->priv_class) {
691  *(const AVClass**)ret->priv = filter->priv_class;
692  av_opt_set_defaults(ret->priv);
693  }
694 
695  ret->internal = av_mallocz(sizeof(*ret->internal));
696  if (!ret->internal)
697  goto err;
698  ret->internal->execute = default_execute;
699 
700  ret->nb_inputs = avfilter_pad_count(filter->inputs);
701  if (ret->nb_inputs ) {
702  ret->input_pads = av_malloc_array(ret->nb_inputs, sizeof(AVFilterPad));
703  if (!ret->input_pads)
704  goto err;
705  memcpy(ret->input_pads, filter->inputs, sizeof(AVFilterPad) * ret->nb_inputs);
706  ret->inputs = av_mallocz_array(ret->nb_inputs, sizeof(AVFilterLink*));
707  if (!ret->inputs)
708  goto err;
709  }
710 
711  ret->nb_outputs = avfilter_pad_count(filter->outputs);
712  if (ret->nb_outputs) {
713  ret->output_pads = av_malloc_array(ret->nb_outputs, sizeof(AVFilterPad));
714  if (!ret->output_pads)
715  goto err;
716  memcpy(ret->output_pads, filter->outputs, sizeof(AVFilterPad) * ret->nb_outputs);
717  ret->outputs = av_mallocz_array(ret->nb_outputs, sizeof(AVFilterLink*));
718  if (!ret->outputs)
719  goto err;
720  }
721 
722  return ret;
723 
724 err:
725  if (preinited)
726  filter->uninit(ret);
727  av_freep(&ret->inputs);
728  av_freep(&ret->input_pads);
729  ret->nb_inputs = 0;
730  av_freep(&ret->outputs);
731  av_freep(&ret->output_pads);
732  ret->nb_outputs = 0;
733  av_freep(&ret->priv);
734  av_freep(&ret->internal);
735  av_free(ret);
736  return NULL;
737 }
738 
740 {
741  if (!link)
742  return;
743 
744  if (link->src)
745  link->src->outputs[link->srcpad - link->src->output_pads] = NULL;
746  if (link->dst)
747  link->dst->inputs[link->dstpad - link->dst->input_pads] = NULL;
748 
750 
751  ff_formats_unref(&link->incfg.formats);
752  ff_formats_unref(&link->outcfg.formats);
753  ff_formats_unref(&link->incfg.samplerates);
754  ff_formats_unref(&link->outcfg.samplerates);
755  ff_channel_layouts_unref(&link->incfg.channel_layouts);
756  ff_channel_layouts_unref(&link->outcfg.channel_layouts);
758 }
759 
761 {
762  int i;
763 
764  if (!filter)
765  return;
766 
767  if (filter->graph)
769 
770  if (filter->filter->uninit)
771  filter->filter->uninit(filter);
772 
773  for (i = 0; i < filter->nb_inputs; i++) {
774  free_link(filter->inputs[i]);
775  }
776  for (i = 0; i < filter->nb_outputs; i++) {
777  free_link(filter->outputs[i]);
778  }
779 
780  if (filter->filter->priv_class)
781  av_opt_free(filter->priv);
782 
783  av_buffer_unref(&filter->hw_device_ctx);
784 
785  av_freep(&filter->name);
786  av_freep(&filter->input_pads);
787  av_freep(&filter->output_pads);
788  av_freep(&filter->inputs);
789  av_freep(&filter->outputs);
790  av_freep(&filter->priv);
791  while(filter->command_queue){
793  }
795  av_expr_free(filter->enable);
796  filter->enable = NULL;
797  av_freep(&filter->var_values);
798  av_freep(&filter->internal);
799  av_free(filter);
800 }
801 
803 {
804  if (ctx->nb_threads > 0)
805  return FFMIN(ctx->nb_threads, ctx->graph->nb_threads);
806  return ctx->graph->nb_threads;
807 }
808 
810  const char *args)
811 {
812  const AVOption *o = NULL;
813  int ret, count = 0;
814  char *av_uninit(parsed_key), *av_uninit(value);
815  const char *key;
816  int offset= -1;
817 
818  if (!args)
819  return 0;
820 
821  while (*args) {
822  const char *shorthand = NULL;
823 
824  o = av_opt_next(ctx->priv, o);
825  if (o) {
826  if (o->type == AV_OPT_TYPE_CONST || o->offset == offset)
827  continue;
828  offset = o->offset;
829  shorthand = o->name;
830  }
831 
832  ret = av_opt_get_key_value(&args, "=", ":",
833  shorthand ? AV_OPT_FLAG_IMPLICIT_KEY : 0,
834  &parsed_key, &value);
835  if (ret < 0) {
836  if (ret == AVERROR(EINVAL))
837  av_log(ctx, AV_LOG_ERROR, "No option name near '%s'\n", args);
838  else
839  av_log(ctx, AV_LOG_ERROR, "Unable to parse '%s': %s\n", args,
840  av_err2str(ret));
841  return ret;
842  }
843  if (*args)
844  args++;
845  if (parsed_key) {
846  key = parsed_key;
847  while ((o = av_opt_next(ctx->priv, o))); /* discard all remaining shorthand */
848  } else {
849  key = shorthand;
850  }
851 
852  av_log(ctx, AV_LOG_DEBUG, "Setting '%s' to value '%s'\n", key, value);
853 
854  if (av_opt_find(ctx, key, NULL, 0, 0)) {
855  ret = av_opt_set(ctx, key, value, 0);
856  if (ret < 0) {
857  av_free(value);
858  av_free(parsed_key);
859  return ret;
860  }
861  } else {
863  if ((ret = av_opt_set(ctx->priv, key, value, AV_OPT_SEARCH_CHILDREN)) < 0) {
866  av_log(ctx, AV_LOG_ERROR, "Option '%s' not found\n", key);
867  av_free(value);
868  av_free(parsed_key);
869  return ret;
870  }
871  }
872  }
873 
874  av_free(value);
875  av_free(parsed_key);
876  count++;
877  }
878 
879  return count;
880 }
881 
883  const char *arg, char *res, int res_len, int flags)
884 {
885  const AVOption *o;
886 
887  if (!ctx->filter->priv_class)
888  return 0;
890  if (!o)
891  return AVERROR(ENOSYS);
892  return av_opt_set(ctx->priv, cmd, arg, 0);
893 }
894 
896 {
897  int ret = 0;
898 
900  if (ret < 0) {
901  av_log(ctx, AV_LOG_ERROR, "Error applying generic filter options.\n");
902  return ret;
903  }
904 
905  if (ctx->filter->flags & AVFILTER_FLAG_SLICE_THREADS &&
906  ctx->thread_type & ctx->graph->thread_type & AVFILTER_THREAD_SLICE &&
907  ctx->graph->internal->thread_execute) {
908  ctx->thread_type = AVFILTER_THREAD_SLICE;
909  ctx->internal->execute = ctx->graph->internal->thread_execute;
910  } else {
911  ctx->thread_type = 0;
912  }
913 
914  if (ctx->filter->priv_class) {
916  if (ret < 0) {
917  av_log(ctx, AV_LOG_ERROR, "Error applying options to the filter.\n");
918  return ret;
919  }
920  }
921 
922  if (ctx->filter->init_opaque)
923  ret = ctx->filter->init_opaque(ctx, NULL);
924  else if (ctx->filter->init)
925  ret = ctx->filter->init(ctx);
926  else if (ctx->filter->init_dict)
927  ret = ctx->filter->init_dict(ctx, options);
928  if (ret < 0)
929  return ret;
930 
931  if (ctx->enable_str) {
932  ret = set_enable_expr(ctx, ctx->enable_str);
933  if (ret < 0)
934  return ret;
935  }
936 
937  return 0;
938 }
939 
940 int avfilter_init_str(AVFilterContext *filter, const char *args)
941 {
944  int ret = 0;
945 
946  if (args && *args) {
947  if (!filter->filter->priv_class) {
948  av_log(filter, AV_LOG_ERROR, "This filter does not take any "
949  "options, but options were provided: %s.\n", args);
950  return AVERROR(EINVAL);
951  }
952 
953 #if FF_API_OLD_FILTER_OPTS_ERROR
954  if ( !strcmp(filter->filter->name, "format") ||
955  !strcmp(filter->filter->name, "noformat") ||
956  !strcmp(filter->filter->name, "frei0r") ||
957  !strcmp(filter->filter->name, "frei0r_src") ||
958  !strcmp(filter->filter->name, "ocv") ||
959  !strcmp(filter->filter->name, "pan") ||
960  !strcmp(filter->filter->name, "pp") ||
961  !strcmp(filter->filter->name, "aevalsrc")) {
962  /* a hack for compatibility with the old syntax
963  * replace colons with |s */
964  char *copy = av_strdup(args);
965  char *p = copy;
966  int nb_leading = 0; // number of leading colons to skip
967  int deprecated = 0;
968 
969  if (!copy) {
970  ret = AVERROR(ENOMEM);
971  goto fail;
972  }
973 
974  if (!strcmp(filter->filter->name, "frei0r") ||
975  !strcmp(filter->filter->name, "ocv"))
976  nb_leading = 1;
977  else if (!strcmp(filter->filter->name, "frei0r_src"))
978  nb_leading = 3;
979 
980  while (nb_leading--) {
981  p = strchr(p, ':');
982  if (!p) {
983  p = copy + strlen(copy);
984  break;
985  }
986  p++;
987  }
988 
989  deprecated = strchr(p, ':') != NULL;
990 
991  if (!strcmp(filter->filter->name, "aevalsrc")) {
992  deprecated = 0;
993  while ((p = strchr(p, ':')) && p[1] != ':') {
994  const char *epos = strchr(p + 1, '=');
995  const char *spos = strchr(p + 1, ':');
996  const int next_token_is_opt = epos && (!spos || epos < spos);
997  if (next_token_is_opt) {
998  p++;
999  break;
1000  }
1001  /* next token does not contain a '=', assume a channel expression */
1002  deprecated = 1;
1003  *p++ = '|';
1004  }
1005  if (p && *p == ':') { // double sep '::' found
1006  deprecated = 1;
1007  memmove(p, p + 1, strlen(p));
1008  }
1009  } else
1010  while ((p = strchr(p, ':')))
1011  *p++ = '|';
1012 
1013  if (deprecated) {
1014  av_log(filter, AV_LOG_ERROR, "This syntax is deprecated. Use "
1015  "'|' to separate the list items ('%s' instead of '%s')\n",
1016  copy, args);
1017  ret = AVERROR(EINVAL);
1018  } else {
1020  }
1021  av_freep(&copy);
1022 
1023  if (ret < 0)
1024  goto fail;
1025  } else
1026 #endif
1027  {
1028  ret = process_options(filter, &options, args);
1029  if (ret < 0)
1030  goto fail;
1031  }
1032  }
1033 
1035  if (ret < 0)
1036  goto fail;
1037 
1038  if ((e = av_dict_get(options, "", NULL, AV_DICT_IGNORE_SUFFIX))) {
1039  av_log(filter, AV_LOG_ERROR, "No such option: %s.\n", e->key);
1041  goto fail;
1042  }
1043 
1044 fail:
1046 
1047  return ret;
1048 }
1049 
1050 const char *avfilter_pad_get_name(const AVFilterPad *pads, int pad_idx)
1051 {
1052  return pads[pad_idx].name;
1053 }
1054 
1055 enum AVMediaType avfilter_pad_get_type(const AVFilterPad *pads, int pad_idx)
1056 {
1057  return pads[pad_idx].type;
1058 }
1059 
1061 {
1062  return ff_filter_frame(link->dst->outputs[0], frame);
1063 }
1064 
1066 {
1068  AVFilterContext *dstctx = link->dst;
1069  AVFilterPad *dst = link->dstpad;
1070  int ret;
1071 
1072  if (!(filter_frame = dst->filter_frame))
1074 
1075  if (dst->needs_writable) {
1077  if (ret < 0)
1078  goto fail;
1079  }
1080 
1083 
1084  if (dstctx->is_disabled &&
1087  ret = filter_frame(link, frame);
1088  link->frame_count_out++;
1089  return ret;
1090 
1091 fail:
1092  av_frame_free(&frame);
1093  return ret;
1094 }
1095 
1097 {
1098  int ret;
1100 
1101  /* Consistency checks */
1102  if (link->type == AVMEDIA_TYPE_VIDEO) {
1103  if (strcmp(link->dst->filter->name, "buffersink") &&
1104  strcmp(link->dst->filter->name, "format") &&
1105  strcmp(link->dst->filter->name, "idet") &&
1106  strcmp(link->dst->filter->name, "null") &&
1107  strcmp(link->dst->filter->name, "scale")) {
1108  av_assert1(frame->format == link->format);
1109  av_assert1(frame->width == link->w);
1110  av_assert1(frame->height == link->h);
1111  }
1112  } else {
1113  if (frame->format != link->format) {
1114  av_log(link->dst, AV_LOG_ERROR, "Format change is not supported\n");
1115  goto error;
1116  }
1117  if (frame->channels != link->channels) {
1118  av_log(link->dst, AV_LOG_ERROR, "Channel count change is not supported\n");
1119  goto error;
1120  }
1121  if (frame->channel_layout != link->channel_layout) {
1122  av_log(link->dst, AV_LOG_ERROR, "Channel layout change is not supported\n");
1123  goto error;
1124  }
1125  if (frame->sample_rate != link->sample_rate) {
1126  av_log(link->dst, AV_LOG_ERROR, "Sample rate change is not supported\n");
1127  goto error;
1128  }
1129  }
1130 
1131  link->frame_blocked_in = link->frame_wanted_out = 0;
1132  link->frame_count_in++;
1133  filter_unblock(link->dst);
1134  ret = ff_framequeue_add(&link->fifo, frame);
1135  if (ret < 0) {
1136  av_frame_free(&frame);
1137  return ret;
1138  }
1139  ff_filter_set_ready(link->dst, 300);
1140  return 0;
1141 
1142 error:
1143  av_frame_free(&frame);
1144  return AVERROR_PATCHWELCOME;
1145 }
1146 
1147 static int samples_ready(AVFilterLink *link, unsigned min)
1148 {
1149  return ff_framequeue_queued_frames(&link->fifo) &&
1150  (ff_framequeue_queued_samples(&link->fifo) >= min ||
1151  link->status_in);
1152 }
1153 
1154 static int take_samples(AVFilterLink *link, unsigned min, unsigned max,
1155  AVFrame **rframe)
1156 {
1157  AVFrame *frame0, *frame, *buf;
1158  unsigned nb_samples, nb_frames, i, p;
1159  int ret;
1160 
1161  /* Note: this function relies on no format changes and must only be
1162  called with enough samples. */
1163  av_assert1(samples_ready(link, link->min_samples));
1164  frame0 = frame = ff_framequeue_peek(&link->fifo, 0);
1165  if (!link->fifo.samples_skipped && frame->nb_samples >= min && frame->nb_samples <= max) {
1166  *rframe = ff_framequeue_take(&link->fifo);
1167  return 0;
1168  }
1169  nb_frames = 0;
1170  nb_samples = 0;
1171  while (1) {
1172  if (nb_samples + frame->nb_samples > max) {
1173  if (nb_samples < min)
1174  nb_samples = max;
1175  break;
1176  }
1177  nb_samples += frame->nb_samples;
1178  nb_frames++;
1179  if (nb_frames == ff_framequeue_queued_frames(&link->fifo))
1180  break;
1181  frame = ff_framequeue_peek(&link->fifo, nb_frames);
1182  }
1183 
1184  buf = ff_get_audio_buffer(link, nb_samples);
1185  if (!buf)
1186  return AVERROR(ENOMEM);
1187  ret = av_frame_copy_props(buf, frame0);
1188  if (ret < 0) {
1189  av_frame_free(&buf);
1190  return ret;
1191  }
1192  buf->pts = frame0->pts;
1193 
1194  p = 0;
1195  for (i = 0; i < nb_frames; i++) {
1196  frame = ff_framequeue_take(&link->fifo);
1197  av_samples_copy(buf->extended_data, frame->extended_data, p, 0,
1198  frame->nb_samples, link->channels, link->format);
1199  p += frame->nb_samples;
1200  av_frame_free(&frame);
1201  }
1202  if (p < nb_samples) {
1203  unsigned n = nb_samples - p;
1204  frame = ff_framequeue_peek(&link->fifo, 0);
1205  av_samples_copy(buf->extended_data, frame->extended_data, p, 0, n,
1206  link->channels, link->format);
1207  ff_framequeue_skip_samples(&link->fifo, n, link->time_base);
1208  }
1209 
1210  *rframe = buf;
1211  return 0;
1212 }
1213 
1215 {
1216  AVFrame *frame = NULL;
1217  AVFilterContext *dst = link->dst;
1218  int ret;
1219 
1221  ret = link->min_samples ?
1222  ff_inlink_consume_samples(link, link->min_samples, link->max_samples, &frame) :
1224  av_assert1(ret);
1225  if (ret < 0) {
1226  av_assert1(!frame);
1227  return ret;
1228  }
1229  /* The filter will soon have received a new frame, that may allow it to
1230  produce one or more: unblock its outputs. */
1231  filter_unblock(dst);
1232  /* AVFilterPad.filter_frame() expect frame_count_out to have the value
1233  before the frame; ff_filter_frame_framed() will re-increment it. */
1234  link->frame_count_out--;
1236  if (ret < 0 && ret != link->status_out) {
1238  } else {
1239  /* Run once again, to see if several frames were available, or if
1240  the input status has also changed, or any other reason. */
1241  ff_filter_set_ready(dst, 300);
1242  }
1243  return ret;
1244 }
1245 
1247 {
1248  unsigned out = 0, progress = 0;
1249  int ret;
1250 
1251  av_assert0(!in->status_out);
1252  if (!filter->nb_outputs) {
1253  /* not necessary with the current API and sinks */
1254  return 0;
1255  }
1256  while (!in->status_out) {
1257  if (!filter->outputs[out]->status_in) {
1258  progress++;
1260  if (ret < 0)
1261  return ret;
1262  }
1263  if (++out == filter->nb_outputs) {
1264  if (!progress) {
1265  /* Every output already closed: input no longer interesting
1266  (example: overlay in shortest mode, other input closed). */
1267  ff_avfilter_link_set_out_status(in, in->status_in, in->status_in_pts);
1268  return 0;
1269  }
1270  progress = 0;
1271  out = 0;
1272  }
1273  }
1275  return 0;
1276 }
1277 
1279 {
1280  unsigned i;
1281 
1282  for (i = 0; i < filter->nb_inputs; i++) {
1283  if (samples_ready(filter->inputs[i], filter->inputs[i]->min_samples)) {
1284  return ff_filter_frame_to_filter(filter->inputs[i]);
1285  }
1286  }
1287  for (i = 0; i < filter->nb_inputs; i++) {
1288  if (filter->inputs[i]->status_in && !filter->inputs[i]->status_out) {
1289  av_assert1(!ff_framequeue_queued_frames(&filter->inputs[i]->fifo));
1290  return forward_status_change(filter, filter->inputs[i]);
1291  }
1292  }
1293  for (i = 0; i < filter->nb_outputs; i++) {
1294  if (filter->outputs[i]->frame_wanted_out &&
1295  !filter->outputs[i]->frame_blocked_in) {
1296  return ff_request_frame_to_filter(filter->outputs[i]);
1297  }
1298  }
1299  return FFERROR_NOT_READY;
1300 }
1301 
1302 /*
1303  Filter scheduling and activation
1304 
1305  When a filter is activated, it must:
1306  - if possible, output a frame;
1307  - else, if relevant, forward the input status change;
1308  - else, check outputs for wanted frames and forward the requests.
1309 
1310  The following AVFilterLink fields are used for activation:
1311 
1312  - frame_wanted_out:
1313 
1314  This field indicates if a frame is needed on this input of the
1315  destination filter. A positive value indicates that a frame is needed
1316  to process queued frames or internal data or to satisfy the
1317  application; a zero value indicates that a frame is not especially
1318  needed but could be processed anyway; a negative value indicates that a
1319  frame would just be queued.
1320 
1321  It is set by filters using ff_request_frame() or ff_request_no_frame(),
1322  when requested by the application through a specific API or when it is
1323  set on one of the outputs.
1324 
1325  It is cleared when a frame is sent from the source using
1326  ff_filter_frame().
1327 
1328  It is also cleared when a status change is sent from the source using
1329  ff_avfilter_link_set_in_status().
1330 
1331  - frame_blocked_in:
1332 
1333  This field means that the source filter can not generate a frame as is.
1334  Its goal is to avoid repeatedly calling the request_frame() method on
1335  the same link.
1336 
1337  It is set by the framework on all outputs of a filter before activating it.
1338 
1339  It is automatically cleared by ff_filter_frame().
1340 
1341  It is also automatically cleared by ff_avfilter_link_set_in_status().
1342 
1343  It is also cleared on all outputs (using filter_unblock()) when
1344  something happens on an input: processing a frame or changing the
1345  status.
1346 
1347  - fifo:
1348 
1349  Contains the frames queued on a filter input. If it contains frames and
1350  frame_wanted_out is not set, then the filter can be activated. If that
1351  result in the filter not able to use these frames, the filter must set
1352  frame_wanted_out to ask for more frames.
1353 
1354  - status_in and status_in_pts:
1355 
1356  Status (EOF or error code) of the link and timestamp of the status
1357  change (in link time base, same as frames) as seen from the input of
1358  the link. The status change is considered happening after the frames
1359  queued in fifo.
1360 
1361  It is set by the source filter using ff_avfilter_link_set_in_status().
1362 
1363  - status_out:
1364 
1365  Status of the link as seen from the output of the link. The status
1366  change is considered having already happened.
1367 
1368  It is set by the destination filter using
1369  ff_avfilter_link_set_out_status().
1370 
1371  Filters are activated according to the ready field, set using the
1372  ff_filter_set_ready(). Eventually, a priority queue will be used.
1373  ff_filter_set_ready() is called whenever anything could cause progress to
1374  be possible. Marking a filter ready when it is not is not a problem,
1375  except for the small overhead it causes.
1376 
1377  Conditions that cause a filter to be marked ready are:
1378 
1379  - frames added on an input link;
1380 
1381  - changes in the input or output status of an input link;
1382 
1383  - requests for a frame on an output link;
1384 
1385  - after any actual processing using the legacy methods (filter_frame(),
1386  and request_frame() to acknowledge status changes), to run once more
1387  and check if enough input was present for several frames.
1388 
1389  Examples of scenarios to consider:
1390 
1391  - buffersrc: activate if frame_wanted_out to notify the application;
1392  activate when the application adds a frame to push it immediately.
1393 
1394  - testsrc: activate only if frame_wanted_out to produce and push a frame.
1395 
1396  - concat (not at stitch points): can process a frame on any output.
1397  Activate if frame_wanted_out on output to forward on the corresponding
1398  input. Activate when a frame is present on input to process it
1399  immediately.
1400 
1401  - framesync: needs at least one frame on each input; extra frames on the
1402  wrong input will accumulate. When a frame is first added on one input,
1403  set frame_wanted_out<0 on it to avoid getting more (would trigger
1404  testsrc) and frame_wanted_out>0 on the other to allow processing it.
1405 
1406  Activation of old filters:
1407 
1408  In order to activate a filter implementing the legacy filter_frame() and
1409  request_frame() methods, perform the first possible of the following
1410  actions:
1411 
1412  - If an input has frames in fifo and frame_wanted_out == 0, dequeue a
1413  frame and call filter_frame().
1414 
1415  Rationale: filter frames as soon as possible instead of leaving them
1416  queued; frame_wanted_out < 0 is not possible since the old API does not
1417  set it nor provides any similar feedback; frame_wanted_out > 0 happens
1418  when min_samples > 0 and there are not enough samples queued.
1419 
1420  - If an input has status_in set but not status_out, try to call
1421  request_frame() on one of the outputs in the hope that it will trigger
1422  request_frame() on the input with status_in and acknowledge it. This is
1423  awkward and fragile, filters with several inputs or outputs should be
1424  updated to direct activation as soon as possible.
1425 
1426  - If an output has frame_wanted_out > 0 and not frame_blocked_in, call
1427  request_frame().
1428 
1429  Rationale: checking frame_blocked_in is necessary to avoid requesting
1430  repeatedly on a blocked input if another is not blocked (example:
1431  [buffersrc1][testsrc1][buffersrc2][testsrc2]concat=v=2).
1432  */
1433 
1435 {
1436  int ret;
1437 
1438  /* Generic timeline support is not yet implemented but should be easy */
1440  filter->filter->activate));
1441  filter->ready = 0;
1442  ret = filter->filter->activate ? filter->filter->activate(filter) :
1444  if (ret == FFERROR_NOT_READY)
1445  ret = 0;
1446  return ret;
1447 }
1448 
1449 int ff_inlink_acknowledge_status(AVFilterLink *link, int *rstatus, int64_t *rpts)
1450 {
1451  *rpts = link->current_pts;
1452  if (ff_framequeue_queued_frames(&link->fifo))
1453  return *rstatus = 0;
1454  if (link->status_out)
1455  return *rstatus = link->status_out;
1456  if (!link->status_in)
1457  return *rstatus = 0;
1458  *rstatus = link->status_out = link->status_in;
1459  ff_update_link_current_pts(link, link->status_in_pts);
1460  *rpts = link->current_pts;
1461  return 1;
1462 }
1463 
1465 {
1466  return ff_framequeue_queued_frames(&link->fifo);
1467 }
1468 
1470 {
1471  return ff_framequeue_queued_frames(&link->fifo) > 0;
1472 }
1473 
1475 {
1476  return ff_framequeue_queued_samples(&link->fifo);
1477 }
1478 
1480 {
1481  uint64_t samples = ff_framequeue_queued_samples(&link->fifo);
1482  av_assert1(min);
1483  return samples >= min || (link->status_in && samples);
1484 }
1485 
1487 {
1490  link->dst->is_disabled = !ff_inlink_evaluate_timeline_at_frame(link, frame);
1491  link->frame_count_out++;
1492 }
1493 
1495 {
1496  AVFrame *frame;
1497 
1498  *rframe = NULL;
1500  return 0;
1501 
1502  if (link->fifo.samples_skipped) {
1503  frame = ff_framequeue_peek(&link->fifo, 0);
1504  return ff_inlink_consume_samples(link, frame->nb_samples, frame->nb_samples, rframe);
1505  }
1506 
1507  frame = ff_framequeue_take(&link->fifo);
1509  *rframe = frame;
1510  return 1;
1511 }
1512 
1514  AVFrame **rframe)
1515 {
1516  AVFrame *frame;
1517  int ret;
1518 
1519  av_assert1(min);
1520  *rframe = NULL;
1522  return 0;
1523  if (link->status_in)
1525  ret = take_samples(link, min, max, &frame);
1526  if (ret < 0)
1527  return ret;
1529  *rframe = frame;
1530  return 1;
1531 }
1532 
1534 {
1535  return ff_framequeue_peek(&link->fifo, idx);
1536 }
1537 
1539 {
1540  AVFrame *frame = *rframe;
1541  AVFrame *out;
1542  int ret;
1543 
1545  return 0;
1546  av_log(link->dst, AV_LOG_DEBUG, "Copying data in avfilter.\n");
1547 
1548  switch (link->type) {
1549  case AVMEDIA_TYPE_VIDEO:
1550  out = ff_get_video_buffer(link, link->w, link->h);
1551  break;
1552  case AVMEDIA_TYPE_AUDIO:
1553  out = ff_get_audio_buffer(link, frame->nb_samples);
1554  break;
1555  default:
1556  return AVERROR(EINVAL);
1557  }
1558  if (!out)
1559  return AVERROR(ENOMEM);
1560 
1562  if (ret < 0) {
1563  av_frame_free(&out);
1564  return ret;
1565  }
1566 
1567  switch (link->type) {
1568  case AVMEDIA_TYPE_VIDEO:
1569  av_image_copy(out->data, out->linesize, (const uint8_t **)frame->data, frame->linesize,
1570  frame->format, frame->width, frame->height);
1571  break;
1572  case AVMEDIA_TYPE_AUDIO:
1573  av_samples_copy(out->extended_data, frame->extended_data,
1574  0, 0, frame->nb_samples,
1575  frame->channels,
1576  frame->format);
1577  break;
1578  default:
1579  av_assert0(!"reached");
1580  }
1581 
1582  av_frame_free(&frame);
1583  *rframe = out;
1584  return 0;
1585 }
1586 
1588 {
1589  AVFilterCommand *cmd = link->dst->command_queue;
1590 
1591  while(cmd && cmd->time <= frame->pts * av_q2d(link->time_base)){
1592  av_log(link->dst, AV_LOG_DEBUG,
1593  "Processing command time:%f command:%s arg:%s\n",
1594  cmd->time, cmd->command, cmd->arg);
1595  avfilter_process_command(link->dst, cmd->command, cmd->arg, 0, 0, cmd->flags);
1596  ff_command_queue_pop(link->dst);
1597  cmd= link->dst->command_queue;
1598  }
1599  return 0;
1600 }
1601 
1603 {
1604  AVFilterContext *dstctx = link->dst;
1605  int64_t pts = frame->pts;
1606  int64_t pos = frame->pkt_pos;
1607 
1608  if (!dstctx->enable_str)
1609  return 1;
1610 
1611  dstctx->var_values[VAR_N] = link->frame_count_out;
1612  dstctx->var_values[VAR_T] = pts == AV_NOPTS_VALUE ? NAN : pts * av_q2d(link->time_base);
1613  dstctx->var_values[VAR_W] = link->w;
1614  dstctx->var_values[VAR_H] = link->h;
1615  dstctx->var_values[VAR_POS] = pos == -1 ? NAN : pos;
1616 
1617  return fabs(av_expr_eval(dstctx->enable, dstctx->var_values, NULL)) >= 0.5;
1618 }
1619 
1621 {
1622  av_assert1(!link->status_in);
1623  av_assert1(!link->status_out);
1624  link->frame_wanted_out = 1;
1625  ff_filter_set_ready(link->src, 100);
1626 }
1627 
1629 {
1630  if (link->status_out)
1631  return;
1632  link->frame_wanted_out = 0;
1633  link->frame_blocked_in = 0;
1635  while (ff_framequeue_queued_frames(&link->fifo)) {
1636  AVFrame *frame = ff_framequeue_take(&link->fifo);
1637  av_frame_free(&frame);
1638  }
1639  if (!link->status_in)
1640  link->status_in = status;
1641 }
1642 
1644 {
1645  return link->status_in;
1646 }
1647 
1649 {
1650  return &avfilter_class;
1651 }
1652 
1654  int default_pool_size)
1655 {
1657 
1658  // Must already be set by caller.
1660 
1662 
1663  if (frames->initial_pool_size == 0) {
1664  // Dynamic allocation is necessarily supported.
1665  } else if (avctx->extra_hw_frames >= 0) {
1666  frames->initial_pool_size += avctx->extra_hw_frames;
1667  } else {
1668  frames->initial_pool_size = default_pool_size;
1669  }
1670 
1671  return 0;
1672 }
error
static void error(const char *err)
Definition: target_bsf_fuzzer.c:30
ff_get_video_buffer
AVFrame * ff_get_video_buffer(AVFilterLink *link, int w, int h)
Request a picture buffer with a specific set of permissions.
Definition: video.c:99
func
int(* func)(AVBPrint *dst, const char *in, const char *arg)
Definition: jacosubdec.c:67
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:86
AV_LOG_WARNING
#define AV_LOG_WARNING
Something somehow does not look correct.
Definition: log.h:200
status
they must not be accessed directly The fifo field contains the frames that are queued in the input for processing by the filter The status_in and status_out fields contains the queued status(EOF or error) of the link
r
const char * r
Definition: vf_curves.c:116
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
filter_ctx
static FilteringContext * filter_ctx
Definition: transcoding.c:48
filter_child_class_iterate
static const AVClass * filter_child_class_iterate(void **iter)
Definition: avfilter.c:611
avfilter_pad_get_name
const char * avfilter_pad_get_name(const AVFilterPad *pads, int pad_idx)
Get the name of an AVFilterPad.
Definition: avfilter.c:1050
av_opt_set_defaults
void av_opt_set_defaults(void *s)
Set the values of all AVOption fields to their default values.
Definition: opt.c:1358
out
FILE * out
Definition: movenc.c:54
FF_FILTER_FLAG_HWFRAME_AWARE
#define FF_FILTER_FLAG_HWFRAME_AWARE
The filter is aware of hardware frames, and any hardware frame context should not be automatically pr...
Definition: internal.h:339
VAR_VARS_NB
@ VAR_VARS_NB
Definition: avfilter.c:486
ff_filter_frame
int ff_filter_frame(AVFilterLink *link, AVFrame *frame)
Send a frame of data to the next filter.
Definition: avfilter.c:1096
avfilter_action_func
int() avfilter_action_func(AVFilterContext *ctx, void *arg, int jobnr, int nb_jobs)
A function pointer passed to the AVFilterGraph::execute callback to be executed multiple times,...
Definition: avfilter.h:833
thread.h
AVERROR_EOF
#define AVERROR_EOF
End of file.
Definition: error.h:55
AVBufferRef::data
uint8_t * data
The data buffer.
Definition: buffer.h:92
FFERROR_NOT_READY
return FFERROR_NOT_READY
Definition: filter_design.txt:204
AVFilterContext::var_values
double * var_values
variable values for the enable expression
Definition: avfilter.h:387
rational.h
AV_TIME_BASE_Q
#define AV_TIME_BASE_Q
Internal time base represented as fractional value.
Definition: avutil.h:260
LIBAVFILTER_VERSION_INT
#define LIBAVFILTER_VERSION_INT
Definition: version.h:37
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_unused
#define av_unused
Definition: attributes.h:131
av_frame_free
void av_frame_free(AVFrame **frame)
Free the frame and any dynamically allocated objects in it, e.g.
Definition: frame.c:203
AVFilterContext::is_disabled
int is_disabled
the enabled state from the last expression evaluation
Definition: avfilter.h:388
ff_filter_activate
int ff_filter_activate(AVFilterContext *filter)
Definition: avfilter.c:1434
av_get_channel_layout_string
void av_get_channel_layout_string(char *buf, int buf_size, int nb_channels, uint64_t channel_layout)
Return a description of a channel layout.
Definition: channel_layout.c:217
AVFrame
This structure describes decoded (raw) audio or video data.
Definition: frame.h:318
pixdesc.h
free_link
static void free_link(AVFilterLink *link)
Definition: avfilter.c:739
AVFrame::pts
int64_t pts
Presentation timestamp in time_base units (time when frame should be shown to user).
Definition: frame.h:411
avfilter_link_set_closed
void avfilter_link_set_closed(AVFilterLink *link, int closed)
Definition: avfilter.c:236
VAR_H
@ VAR_H
Definition: avfilter.c:485
ff_command_queue_pop
void ff_command_queue_pop(AVFilterContext *filter)
Definition: avfilter.c:94
AVOption
AVOption.
Definition: opt.h:248
process_options
static int process_options(AVFilterContext *ctx, AVDictionary **options, const char *args)
Definition: avfilter.c:809
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:408
AV_OPT_FLAG_RUNTIME_PARAM
#define AV_OPT_FLAG_RUNTIME_PARAM
a generic parameter which can be set by the user at runtime
Definition: opt.h:293
AV_DICT_IGNORE_SUFFIX
#define AV_DICT_IGNORE_SUFFIX
Return first entry in a dictionary whose first part corresponds to the search key,...
Definition: dict.h:70
av_mallocz_array
void * av_mallocz_array(size_t nmemb, size_t size)
Definition: mem.c:190
AV_LOG_VERBOSE
#define AV_LOG_VERBOSE
Detailed information.
Definition: log.h:210
max
#define max(a, b)
Definition: cuda_runtime.h:33
ff_tlog
#define ff_tlog(ctx,...)
Definition: internal.h:96
filter
filter_frame For filters that do not use the this method is called when a frame is pushed to the filter s input It can be called at any time except in a reentrant way If the input frame is enough to produce then the filter should push the output frames on the output link immediately As an exception to the previous rule if the input frame is enough to produce several output frames then the filter needs output only at least one per link The additional frames can be left buffered in the filter
Definition: filter_design.txt:228
AVDictionary
Definition: dict.c:30
ff_framequeue_init
void ff_framequeue_init(FFFrameQueue *fq, FFFrameQueueGlobal *fqg)
Init a frame queue and attach it to a global structure.
Definition: framequeue.c:47
default_filter_name
static const char * default_filter_name(void *filter_ctx)
Definition: avfilter.c:573
AVFormatContext::internal
AVFormatInternal * internal
An opaque field for libavformat internal usage.
Definition: avformat.h:1699
AV_OPT_FLAG_FILTERING_PARAM
#define AV_OPT_FLAG_FILTERING_PARAM
a generic parameter which can be set by the user for filtering
Definition: opt.h:294
av_strlcatf
size_t av_strlcatf(char *dst, size_t size, const char *fmt,...)
Definition: avstring.c:101
ff_filter_alloc
AVFilterContext * ff_filter_alloc(const AVFilter *filter, const char *inst_name)
Allocate a new filter context and return it.
Definition: avfilter.c:663
forward_status_change
static int forward_status_change(AVFilterContext *filter, AVFilterLink *in)
Definition: avfilter.c:1246
formats.h
av_expr_parse
int av_expr_parse(AVExpr **expr, const char *s, const char *const *const_names, const char *const *func1_names, double(*const *funcs1)(void *, double), const char *const *func2_names, double(*const *funcs2)(void *, double, double), int log_offset, void *log_ctx)
Parse an expression.
Definition: eval.c:685
ff_inlink_consume_frame
int ff_inlink_consume_frame(AVFilterLink *link, AVFrame **rframe)
Take a frame from the link's FIFO and update the link's stats.
Definition: avfilter.c:1494
ff_framequeue_skip_samples
void ff_framequeue_skip_samples(FFFrameQueue *fq, size_t samples, AVRational time_base)
Skip samples from the first frame in the queue.
Definition: framequeue.c:126
FFFramePool
Frame pool.
Definition: framepool.c:30
AVFilterContext::graph
struct AVFilterGraph * graph
filtergraph this filter belongs to
Definition: avfilter.h:358
fail
#define fail()
Definition: checkasm.h:133
AVOption::offset
int offset
The offset relative to the context structure where the option value is stored.
Definition: opt.h:261
AVFilterContext::enable_str
char * enable_str
enable expression string
Definition: avfilter.h:385
AVFilterCommand::flags
int flags
Definition: internal.h:42
frames
if it could not because there are no more frames
Definition: filter_design.txt:266
avfilter_insert_filter
int avfilter_insert_filter(AVFilterLink *link, AVFilterContext *filt, unsigned filt_srcpad_idx, unsigned filt_dstpad_idx)
Insert a filter in the middle of an existing link.
Definition: avfilter.c:241
av_filter_iterate
const AVFilter * av_filter_iterate(void **opaque)
Iterate over all registered filters.
Definition: allfilters.c:534
samplefmt.h
AVFilterContext::extra_hw_frames
int extra_hw_frames
Sets the number of extra hardware frames which the filter will allocate on its output links for use i...
Definition: avfilter.h:427
avfilter_config_links
int avfilter_config_links(AVFilterContext *filter)
Negotiate the media format, dimensions, etc of all inputs to a filter.
Definition: avfilter.c:278
AVERROR_OPTION_NOT_FOUND
#define AVERROR_OPTION_NOT_FOUND
Option not found.
Definition: error.h:61
pts
static int64_t pts
Definition: transcode_aac.c:652
AVFILTER_THREAD_SLICE
#define AVFILTER_THREAD_SLICE
Process multiple parts of the frame concurrently.
Definition: avfilter.h:336
av_opt_set
int av_opt_set(void *obj, const char *name, const char *val, int search_flags)
Definition: opt.c:465
av_expr_free
void av_expr_free(AVExpr *e)
Free a parsed expression previously created with av_expr_parse().
Definition: eval.c:336
AVRational::num
int num
Numerator.
Definition: rational.h:59
AVFilterPad
A filter pad used for either input or output.
Definition: internal.h:54
avfilter_license
const char * avfilter_license(void)
Return the libavfilter license.
Definition: avfilter.c:88
AVFilterContext::input_pads
AVFilterPad * input_pads
array of input pads
Definition: avfilter.h:348
avassert.h
AV_LOG_ERROR
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
Definition: log.h:194
ff_inlink_check_available_samples
int ff_inlink_check_available_samples(AVFilterLink *link, unsigned min)
Test if enough samples are available on the link.
Definition: avfilter.c:1479
av_dict_get
AVDictionaryEntry * av_dict_get(const AVDictionary *m, const char *key, const AVDictionaryEntry *prev, int flags)
Get a dictionary entry with matching key.
Definition: dict.c:40
av_opt_set_dict
int av_opt_set_dict(void *obj, AVDictionary **options)
Set all the options from a given dictionary on an object.
Definition: opt.c:1656
ff_request_frame_to_filter
static int ff_request_frame_to_filter(AVFilterLink *link)
Definition: avfilter.c:451
ff_avfilter_link_set_out_status
void ff_avfilter_link_set_out_status(AVFilterLink *link, int status, int64_t pts)
Set the status field of a link from the destination filter.
Definition: avfilter.c:224
ff_inlink_request_frame
void ff_inlink_request_frame(AVFilterLink *link)
Mark that a frame is wanted on the link.
Definition: avfilter.c:1620
av_realloc_array
void * av_realloc_array(void *ptr, size_t nmemb, size_t size)
Definition: mem.c:198
AVFormatContext::flags
int flags
Flags modifying the (de)muxer behaviour.
Definition: avformat.h:1363
AVFrame::channels
int channels
number of audio channels, only used for audio.
Definition: frame.h:624
avfilter_process_command
int avfilter_process_command(AVFilterContext *filter, const char *cmd, const char *arg, char *res, int res_len, int flags)
Make the filter instance process a command.
Definition: avfilter.c:540
AVDictionaryEntry::key
char * key
Definition: dict.h:82
AVMEDIA_TYPE_AUDIO
@ AVMEDIA_TYPE_AUDIO
Definition: avutil.h:202
avfilter_pad_count
int avfilter_pad_count(const AVFilterPad *pads)
Get the number of elements in a NULL-terminated array of AVFilterPads (e.g.
Definition: avfilter.c:561
av_q2d
static double av_q2d(AVRational a)
Convert an AVRational to a double.
Definition: rational.h:104
av_assert0
#define av_assert0(cond)
assert() equivalent, that is always enabled.
Definition: avassert.h:37
filters.h
AV_OPT_FLAG_IMPLICIT_KEY
@ AV_OPT_FLAG_IMPLICIT_KEY
Accept to parse a value without a key; the key will then be returned as NULL.
Definition: opt.h:533
AVFilter::flags
int flags
A combination of AVFILTER_FLAG_*.
Definition: avfilter.h:188
AV_LOG_DEBUG
#define AV_LOG_DEBUG
Stuff which is only useful for libav* developers.
Definition: log.h:215
ctx
AVFormatContext * ctx
Definition: movenc.c:48
av_expr_eval
double av_expr_eval(AVExpr *e, const double *const_values, void *opaque)
Evaluate a previously parsed expression.
Definition: eval.c:766
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
AVExpr
Definition: eval.c:157
av_get_sample_fmt_name
const char * av_get_sample_fmt_name(enum AVSampleFormat sample_fmt)
Return the name of sample_fmt, or NULL if sample_fmt is not recognized.
Definition: samplefmt.c:49
key
const char * key
Definition: hwcontext_opencl.c:168
ff_filter_frame_to_filter
static int ff_filter_frame_to_filter(AVFilterLink *link)
Definition: avfilter.c:1214
NAN
#define NAN
Definition: mathematics.h:64
f
#define f(width, name)
Definition: cbs_vp9.c:255
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
ff_framequeue_take
AVFrame * ff_framequeue_take(FFFrameQueue *fq)
Take the first frame in the queue.
Definition: framequeue.c:98
ff_inlink_make_frame_writable
int ff_inlink_make_frame_writable(AVFilterLink *link, AVFrame **rframe)
Make sure a frame is writable.
Definition: avfilter.c:1538
av_opt_find
const AVOption * av_opt_find(void *obj, const char *name, const char *unit, int opt_flags, int search_flags)
Look for an option in an object.
Definition: opt.c:1661
arg
const char * arg
Definition: jacosubdec.c:66
if
if(ret)
Definition: filter_design.txt:179
ff_formats_changeref
void ff_formats_changeref(AVFilterFormats **oldref, AVFilterFormats **newref)
Definition: formats.c:532
ff_inlink_peek_frame
AVFrame * ff_inlink_peek_frame(AVFilterLink *link, size_t idx)
Access a frame in the link fifo without consuming it.
Definition: avfilter.c:1533
LIBAVUTIL_VERSION_INT
#define LIBAVUTIL_VERSION_INT
Definition: version.h:85
filter_unblock
static void filter_unblock(AVFilterContext *filter)
Clear frame_blocked_in on all outputs.
Definition: avfilter.c:202
AVClass
Describe the class of an AVClass context structure.
Definition: log.h:67
fabs
static __device__ float fabs(float a)
Definition: cuda_runtime.h:182
ff_inlink_consume_samples
int ff_inlink_consume_samples(AVFilterLink *link, unsigned min, unsigned max, AVFrame **rframe)
Take samples from the link's FIFO and update the link's stats.
Definition: avfilter.c:1513
NULL
#define NULL
Definition: coverity.c:32
AVERROR_PATCHWELCOME
#define AVERROR_PATCHWELCOME
Not yet implemented in FFmpeg, patches welcome.
Definition: error.h:62
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:658
av_buffer_unref
void av_buffer_unref(AVBufferRef **buf)
Free a given reference and automatically free the buffer if there are no more references to it.
Definition: buffer.c:125
ff_framequeue_add
int ff_framequeue_add(FFFrameQueue *fq, AVFrame *frame)
Add a frame.
Definition: framequeue.c:63
ff_framequeue_free
void ff_framequeue_free(FFFrameQueue *fq)
Free the queue and all queued frames.
Definition: framequeue.c:53
LIBAVFILTER_VERSION_MICRO
#define LIBAVFILTER_VERSION_MICRO
Definition: version.h:34
framequeue.h
VAR_W
@ VAR_W
Definition: avfilter.c:484
AVRational
Rational number (pair of numerator and denominator).
Definition: rational.h:58
AVFilterContext::inputs
AVFilterLink ** inputs
array of pointers to input links
Definition: avfilter.h:349
src
#define src
Definition: vp8dsp.c:255
AVFilterContext::name
char * name
name of this filter instance
Definition: avfilter.h:346
take_samples
static int take_samples(AVFilterLink *link, unsigned min, unsigned max, AVFrame **rframe)
Definition: avfilter.c:1154
AVFilterPad::filter_frame
int(* filter_frame)(AVFilterLink *link, AVFrame *frame)
Filtering callback.
Definition: internal.h:93
av_opt_free
void av_opt_free(void *obj)
Free all allocated objects in obj.
Definition: opt.c:1611
filter_frame
static int filter_frame(DBEDecodeContext *s, AVFrame *frame)
Definition: dolby_e.c:1049
avfilter_class
static const AVClass avfilter_class
Definition: avfilter.c:637
ff_channel_layouts_unref
void ff_channel_layouts_unref(AVFilterChannelLayouts **ref)
Remove a reference to a channel layouts list.
Definition: formats.c:508
ff_inlink_acknowledge_status
int ff_inlink_acknowledge_status(AVFilterLink *link, int *rstatus, int64_t *rpts)
Test and acknowledge the change of status on the link.
Definition: avfilter.c:1449
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
ff_inlink_queued_frames
size_t ff_inlink_queued_frames(AVFilterLink *link)
Get the number of frames available on the link.
Definition: avfilter.c:1464
consume_update
static void consume_update(AVFilterLink *link, const AVFrame *frame)
Definition: avfilter.c:1486
av_filter_ffversion
const char av_filter_ffversion[]
Definition: avfilter.c:47
AV_OPT_SEARCH_FAKE_OBJ
#define AV_OPT_SEARCH_FAKE_OBJ
The obj passed to av_opt_find() is fake – only a double pointer to AVClass instead of a required poin...
Definition: opt.h:568
AV_CLASS_CATEGORY_FILTER
@ AV_CLASS_CATEGORY_FILTER
Definition: log.h:37
ff_frame_pool_uninit
void ff_frame_pool_uninit(FFFramePool **pool)
Deallocate the frame pool.
Definition: framepool.c:284
options
const OptionDef options[]
eval.h
AVFilterContext::nb_inputs
unsigned nb_inputs
number of input pads
Definition: avfilter.h:350
default_execute
static int default_execute(AVFilterContext *ctx, avfilter_action_func *func, void *arg, int *ret, int nb_jobs)
Definition: avfilter.c:650
AVMediaType
AVMediaType
Definition: avutil.h:199
guess_status_pts
static int64_t guess_status_pts(AVFilterContext *ctx, int status, AVRational link_time_base)
Definition: avfilter.c:433
ff_update_link_current_pts
void ff_update_link_current_pts(AVFilterLink *link, int64_t pts)
Definition: avfilter.c:529
ff_inlink_set_status
void ff_inlink_set_status(AVFilterLink *link, int status)
Set the status on an input link.
Definition: avfilter.c:1628
ff_inlink_check_available_frame
int ff_inlink_check_available_frame(AVFilterLink *link)
Test if a frame is available on the link.
Definition: avfilter.c:1469
copy
static void copy(const float *p1, float *p2, const int length)
Definition: vf_vaguedenoiser.c:194
ff_inlink_evaluate_timeline_at_frame
int ff_inlink_evaluate_timeline_at_frame(AVFilterLink *link, const AVFrame *frame)
Evaluate the timeline expression of the link for the time and properties of the frame.
Definition: avfilter.c:1602
FF_TPRINTF_START
#define FF_TPRINTF_START(ctx, func)
Definition: internal.h:213
av_err2str
#define av_err2str(errnum)
Convenience macro, the return value should be used only directly in function arguments but never stan...
Definition: error.h:119
AVFrame::sample_rate
int sample_rate
Sample rate of the audio data.
Definition: frame.h:490
avfilter_link
int avfilter_link(AVFilterContext *src, unsigned srcpad, AVFilterContext *dst, unsigned dstpad)
Link two filters together.
Definition: avfilter.c:135
FFMAX
#define FFMAX(a, b)
Definition: common.h:103
AV_SAMPLE_FMT_NONE
@ AV_SAMPLE_FMT_NONE
Definition: samplefmt.h:59
AV_NOPTS_VALUE
#define AV_NOPTS_VALUE
Undefined timestamp value.
Definition: avutil.h:248
set_enable_expr
static int set_enable_expr(AVFilterContext *ctx, const char *expr)
Definition: avfilter.c:489
OFFSET
#define OFFSET(x)
Definition: avfilter.c:622
av_frame_is_writable
int av_frame_is_writable(AVFrame *frame)
Check if the frame data is writable.
Definition: frame.c:594
AVFrame::format
int format
format of the frame, -1 if unknown or unset Values correspond to enum AVPixelFormat for video frames,...
Definition: frame.h:391
AVOption::name
const char * name
Definition: opt.h:249
ff_filter_process_command
int ff_filter_process_command(AVFilterContext *ctx, const char *cmd, const char *arg, char *res, int res_len, int flags)
Generic processing of user supplied commands that are set in the same way as the filter options.
Definition: avfilter.c:882
avfilter_link_free
void avfilter_link_free(AVFilterLink **link)
Free the link in *link, and set its pointer to NULL.
Definition: avfilter.c:174
buffer.h
AV_OPT_SEARCH_CHILDREN
#define AV_OPT_SEARCH_CHILDREN
Search in possible children of the given object first.
Definition: opt.h:560
AVFilterPad::needs_writable
int needs_writable
The filter expects writable frames from its input link, duplicating data buffers if needed.
Definition: internal.h:126
VAR_POS
@ VAR_POS
Definition: avfilter.c:483
FFMIN
#define FFMIN(a, b)
Definition: common.h:105
AVFrame::channel_layout
uint64_t channel_layout
Channel layout of the audio data.
Definition: frame.h:495
av_opt_find2
const AVOption * av_opt_find2(void *obj, const char *name, const char *unit, int opt_flags, int search_flags, void **target_obj)
Look for an option in an object.
Definition: opt.c:1667
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_opt_set_dict2
int av_opt_set_dict2(void *obj, AVDictionary **options, int search_flags)
Set all the options from a given dictionary on an object.
Definition: opt.c:1631
av_dict_free
void av_dict_free(AVDictionary **pm)
Free all the memory allocated for an AVDictionary struct and all keys and values.
Definition: dict.c:203
AV_LOG_INFO
#define AV_LOG_INFO
Standard information.
Definition: log.h:205
internal.h
avfilter_init_str
int avfilter_init_str(AVFilterContext *filter, const char *args)
Initialize a filter with the supplied parameters.
Definition: avfilter.c:940
AVFILTER_FLAG_SUPPORT_TIMELINE_GENERIC
#define AVFILTER_FLAG_SUPPORT_TIMELINE_GENERIC
Some filters support a generic "enable" expression option that can be used to enable or disable a fil...
Definition: avfilter.h:126
ff_framequeue_peek
AVFrame * ff_framequeue_peek(FFFrameQueue *fq, size_t idx)
Access a frame in the queue, without removing it.
Definition: framequeue.c:115
av_get_picture_type_char
char av_get_picture_type_char(enum AVPictureType pict_type)
Return a single letter to describe the given picture type pict_type.
Definition: utils.c:83
in
uint8_t pi<< 24) CONV_FUNC_GROUP(AV_SAMPLE_FMT_FLT, float, AV_SAMPLE_FMT_U8, uint8_t,(*(const uint8_t *) pi - 0x80) *(1.0f/(1<< 7))) CONV_FUNC_GROUP(AV_SAMPLE_FMT_DBL, double, AV_SAMPLE_FMT_U8, uint8_t,(*(const uint8_t *) pi - 0x80) *(1.0/(1<< 7))) CONV_FUNC_GROUP(AV_SAMPLE_FMT_U8, uint8_t, AV_SAMPLE_FMT_S16, int16_t,(*(const int16_t *) pi >> 8)+0x80) CONV_FUNC_GROUP(AV_SAMPLE_FMT_FLT, float, AV_SAMPLE_FMT_S16, int16_t, *(const int16_t *) pi *(1.0f/(1<< 15))) CONV_FUNC_GROUP(AV_SAMPLE_FMT_DBL, double, AV_SAMPLE_FMT_S16, int16_t, *(const int16_t *) pi *(1.0/(1<< 15))) CONV_FUNC_GROUP(AV_SAMPLE_FMT_U8, uint8_t, AV_SAMPLE_FMT_S32, int32_t,(*(const int32_t *) pi >> 24)+0x80) CONV_FUNC_GROUP(AV_SAMPLE_FMT_FLT, float, AV_SAMPLE_FMT_S32, int32_t, *(const int32_t *) pi *(1.0f/(1U<< 31))) CONV_FUNC_GROUP(AV_SAMPLE_FMT_DBL, double, AV_SAMPLE_FMT_S32, int32_t, *(const int32_t *) pi *(1.0/(1U<< 31))) CONV_FUNC_GROUP(AV_SAMPLE_FMT_U8, uint8_t, AV_SAMPLE_FMT_FLT, float, av_clip_uint8(lrintf(*(const float *) pi *(1<< 7))+0x80)) CONV_FUNC_GROUP(AV_SAMPLE_FMT_S16, int16_t, AV_SAMPLE_FMT_FLT, float, av_clip_int16(lrintf(*(const float *) pi *(1<< 15)))) CONV_FUNC_GROUP(AV_SAMPLE_FMT_S32, int32_t, AV_SAMPLE_FMT_FLT, float, av_clipl_int32(llrintf(*(const float *) pi *(1U<< 31)))) CONV_FUNC_GROUP(AV_SAMPLE_FMT_U8, uint8_t, AV_SAMPLE_FMT_DBL, double, av_clip_uint8(lrint(*(const double *) pi *(1<< 7))+0x80)) CONV_FUNC_GROUP(AV_SAMPLE_FMT_S16, int16_t, AV_SAMPLE_FMT_DBL, double, av_clip_int16(lrint(*(const double *) pi *(1<< 15)))) CONV_FUNC_GROUP(AV_SAMPLE_FMT_S32, int32_t, AV_SAMPLE_FMT_DBL, double, av_clipl_int32(llrint(*(const double *) pi *(1U<< 31)))) #define SET_CONV_FUNC_GROUP(ofmt, ifmt) static void set_generic_function(AudioConvert *ac) { } void ff_audio_convert_free(AudioConvert **ac) { if(! *ac) return;ff_dither_free(&(*ac) ->dc);av_freep(ac);} AudioConvert *ff_audio_convert_alloc(AVAudioResampleContext *avr, enum AVSampleFormat out_fmt, enum AVSampleFormat in_fmt, int channels, int sample_rate, int apply_map) { AudioConvert *ac;int in_planar, out_planar;ac=av_mallocz(sizeof(*ac));if(!ac) return NULL;ac->avr=avr;ac->out_fmt=out_fmt;ac->in_fmt=in_fmt;ac->channels=channels;ac->apply_map=apply_map;if(avr->dither_method !=AV_RESAMPLE_DITHER_NONE &&av_get_packed_sample_fmt(out_fmt)==AV_SAMPLE_FMT_S16 &&av_get_bytes_per_sample(in_fmt) > 2) { ac->dc=ff_dither_alloc(avr, out_fmt, in_fmt, channels, sample_rate, apply_map);if(!ac->dc) { av_free(ac);return NULL;} return ac;} in_planar=ff_sample_fmt_is_planar(in_fmt, channels);out_planar=ff_sample_fmt_is_planar(out_fmt, channels);if(in_planar==out_planar) { ac->func_type=CONV_FUNC_TYPE_FLAT;ac->planes=in_planar ? ac->channels :1;} else if(in_planar) ac->func_type=CONV_FUNC_TYPE_INTERLEAVE;else ac->func_type=CONV_FUNC_TYPE_DEINTERLEAVE;set_generic_function(ac);if(ARCH_AARCH64) ff_audio_convert_init_aarch64(ac);if(ARCH_ARM) ff_audio_convert_init_arm(ac);if(ARCH_X86) ff_audio_convert_init_x86(ac);return ac;} int ff_audio_convert(AudioConvert *ac, AudioData *out, AudioData *in) { int use_generic=1;int len=in->nb_samples;int p;if(ac->dc) { av_log(ac->avr, AV_LOG_TRACE, "%d samples - audio_convert: %s to %s (dithered)\n", len, av_get_sample_fmt_name(ac->in_fmt), av_get_sample_fmt_name(ac->out_fmt));return ff_convert_dither(ac-> in
Definition: audio_convert.c:326
ff_formats_unref
void ff_formats_unref(AVFilterFormats **ref)
If *ref is non-NULL, remove *ref as a reference to the format list it currently points to,...
Definition: formats.c:503
av_samples_copy
int av_samples_copy(uint8_t **dst, uint8_t *const *src, int dst_offset, int src_offset, int nb_samples, int nb_channels, enum AVSampleFormat sample_fmt)
Copy samples from src to dst.
Definition: samplefmt.c:213
avfilter_options
static const AVOption avfilter_options[]
Definition: avfilter.c:625
i
int i
Definition: input.c:407
ff_filter_frame_framed
static int ff_filter_frame_framed(AVFilterLink *link, AVFrame *frame)
Definition: avfilter.c:1065
filter_child_next
static void * filter_child_next(void *obj, void *prev)
Definition: avfilter.c:579
ff_avfilter_link_set_in_status
void ff_avfilter_link_set_in_status(AVFilterLink *link, int status, int64_t pts)
Set the status field of a link from the source filter.
Definition: avfilter.c:211
internal.h
AVFrame::extended_data
uint8_t ** extended_data
pointers to the data planes/channels.
Definition: frame.h:365
AVFilterCommand
Definition: internal.h:38
av_malloc_array
#define av_malloc_array(a, b)
Definition: tableprint_vlc.h:32
common.h
ff_filter_get_nb_threads
int ff_filter_get_nb_threads(AVFilterContext *ctx)
Get number of threads for current filter instance.
Definition: avfilter.c:802
samples_ready
static int samples_ready(AVFilterLink *link, unsigned min)
Definition: avfilter.c:1147
av_assert1
#define av_assert1(cond)
assert() equivalent, that does not lie in speed critical code.
Definition: avassert.h:53
ff_framequeue_queued_samples
static uint64_t ff_framequeue_queued_samples(const FFFrameQueue *fq)
Get the number of queued samples.
Definition: framequeue.h:154
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
ff_insert_pad
int ff_insert_pad(unsigned idx, unsigned *count, size_t padidx_off, AVFilterPad **pads, AVFilterLink ***links, AVFilterPad *newpad)
Insert a new pad.
Definition: avfilter.c:103
uint8_t
uint8_t
Definition: audio_convert.c:194
VAR_T
@ VAR_T
Definition: avfilter.c:481
av_mallocz
void * av_mallocz(size_t size)
Allocate a memory block with alignment suitable for all memory accesses (including vectors if availab...
Definition: mem.c:237
filt
static const int8_t filt[NUMTAPS *2]
Definition: af_earwax.c:39
AVFilterPad::name
const char * name
Pad name.
Definition: internal.h:60
ff_inlink_queued_samples
int ff_inlink_queued_samples(AVFilterLink *link)
Definition: avfilter.c:1474
av_opt_next
const AVOption * av_opt_next(const void *obj, const AVOption *last)
Iterate over all AVOptions belonging to obj.
Definition: opt.c:45
AVFilter
Filter definition.
Definition: avfilter.h:145
AVHWFramesContext
This struct describes a set or pool of "hardware" frames (i.e.
Definition: hwcontext.h:124
av_uninit
#define av_uninit(x)
Definition: attributes.h:154
ret
ret
Definition: filter_design.txt:187
AVFilterPad::type
enum AVMediaType type
AVFilterPad type.
Definition: internal.h:65
links
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 links
Definition: filter_design.txt:14
AVClass::class_name
const char * class_name
The name of the class; usually it is the same name as the context structure type to which the AVClass...
Definition: log.h:72
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
avfilter_configuration
const char * avfilter_configuration(void)
Return the libavfilter build-time configuration.
Definition: avfilter.c:83
av_opt_get_key_value
int av_opt_get_key_value(const char **ropts, const char *key_val_sep, const char *pairs_sep, unsigned flags, char **rkey, char **rval)
Extract a key-value pair from the beginning of a string.
Definition: opt.c:1537
pos
unsigned int pos
Definition: spdifenc.c:412
AVOption::type
enum AVOptionType type
Definition: opt.h:262
AVFrame::sample_aspect_ratio
AVRational sample_aspect_ratio
Sample aspect ratio for the video frame, 0/1 if unknown/unspecified.
Definition: frame.h:406
ff_framequeue_queued_frames
static size_t ff_framequeue_queued_frames(const FFFrameQueue *fq)
Get the number of queued frames.
Definition: framequeue.h:146
avfilter_pad_get_type
enum AVMediaType avfilter_pad_get_type(const AVFilterPad *pads, int pad_idx)
Get the type of an AVFilterPad.
Definition: avfilter.c:1055
AVFrame::hw_frames_ctx
AVBufferRef * hw_frames_ctx
For hwaccel-format frames, this should be a reference to the AVHWFramesContext describing the frame.
Definition: frame.h:657
av_get_media_type_string
const char * av_get_media_type_string(enum AVMediaType media_type)
Return a string describing the media_type enum, NULL if media_type is unknown.
Definition: utils.c:71
av_calloc
void * av_calloc(size_t nmemb, size_t size)
Non-inlined equivalent of av_mallocz_array().
Definition: mem.c:245
av_image_copy
void av_image_copy(uint8_t *dst_data[4], int dst_linesizes[4], const uint8_t *src_data[4], const int src_linesizes[4], enum AVPixelFormat pix_fmt, int width, int height)
Copy image in src_data to dst_data.
Definition: imgutils.c:422
channel_layout.h
AVClass::option
const struct AVOption * option
a pointer to the first option specified in the class if any or NULL
Definition: log.h:85
ff_filter_graph_remove_filter
void ff_filter_graph_remove_filter(AVFilterGraph *graph, AVFilterContext *filter)
Remove a filter from a graph;.
Definition: avfiltergraph.c:102
avfilter_init_dict
int avfilter_init_dict(AVFilterContext *ctx, AVDictionary **options)
Initialize a filter with the supplied dictionary of options.
Definition: avfilter.c:895
AVRational::den
int den
Denominator.
Definition: rational.h:60
ff_avfilter_graph_update_heap
void ff_avfilter_graph_update_heap(AVFilterGraph *graph, AVFilterLink *link)
Update the position of a link in the age heap.
Definition: avfiltergraph.c:1340
AV_PIX_FMT_NONE
@ AV_PIX_FMT_NONE
Definition: pixfmt.h:65
AV_OPT_TYPE_INT
@ AV_OPT_TYPE_INT
Definition: opt.h:225
avfilter.h
ff_tlog_ref
void ff_tlog_ref(void *ctx, AVFrame *ref, int end)
Definition: avfilter.c:49
AVFilterContext::enable
void * enable
parsed expression (AVExpr*)
Definition: avfilter.h:386
AVFilterCommand::command
char * command
command
Definition: internal.h:40
ref
static int ref[MAX_W *MAX_W]
Definition: jpeg2000dwt.c:107
samples
Filter the word “frame” indicates either a video frame or a group of audio samples
Definition: filter_design.txt:8
ff_tlog_link
void ff_tlog_link(void *ctx, AVFilterLink *link, int end)
Definition: avfilter.c:384
AVFilterCommand::arg
char * arg
optional argument for the command
Definition: internal.h:41
av_buffer_ref
AVBufferRef * av_buffer_ref(AVBufferRef *buf)
Create a new reference to an AVBuffer.
Definition: buffer.c:93
ff_outlink_get_status
int ff_outlink_get_status(AVFilterLink *link)
Get the status on an output link.
Definition: avfilter.c:1643
AVFilterContext
An instance of a filter.
Definition: avfilter.h:341
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
av_strdup
char * av_strdup(const char *s)
Duplicate a string.
Definition: mem.c:253
AVMEDIA_TYPE_VIDEO
@ AVMEDIA_TYPE_VIDEO
Definition: avutil.h:201
audio.h
TFLAGS
#define TFLAGS
Definition: avfilter.c:624
avfilter_free
void avfilter_free(AVFilterContext *filter)
Free a filter context.
Definition: avfilter.c:760
FLAGS
#define FLAGS
Definition: avfilter.c:623
av_free
#define av_free(p)
Definition: tableprint_vlc.h:34
AVDictionaryEntry
Definition: dict.h:81
default_filter_frame
static int default_filter_frame(AVFilterLink *link, AVFrame *frame)
Definition: avfilter.c:1060
ff_inlink_process_commands
int ff_inlink_process_commands(AVFilterLink *link, const AVFrame *frame)
Process the commands queued in the link up to the time of the frame.
Definition: avfilter.c:1587
LICENSE_PREFIX
#define LICENSE_PREFIX
AVFILTER_FLAG_SUPPORT_TIMELINE
#define AVFILTER_FLAG_SUPPORT_TIMELINE
Handy mask to test whether the filter supports or no the timeline feature (internally or generically)...
Definition: avfilter.h:139
av_freep
#define av_freep(p)
Definition: tableprint_vlc.h:35
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:70
var_names
static const char *const var_names[]
Definition: avfilter.c:471
ff_filter_activate_default
static int ff_filter_activate_default(AVFilterContext *filter)
Definition: avfilter.c:1278
avfilter_link_get_channels
int avfilter_link_get_channels(AVFilterLink *link)
Definition: avfilter.c:187
AV_OPT_TYPE_FLAGS
@ AV_OPT_TYPE_FLAGS
Definition: opt.h:224
imgutils.h
flags
#define flags(name, subs,...)
Definition: cbs_av1.c:561
hwcontext.h
av_log
#define av_log(a,...)
Definition: tableprint_vlc.h:28
ff_channel_layouts_changeref
void ff_channel_layouts_changeref(AVFilterChannelLayouts **oldref, AVFilterChannelLayouts **newref)
Definition: formats.c:526
avstring.h
AVFilterContext::filter
const AVFilter * filter
the AVFilter of which this is an instance
Definition: avfilter.h:344
AV_OPT_TYPE_STRING
@ AV_OPT_TYPE_STRING
Definition: opt.h:229
int
int
Definition: ffmpeg_filter.c:170
avfilter_version
unsigned avfilter_version(void)
Return the LIBAVFILTER_VERSION_INT constant.
Definition: avfilter.c:77
avfilter_get_class
const AVClass * avfilter_get_class(void)
Definition: avfilter.c:1648
AV_OPT_TYPE_CONST
@ AV_OPT_TYPE_CONST
Definition: opt.h:234
VAR_N
@ VAR_N
Definition: avfilter.c:482
request_frame
static int request_frame(AVFilterLink *outlink)
Definition: aeval.c:273
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
av_get_pix_fmt_name
const char * av_get_pix_fmt_name(enum AVPixelFormat pix_fmt)
Return the short name for a pixel format, NULL in case pix_fmt is unknown.
Definition: pixdesc.c:2489
ff_filter_set_ready
void ff_filter_set_ready(AVFilterContext *filter, unsigned priority)
Mark a filter ready and schedule it for activation.
Definition: avfilter.c:193
ff_filter_init_hw_frames
int ff_filter_init_hw_frames(AVFilterContext *avctx, AVFilterLink *link, int default_pool_size)
Perform any additional setup required for hardware frames.
Definition: avfilter.c:1653
AVFilterCommand::time
double time
time expressed in seconds
Definition: internal.h:39
min
float min
Definition: vorbis_enc_data.h:456