FFmpeg
vf_mestimate.c
Go to the documentation of this file.
1 /**
2  * Copyright (c) 2016 Davinder Singh (DSM_) <ds.mudhar<@gmail.com>
3  *
4  * This file is part of FFmpeg.
5  *
6  * FFmpeg is free software; you can redistribute it and/or
7  * modify it under the terms of the GNU Lesser General Public
8  * License as published by the Free Software Foundation; either
9  * version 2.1 of the License, or (at your option) any later version.
10  *
11  * FFmpeg is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14  * Lesser General Public License for more details.
15  *
16  * You should have received a copy of the GNU Lesser General Public
17  * License along with FFmpeg; if not, write to the Free Software
18  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
19  */
20 
21 #include "motion_estimation.h"
22 #include "libavcodec/mathops.h"
23 #include "libavutil/avassert.h"
24 #include "libavutil/common.h"
25 #include "libavutil/imgutils.h"
26 #include "libavutil/opt.h"
27 #include "libavutil/pixdesc.h"
29 #include "avfilter.h"
30 #include "formats.h"
31 #include "internal.h"
32 #include "video.h"
33 
34 typedef struct MEContext {
35  const AVClass *class;
37  int method; ///< motion estimation method
38 
39  int mb_size; ///< macroblock size
40  int search_param; ///< search parameter
43 
45 
46  int (*mv_table[3])[2][2]; ///< motion vectors of current & prev 2 frames
47 } MEContext;
48 
49 #define OFFSET(x) offsetof(MEContext, x)
50 #define FLAGS AV_OPT_FLAG_VIDEO_PARAM|AV_OPT_FLAG_FILTERING_PARAM
51 #define CONST(name, help, val, unit) { name, help, 0, AV_OPT_TYPE_CONST, {.i64=val}, 0, 0, FLAGS, unit }
52 
53 static const AVOption mestimate_options[] = {
54  { "method", "motion estimation method", OFFSET(method), AV_OPT_TYPE_INT, {.i64 = AV_ME_METHOD_ESA}, AV_ME_METHOD_ESA, AV_ME_METHOD_UMH, FLAGS, "method" },
55  CONST("esa", "exhaustive search", AV_ME_METHOD_ESA, "method"),
56  CONST("tss", "three step search", AV_ME_METHOD_TSS, "method"),
57  CONST("tdls", "two dimensional logarithmic search", AV_ME_METHOD_TDLS, "method"),
58  CONST("ntss", "new three step search", AV_ME_METHOD_NTSS, "method"),
59  CONST("fss", "four step search", AV_ME_METHOD_FSS, "method"),
60  CONST("ds", "diamond search", AV_ME_METHOD_DS, "method"),
61  CONST("hexbs", "hexagon-based search", AV_ME_METHOD_HEXBS, "method"),
62  CONST("epzs", "enhanced predictive zonal search", AV_ME_METHOD_EPZS, "method"),
63  CONST("umh", "uneven multi-hexagon search", AV_ME_METHOD_UMH, "method"),
64  { "mb_size", "macroblock size", OFFSET(mb_size), AV_OPT_TYPE_INT, {.i64 = 16}, 8, INT_MAX, FLAGS },
65  { "search_param", "search parameter", OFFSET(search_param), AV_OPT_TYPE_INT, {.i64 = 7}, 4, INT_MAX, FLAGS },
66  { NULL }
67 };
68 
69 AVFILTER_DEFINE_CLASS(mestimate);
70 
72 {
73  static const enum AVPixelFormat pix_fmts[] = {
83  };
84 
86  if (!fmts_list)
87  return AVERROR(ENOMEM);
88  return ff_set_common_formats(ctx, fmts_list);
89 }
90 
92 {
93  MEContext *s = inlink->dst->priv;
94  int i;
95 
96  s->log2_mb_size = av_ceil_log2_c(s->mb_size);
97  s->mb_size = 1 << s->log2_mb_size;
98 
99  s->b_width = inlink->w >> s->log2_mb_size;
100  s->b_height = inlink->h >> s->log2_mb_size;
101  s->b_count = s->b_width * s->b_height;
102 
103  if (s->b_count == 0)
104  return AVERROR(EINVAL);
105 
106  for (i = 0; i < 3; i++) {
107  s->mv_table[i] = av_mallocz_array(s->b_count, sizeof(*s->mv_table[0]));
108  if (!s->mv_table[i])
109  return AVERROR(ENOMEM);
110  }
111 
112  ff_me_init_context(&s->me_ctx, s->mb_size, s->search_param, inlink->w, inlink->h, 0, (s->b_width - 1) << s->log2_mb_size, 0, (s->b_height - 1) << s->log2_mb_size);
113 
114  return 0;
115 }
116 
117 static void add_mv_data(AVMotionVector *mv, int mb_size,
118  int x, int y, int x_mv, int y_mv, int dir)
119 {
120  mv->w = mb_size;
121  mv->h = mb_size;
122  mv->dst_x = x + (mb_size >> 1);
123  mv->dst_y = y + (mb_size >> 1);
124  mv->src_x = x_mv + (mb_size >> 1);
125  mv->src_y = y_mv + (mb_size >> 1);
126  mv->source = dir ? 1 : -1;
127  mv->flags = 0;
128 }
129 
130 #define SEARCH_MV(method)\
131  do {\
132  for (mb_y = 0; mb_y < s->b_height; mb_y++)\
133  for (mb_x = 0; mb_x < s->b_width; mb_x++) {\
134  const int x_mb = mb_x << s->log2_mb_size;\
135  const int y_mb = mb_y << s->log2_mb_size;\
136  int mv[2] = {x_mb, y_mb};\
137  ff_me_search_##method(me_ctx, x_mb, y_mb, mv);\
138  add_mv_data(((AVMotionVector *) sd->data) + mv_count++, me_ctx->mb_size, x_mb, y_mb, mv[0], mv[1], dir);\
139  }\
140  } while (0)
141 
142 #define ADD_PRED(preds, px, py)\
143  do {\
144  preds.mvs[preds.nb][0] = px;\
145  preds.mvs[preds.nb][1] = py;\
146  preds.nb++;\
147  } while(0)
148 
150 {
151  AVFilterContext *ctx = inlink->dst;
152  MEContext *s = ctx->priv;
153  AVMotionEstContext *me_ctx = &s->me_ctx;
154  AVFrameSideData *sd;
155  AVFrame *out;
156  int mb_x, mb_y, dir;
157  int32_t mv_count = 0;
158  int ret;
159 
160  if (frame->pts == AV_NOPTS_VALUE) {
161  ret = ff_filter_frame(ctx->outputs[0], frame);
162  return ret;
163  }
164 
165  av_frame_free(&s->prev);
166  s->prev = s->cur;
167  s->cur = s->next;
168  s->next = frame;
169 
170  s->mv_table[2] = memcpy(s->mv_table[2], s->mv_table[1], sizeof(*s->mv_table[1]) * s->b_count);
171  s->mv_table[1] = memcpy(s->mv_table[1], s->mv_table[0], sizeof(*s->mv_table[0]) * s->b_count);
172 
173  if (!s->cur) {
174  s->cur = av_frame_clone(frame);
175  if (!s->cur)
176  return AVERROR(ENOMEM);
177  }
178 
179  if (!s->prev)
180  return 0;
181 
182  out = av_frame_clone(s->cur);
183  if (!out)
184  return AVERROR(ENOMEM);
185 
187  if (!sd) {
188  av_frame_free(&out);
189  return AVERROR(ENOMEM);
190  }
191 
192  me_ctx->data_cur = s->cur->data[0];
193  me_ctx->linesize = s->cur->linesize[0];
194 
195  for (dir = 0; dir < 2; dir++) {
196  me_ctx->data_ref = (dir ? s->next : s->prev)->data[0];
197 
198  if (s->method == AV_ME_METHOD_DS)
199  SEARCH_MV(ds);
200  else if (s->method == AV_ME_METHOD_ESA)
201  SEARCH_MV(esa);
202  else if (s->method == AV_ME_METHOD_FSS)
203  SEARCH_MV(fss);
204  else if (s->method == AV_ME_METHOD_NTSS)
205  SEARCH_MV(ntss);
206  else if (s->method == AV_ME_METHOD_TDLS)
207  SEARCH_MV(tdls);
208  else if (s->method == AV_ME_METHOD_TSS)
209  SEARCH_MV(tss);
210  else if (s->method == AV_ME_METHOD_HEXBS)
211  SEARCH_MV(hexbs);
212  else if (s->method == AV_ME_METHOD_UMH) {
213  for (mb_y = 0; mb_y < s->b_height; mb_y++)
214  for (mb_x = 0; mb_x < s->b_width; mb_x++) {
215  const int mb_i = mb_x + mb_y * s->b_width;
216  const int x_mb = mb_x << s->log2_mb_size;
217  const int y_mb = mb_y << s->log2_mb_size;
218  int mv[2] = {x_mb, y_mb};
219 
220  AVMotionEstPredictor *preds = me_ctx->preds;
221  preds[0].nb = 0;
222 
223  ADD_PRED(preds[0], 0, 0);
224 
225  //left mb in current frame
226  if (mb_x > 0)
227  ADD_PRED(preds[0], s->mv_table[0][mb_i - 1][dir][0], s->mv_table[0][mb_i - 1][dir][1]);
228 
229  if (mb_y > 0) {
230  //top mb in current frame
231  ADD_PRED(preds[0], s->mv_table[0][mb_i - s->b_width][dir][0], s->mv_table[0][mb_i - s->b_width][dir][1]);
232 
233  //top-right mb in current frame
234  if (mb_x + 1 < s->b_width)
235  ADD_PRED(preds[0], s->mv_table[0][mb_i - s->b_width + 1][dir][0], s->mv_table[0][mb_i - s->b_width + 1][dir][1]);
236  //top-left mb in current frame
237  else if (mb_x > 0)
238  ADD_PRED(preds[0], s->mv_table[0][mb_i - s->b_width - 1][dir][0], s->mv_table[0][mb_i - s->b_width - 1][dir][1]);
239  }
240 
241  //median predictor
242  if (preds[0].nb == 4) {
243  me_ctx->pred_x = mid_pred(preds[0].mvs[1][0], preds[0].mvs[2][0], preds[0].mvs[3][0]);
244  me_ctx->pred_y = mid_pred(preds[0].mvs[1][1], preds[0].mvs[2][1], preds[0].mvs[3][1]);
245  } else if (preds[0].nb == 3) {
246  me_ctx->pred_x = mid_pred(0, preds[0].mvs[1][0], preds[0].mvs[2][0]);
247  me_ctx->pred_y = mid_pred(0, preds[0].mvs[1][1], preds[0].mvs[2][1]);
248  } else if (preds[0].nb == 2) {
249  me_ctx->pred_x = preds[0].mvs[1][0];
250  me_ctx->pred_y = preds[0].mvs[1][1];
251  } else {
252  me_ctx->pred_x = 0;
253  me_ctx->pred_y = 0;
254  }
255 
256  ff_me_search_umh(me_ctx, x_mb, y_mb, mv);
257 
258  s->mv_table[0][mb_i][dir][0] = mv[0] - x_mb;
259  s->mv_table[0][mb_i][dir][1] = mv[1] - y_mb;
260  add_mv_data(((AVMotionVector *) sd->data) + mv_count++, me_ctx->mb_size, x_mb, y_mb, mv[0], mv[1], dir);
261  }
262 
263  } else if (s->method == AV_ME_METHOD_EPZS) {
264 
265  for (mb_y = 0; mb_y < s->b_height; mb_y++)
266  for (mb_x = 0; mb_x < s->b_width; mb_x++) {
267  const int mb_i = mb_x + mb_y * s->b_width;
268  const int x_mb = mb_x << s->log2_mb_size;
269  const int y_mb = mb_y << s->log2_mb_size;
270  int mv[2] = {x_mb, y_mb};
271 
272  AVMotionEstPredictor *preds = me_ctx->preds;
273  preds[0].nb = 0;
274  preds[1].nb = 0;
275 
276  ADD_PRED(preds[0], 0, 0);
277 
278  //left mb in current frame
279  if (mb_x > 0)
280  ADD_PRED(preds[0], s->mv_table[0][mb_i - 1][dir][0], s->mv_table[0][mb_i - 1][dir][1]);
281 
282  //top mb in current frame
283  if (mb_y > 0)
284  ADD_PRED(preds[0], s->mv_table[0][mb_i - s->b_width][dir][0], s->mv_table[0][mb_i - s->b_width][dir][1]);
285 
286  //top-right mb in current frame
287  if (mb_y > 0 && mb_x + 1 < s->b_width)
288  ADD_PRED(preds[0], s->mv_table[0][mb_i - s->b_width + 1][dir][0], s->mv_table[0][mb_i - s->b_width + 1][dir][1]);
289 
290  //median predictor
291  if (preds[0].nb == 4) {
292  me_ctx->pred_x = mid_pred(preds[0].mvs[1][0], preds[0].mvs[2][0], preds[0].mvs[3][0]);
293  me_ctx->pred_y = mid_pred(preds[0].mvs[1][1], preds[0].mvs[2][1], preds[0].mvs[3][1]);
294  } else if (preds[0].nb == 3) {
295  me_ctx->pred_x = mid_pred(0, preds[0].mvs[1][0], preds[0].mvs[2][0]);
296  me_ctx->pred_y = mid_pred(0, preds[0].mvs[1][1], preds[0].mvs[2][1]);
297  } else if (preds[0].nb == 2) {
298  me_ctx->pred_x = preds[0].mvs[1][0];
299  me_ctx->pred_y = preds[0].mvs[1][1];
300  } else {
301  me_ctx->pred_x = 0;
302  me_ctx->pred_y = 0;
303  }
304 
305  //collocated mb in prev frame
306  ADD_PRED(preds[0], s->mv_table[1][mb_i][dir][0], s->mv_table[1][mb_i][dir][1]);
307 
308  //accelerator motion vector of collocated block in prev frame
309  ADD_PRED(preds[1], s->mv_table[1][mb_i][dir][0] + (s->mv_table[1][mb_i][dir][0] - s->mv_table[2][mb_i][dir][0]),
310  s->mv_table[1][mb_i][dir][1] + (s->mv_table[1][mb_i][dir][1] - s->mv_table[2][mb_i][dir][1]));
311 
312  //left mb in prev frame
313  if (mb_x > 0)
314  ADD_PRED(preds[1], s->mv_table[1][mb_i - 1][dir][0], s->mv_table[1][mb_i - 1][dir][1]);
315 
316  //top mb in prev frame
317  if (mb_y > 0)
318  ADD_PRED(preds[1], s->mv_table[1][mb_i - s->b_width][dir][0], s->mv_table[1][mb_i - s->b_width][dir][1]);
319 
320  //right mb in prev frame
321  if (mb_x + 1 < s->b_width)
322  ADD_PRED(preds[1], s->mv_table[1][mb_i + 1][dir][0], s->mv_table[1][mb_i + 1][dir][1]);
323 
324  //bottom mb in prev frame
325  if (mb_y + 1 < s->b_height)
326  ADD_PRED(preds[1], s->mv_table[1][mb_i + s->b_width][dir][0], s->mv_table[1][mb_i + s->b_width][dir][1]);
327 
328  ff_me_search_epzs(me_ctx, x_mb, y_mb, mv);
329 
330  s->mv_table[0][mb_i][dir][0] = mv[0] - x_mb;
331  s->mv_table[0][mb_i][dir][1] = mv[1] - y_mb;
332  add_mv_data(((AVMotionVector *) sd->data) + mv_count++, s->mb_size, x_mb, y_mb, mv[0], mv[1], dir);
333  }
334  }
335  }
336 
337  return ff_filter_frame(ctx->outputs[0], out);
338 }
339 
341 {
342  MEContext *s = ctx->priv;
343  int i;
344 
345  av_frame_free(&s->prev);
346  av_frame_free(&s->cur);
347  av_frame_free(&s->next);
348 
349  for (i = 0; i < 3; i++)
350  av_freep(&s->mv_table[i]);
351 }
352 
353 static const AVFilterPad mestimate_inputs[] = {
354  {
355  .name = "default",
356  .type = AVMEDIA_TYPE_VIDEO,
357  .filter_frame = filter_frame,
358  .config_props = config_input,
359  },
360  { NULL }
361 };
362 
363 static const AVFilterPad mestimate_outputs[] = {
364  {
365  .name = "default",
366  .type = AVMEDIA_TYPE_VIDEO,
367  },
368  { NULL }
369 };
370 
372  .name = "mestimate",
373  .description = NULL_IF_CONFIG_SMALL("Generate motion vectors."),
374  .priv_size = sizeof(MEContext),
375  .priv_class = &mestimate_class,
376  .uninit = uninit,
380 };
AVMotionEstPredictor::nb
int nb
Definition: motion_estimation.h:38
query_formats
static int query_formats(AVFilterContext *ctx)
Definition: vf_mestimate.c:71
AVPixelFormat
AVPixelFormat
Pixel format.
Definition: pixfmt.h:64
AVMotionEstContext::data_ref
uint8_t * data_ref
Definition: motion_estimation.h:42
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
ff_make_format_list
AVFilterFormats * ff_make_format_list(const int *fmts)
Create a list of supported formats.
Definition: formats.c:283
AVMotionEstPredictor
Definition: motion_estimation.h:36
out
FILE * out
Definition: movenc.c:54
AVMotionVector
Definition: motion_vector.h:24
ff_filter_frame
int ff_filter_frame(AVFilterLink *link, AVFrame *frame)
Send a frame of data to the next filter.
Definition: avfilter.c:1080
MEContext::mv_table
int(*[3] mv_table)[2][2]
motion vectors of current & prev 2 frames
Definition: vf_mestimate.c:46
av_frame_new_side_data
AVFrameSideData * av_frame_new_side_data(AVFrame *frame, enum AVFrameSideDataType type, int size)
Add a new side data to a frame.
Definition: frame.c:722
mv
static const int8_t mv[256][2]
Definition: 4xm.c:77
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
MEContext::b_height
int b_height
Definition: vf_mestimate.c:41
av_frame_free
void av_frame_free(AVFrame **frame)
Free the frame and any dynamically allocated objects in it, e.g.
Definition: frame.c:202
mestimate_outputs
static const AVFilterPad mestimate_outputs[]
Definition: vf_mestimate.c:363
AVMotionEstContext::data_cur
uint8_t * data_cur
Definition: motion_estimation.h:42
AVFrame
This structure describes decoded (raw) audio or video data.
Definition: frame.h:295
pixdesc.h
AVOption
AVOption.
Definition: opt.h:246
MEContext::next
AVFrame * next
Definition: vf_mestimate.c:44
data
const char data[16]
Definition: mxf.c:91
MEContext::prev
AVFrame * prev
Definition: vf_mestimate.c:44
av_mallocz_array
void * av_mallocz_array(size_t nmemb, size_t size)
Definition: mem.c:191
AV_PIX_FMT_YUV440P
@ AV_PIX_FMT_YUV440P
planar YUV 4:4:0 (1 Cr & Cb sample per 1x2 Y samples)
Definition: pixfmt.h:99
AVFilter::name
const char * name
Filter name.
Definition: avfilter.h:148
add_mv_data
static void add_mv_data(AVMotionVector *mv, int mb_size, int x, int y, int x_mv, int y_mv, int dir)
Definition: vf_mestimate.c:117
MEContext::me_ctx
AVMotionEstContext me_ctx
Definition: vf_mestimate.c:36
MEContext::method
int method
motion estimation method
Definition: vf_mestimate.c:37
video.h
MEContext
Copyright (c) 2016 Davinder Singh (DSM_) <ds.mudhar<@gmail.com>
Definition: vf_mestimate.c:34
AV_ME_METHOD_FSS
#define AV_ME_METHOD_FSS
Definition: motion_estimation.h:30
AVMotionEstContext::pred_x
int pred_x
median predictor x
Definition: motion_estimation.h:56
AVFilterFormats
A list of supported formats for one end of a filter link.
Definition: formats.h:64
formats.h
SEARCH_MV
#define SEARCH_MV(method)
Definition: vf_mestimate.c:130
config_input
static int config_input(AVFilterLink *inlink)
Definition: vf_mestimate.c:91
AV_ME_METHOD_ESA
#define AV_ME_METHOD_ESA
Copyright (c) 2016 Davinder Singh (DSM_) <ds.mudhar<@gmail.com>
Definition: motion_estimation.h:26
AVFilterPad
A filter pad used for either input or output.
Definition: internal.h:54
AV_PIX_FMT_YUVJ411P
@ AV_PIX_FMT_YUVJ411P
planar YUV 4:1:1, 12bpp, (1 Cr & Cb sample per 4x1 Y samples) full scale (JPEG), deprecated in favor ...
Definition: pixfmt.h:258
avassert.h
av_cold
#define av_cold
Definition: attributes.h:84
ff_set_common_formats
int ff_set_common_formats(AVFilterContext *ctx, AVFilterFormats *formats)
A helper for query_formats() which sets all links to the same list of formats.
Definition: formats.c:568
AV_PIX_FMT_YUVJ422P
@ AV_PIX_FMT_YUVJ422P
planar YUV 4:2:2, 16bpp, full scale (JPEG), deprecated in favor of AV_PIX_FMT_YUV422P and setting col...
Definition: pixfmt.h:79
motion_vector.h
AV_ME_METHOD_TSS
#define AV_ME_METHOD_TSS
Definition: motion_estimation.h:27
s
#define s(width, name)
Definition: cbs_vp9.c:257
AV_PIX_FMT_YUVA420P
@ AV_PIX_FMT_YUVA420P
planar YUV 4:2:0, 20bpp, (1 Cr & Cb sample per 2x2 Y & A samples)
Definition: pixfmt.h:101
AVFILTER_DEFINE_CLASS
AVFILTER_DEFINE_CLASS(mestimate)
outputs
static const AVFilterPad outputs[]
Definition: af_acontrast.c:203
pix_fmts
static enum AVPixelFormat pix_fmts[]
Definition: libkvazaar.c:275
ctx
AVFormatContext * ctx
Definition: movenc.c:48
av_frame_clone
AVFrame * av_frame_clone(const AVFrame *src)
Create a new frame that references the same data as src.
Definition: frame.c:540
CONST
#define CONST(name, help, val, unit)
Definition: vf_mestimate.c:51
AV_PIX_FMT_YUV420P
@ AV_PIX_FMT_YUV420P
planar YUV 4:2:0, 12bpp, (1 Cr & Cb sample per 2x2 Y samples)
Definition: pixfmt.h:66
AVMotionEstContext
Definition: motion_estimation.h:41
AV_PIX_FMT_YUVJ444P
@ AV_PIX_FMT_YUVJ444P
planar YUV 4:4:4, 24bpp, full scale (JPEG), deprecated in favor of AV_PIX_FMT_YUV444P and setting col...
Definition: pixfmt.h:80
int32_t
int32_t
Definition: audio_convert.c:194
mestimate_inputs
static const AVFilterPad mestimate_inputs[]
Definition: vf_mestimate.c:353
AVClass
Describe the class of an AVClass context structure.
Definition: log.h:67
NULL
#define NULL
Definition: coverity.c:32
AV_PIX_FMT_YUVJ420P
@ AV_PIX_FMT_YUVJ420P
planar YUV 4:2:0, 12bpp, full scale (JPEG), deprecated in favor of AV_PIX_FMT_YUV420P and setting col...
Definition: pixfmt.h:78
ADD_PRED
#define ADD_PRED(preds, px, py)
Definition: vf_mestimate.c:142
motion_estimation.h
mathops.h
inputs
these buffered frames must be flushed immediately if a new input produces new the filter must not call request_frame to get more It must just process the frame or queue it The task of requesting more frames is left to the filter s request_frame method or the application If a filter has several inputs
Definition: filter_design.txt:243
AV_PIX_FMT_GRAY8
@ AV_PIX_FMT_GRAY8
Y , 8bpp.
Definition: pixfmt.h:74
OFFSET
#define OFFSET(x)
Definition: vf_mestimate.c:49
NULL_IF_CONFIG_SMALL
#define NULL_IF_CONFIG_SMALL(x)
Return NULL if CONFIG_SMALL is true, otherwise the argument without modification.
Definition: internal.h:188
ff_me_search_epzs
uint64_t ff_me_search_epzs(AVMotionEstContext *me_ctx, int x_mb, int y_mb, int *mv)
Definition: motion_estimation.c:332
MEContext::log2_mb_size
int log2_mb_size
Definition: vf_mestimate.c:42
mestimate_options
static const AVOption mestimate_options[]
Definition: vf_mestimate.c:53
AV_NOPTS_VALUE
#define AV_NOPTS_VALUE
Undefined timestamp value.
Definition: avutil.h:248
AVFrameSideData::data
uint8_t * data
Definition: frame.h:203
MEContext::b_width
int b_width
Definition: vf_mestimate.c:41
AV_PIX_FMT_YUVA444P
@ AV_PIX_FMT_YUVA444P
planar YUV 4:4:4 32bpp, (1 Cr & Cb sample per 1x1 Y & A samples)
Definition: pixfmt.h:177
AV_ME_METHOD_EPZS
#define AV_ME_METHOD_EPZS
Definition: motion_estimation.h:33
internal.h
MEContext::cur
AVFrame * cur
Definition: vf_mestimate.c:44
AV_ME_METHOD_DS
#define AV_ME_METHOD_DS
Definition: motion_estimation.h:31
i
#define i(width, name, range_min, range_max)
Definition: cbs_h2645.c:259
AV_ME_METHOD_HEXBS
#define AV_ME_METHOD_HEXBS
Definition: motion_estimation.h:32
common.h
AV_PIX_FMT_YUVJ440P
@ AV_PIX_FMT_YUVJ440P
planar YUV 4:4:0 full scale (JPEG), deprecated in favor of AV_PIX_FMT_YUV440P and setting color_range
Definition: pixfmt.h:100
AVFilterPad::name
const char * name
Pad name.
Definition: internal.h:60
AVFilter
Filter definition.
Definition: avfilter.h:144
mid_pred
#define mid_pred
Definition: mathops.h:97
ret
ret
Definition: filter_design.txt:187
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
FLAGS
#define FLAGS
Definition: vf_mestimate.c:50
ff_me_init_context
void ff_me_init_context(AVMotionEstContext *me_ctx, int mb_size, int search_param, int width, int height, int x_min, int x_max, int y_min, int y_max)
Definition: motion_estimation.c:45
uninit
static av_cold void uninit(AVFilterContext *ctx)
Definition: vf_mestimate.c:340
MEContext::search_param
int search_param
search parameter
Definition: vf_mestimate.c:40
AV_PIX_FMT_NONE
@ AV_PIX_FMT_NONE
Definition: pixfmt.h:65
AV_OPT_TYPE_INT
@ AV_OPT_TYPE_INT
Definition: opt.h:223
avfilter.h
MEContext::b_count
int b_count
Definition: vf_mestimate.c:41
AV_ME_METHOD_UMH
#define AV_ME_METHOD_UMH
Definition: motion_estimation.h:34
MEContext::mb_size
int mb_size
macroblock size
Definition: vf_mestimate.c:39
AV_PIX_FMT_YUV444P
@ AV_PIX_FMT_YUV444P
planar YUV 4:4:4, 24bpp, (1 Cr & Cb sample per 1x1 Y samples)
Definition: pixfmt.h:71
AVFilterContext
An instance of a filter.
Definition: avfilter.h:338
AVMotionEstContext::pred_y
int pred_y
median predictor y
Definition: motion_estimation.h:57
AVMEDIA_TYPE_VIDEO
@ AVMEDIA_TYPE_VIDEO
Definition: avutil.h:201
AV_PIX_FMT_YUV422P
@ AV_PIX_FMT_YUV422P
planar YUV 4:2:2, 16bpp, (1 Cr & Cb sample per 2x1 Y samples)
Definition: pixfmt.h:70
AV_ME_METHOD_NTSS
#define AV_ME_METHOD_NTSS
Definition: motion_estimation.h:29
AVMotionEstContext::linesize
int linesize
Definition: motion_estimation.h:43
AVFrameSideData
Structure to hold side data for an AVFrame.
Definition: frame.h:201
av_freep
#define av_freep(p)
Definition: tableprint_vlc.h:35
AV_PIX_FMT_YUV411P
@ AV_PIX_FMT_YUV411P
planar YUV 4:1:1, 12bpp, (1 Cr & Cb sample per 4x1 Y samples)
Definition: pixfmt.h:73
ff_vf_mestimate
AVFilter ff_vf_mestimate
Definition: vf_mestimate.c:371
imgutils.h
AV_PIX_FMT_YUV410P
@ AV_PIX_FMT_YUV410P
planar YUV 4:1:0, 9bpp, (1 Cr & Cb sample per 4x4 Y samples)
Definition: pixfmt.h:72
AV_FRAME_DATA_MOTION_VECTORS
@ AV_FRAME_DATA_MOTION_VECTORS
Motion vectors exported by some codecs (on demand through the export_mvs flag set in the libavcodec A...
Definition: frame.h:96
ff_me_search_umh
uint64_t ff_me_search_umh(AVMotionEstContext *me_ctx, int x_mb, int y_mb, int *mv)
Definition: motion_estimation.c:373
AVMotionEstPredictor::mvs
int mvs[10][2]
Definition: motion_estimation.h:37
AV_ME_METHOD_TDLS
#define AV_ME_METHOD_TDLS
Definition: motion_estimation.h:28
int
int
Definition: ffmpeg_filter.c:191
filter_frame
static int filter_frame(AVFilterLink *inlink, AVFrame *frame)
Definition: vf_mestimate.c:149
AVMotionEstContext::preds
AVMotionEstPredictor preds[2]
Definition: motion_estimation.h:58
AV_PIX_FMT_YUVA422P
@ AV_PIX_FMT_YUVA422P
planar YUV 4:2:2 24bpp, (1 Cr & Cb sample per 2x1 Y & A samples)
Definition: pixfmt.h:176
AVMotionEstContext::mb_size
int mb_size
Definition: motion_estimation.h:45
av_ceil_log2_c
static av_always_inline av_const int av_ceil_log2_c(int x)
Compute ceil(log2(x)).
Definition: common.h:332