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/bprint.h"
25 #include "libavutil/buffer.h"
27 #include "libavutil/common.h"
28 #include "libavutil/eval.h"
29 #include "libavutil/frame.h"
30 #include "libavutil/hwcontext.h"
31 #include "libavutil/internal.h"
32 #include "libavutil/mem.h"
33 #include "libavutil/opt.h"
34 #include "libavutil/pixdesc.h"
35 #include "libavutil/rational.h"
36 #include "libavutil/samplefmt.h"
37 
38 #include "audio.h"
39 #include "avfilter.h"
40 #include "avfilter_internal.h"
41 #include "filters.h"
42 #include "formats.h"
43 #include "framequeue.h"
44 #include "framepool.h"
45 #include "video.h"
46 
47 static void tlog_ref(void *ctx, AVFrame *ref, int end)
48 {
49 #ifdef TRACE
50  ff_tlog(ctx,
51  "ref[%p buf:%p data:%p linesize[%d, %d, %d, %d] pts:%"PRId64,
52  ref, ref->buf, ref->data[0],
53  ref->linesize[0], ref->linesize[1], ref->linesize[2], ref->linesize[3],
54  ref->pts);
55 
56  if (ref->width) {
57  ff_tlog(ctx, " a:%d/%d s:%dx%d i:%c iskey:%d type:%c",
58  ref->sample_aspect_ratio.num, ref->sample_aspect_ratio.den,
59  ref->width, ref->height,
60  !(ref->flags & AV_FRAME_FLAG_INTERLACED) ? 'P' : /* Progressive */
61  (ref->flags & AV_FRAME_FLAG_TOP_FIELD_FIRST) ? 'T' : 'B', /* Top / Bottom */
62  !!(ref->flags & AV_FRAME_FLAG_KEY),
63  av_get_picture_type_char(ref->pict_type));
64  }
65  if (ref->nb_samples) {
66  AVBPrint bprint;
67 
69  av_channel_layout_describe_bprint(&ref->ch_layout, &bprint);
70  ff_tlog(ctx, " cl:%s n:%d r:%d",
71  bprint.str,
72  ref->nb_samples,
73  ref->sample_rate);
74  av_bprint_finalize(&bprint, NULL);
75  }
76 
77  ff_tlog(ctx, "]%s", end ? "\n" : "");
78 #endif
79 }
80 
82 {
83  AVFilterCommand *c= filter->command_queue;
84  av_freep(&c->arg);
85  av_freep(&c->command);
86  filter->command_queue= c->next;
87  av_free(c);
88 }
89 
90 /**
91  * Append a new pad.
92  *
93  * @param count Pointer to the number of pads in the list
94  * @param pads Pointer to the pointer to the beginning of the list of pads
95  * @param links Pointer to the pointer to the beginning of the list of links
96  * @param newpad The new pad to add. A copy is made when adding.
97  * @return >= 0 in case of success, a negative AVERROR code on error
98  */
99 static int append_pad(unsigned *count, AVFilterPad **pads,
100  AVFilterLink ***links, AVFilterPad *newpad)
101 {
102  AVFilterLink **newlinks;
103  AVFilterPad *newpads;
104  unsigned idx = *count;
105 
106  newpads = av_realloc_array(*pads, idx + 1, sizeof(*newpads));
107  newlinks = av_realloc_array(*links, idx + 1, sizeof(*newlinks));
108  if (newpads)
109  *pads = newpads;
110  if (newlinks)
111  *links = newlinks;
112  if (!newpads || !newlinks) {
113  if (newpad->flags & AVFILTERPAD_FLAG_FREE_NAME)
114  av_freep(&newpad->name);
115  return AVERROR(ENOMEM);
116  }
117 
118  memcpy(*pads + idx, newpad, sizeof(AVFilterPad));
119  (*links)[idx] = NULL;
120 
121  (*count)++;
122 
123  return 0;
124 }
125 
127 {
128  return append_pad(&f->nb_inputs, &f->input_pads, &f->inputs, p);
129 }
130 
132 {
134  return ff_append_inpad(f, p);
135 }
136 
138 {
139  return append_pad(&f->nb_outputs, &f->output_pads, &f->outputs, p);
140 }
141 
143 {
145  return ff_append_outpad(f, p);
146 }
147 
148 int avfilter_link(AVFilterContext *src, unsigned srcpad,
149  AVFilterContext *dst, unsigned dstpad)
150 {
151  FilterLinkInternal *li;
153 
154  av_assert0(src->graph);
155  av_assert0(dst->graph);
156  av_assert0(src->graph == dst->graph);
157 
158  if (src->nb_outputs <= srcpad || dst->nb_inputs <= dstpad ||
159  src->outputs[srcpad] || dst->inputs[dstpad])
160  return AVERROR(EINVAL);
161 
163  av_log(src, AV_LOG_ERROR, "Filters must be initialized before linking.\n");
164  return AVERROR(EINVAL);
165  }
166 
167  if (src->output_pads[srcpad].type != dst->input_pads[dstpad].type) {
169  "Media type mismatch between the '%s' filter output pad %d (%s) and the '%s' filter input pad %d (%s)\n",
170  src->name, srcpad, (char *)av_x_if_null(av_get_media_type_string(src->output_pads[srcpad].type), "?"),
171  dst->name, dstpad, (char *)av_x_if_null(av_get_media_type_string(dst-> input_pads[dstpad].type), "?"));
172  return AVERROR(EINVAL);
173  }
174 
175  li = av_mallocz(sizeof(*li));
176  if (!li)
177  return AVERROR(ENOMEM);
178  link = &li->l.pub;
179 
180  src->outputs[srcpad] = dst->inputs[dstpad] = link;
181 
182  link->src = src;
183  link->dst = dst;
184  link->srcpad = &src->output_pads[srcpad];
185  link->dstpad = &dst->input_pads[dstpad];
186  link->type = src->output_pads[srcpad].type;
187  li->l.graph = src->graph;
189  link->format = -1;
192 
193  return 0;
194 }
195 
197 {
198  FilterLinkInternal *li;
199 
200  if (!*link)
201  return;
202  li = ff_link_internal(*link);
203 
204  ff_framequeue_free(&li->fifo);
206  av_channel_layout_uninit(&(*link)->ch_layout);
207 
209 
210  av_freep(link);
211 }
212 
213 #if FF_API_LINK_PUBLIC
214 void avfilter_link_free(AVFilterLink **link)
215 {
216  link_free(link);
217 }
218 int avfilter_config_links(AVFilterContext *filter)
219 {
221 }
222 #endif
223 
225 {
226  AVFilterLink *const link = &li->l.pub;
227 
228  if (pts == AV_NOPTS_VALUE)
229  return;
230  li->l.current_pts = pts;
232  /* TODO use duration */
233  if (li->l.graph && li->age_index >= 0)
235 }
236 
237 void ff_filter_set_ready(AVFilterContext *filter, unsigned priority)
238 {
239  filter->ready = FFMAX(filter->ready, priority);
240 }
241 
242 /**
243  * Clear frame_blocked_in on all outputs.
244  * This is necessary whenever something changes on input.
245  */
247 {
248  unsigned i;
249 
250  for (i = 0; i < filter->nb_outputs; i++) {
251  FilterLinkInternal * const li = ff_link_internal(filter->outputs[i]);
252  li->frame_blocked_in = 0;
253  }
254 }
255 
256 
258 {
260 
261  if (li->status_in == status)
262  return;
263  av_assert0(!li->status_in);
264  li->status_in = status;
265  li->status_in_pts = pts;
266  li->frame_wanted_out = 0;
267  li->frame_blocked_in = 0;
268  filter_unblock(link->dst);
269  ff_filter_set_ready(link->dst, 200);
270 }
271 
272 /**
273  * Set the status field of a link from the destination filter.
274  * The pts should probably be left unset (AV_NOPTS_VALUE).
275  */
277 {
279 
281  av_assert0(!li->status_out);
282  li->status_out = status;
283  if (pts != AV_NOPTS_VALUE)
285  filter_unblock(link->dst);
286  ff_filter_set_ready(link->src, 200);
287 }
288 
290  unsigned filt_srcpad_idx, unsigned filt_dstpad_idx)
291 {
292  int ret;
293  unsigned dstpad_idx = link->dstpad - link->dst->input_pads;
294 
295  av_log(link->dst, AV_LOG_VERBOSE, "auto-inserting filter '%s' "
296  "between the filter '%s' and the filter '%s'\n",
297  filt->name, link->src->name, link->dst->name);
298 
299  link->dst->inputs[dstpad_idx] = NULL;
300  if ((ret = avfilter_link(filt, filt_dstpad_idx, link->dst, dstpad_idx)) < 0) {
301  /* failed to link output filter to new filter */
302  link->dst->inputs[dstpad_idx] = link;
303  return ret;
304  }
305 
306  /* re-hookup the link to the new destination filter we inserted */
307  link->dst = filt;
308  link->dstpad = &filt->input_pads[filt_srcpad_idx];
309  filt->inputs[filt_srcpad_idx] = link;
310 
311  /* if any information on supported media formats already exists on the
312  * link, we need to preserve that */
313  if (link->outcfg.formats)
314  ff_formats_changeref(&link->outcfg.formats,
315  &filt->outputs[filt_dstpad_idx]->outcfg.formats);
316  if (link->outcfg.color_spaces)
317  ff_formats_changeref(&link->outcfg.color_spaces,
318  &filt->outputs[filt_dstpad_idx]->outcfg.color_spaces);
319  if (link->outcfg.color_ranges)
320  ff_formats_changeref(&link->outcfg.color_ranges,
321  &filt->outputs[filt_dstpad_idx]->outcfg.color_ranges);
322  if (link->outcfg.samplerates)
323  ff_formats_changeref(&link->outcfg.samplerates,
324  &filt->outputs[filt_dstpad_idx]->outcfg.samplerates);
325  if (link->outcfg.channel_layouts)
326  ff_channel_layouts_changeref(&link->outcfg.channel_layouts,
327  &filt->outputs[filt_dstpad_idx]->outcfg.channel_layouts);
328 
329  return 0;
330 }
331 
333 {
334  int (*config_link)(AVFilterLink *);
335  unsigned i;
336  int ret;
337 
338  for (i = 0; i < filter->nb_inputs; i ++) {
339  AVFilterLink *link = filter->inputs[i];
342  FilterLinkInternal *li_in;
343 
344  if (!link) continue;
345  if (!link->src || !link->dst) {
347  "Not all input and output are properly linked (%d).\n", i);
348  return AVERROR(EINVAL);
349  }
350 
351  inlink = link->src->nb_inputs ? link->src->inputs[0] : NULL;
352  li_in = inlink ? ff_link_internal(inlink) : NULL;
353  li->l.current_pts =
355 
356  switch (li->init_state) {
357  case AVLINK_INIT:
358  continue;
359  case AVLINK_STARTINIT:
360  av_log(filter, AV_LOG_INFO, "circular filter chain detected\n");
361  return 0;
362  case AVLINK_UNINIT:
363  li->init_state = AVLINK_STARTINIT;
364 
365  if ((ret = ff_filter_config_links(link->src)) < 0)
366  return ret;
367 
368  if (!(config_link = link->srcpad->config_props)) {
369  if (link->src->nb_inputs != 1) {
370  av_log(link->src, AV_LOG_ERROR, "Source filters and filters "
371  "with more than one input "
372  "must set config_props() "
373  "callbacks on all outputs\n");
374  return AVERROR(EINVAL);
375  }
376  } else if ((ret = config_link(link)) < 0) {
377  av_log(link->src, AV_LOG_ERROR,
378  "Failed to configure output pad on %s\n",
379  link->src->name);
380  return ret;
381  }
382 
383  switch (link->type) {
384  case AVMEDIA_TYPE_VIDEO:
385  if (!link->time_base.num && !link->time_base.den)
386  link->time_base = inlink ? inlink->time_base : AV_TIME_BASE_Q;
387 
390  inlink->sample_aspect_ratio : (AVRational){1,1};
391 
392  if (inlink) {
393  if (!li->l.frame_rate.num && !li->l.frame_rate.den)
394  li->l.frame_rate = li_in->l.frame_rate;
395  if (!link->w)
396  link->w = inlink->w;
397  if (!link->h)
398  link->h = inlink->h;
399  } else if (!link->w || !link->h) {
400  av_log(link->src, AV_LOG_ERROR,
401  "Video source filters must set their output link's "
402  "width and height\n");
403  return AVERROR(EINVAL);
404  }
405  break;
406 
407  case AVMEDIA_TYPE_AUDIO:
408  if (inlink) {
409  if (!link->time_base.num && !link->time_base.den)
410  link->time_base = inlink->time_base;
411  }
412 
413  if (!link->time_base.num && !link->time_base.den)
415  }
416 
417  if (link->src->nb_inputs &&
418  !(link->src->filter->flags_internal & FF_FILTER_FLAG_HWFRAME_AWARE)) {
419  FilterLink *l0 = ff_filter_link(link->src->inputs[0]);
420 
421  av_assert0(!li->l.hw_frames_ctx &&
422  "should not be set by non-hwframe-aware filter");
423 
424  if (l0->hw_frames_ctx) {
426  if (!li->l.hw_frames_ctx)
427  return AVERROR(ENOMEM);
428  }
429  }
430 
431  if ((config_link = link->dstpad->config_props))
432  if ((ret = config_link(link)) < 0) {
433  av_log(link->dst, AV_LOG_ERROR,
434  "Failed to configure input pad on %s\n",
435  link->dst->name);
436  return ret;
437  }
438 
439  li->init_state = AVLINK_INIT;
440  }
441  }
442 
443  return 0;
444 }
445 
446 #ifdef TRACE
447 void ff_tlog_link(void *ctx, AVFilterLink *link, int end)
448 {
449  if (link->type == AVMEDIA_TYPE_VIDEO) {
450  ff_tlog(ctx,
451  "link[%p s:%dx%d fmt:%s %s->%s]%s",
452  link, link->w, link->h,
454  link->src ? link->src->filter->name : "",
455  link->dst ? link->dst->filter->name : "",
456  end ? "\n" : "");
457  } else {
458  char buf[128];
459  av_channel_layout_describe(&link->ch_layout, buf, sizeof(buf));
460 
461  ff_tlog(ctx,
462  "link[%p r:%d cl:%s fmt:%s %s->%s]%s",
463  link, (int)link->sample_rate, buf,
465  link->src ? link->src->filter->name : "",
466  link->dst ? link->dst->filter->name : "",
467  end ? "\n" : "");
468  }
469 }
470 #endif
471 
473 {
475 
477 
478  av_assert1(!link->dst->filter->activate);
479  if (li->status_out)
480  return li->status_out;
481  if (li->status_in) {
482  if (ff_framequeue_queued_frames(&li->fifo)) {
484  av_assert1(link->dst->ready >= 300);
485  return 0;
486  } else {
487  /* Acknowledge status change. Filters using ff_request_frame() will
488  handle the change automatically. Filters can also check the
489  status directly but none do yet. */
491  return li->status_out;
492  }
493  }
494  li->frame_wanted_out = 1;
495  ff_filter_set_ready(link->src, 100);
496  return 0;
497 }
498 
500 {
501  unsigned i;
502  int64_t r = INT64_MAX;
503 
504  for (i = 0; i < ctx->nb_inputs; i++) {
505  FilterLinkInternal * const li = ff_link_internal(ctx->inputs[i]);
506  if (li->status_out == status)
507  r = FFMIN(r, av_rescale_q(li->l.current_pts, ctx->inputs[i]->time_base, link_time_base));
508  }
509  if (r < INT64_MAX)
510  return r;
511  av_log(ctx, AV_LOG_WARNING, "EOF timestamp not reliable\n");
512  for (i = 0; i < ctx->nb_inputs; i++) {
513  FilterLinkInternal * const li = ff_link_internal(ctx->inputs[i]);
514  r = FFMIN(r, av_rescale_q(li->status_in_pts, ctx->inputs[i]->time_base, link_time_base));
515  }
516  if (r < INT64_MAX)
517  return r;
518  return AV_NOPTS_VALUE;
519 }
520 
522 {
524  int ret = -1;
525 
526  FF_TPRINTF_START(NULL, request_frame_to_filter); ff_tlog_link(NULL, link, 1);
527  /* Assume the filter is blocked, let the method clear it if not */
528  li->frame_blocked_in = 1;
529  if (link->srcpad->request_frame)
530  ret = link->srcpad->request_frame(link);
531  else if (link->src->inputs[0])
532  ret = ff_request_frame(link->src->inputs[0]);
533  if (ret < 0) {
534  if (ret != AVERROR(EAGAIN) && ret != li->status_in)
536  if (ret == AVERROR_EOF)
537  ret = 0;
538  }
539  return ret;
540 }
541 
542 static const char *const var_names[] = {
543  "t",
544  "n",
545 #if FF_API_FRAME_PKT
546  "pos",
547 #endif
548  "w",
549  "h",
550  NULL
551 };
552 
553 enum {
556 #if FF_API_FRAME_PKT
557  VAR_POS,
558 #endif
562 };
563 
564 static int set_enable_expr(AVFilterContext *ctx, const char *expr)
565 {
566  int ret;
567  char *expr_dup;
568  AVExpr *old = ctx->enable;
569 
570  if (!(ctx->filter->flags & AVFILTER_FLAG_SUPPORT_TIMELINE)) {
571  av_log(ctx, AV_LOG_ERROR, "Timeline ('enable' option) not supported "
572  "with filter '%s'\n", ctx->filter->name);
573  return AVERROR_PATCHWELCOME;
574  }
575 
576  expr_dup = av_strdup(expr);
577  if (!expr_dup)
578  return AVERROR(ENOMEM);
579 
580  if (!ctx->var_values) {
581  ctx->var_values = av_calloc(VAR_VARS_NB, sizeof(*ctx->var_values));
582  if (!ctx->var_values) {
583  av_free(expr_dup);
584  return AVERROR(ENOMEM);
585  }
586  }
587 
588  ret = av_expr_parse((AVExpr**)&ctx->enable, expr_dup, var_names,
589  NULL, NULL, NULL, NULL, 0, ctx->priv);
590  if (ret < 0) {
591  av_log(ctx->priv, AV_LOG_ERROR,
592  "Error when evaluating the expression '%s' for enable\n",
593  expr_dup);
594  av_free(expr_dup);
595  return ret;
596  }
597 
598  av_expr_free(old);
599  av_free(ctx->enable_str);
600  ctx->enable_str = expr_dup;
601  return 0;
602 }
603 
604 int avfilter_process_command(AVFilterContext *filter, const char *cmd, const char *arg, char *res, int res_len, int flags)
605 {
606  if(!strcmp(cmd, "ping")){
607  char local_res[256] = {0};
608 
609  if (!res) {
610  res = local_res;
611  res_len = sizeof(local_res);
612  }
613  av_strlcatf(res, res_len, "pong from:%s %s\n", filter->filter->name, filter->name);
614  if (res == local_res)
615  av_log(filter, AV_LOG_INFO, "%s", res);
616  return 0;
617  }else if(!strcmp(cmd, "enable")) {
618  return set_enable_expr(filter, arg);
619  }else if(filter->filter->process_command) {
620  return filter->filter->process_command(filter, cmd, arg, res, res_len, flags);
621  }
622  return AVERROR(ENOSYS);
623 }
624 
625 unsigned avfilter_filter_pad_count(const AVFilter *filter, int is_output)
626 {
627  return is_output ? filter->nb_outputs : filter->nb_inputs;
628 }
629 
630 static const char *default_filter_name(void *filter_ctx)
631 {
633  return ctx->name ? ctx->name : ctx->filter->name;
634 }
635 
636 static void *filter_child_next(void *obj, void *prev)
637 {
638  AVFilterContext *ctx = obj;
639  if (!prev && ctx->filter && ctx->filter->priv_class && ctx->priv)
640  return ctx->priv;
641  return NULL;
642 }
643 
644 static const AVClass *filter_child_class_iterate(void **iter)
645 {
646  const AVFilter *f;
647 
648  while ((f = av_filter_iterate(iter)))
649  if (f->priv_class)
650  return f->priv_class;
651 
652  return NULL;
653 }
654 
655 #define OFFSET(x) offsetof(AVFilterContext, x)
656 #define FLAGS AV_OPT_FLAG_FILTERING_PARAM
657 #define TFLAGS AV_OPT_FLAG_FILTERING_PARAM|AV_OPT_FLAG_RUNTIME_PARAM
658 static const AVOption avfilter_options[] = {
659  { "thread_type", "Allowed thread types", OFFSET(thread_type), AV_OPT_TYPE_FLAGS,
660  { .i64 = AVFILTER_THREAD_SLICE }, 0, INT_MAX, FLAGS, .unit = "thread_type" },
661  { "slice", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = AVFILTER_THREAD_SLICE }, .flags = FLAGS, .unit = "thread_type" },
662  { "enable", "set enable expression", OFFSET(enable_str), AV_OPT_TYPE_STRING, {.str=NULL}, .flags = TFLAGS },
663  { "threads", "Allowed number of threads", OFFSET(nb_threads), AV_OPT_TYPE_INT,
664  { .i64 = 0 }, 0, INT_MAX, FLAGS, .unit = "threads" },
665  {"auto", "autodetect a suitable number of threads to use", 0, AV_OPT_TYPE_CONST, {.i64 = 0 }, .flags = FLAGS, .unit = "threads"},
666  { "extra_hw_frames", "Number of extra hardware frames to allocate for the user",
667  OFFSET(extra_hw_frames), AV_OPT_TYPE_INT, { .i64 = -1 }, -1, INT_MAX, FLAGS },
668  { NULL },
669 };
670 
671 static const AVClass avfilter_class = {
672  .class_name = "AVFilter",
673  .item_name = default_filter_name,
674  .version = LIBAVUTIL_VERSION_INT,
675  .category = AV_CLASS_CATEGORY_FILTER,
676  .child_next = filter_child_next,
677  .child_class_iterate = filter_child_class_iterate,
679 };
680 
682  int *ret, int nb_jobs)
683 {
684  int i;
685 
686  for (i = 0; i < nb_jobs; i++) {
687  int r = func(ctx, arg, i, nb_jobs);
688  if (ret)
689  ret[i] = r;
690  }
691  return 0;
692 }
693 
694 AVFilterContext *ff_filter_alloc(const AVFilter *filter, const char *inst_name)
695 {
698  int preinited = 0;
699 
700  if (!filter)
701  return NULL;
702 
703  ctx = av_mallocz(sizeof(*ctx));
704  if (!ctx)
705  return NULL;
706  ret = &ctx->p;
707 
708  ret->av_class = &avfilter_class;
709  ret->filter = filter;
710  ret->name = inst_name ? av_strdup(inst_name) : NULL;
711  if (filter->priv_size) {
712  ret->priv = av_mallocz(filter->priv_size);
713  if (!ret->priv)
714  goto err;
715  }
716  if (filter->preinit) {
717  if (filter->preinit(ret) < 0)
718  goto err;
719  preinited = 1;
720  }
721 
723  if (filter->priv_class) {
724  *(const AVClass**)ret->priv = filter->priv_class;
725  av_opt_set_defaults(ret->priv);
726  }
727 
728  ctx->execute = default_execute;
729 
730  ret->nb_inputs = filter->nb_inputs;
731  if (ret->nb_inputs ) {
732  ret->input_pads = av_memdup(filter->inputs, ret->nb_inputs * sizeof(*filter->inputs));
733  if (!ret->input_pads)
734  goto err;
735  ret->inputs = av_calloc(ret->nb_inputs, sizeof(*ret->inputs));
736  if (!ret->inputs)
737  goto err;
738  }
739 
740  ret->nb_outputs = filter->nb_outputs;
741  if (ret->nb_outputs) {
742  ret->output_pads = av_memdup(filter->outputs, ret->nb_outputs * sizeof(*filter->outputs));
743  if (!ret->output_pads)
744  goto err;
745  ret->outputs = av_calloc(ret->nb_outputs, sizeof(*ret->outputs));
746  if (!ret->outputs)
747  goto err;
748  }
749 
750  return ret;
751 
752 err:
753  if (preinited)
754  filter->uninit(ret);
755  av_freep(&ret->inputs);
756  av_freep(&ret->input_pads);
757  ret->nb_inputs = 0;
758  av_freep(&ret->outputs);
759  av_freep(&ret->output_pads);
760  ret->nb_outputs = 0;
761  av_freep(&ret->priv);
762  av_free(ret);
763  return NULL;
764 }
765 
767 {
768  if (!link)
769  return;
770 
771  if (link->src)
772  link->src->outputs[link->srcpad - link->src->output_pads] = NULL;
773  if (link->dst)
774  link->dst->inputs[link->dstpad - link->dst->input_pads] = NULL;
775 
776  ff_formats_unref(&link->incfg.formats);
777  ff_formats_unref(&link->outcfg.formats);
778  ff_formats_unref(&link->incfg.color_spaces);
779  ff_formats_unref(&link->outcfg.color_spaces);
780  ff_formats_unref(&link->incfg.color_ranges);
781  ff_formats_unref(&link->outcfg.color_ranges);
782  ff_formats_unref(&link->incfg.samplerates);
783  ff_formats_unref(&link->outcfg.samplerates);
784  ff_channel_layouts_unref(&link->incfg.channel_layouts);
785  ff_channel_layouts_unref(&link->outcfg.channel_layouts);
786  link_free(&link);
787 }
788 
790 {
791  int i;
792 
793  if (!filter)
794  return;
795 
796  if (filter->graph)
798 
799  if (filter->filter->uninit)
800  filter->filter->uninit(filter);
801 
802  for (i = 0; i < filter->nb_inputs; i++) {
803  free_link(filter->inputs[i]);
804  if (filter->input_pads[i].flags & AVFILTERPAD_FLAG_FREE_NAME)
805  av_freep(&filter->input_pads[i].name);
806  }
807  for (i = 0; i < filter->nb_outputs; i++) {
808  free_link(filter->outputs[i]);
809  if (filter->output_pads[i].flags & AVFILTERPAD_FLAG_FREE_NAME)
810  av_freep(&filter->output_pads[i].name);
811  }
812 
813  if (filter->filter->priv_class)
814  av_opt_free(filter->priv);
815 
816  av_buffer_unref(&filter->hw_device_ctx);
817 
818  av_freep(&filter->name);
819  av_freep(&filter->input_pads);
820  av_freep(&filter->output_pads);
821  av_freep(&filter->inputs);
822  av_freep(&filter->outputs);
823  av_freep(&filter->priv);
824  while(filter->command_queue){
826  }
828  av_expr_free(filter->enable);
829  filter->enable = NULL;
830  av_freep(&filter->var_values);
831  av_free(filter);
832 }
833 
835 {
836  if (ctx->nb_threads > 0)
837  return FFMIN(ctx->nb_threads, ctx->graph->nb_threads);
838  return ctx->graph->nb_threads;
839 }
840 
841 int ff_filter_opt_parse(void *logctx, const AVClass *priv_class,
842  AVDictionary **options, const char *args)
843 {
844  const AVOption *o = NULL;
845  int ret;
846  int offset= -1;
847 
848  if (!args)
849  return 0;
850 
851  while (*args) {
852  char *parsed_key, *value;
853  const char *key;
854  const char *shorthand = NULL;
855  int additional_flags = 0;
856 
857  if (priv_class && (o = av_opt_next(&priv_class, o))) {
858  if (o->type == AV_OPT_TYPE_CONST || o->offset == offset)
859  continue;
860  offset = o->offset;
861  shorthand = o->name;
862  }
863 
864  ret = av_opt_get_key_value(&args, "=", ":",
865  shorthand ? AV_OPT_FLAG_IMPLICIT_KEY : 0,
866  &parsed_key, &value);
867  if (ret < 0) {
868  if (ret == AVERROR(EINVAL))
869  av_log(logctx, AV_LOG_ERROR, "No option name near '%s'\n", args);
870  else
871  av_log(logctx, AV_LOG_ERROR, "Unable to parse '%s': %s\n", args,
872  av_err2str(ret));
873  return ret;
874  }
875  if (*args)
876  args++;
877  if (parsed_key) {
878  key = parsed_key;
879  additional_flags = AV_DICT_DONT_STRDUP_KEY;
880  priv_class = NULL; /* reject all remaining shorthand */
881  } else {
882  key = shorthand;
883  }
884 
885  av_log(logctx, AV_LOG_DEBUG, "Setting '%s' to value '%s'\n", key, value);
886 
888  additional_flags | AV_DICT_DONT_STRDUP_VAL | AV_DICT_MULTIKEY);
889  }
890 
891  return 0;
892 }
893 
895  const char *arg, char *res, int res_len, int flags)
896 {
897  const AVOption *o;
898 
899  if (!ctx->filter->priv_class)
900  return 0;
902  if (!o)
903  return AVERROR(ENOSYS);
904  return av_opt_set(ctx->priv, cmd, arg, 0);
905 }
906 
908 {
910  int ret = 0;
911 
912  if (ctxi->initialized) {
913  av_log(ctx, AV_LOG_ERROR, "Filter already initialized\n");
914  return AVERROR(EINVAL);
915  }
916 
918  if (ret < 0) {
919  av_log(ctx, AV_LOG_ERROR, "Error applying generic filter options.\n");
920  return ret;
921  }
922 
923  if (ctx->filter->flags & AVFILTER_FLAG_SLICE_THREADS &&
924  ctx->thread_type & ctx->graph->thread_type & AVFILTER_THREAD_SLICE &&
925  fffiltergraph(ctx->graph)->thread_execute) {
926  ctx->thread_type = AVFILTER_THREAD_SLICE;
927  ctxi->execute = fffiltergraph(ctx->graph)->thread_execute;
928  } else {
929  ctx->thread_type = 0;
930  }
931 
932  if (ctx->filter->init)
933  ret = ctx->filter->init(ctx);
934  if (ret < 0)
935  return ret;
936 
937  if (ctx->enable_str) {
938  ret = set_enable_expr(ctx, ctx->enable_str);
939  if (ret < 0)
940  return ret;
941  }
942 
943  ctxi->initialized = 1;
944 
945  return 0;
946 }
947 
948 int avfilter_init_str(AVFilterContext *filter, const char *args)
949 {
951  const AVDictionaryEntry *e;
952  int ret = 0;
953 
954  if (args && *args) {
955  ret = ff_filter_opt_parse(filter, filter->filter->priv_class, &options, args);
956  if (ret < 0)
957  goto fail;
958  }
959 
961  if (ret < 0)
962  goto fail;
963 
964  if ((e = av_dict_iterate(options, NULL))) {
965  av_log(filter, AV_LOG_ERROR, "No such option: %s.\n", e->key);
967  goto fail;
968  }
969 
970 fail:
972 
973  return ret;
974 }
975 
976 const char *avfilter_pad_get_name(const AVFilterPad *pads, int pad_idx)
977 {
978  return pads[pad_idx].name;
979 }
980 
981 enum AVMediaType avfilter_pad_get_type(const AVFilterPad *pads, int pad_idx)
982 {
983  return pads[pad_idx].type;
984 }
985 
987 {
988  return ff_filter_frame(link->dst->outputs[0], frame);
989 }
990 
992 {
994  int (*filter_frame)(AVFilterLink *, AVFrame *);
995  AVFilterContext *dstctx = link->dst;
996  AVFilterPad *dst = link->dstpad;
997  int ret;
998 
999  if (!(filter_frame = dst->filter_frame))
1001 
1002  if (dst->flags & AVFILTERPAD_FLAG_NEEDS_WRITABLE) {
1004  if (ret < 0)
1005  goto fail;
1006  }
1007 
1010 
1011  if (dstctx->is_disabled &&
1014  ret = filter_frame(link, frame);
1015  l->frame_count_out++;
1016  return ret;
1017 
1018 fail:
1019  av_frame_free(&frame);
1020  return ret;
1021 }
1022 
1024 {
1026  int ret;
1028 
1029  /* Consistency checks */
1030  if (link->type == AVMEDIA_TYPE_VIDEO) {
1031  if (strcmp(link->dst->filter->name, "buffersink") &&
1032  strcmp(link->dst->filter->name, "format") &&
1033  strcmp(link->dst->filter->name, "idet") &&
1034  strcmp(link->dst->filter->name, "null") &&
1035  strcmp(link->dst->filter->name, "scale")) {
1036  av_assert1(frame->format == link->format);
1037  av_assert1(frame->width == link->w);
1038  av_assert1(frame->height == link->h);
1039  }
1040 
1041  frame->sample_aspect_ratio = link->sample_aspect_ratio;
1042  } else {
1043  if (frame->format != link->format) {
1044  av_log(link->dst, AV_LOG_ERROR, "Format change is not supported\n");
1045  goto error;
1046  }
1047  if (av_channel_layout_compare(&frame->ch_layout, &link->ch_layout)) {
1048  av_log(link->dst, AV_LOG_ERROR, "Channel layout change is not supported\n");
1049  goto error;
1050  }
1051  if (frame->sample_rate != link->sample_rate) {
1052  av_log(link->dst, AV_LOG_ERROR, "Sample rate change is not supported\n");
1053  goto error;
1054  }
1055 
1056  frame->duration = av_rescale_q(frame->nb_samples, (AVRational){ 1, frame->sample_rate },
1057  link->time_base);
1058  }
1059 
1060  li->frame_blocked_in = li->frame_wanted_out = 0;
1061  li->l.frame_count_in++;
1062  li->l.sample_count_in += frame->nb_samples;
1063  filter_unblock(link->dst);
1064  ret = ff_framequeue_add(&li->fifo, frame);
1065  if (ret < 0) {
1066  av_frame_free(&frame);
1067  return ret;
1068  }
1069  ff_filter_set_ready(link->dst, 300);
1070  return 0;
1071 
1072 error:
1073  av_frame_free(&frame);
1074  return AVERROR_PATCHWELCOME;
1075 }
1076 
1078 {
1079  return ff_framequeue_queued_frames(&link->fifo) &&
1080  (ff_framequeue_queued_samples(&link->fifo) >= min ||
1081  link->status_in);
1082 }
1083 
1084 static int take_samples(FilterLinkInternal *li, unsigned min, unsigned max,
1085  AVFrame **rframe)
1086 {
1087  FilterLink *l = &li->l;
1088  AVFilterLink *link = &l->pub;
1089  AVFrame *frame0, *frame, *buf;
1090  unsigned nb_samples, nb_frames, i, p;
1091  int ret;
1092 
1093  /* Note: this function relies on no format changes and must only be
1094  called with enough samples. */
1096  frame0 = frame = ff_framequeue_peek(&li->fifo, 0);
1097  if (!li->fifo.samples_skipped && frame->nb_samples >= min && frame->nb_samples <= max) {
1098  *rframe = ff_framequeue_take(&li->fifo);
1099  return 0;
1100  }
1101  nb_frames = 0;
1102  nb_samples = 0;
1103  while (1) {
1104  if (nb_samples + frame->nb_samples > max) {
1105  if (nb_samples < min)
1106  nb_samples = max;
1107  break;
1108  }
1109  nb_samples += frame->nb_samples;
1110  nb_frames++;
1111  if (nb_frames == ff_framequeue_queued_frames(&li->fifo))
1112  break;
1113  frame = ff_framequeue_peek(&li->fifo, nb_frames);
1114  }
1115 
1116  buf = ff_get_audio_buffer(link, nb_samples);
1117  if (!buf)
1118  return AVERROR(ENOMEM);
1119  ret = av_frame_copy_props(buf, frame0);
1120  if (ret < 0) {
1121  av_frame_free(&buf);
1122  return ret;
1123  }
1124 
1125  p = 0;
1126  for (i = 0; i < nb_frames; i++) {
1127  frame = ff_framequeue_take(&li->fifo);
1128  av_samples_copy(buf->extended_data, frame->extended_data, p, 0,
1129  frame->nb_samples, link->ch_layout.nb_channels, link->format);
1130  p += frame->nb_samples;
1131  av_frame_free(&frame);
1132  }
1133  if (p < nb_samples) {
1134  unsigned n = nb_samples - p;
1135  frame = ff_framequeue_peek(&li->fifo, 0);
1136  av_samples_copy(buf->extended_data, frame->extended_data, p, 0, n,
1139  }
1140 
1141  *rframe = buf;
1142  return 0;
1143 }
1144 
1146 {
1148  AVFrame *frame = NULL;
1149  AVFilterContext *dst = link->dst;
1150  int ret;
1151 
1153  ret = li->l.min_samples ?
1156  av_assert1(ret);
1157  if (ret < 0) {
1158  av_assert1(!frame);
1159  return ret;
1160  }
1161  /* The filter will soon have received a new frame, that may allow it to
1162  produce one or more: unblock its outputs. */
1164  /* AVFilterPad.filter_frame() expect frame_count_out to have the value
1165  before the frame; ff_filter_frame_framed() will re-increment it. */
1166  li->l.frame_count_out--;
1168  if (ret < 0 && ret != li->status_out) {
1170  } else {
1171  /* Run once again, to see if several frames were available, or if
1172  the input status has also changed, or any other reason. */
1173  ff_filter_set_ready(dst, 300);
1174  }
1175  return ret;
1176 }
1177 
1179 {
1180  AVFilterLink *in = &li_in->l.pub;
1181  unsigned out = 0, progress = 0;
1182  int ret;
1183 
1184  av_assert0(!li_in->status_out);
1185  if (!filter->nb_outputs) {
1186  /* not necessary with the current API and sinks */
1187  return 0;
1188  }
1189  while (!li_in->status_out) {
1190  FilterLinkInternal *li_out = ff_link_internal(filter->outputs[out]);
1191 
1192  if (!li_out->status_in) {
1193  progress++;
1195  if (ret < 0)
1196  return ret;
1197  }
1198  if (++out == filter->nb_outputs) {
1199  if (!progress) {
1200  /* Every output already closed: input no longer interesting
1201  (example: overlay in shortest mode, other input closed). */
1202  link_set_out_status(in, li_in->status_in, li_in->status_in_pts);
1203  return 0;
1204  }
1205  progress = 0;
1206  out = 0;
1207  }
1208  }
1210  return 0;
1211 }
1212 
1214 {
1215  unsigned i;
1216 
1217  for (i = 0; i < filter->nb_outputs; i++) {
1218  FilterLinkInternal *li = ff_link_internal(filter->outputs[i]);
1219  int ret = li->status_in;
1220 
1221  if (ret) {
1222  for (int j = 0; j < filter->nb_inputs; j++)
1223  ff_inlink_set_status(filter->inputs[j], ret);
1224  return 0;
1225  }
1226  }
1227 
1228  for (i = 0; i < filter->nb_inputs; i++) {
1229  FilterLinkInternal *li = ff_link_internal(filter->inputs[i]);
1230  if (samples_ready(li, li->l.min_samples)) {
1231  return ff_filter_frame_to_filter(filter->inputs[i]);
1232  }
1233  }
1234  for (i = 0; i < filter->nb_inputs; i++) {
1235  FilterLinkInternal * const li = ff_link_internal(filter->inputs[i]);
1236  if (li->status_in && !li->status_out) {
1238  return forward_status_change(filter, li);
1239  }
1240  }
1241  for (i = 0; i < filter->nb_outputs; i++) {
1242  FilterLinkInternal * const li = ff_link_internal(filter->outputs[i]);
1243  if (li->frame_wanted_out &&
1244  !li->frame_blocked_in) {
1245  return ff_request_frame_to_filter(filter->outputs[i]);
1246  }
1247  }
1248  return FFERROR_NOT_READY;
1249 }
1250 
1251 /*
1252  Filter scheduling and activation
1253 
1254  When a filter is activated, it must:
1255  - if possible, output a frame;
1256  - else, if relevant, forward the input status change;
1257  - else, check outputs for wanted frames and forward the requests.
1258 
1259  The following AVFilterLink fields are used for activation:
1260 
1261  - frame_wanted_out:
1262 
1263  This field indicates if a frame is needed on this input of the
1264  destination filter. A positive value indicates that a frame is needed
1265  to process queued frames or internal data or to satisfy the
1266  application; a zero value indicates that a frame is not especially
1267  needed but could be processed anyway; a negative value indicates that a
1268  frame would just be queued.
1269 
1270  It is set by filters using ff_request_frame() or ff_request_no_frame(),
1271  when requested by the application through a specific API or when it is
1272  set on one of the outputs.
1273 
1274  It is cleared when a frame is sent from the source using
1275  ff_filter_frame().
1276 
1277  It is also cleared when a status change is sent from the source using
1278  ff_avfilter_link_set_in_status().
1279 
1280  - frame_blocked_in:
1281 
1282  This field means that the source filter can not generate a frame as is.
1283  Its goal is to avoid repeatedly calling the request_frame() method on
1284  the same link.
1285 
1286  It is set by the framework on all outputs of a filter before activating it.
1287 
1288  It is automatically cleared by ff_filter_frame().
1289 
1290  It is also automatically cleared by ff_avfilter_link_set_in_status().
1291 
1292  It is also cleared on all outputs (using filter_unblock()) when
1293  something happens on an input: processing a frame or changing the
1294  status.
1295 
1296  - fifo:
1297 
1298  Contains the frames queued on a filter input. If it contains frames and
1299  frame_wanted_out is not set, then the filter can be activated. If that
1300  result in the filter not able to use these frames, the filter must set
1301  frame_wanted_out to ask for more frames.
1302 
1303  - status_in and status_in_pts:
1304 
1305  Status (EOF or error code) of the link and timestamp of the status
1306  change (in link time base, same as frames) as seen from the input of
1307  the link. The status change is considered happening after the frames
1308  queued in fifo.
1309 
1310  It is set by the source filter using ff_avfilter_link_set_in_status().
1311 
1312  - status_out:
1313 
1314  Status of the link as seen from the output of the link. The status
1315  change is considered having already happened.
1316 
1317  It is set by the destination filter using
1318  link_set_out_status().
1319 
1320  Filters are activated according to the ready field, set using the
1321  ff_filter_set_ready(). Eventually, a priority queue will be used.
1322  ff_filter_set_ready() is called whenever anything could cause progress to
1323  be possible. Marking a filter ready when it is not is not a problem,
1324  except for the small overhead it causes.
1325 
1326  Conditions that cause a filter to be marked ready are:
1327 
1328  - frames added on an input link;
1329 
1330  - changes in the input or output status of an input link;
1331 
1332  - requests for a frame on an output link;
1333 
1334  - after any actual processing using the legacy methods (filter_frame(),
1335  and request_frame() to acknowledge status changes), to run once more
1336  and check if enough input was present for several frames.
1337 
1338  Examples of scenarios to consider:
1339 
1340  - buffersrc: activate if frame_wanted_out to notify the application;
1341  activate when the application adds a frame to push it immediately.
1342 
1343  - testsrc: activate only if frame_wanted_out to produce and push a frame.
1344 
1345  - concat (not at stitch points): can process a frame on any output.
1346  Activate if frame_wanted_out on output to forward on the corresponding
1347  input. Activate when a frame is present on input to process it
1348  immediately.
1349 
1350  - framesync: needs at least one frame on each input; extra frames on the
1351  wrong input will accumulate. When a frame is first added on one input,
1352  set frame_wanted_out<0 on it to avoid getting more (would trigger
1353  testsrc) and frame_wanted_out>0 on the other to allow processing it.
1354 
1355  Activation of old filters:
1356 
1357  In order to activate a filter implementing the legacy filter_frame() and
1358  request_frame() methods, perform the first possible of the following
1359  actions:
1360 
1361  - If an input has frames in fifo and frame_wanted_out == 0, dequeue a
1362  frame and call filter_frame().
1363 
1364  Rationale: filter frames as soon as possible instead of leaving them
1365  queued; frame_wanted_out < 0 is not possible since the old API does not
1366  set it nor provides any similar feedback; frame_wanted_out > 0 happens
1367  when min_samples > 0 and there are not enough samples queued.
1368 
1369  - If an input has status_in set but not status_out, try to call
1370  request_frame() on one of the outputs in the hope that it will trigger
1371  request_frame() on the input with status_in and acknowledge it. This is
1372  awkward and fragile, filters with several inputs or outputs should be
1373  updated to direct activation as soon as possible.
1374 
1375  - If an output has frame_wanted_out > 0 and not frame_blocked_in, call
1376  request_frame().
1377 
1378  Rationale: checking frame_blocked_in is necessary to avoid requesting
1379  repeatedly on a blocked input if another is not blocked (example:
1380  [buffersrc1][testsrc1][buffersrc2][testsrc2]concat=v=2).
1381  */
1382 
1384 {
1385  int ret;
1386 
1387  /* Generic timeline support is not yet implemented but should be easy */
1389  filter->filter->activate));
1390  filter->ready = 0;
1391  ret = filter->filter->activate ? filter->filter->activate(filter) :
1393  if (ret == FFERROR_NOT_READY)
1394  ret = 0;
1395  return ret;
1396 }
1397 
1399 {
1401  *rpts = li->l.current_pts;
1403  return *rstatus = 0;
1404  if (li->status_out)
1405  return *rstatus = li->status_out;
1406  if (!li->status_in)
1407  return *rstatus = 0;
1408  *rstatus = li->status_out = li->status_in;
1410  *rpts = li->l.current_pts;
1411  return 1;
1412 }
1413 
1415 {
1417  return ff_framequeue_queued_frames(&li->fifo);
1418 }
1419 
1421 {
1423  return ff_framequeue_queued_frames(&li->fifo) > 0;
1424 }
1425 
1427 {
1429  return ff_framequeue_queued_samples(&li->fifo);
1430 }
1431 
1433 {
1435  uint64_t samples = ff_framequeue_queued_samples(&li->fifo);
1436  av_assert1(min);
1437  return samples >= min || (li->status_in && samples);
1438 }
1439 
1441 {
1442  AVFilterLink *const link = &li->l.pub;
1443  update_link_current_pts(li, frame->pts);
1445  if (link == link->dst->inputs[0])
1446  link->dst->is_disabled = !ff_inlink_evaluate_timeline_at_frame(link, frame);
1447  li->l.frame_count_out++;
1448  li->l.sample_count_out += frame->nb_samples;
1449 }
1450 
1452 {
1454  AVFrame *frame;
1455 
1456  *rframe = NULL;
1458  return 0;
1459 
1460  if (li->fifo.samples_skipped) {
1461  frame = ff_framequeue_peek(&li->fifo, 0);
1462  return ff_inlink_consume_samples(link, frame->nb_samples, frame->nb_samples, rframe);
1463  }
1464 
1465  frame = ff_framequeue_take(&li->fifo);
1466  consume_update(li, frame);
1467  *rframe = frame;
1468  return 1;
1469 }
1470 
1472  AVFrame **rframe)
1473 {
1475  AVFrame *frame;
1476  int ret;
1477 
1478  av_assert1(min);
1479  *rframe = NULL;
1481  return 0;
1482  if (li->status_in)
1484  ret = take_samples(li, min, max, &frame);
1485  if (ret < 0)
1486  return ret;
1487  consume_update(li, frame);
1488  *rframe = frame;
1489  return 1;
1490 }
1491 
1493 {
1495  return ff_framequeue_peek(&li->fifo, idx);
1496 }
1497 
1499 {
1500  AVFrame *frame = *rframe;
1501  AVFrame *out;
1502  int ret;
1503 
1505  return 0;
1506  av_log(link->dst, AV_LOG_DEBUG, "Copying data in avfilter.\n");
1507 
1508  switch (link->type) {
1509  case AVMEDIA_TYPE_VIDEO:
1510  out = ff_get_video_buffer(link, link->w, link->h);
1511  break;
1512  case AVMEDIA_TYPE_AUDIO:
1513  out = ff_get_audio_buffer(link, frame->nb_samples);
1514  break;
1515  default:
1516  return AVERROR(EINVAL);
1517  }
1518  if (!out)
1519  return AVERROR(ENOMEM);
1520 
1522  if (ret < 0) {
1523  av_frame_free(&out);
1524  return ret;
1525  }
1526 
1527  ret = av_frame_copy(out, frame);
1528  if (ret < 0) {
1529  av_frame_free(&out);
1530  return ret;
1531  }
1532 
1533  av_frame_free(&frame);
1534  *rframe = out;
1535  return 0;
1536 }
1537 
1539 {
1540  AVFilterCommand *cmd = link->dst->command_queue;
1541 
1542  while(cmd && cmd->time <= frame->pts * av_q2d(link->time_base)){
1543  av_log(link->dst, AV_LOG_DEBUG,
1544  "Processing command time:%f command:%s arg:%s\n",
1545  cmd->time, cmd->command, cmd->arg);
1546  avfilter_process_command(link->dst, cmd->command, cmd->arg, 0, 0, cmd->flags);
1547  command_queue_pop(link->dst);
1548  cmd= link->dst->command_queue;
1549  }
1550  return 0;
1551 }
1552 
1554 {
1556  AVFilterContext *dstctx = link->dst;
1557  int64_t pts = frame->pts;
1558 #if FF_API_FRAME_PKT
1560  int64_t pos = frame->pkt_pos;
1562 #endif
1563 
1564  if (!dstctx->enable_str)
1565  return 1;
1566 
1567  dstctx->var_values[VAR_N] = l->frame_count_out;
1568  dstctx->var_values[VAR_T] = pts == AV_NOPTS_VALUE ? NAN : pts * av_q2d(link->time_base);
1569  dstctx->var_values[VAR_W] = link->w;
1570  dstctx->var_values[VAR_H] = link->h;
1571 #if FF_API_FRAME_PKT
1572  dstctx->var_values[VAR_POS] = pos == -1 ? NAN : pos;
1573 #endif
1574 
1575  return fabs(av_expr_eval(dstctx->enable, dstctx->var_values, NULL)) >= 0.5;
1576 }
1577 
1579 {
1581  av_assert1(!li->status_in);
1582  av_assert1(!li->status_out);
1583  li->frame_wanted_out = 1;
1584  ff_filter_set_ready(link->src, 100);
1585 }
1586 
1588 {
1590  if (li->status_out)
1591  return;
1592  li->frame_wanted_out = 0;
1593  li->frame_blocked_in = 0;
1595  while (ff_framequeue_queued_frames(&li->fifo)) {
1597  av_frame_free(&frame);
1598  }
1599  if (!li->status_in)
1600  li->status_in = status;
1601 }
1602 
1604 {
1606  return li->status_in;
1607 }
1608 
1610 {
1611  FilterLinkInternal * const li_in = ff_link_internal(inlink);
1612  return ff_outlink_frame_wanted(outlink) ||
1614  li_in->status_out;
1615 }
1616 
1617 
1619 {
1620  return &avfilter_class;
1621 }
1622 
1624  int default_pool_size)
1625 {
1628 
1629  // Must already be set by caller.
1631 
1633 
1634  if (frames->initial_pool_size == 0) {
1635  // Dynamic allocation is necessarily supported.
1636  } else if (avctx->extra_hw_frames >= 0) {
1637  frames->initial_pool_size += avctx->extra_hw_frames;
1638  } else {
1639  frames->initial_pool_size = default_pool_size;
1640  }
1641 
1642  return 0;
1643 }
1644 
1646 {
1648  return li->frame_wanted_out;
1649 }
1650 
1652  void *arg, int *ret, int nb_jobs)
1653 {
1654  return fffilterctx(ctx)->execute(ctx, func, arg, ret, nb_jobs);
1655 }
error
static void error(const char *err)
Definition: target_bsf_fuzzer.c:32
AV_OPT_SEARCH_CHILDREN
#define AV_OPT_SEARCH_CHILDREN
Search in possible children of the given object first.
Definition: opt.h:605
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:116
func
int(* func)(AVBPrint *dst, const char *in, const char *arg)
Definition: jacosubdec.c:68
av_samples_copy
int av_samples_copy(uint8_t *const *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:222
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:98
FF_ENABLE_DEPRECATION_WARNINGS
#define FF_ENABLE_DEPRECATION_WARNINGS
Definition: internal.h:73
AV_LOG_WARNING
#define AV_LOG_WARNING
Something somehow does not look correct.
Definition: log.h:186
AV_BPRINT_SIZE_UNLIMITED
#define AV_BPRINT_SIZE_UNLIMITED
avfilter_filter_pad_count
unsigned avfilter_filter_pad_count(const AVFilter *filter, int is_output)
Get the number of elements in an AVFilter's inputs or outputs array.
Definition: avfilter.c:625
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:1644
ff_link_internal
static FilterLinkInternal * ff_link_internal(AVFilterLink *link)
Definition: avfilter_internal.h:90
r
const char * r
Definition: vf_curves.c:127
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_child_class_iterate
static const AVClass * filter_child_class_iterate(void **iter)
Definition: avfilter.c:644
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:976
out
FILE * out
Definition: movenc.c:55
av_bprint_init
void av_bprint_init(AVBPrint *buf, unsigned size_init, unsigned size_max)
Definition: bprint.c:69
update_link_current_pts
static void update_link_current_pts(FilterLinkInternal *li, int64_t pts)
Definition: avfilter.c:224
ff_filter_frame
int ff_filter_frame(AVFilterLink *link, AVFrame *frame)
Send a frame of data to the next filter.
Definition: avfilter.c:1023
ff_filter_opt_parse
int ff_filter_opt_parse(void *logctx, const AVClass *priv_class, AVDictionary **options, const char *args)
Parse filter options into a dictionary.
Definition: avfilter.c:841
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:743
AVERROR_EOF
#define AVERROR_EOF
End of file.
Definition: error.h:57
AVBufferRef::data
uint8_t * data
The data buffer.
Definition: buffer.h:90
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:505
rational.h
AV_TIME_BASE_Q
#define AV_TIME_BASE_Q
Internal time base represented as fractional value.
Definition: avutil.h:264
int64_t
long long int64_t
Definition: coverity.c:34
inlink
The exact code depends on how similar the blocks are and how related they are to the and needs to apply these operations to the correct inlink or outlink if there are several Macros are available to factor that when no extra processing is inlink
Definition: filter_design.txt:212
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:160
AVFilterContext::is_disabled
int is_disabled
the enabled state from the last expression evaluation
Definition: avfilter.h:506
ff_filter_activate
int ff_filter_activate(AVFilterContext *filter)
Definition: avfilter.c:1383
AVFrame::colorspace
enum AVColorSpace colorspace
YUV colorspace type.
Definition: frame.h:664
AVFrame
This structure describes decoded (raw) audio or video data.
Definition: frame.h:374
pixdesc.h
free_link
static void free_link(AVFilterLink *link)
Definition: avfilter.c:766
link_free
static void link_free(AVFilterLink **link)
Definition: avfilter.c:196
command_queue_pop
static void command_queue_pop(AVFilterContext *filter)
Definition: avfilter.c:81
AVOption
AVOption.
Definition: opt.h:429
VAR_T
@ VAR_T
Definition: avfilter.c:554
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:1963
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:472
FilterLinkInternal::l
FilterLink l
Definition: avfilter_internal.h:35
AV_LOG_VERBOSE
#define AV_LOG_VERBOSE
Detailed information.
Definition: log.h:196
filter
void(* filter)(uint8_t *src, int stride, int qscale)
Definition: h263dsp.c:29
max
#define max(a, b)
Definition: cuda_runtime.h:33
VAR_H
@ VAR_H
Definition: avfilter.c:560
AVDictionary
Definition: dict.c:34
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:48
FFMAX
#define FFMAX(a, b)
Definition: macros.h:47
av_buffer_ref
AVBufferRef * av_buffer_ref(const AVBufferRef *buf)
Create a new reference to an AVBuffer.
Definition: buffer.c:103
default_filter_name
static const char * default_filter_name(void *filter_ctx)
Definition: avfilter.c:630
AVChannelLayout::nb_channels
int nb_channels
Number of channels in this layout.
Definition: channel_layout.h:321
video.h
av_strlcatf
size_t av_strlcatf(char *dst, size_t size, const char *fmt,...)
Definition: avstring.c:103
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:694
av_channel_layout_describe_bprint
int av_channel_layout_describe_bprint(const AVChannelLayout *channel_layout, AVBPrint *bp)
bprint variant of av_channel_layout_describe().
Definition: channel_layout.c:594
ff_inoutlink_check_flow
int ff_inoutlink_check_flow(AVFilterLink *inlink, AVFilterLink *outlink)
Check for flow control between input and output.
Definition: avfilter.c:1609
AVFILTERPAD_FLAG_FREE_NAME
#define AVFILTERPAD_FLAG_FREE_NAME
The pad's name is allocated and should be freed generically.
Definition: filters.h:62
FilterLinkInternal
Definition: avfilter_internal.h:34
AV_FRAME_FLAG_TOP_FIELD_FIRST
#define AV_FRAME_FLAG_TOP_FIELD_FIRST
A flag to mark frames where the top field is displayed first if the content is interlaced.
Definition: frame.h:638
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:710
av_memdup
void * av_memdup(const void *p, size_t size)
Duplicate a buffer with av_malloc().
Definition: mem.c:304
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:1451
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
ff_append_inpad
int ff_append_inpad(AVFilterContext *f, AVFilterPad *p)
Append a new input/output pad to the filter's list of such pads.
Definition: avfilter.c:126
fail
#define fail()
Definition: checkasm.h:188
AVOption::offset
int offset
Native access only.
Definition: opt.h:444
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:1841
AVFilterContext::enable_str
char * enable_str
enable expression string
Definition: avfilter.h:503
AVFilterCommand::flags
int flags
Definition: avfilter_internal.h:117
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:289
av_filter_iterate
const AVFilter * av_filter_iterate(void **opaque)
Iterate over all registered filters.
Definition: allfilters.c:622
samplefmt.h
take_samples
static int take_samples(FilterLinkInternal *li, unsigned min, unsigned max, AVFrame **rframe)
Definition: avfilter.c:1084
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:542
av_opt_free
void av_opt_free(void *obj)
Free all allocated objects in obj.
Definition: opt.c:1915
AVERROR_OPTION_NOT_FOUND
#define AVERROR_OPTION_NOT_FOUND
Option not found.
Definition: error.h:63
filter_ctx
static FilteringContext * filter_ctx
Definition: transcode.c:52
AVFrame::ch_layout
AVChannelLayout ch_layout
Channel layout of the audio data.
Definition: frame.h:775
pts
static int64_t pts
Definition: transcode_aac.c:644
AVFILTER_THREAD_SLICE
#define AVFILTER_THREAD_SLICE
Process multiple parts of the frame concurrently.
Definition: avfilter.h:454
av_opt_set
int av_opt_set(void *obj, const char *name, const char *val, int search_flags)
Definition: opt.c:748
av_expr_free
void av_expr_free(AVExpr *e)
Free a parsed expression previously created with av_expr_parse().
Definition: eval.c:358
AVRational::num
int num
Numerator.
Definition: rational.h:59
AVFilterPad
A filter pad used for either input or output.
Definition: filters.h:38
AV_DICT_DONT_STRDUP_VAL
#define AV_DICT_DONT_STRDUP_VAL
Take ownership of a value that's been allocated with av_malloc() or another memory allocation functio...
Definition: dict.h:79
ff_filter_config_links
int ff_filter_config_links(AVFilterContext *filter)
Negotiate the media format, dimensions, etc of all inputs to a filter.
Definition: avfilter.c:332
FFFrameQueue::samples_skipped
int samples_skipped
Indicate that samples are skipped.
Definition: framequeue.h:106
avassert.h
ff_outlink_frame_wanted
int ff_outlink_frame_wanted(AVFilterLink *link)
Test if a frame is wanted on an output link.
Definition: avfilter.c:1645
FFFilterGraph::thread_execute
avfilter_execute_func * thread_execute
Definition: avfilter_internal.h:133
AV_LOG_ERROR
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
Definition: log.h:180
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:1432
FFFilterContext::initialized
int initialized
Definition: avfilter_internal.h:105
AV_FRAME_FLAG_KEY
#define AV_FRAME_FLAG_KEY
A flag to mark frames that are keyframes.
Definition: frame.h:625
av_channel_layout_describe
int av_channel_layout_describe(const AVChannelLayout *channel_layout, char *buf, size_t buf_size)
Get a human-readable string describing the channel layout properties.
Definition: channel_layout.c:648
ff_request_frame_to_filter
static int ff_request_frame_to_filter(AVFilterLink *link)
Definition: avfilter.c:521
initialized
static int initialized
Definition: vaapi_transcode.c:43
ff_inlink_request_frame
void ff_inlink_request_frame(AVFilterLink *link)
Mark that a frame is wanted on the link.
Definition: avfilter.c:1578
av_realloc_array
void * av_realloc_array(void *ptr, size_t nmemb, size_t size)
Definition: mem.c:217
AVFormatContext::flags
int flags
Flags modifying the (de)muxer behaviour.
Definition: avformat.h:1411
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:604
AVDictionaryEntry::key
char * key
Definition: dict.h:90
AVMEDIA_TYPE_AUDIO
@ AVMEDIA_TYPE_AUDIO
Definition: avutil.h:202
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:40
filters.h
AVFilter::flags
int flags
A combination of AVFILTER_FLAG_*.
Definition: avfilter.h:245
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:49
av_expr_eval
double av_expr_eval(AVExpr *e, const double *const_values, void *opaque)
Evaluate a previously parsed expression.
Definition: eval.c:792
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:158
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:51
key
const char * key
Definition: hwcontext_opencl.c:189
ff_filter_frame_to_filter
static int ff_filter_frame_to_filter(AVFilterLink *link)
Definition: avfilter.c:1145
NAN
#define NAN
Definition: mathematics.h:115
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:1498
arg
const char * arg
Definition: jacosubdec.c:67
if
if(ret)
Definition: filter_design.txt:179
ff_formats_changeref
void ff_formats_changeref(AVFilterFormats **oldref, AVFilterFormats **newref)
Definition: formats.c:753
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:1492
ff_avfilter_graph_update_heap
void ff_avfilter_graph_update_heap(AVFilterGraph *graph, struct FilterLinkInternal *li)
Update the position of a link in the age heap.
Definition: avfiltergraph.c:1416
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:246
AVClass
Describe the class of an AVClass context structure.
Definition: log.h:66
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:1471
NULL
#define NULL
Definition: coverity.c:32
AVERROR_PATCHWELCOME
#define AVERROR_PATCHWELCOME
Not yet implemented in FFmpeg, patches welcome.
Definition: error.h:64
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:711
VAR_POS
@ VAR_POS
Definition: noise.c:56
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:139
AV_DICT_MULTIKEY
#define AV_DICT_MULTIKEY
Allow to store several equal keys in the dictionary.
Definition: dict.h:84
consume_update
static void consume_update(FilterLinkInternal *li, const AVFrame *frame)
Definition: avfilter.c:1440
ff_framequeue_add
int ff_framequeue_add(FFFrameQueue *fq, AVFrame *frame)
Add a frame.
Definition: framequeue.c:64
ff_framequeue_free
void ff_framequeue_free(FFFrameQueue *fq)
Free the queue and all queued frames.
Definition: framequeue.c:54
framequeue.h
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
fffiltergraph
static FFFilterGraph * fffiltergraph(AVFilterGraph *graph)
Definition: avfilter_internal.h:137
avfilter_internal.h
filter_frame
static int filter_frame(DBEDecodeContext *s, AVFrame *frame)
Definition: dolby_e.c:1059
avfilter_class
static const AVClass avfilter_class
Definition: avfilter.c:671
ff_channel_layouts_unref
void ff_channel_layouts_unref(AVFilterChannelLayouts **ref)
Remove a reference to a channel layouts list.
Definition: formats.c:729
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:1398
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:1414
tlog_ref
static void tlog_ref(void *ctx, AVFrame *ref, int end)
Definition: avfilter.c:47
ff_filter_link
static FilterLink * ff_filter_link(AVFilterLink *link)
Definition: filters.h:197
AV_CLASS_CATEGORY_FILTER
@ AV_CLASS_CATEGORY_FILTER
Definition: log.h:36
FilterLinkInternal::status_out
int status_out
Link output status.
Definition: avfilter_internal.h:68
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: filters.h:206
ff_frame_pool_uninit
void ff_frame_pool_uninit(FFFramePool **pool)
Deallocate the frame pool.
Definition: framepool.c:279
options
const OptionDef options[]
eval.h
AVFILTERPAD_FLAG_NEEDS_WRITABLE
#define AVFILTERPAD_FLAG_NEEDS_WRITABLE
The filter expects writable frames from its input link, duplicating data buffers if needed.
Definition: filters.h:57
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:381
f
f
Definition: af_crystalizer.c:122
default_execute
static int default_execute(AVFilterContext *ctx, avfilter_action_func *func, void *arg, int *ret, int nb_jobs)
Definition: avfilter.c:681
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:499
ff_inlink_set_status
void ff_inlink_set_status(AVFilterLink *link, int status)
Set the status on an input link.
Definition: avfilter.c:1587
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:1420
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:1553
av_bprint_finalize
int av_bprint_finalize(AVBPrint *buf, char **ret_str)
Finalize a print buffer.
Definition: bprint.c:240
FilterLinkInternal::age_index
int age_index
Index in the age array.
Definition: avfilter_internal.h:80
dst
uint8_t ptrdiff_t const uint8_t ptrdiff_t int intptr_t intptr_t int int16_t * dst
Definition: dsp.h:83
av_frame_copy
int av_frame_copy(AVFrame *dst, const AVFrame *src)
Copy the frame data from src to dst.
Definition: frame.c:1001
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:122
AVFrame::sample_rate
int sample_rate
Sample rate of the audio data.
Definition: frame.h:573
avfilter_link
int avfilter_link(AVFilterContext *src, unsigned srcpad, AVFilterContext *dst, unsigned dstpad)
Link two filters together.
Definition: avfilter.c:148
AV_SAMPLE_FMT_NONE
@ AV_SAMPLE_FMT_NONE
Definition: samplefmt.h:56
AV_NOPTS_VALUE
#define AV_NOPTS_VALUE
Undefined timestamp value.
Definition: avutil.h:248
FFFilterGraph::frame_queues
FFFrameQueueGlobal frame_queues
Definition: avfilter_internal.h:134
set_enable_expr
static int set_enable_expr(AVFilterContext *ctx, const char *expr)
Definition: avfilter.c:564
AVFrame::time_base
AVRational time_base
Time base for the timestamps in this frame.
Definition: frame.h:501
OFFSET
#define OFFSET(x)
Definition: avfilter.c:655
av_frame_is_writable
int av_frame_is_writable(AVFrame *frame)
Check if the frame data is writable.
Definition: frame.c:647
AVFrame::format
int format
format of the frame, -1 if unknown or unset Values correspond to enum AVPixelFormat for video frames,...
Definition: frame.h:461
AVOption::name
const char * name
Definition: opt.h:430
frame.h
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:894
buffer.h
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_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:223
av_channel_layout_compare
int av_channel_layout_compare(const AVChannelLayout *chl, const AVChannelLayout *chl1)
Check whether two channel layouts are semantically the same, i.e.
Definition: channel_layout.c:804
AV_LOG_INFO
#define AV_LOG_INFO
Standard information.
Definition: log.h:191
avfilter_init_str
int avfilter_init_str(AVFilterContext *filter, const char *args)
Initialize a filter with the supplied parameters.
Definition: avfilter.c:948
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:182
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
FilterLinkInternal::frame_blocked_in
int frame_blocked_in
If set, the source filter can not generate a frame as is.
Definition: avfilter_internal.h:49
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:40
ff_tlog_link
#define ff_tlog_link(ctx, link, end)
Definition: avfilter_internal.h:197
av_opt_next
const AVOption * av_opt_next(const void *obj, const AVOption *last)
Iterate over all AVOptions belonging to obj.
Definition: opt.c:48
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:717
VAR_W
@ VAR_W
Definition: avfilter.c:559
avfilter_options
static const AVOption avfilter_options[]
Definition: avfilter.c:658
bprint.h
append_pad
static int append_pad(unsigned *count, AVFilterPad **pads, AVFilterLink ***links, AVFilterPad *newpad)
Append a new pad.
Definition: avfilter.c:99
FilterLinkInternal::init_state
enum FilterLinkInternal::@304 init_state
stage of the initialization of the link properties (dimensions, etc)
ff_filter_frame_framed
static int ff_filter_frame_framed(AVFilterLink *link, AVFrame *frame)
Definition: avfilter.c:991
i
#define i(width, name, range_min, range_max)
Definition: cbs_h2645.c:256
link_set_out_status
static void 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:276
filter_child_next
static void * filter_child_next(void *obj, void *prev)
Definition: avfilter.c:636
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:257
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:1928
internal.h
fffilterctx
static FFFilterContext * fffilterctx(AVFilterContext *ctx)
Definition: avfilter_internal.h:108
AVFrame::extended_data
uint8_t ** extended_data
pointers to the data planes/channels.
Definition: frame.h:435
AVFilterCommand
Definition: avfilter_internal.h:113
FilterLinkInternal::status_in
int status_in
Link input status.
Definition: avfilter_internal.h:56
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:834
av_assert1
#define av_assert1(cond)
assert() equivalent, that does not lie in speed critical code.
Definition: avassert.h:56
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
FilterLinkInternal::frame_wanted_out
int frame_wanted_out
True if a frame is currently wanted on the output of this filter.
Definition: avfilter_internal.h:75
FFMIN
#define FFMIN(a, b)
Definition: macros.h:49
FF_TPRINTF_START
#define FF_TPRINTF_START(ctx, func)
Definition: avfilter_internal.h:192
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:256
AVFilterPad::flags
int flags
A combination of AVFILTERPAD_FLAG_* flags.
Definition: filters.h:67
VAR_N
@ VAR_N
Definition: avfilter.c:555
filt
static const int8_t filt[NUMTAPS *2]
Definition: af_earwax.c:40
AVFilterPad::name
const char * name
Pad name.
Definition: filters.h:44
AVCOL_SPC_UNSPECIFIED
@ AVCOL_SPC_UNSPECIFIED
Definition: pixfmt.h:612
ff_inlink_queued_samples
int ff_inlink_queued_samples(AVFilterLink *link)
Definition: avfilter.c:1426
forward_status_change
static int forward_status_change(AVFilterContext *filter, FilterLinkInternal *li_in)
Definition: avfilter.c:1178
AV_FRAME_FLAG_INTERLACED
#define AV_FRAME_FLAG_INTERLACED
A flag to mark frames whose content is interlaced.
Definition: frame.h:633
av_calloc
void * av_calloc(size_t nmemb, size_t size)
Definition: mem.c:264
AVFilter
Filter definition.
Definition: avfilter.h:201
AVHWFramesContext
This struct describes a set or pool of "hardware" frames (i.e.
Definition: hwcontext.h:115
ret
ret
Definition: filter_design.txt:187
AVFilterPad::type
enum AVMediaType type
AVFilterPad type.
Definition: filters.h:49
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:71
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
framepool.h
pos
unsigned int pos
Definition: spdifenc.c:414
AVOption::type
enum AVOptionType type
Definition: opt.h:445
AVFrame::sample_aspect_ratio
AVRational sample_aspect_ratio
Sample aspect ratio for the video frame, 0/1 if unknown/unspecified.
Definition: frame.h:481
request_frame
static int request_frame(AVFilterLink *outlink)
Definition: af_aecho.c:272
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:981
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:28
ff_filter_graph_remove_filter
void ff_filter_graph_remove_filter(AVFilterGraph *graph, AVFilterContext *filter)
Remove a filter from a graph;.
Definition: avfiltergraph.c:99
status
ov_status_e status
Definition: dnn_backend_openvino.c:100
channel_layout.h
FFFilterContext::execute
avfilter_execute_func * execute
Definition: avfilter_internal.h:101
ff_filter_execute
int ff_filter_execute(AVFilterContext *ctx, avfilter_action_func *func, void *arg, int *ret, int nb_jobs)
Definition: avfilter.c:1651
AVClass::option
const struct AVOption * option
a pointer to the first option specified in the class if any or NULL
Definition: log.h:84
avfilter_init_dict
int avfilter_init_dict(AVFilterContext *ctx, AVDictionary **options)
Initialize a filter with the supplied dictionary of options.
Definition: avfilter.c:907
AVRational::den
int den
Denominator.
Definition: rational.h:60
AV_PIX_FMT_NONE
@ AV_PIX_FMT_NONE
Definition: pixfmt.h:72
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:377
AV_OPT_TYPE_INT
@ AV_OPT_TYPE_INT
Underlying C type is int.
Definition: opt.h:259
avfilter.h
av_channel_layout_uninit
void av_channel_layout_uninit(AVChannelLayout *channel_layout)
Free any allocated data in the channel layout and reset the channel count to 0.
Definition: channel_layout.c:437
AVFilterContext::enable
void * enable
parsed expression (AVExpr*)
Definition: avfilter.h:504
AVFilterCommand::command
char * command
command
Definition: avfilter_internal.h:115
FFFilterContext
Definition: avfilter_internal.h:95
ref
static int ref[MAX_W *MAX_W]
Definition: jpeg2000dwt.c:112
samples
Filter the word “frame” indicates either a video frame or a group of audio samples
Definition: filter_design.txt:8
AVFilterCommand::arg
char * arg
optional argument for the command
Definition: avfilter_internal.h:116
ff_outlink_get_status
int ff_outlink_get_status(AVFilterLink *link)
Get the status on an output link.
Definition: avfilter.c:1603
AVFilterContext
An instance of a filter.
Definition: avfilter.h:457
FF_DISABLE_DEPRECATION_WARNINGS
#define FF_DISABLE_DEPRECATION_WARNINGS
Definition: internal.h:72
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:152
av_strdup
char * av_strdup(const char *s)
Duplicate a string.
Definition: mem.c:272
AVMEDIA_TYPE_VIDEO
@ AVMEDIA_TYPE_VIDEO
Definition: avutil.h:201
mem.h
audio.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:724
TFLAGS
#define TFLAGS
Definition: avfilter.c:657
avfilter_free
void avfilter_free(AVFilterContext *filter)
Free a filter context.
Definition: avfilter.c:789
ff_append_outpad
int ff_append_outpad(AVFilterContext *f, AVFilterPad *p)
Definition: avfilter.c:137
FLAGS
#define FLAGS
Definition: avfilter.c:656
av_free
#define av_free(p)
Definition: tableprint_vlc.h:33
AVDictionaryEntry
Definition: dict.h:89
ff_tlog
#define ff_tlog(ctx,...)
Definition: internal.h:141
default_filter_frame
static int default_filter_frame(AVFilterLink *link, AVFrame *frame)
Definition: avfilter.c:986
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:1538
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:195
ff_append_outpad_free_name
int ff_append_outpad_free_name(AVFilterContext *f, AVFilterPad *p)
Definition: avfilter.c:142
av_freep
#define av_freep(p)
Definition: tableprint_vlc.h:34
av_dict_set
int av_dict_set(AVDictionary **pm, const char *key, const char *value, int flags)
Set the given entry in *pm, overwriting an existing entry.
Definition: dict.c:88
var_names
static const char *const var_names[]
Definition: avfilter.c:542
ff_filter_activate_default
static int ff_filter_activate_default(AVFilterContext *filter)
Definition: avfilter.c:1213
samples_ready
static int samples_ready(FilterLinkInternal *link, unsigned min)
Definition: avfilter.c:1077
FilterLinkInternal::frame_pool
struct FFFramePool * frame_pool
Definition: avfilter_internal.h:37
AV_OPT_TYPE_FLAGS
@ AV_OPT_TYPE_FLAGS
Underlying C type is unsigned int.
Definition: opt.h:255
flags
#define flags(name, subs,...)
Definition: cbs_av1.c:482
hwcontext.h
av_log
#define av_log(a,...)
Definition: tableprint_vlc.h:27
FilterLinkInternal::fifo
FFFrameQueue fifo
Queue of frames waiting to be filtered.
Definition: avfilter_internal.h:42
ff_channel_layouts_changeref
void ff_channel_layouts_changeref(AVFilterChannelLayouts **oldref, AVFilterChannelLayouts **newref)
Definition: formats.c:747
avstring.h
AVFilterContext::filter
const AVFilter * filter
the AVFilter of which this is an instance
Definition: avfilter.h:460
AV_OPT_TYPE_STRING
@ AV_OPT_TYPE_STRING
Underlying C type is a uint8_t* that is either NULL or points to a C string allocated with the av_mal...
Definition: opt.h:276
avfilter_get_class
const AVClass * avfilter_get_class(void)
Definition: avfilter.c:1618
AV_OPT_TYPE_CONST
@ AV_OPT_TYPE_CONST
Special option type for declaring named constants.
Definition: opt.h:299
FilterLinkInternal::status_in_pts
int64_t status_in_pts
Timestamp of the input status change.
Definition: avfilter_internal.h:61
av_dict_iterate
const AVDictionaryEntry * av_dict_iterate(const AVDictionary *m, const AVDictionaryEntry *prev)
Iterate over a dictionary.
Definition: dict.c:44
src
#define src
Definition: vp8dsp.c:248
AV_DICT_DONT_STRDUP_KEY
#define AV_DICT_DONT_STRDUP_KEY
Take ownership of a key that's been allocated with av_malloc() or another memory allocation function.
Definition: dict.h:77
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:312
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:2885
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:237
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:1623
AVFilterCommand::time
double time
time expressed in seconds
Definition: avfilter_internal.h:114
min
float min
Definition: vorbis_enc_data.h:429
VAR_VARS_NB
@ VAR_VARS_NB
Definition: avfilter.c:561