FFmpeg
vf_fps.c
Go to the documentation of this file.
1 /*
2  * Copyright 2007 Bobby Bingham
3  * Copyright 2012 Robert Nagy <ronag89 gmail com>
4  * Copyright 2012 Anton Khirnov <anton khirnov net>
5  * Copyright 2018 Calvin Walton <calvin.walton@kepstin.ca>
6  *
7  * This file is part of FFmpeg.
8  *
9  * FFmpeg is free software; you can redistribute it and/or
10  * modify it under the terms of the GNU Lesser General Public
11  * License as published by the Free Software Foundation; either
12  * version 2.1 of the License, or (at your option) any later version.
13  *
14  * FFmpeg is distributed in the hope that it will be useful,
15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
17  * Lesser General Public License for more details.
18  *
19  * You should have received a copy of the GNU Lesser General Public
20  * License along with FFmpeg; if not, write to the Free Software
21  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
22  */
23 
24 /**
25  * @file
26  * a filter enforcing given constant framerate
27  */
28 
29 #include <float.h>
30 #include <stdint.h>
31 
32 #include "libavutil/avassert.h"
33 #include "libavutil/eval.h"
34 #include "libavutil/mathematics.h"
35 #include "libavutil/opt.h"
36 #include "avfilter.h"
37 #include "filters.h"
38 #include "internal.h"
39 
40 enum EOFAction {
44 };
45 
46 static const char *const var_names[] = {
47  "source_fps",
48  "ntsc",
49  "pal",
50  "qntsc",
51  "qpal",
52  "sntsc",
53  "spal",
54  "film",
55  "ntsc_film",
56  NULL
57 };
58 
59 enum var_name {
70 };
71 
72 static const double ntsc_fps = 30000.0 / 1001.0;
73 static const double pal_fps = 25.0;
74 static const double qntsc_fps = 30000.0 / 1001.0;
75 static const double qpal_fps = 25.0;
76 static const double sntsc_fps = 30000.0 / 1001.0;
77 static const double spal_fps = 25.0;
78 static const double film_fps = 24.0;
79 static const double ntsc_film_fps = 24000.0 / 1001.0;
80 
81 typedef struct FPSContext {
82  const AVClass *class;
83 
84  double start_time; ///< pts, in seconds, of the expected first frame
85 
86  char *framerate; ///< expression that defines the target framerate
87  int rounding; ///< AVRounding method for timestamps
88  int eof_action; ///< action performed for last frame in FIFO
89 
90  /* Set during outlink configuration */
91  int64_t in_pts_off; ///< input frame pts offset for start_time handling
92  int64_t out_pts_off; ///< output frame pts offset for start_time handling
93 
94  /* Runtime state */
95  int status; ///< buffered input status
96  int64_t status_pts; ///< buffered input status timestamp
97 
98  AVFrame *frames[2]; ///< buffered frames
99  int frames_count; ///< number of buffered frames
100 
101  int64_t next_pts; ///< pts of the next frame to output
102 
103  /* statistics */
104  int cur_frame_out; ///< number of times current frame has been output
105  int frames_in; ///< number of frames on input
106  int frames_out; ///< number of frames on output
107  int dup; ///< number of frames duplicated
108  int drop; ///< number of framed dropped
109 } FPSContext;
110 
111 #define OFFSET(x) offsetof(FPSContext, x)
112 #define V AV_OPT_FLAG_VIDEO_PARAM
113 #define F AV_OPT_FLAG_FILTERING_PARAM
114 static const AVOption fps_options[] = {
115  { "fps", "A string describing desired output framerate", OFFSET(framerate), AV_OPT_TYPE_STRING, { .str = "25" }, 0, 0, V|F },
116  { "start_time", "Assume the first PTS should be this value.", OFFSET(start_time), AV_OPT_TYPE_DOUBLE, { .dbl = DBL_MAX}, -DBL_MAX, DBL_MAX, V|F },
117  { "round", "set rounding method for timestamps", OFFSET(rounding), AV_OPT_TYPE_INT, { .i64 = AV_ROUND_NEAR_INF }, 0, 5, V|F, "round" },
118  { "zero", "round towards 0", 0, AV_OPT_TYPE_CONST, { .i64 = AV_ROUND_ZERO }, 0, 0, V|F, "round" },
119  { "inf", "round away from 0", 0, AV_OPT_TYPE_CONST, { .i64 = AV_ROUND_INF }, 0, 0, V|F, "round" },
120  { "down", "round towards -infty", 0, AV_OPT_TYPE_CONST, { .i64 = AV_ROUND_DOWN }, 0, 0, V|F, "round" },
121  { "up", "round towards +infty", 0, AV_OPT_TYPE_CONST, { .i64 = AV_ROUND_UP }, 0, 0, V|F, "round" },
122  { "near", "round to nearest", 0, AV_OPT_TYPE_CONST, { .i64 = AV_ROUND_NEAR_INF }, 0, 0, V|F, "round" },
123  { "eof_action", "action performed for last frame", OFFSET(eof_action), AV_OPT_TYPE_INT, { .i64 = EOF_ACTION_ROUND }, 0, EOF_ACTION_NB-1, V|F, "eof_action" },
124  { "round", "round similar to other frames", 0, AV_OPT_TYPE_CONST, { .i64 = EOF_ACTION_ROUND }, 0, 0, V|F, "eof_action" },
125  { "pass", "pass through last frame", 0, AV_OPT_TYPE_CONST, { .i64 = EOF_ACTION_PASS }, 0, 0, V|F, "eof_action" },
126  { NULL }
127 };
128 
130 
132 {
133  FPSContext *s = ctx->priv;
134 
135  s->status_pts = AV_NOPTS_VALUE;
136  s->next_pts = AV_NOPTS_VALUE;
137 
138  return 0;
139 }
140 
141 /* Remove the first frame from the buffer, returning it */
143 {
144  AVFrame *frame;
145 
146  /* Must only be called when there are frames in the buffer */
147  av_assert1(s->frames_count > 0);
148 
149  frame = s->frames[0];
150  s->frames[0] = s->frames[1];
151  s->frames[1] = NULL;
152  s->frames_count--;
153 
154  /* Update statistics counters */
155  s->frames_out += s->cur_frame_out;
156  if (s->cur_frame_out > 1) {
157  av_log(ctx, AV_LOG_DEBUG, "Duplicated frame with pts %"PRId64" %d times\n",
158  frame->pts, s->cur_frame_out - 1);
159  s->dup += s->cur_frame_out - 1;
160  } else if (s->cur_frame_out == 0) {
161  av_log(ctx, AV_LOG_DEBUG, "Dropping frame with pts %"PRId64"\n",
162  frame->pts);
163  s->drop++;
164  }
165  s->cur_frame_out = 0;
166 
167  return frame;
168 }
169 
171 {
172  FPSContext *s = ctx->priv;
173 
174  AVFrame *frame;
175 
176  while (s->frames_count > 0) {
177  frame = shift_frame(ctx, s);
179  }
180 
181  av_log(ctx, AV_LOG_VERBOSE, "%d frames in, %d frames out; %d frames dropped, "
182  "%d frames duplicated.\n", s->frames_in, s->frames_out, s->drop, s->dup);
183 }
184 
185 static int config_props(AVFilterLink* outlink)
186 {
187  AVFilterContext *ctx = outlink->src;
188  AVFilterLink *inlink = ctx->inputs[0];
189  FPSContext *s = ctx->priv;
190 
191  double var_values[VARS_NB], res;
192  int ret;
193 
194  var_values[VAR_SOURCE_FPS] = av_q2d(inlink->frame_rate);
195  var_values[VAR_FPS_NTSC] = ntsc_fps;
196  var_values[VAR_FPS_PAL] = pal_fps;
197  var_values[VAR_FPS_QNTSC] = qntsc_fps;
198  var_values[VAR_FPS_QPAL] = qpal_fps;
199  var_values[VAR_FPS_SNTSC] = sntsc_fps;
200  var_values[VAR_FPS_SPAL] = spal_fps;
201  var_values[VAR_FPS_FILM] = film_fps;
202  var_values[VAR_FPS_NTSC_FILM] = ntsc_film_fps;
203  ret = av_expr_parse_and_eval(&res, s->framerate,
204  var_names, var_values,
205  NULL, NULL, NULL, NULL, NULL, 0, ctx);
206  if (ret < 0)
207  return ret;
208 
209  outlink->frame_rate = av_d2q(res, INT_MAX);
210  outlink->time_base = av_inv_q(outlink->frame_rate);
211 
212  /* Calculate the input and output pts offsets for start_time */
213  if (s->start_time != DBL_MAX && s->start_time != AV_NOPTS_VALUE) {
214  double first_pts = s->start_time * AV_TIME_BASE;
215  if (first_pts < INT64_MIN || first_pts > INT64_MAX) {
216  av_log(ctx, AV_LOG_ERROR, "Start time %f cannot be represented in internal time base\n",
217  s->start_time);
218  return AVERROR(EINVAL);
219  }
220  s->in_pts_off = av_rescale_q_rnd(first_pts, AV_TIME_BASE_Q, inlink->time_base,
221  s->rounding | AV_ROUND_PASS_MINMAX);
222  s->out_pts_off = av_rescale_q_rnd(first_pts, AV_TIME_BASE_Q, outlink->time_base,
223  s->rounding | AV_ROUND_PASS_MINMAX);
224  s->next_pts = s->out_pts_off;
225  av_log(ctx, AV_LOG_VERBOSE, "Set first pts to (in:%"PRId64" out:%"PRId64") from start time %f\n",
226  s->in_pts_off, s->out_pts_off, s->start_time);
227  }
228 
229  av_log(ctx, AV_LOG_VERBOSE, "fps=%d/%d\n", outlink->frame_rate.num, outlink->frame_rate.den);
230 
231  return 0;
232 }
233 
234 /* Read a frame from the input and save it in the buffer */
236 {
237  AVFrame *frame;
238  int ret;
239  int64_t in_pts;
240 
241  /* Must only be called when we have buffer room available */
242  av_assert1(s->frames_count < 2);
243 
245  /* Caller must have run ff_inlink_check_available_frame first */
246  av_assert1(ret);
247  if (ret < 0)
248  return ret;
249 
250  /* Convert frame pts to output timebase.
251  * The dance with offsets is required to match the rounding behaviour of the
252  * previous version of the fps filter when using the start_time option. */
253  in_pts = frame->pts;
254  frame->pts = s->out_pts_off + av_rescale_q_rnd(in_pts - s->in_pts_off,
255  inlink->time_base, outlink->time_base,
256  s->rounding | AV_ROUND_PASS_MINMAX);
257 
258  av_log(ctx, AV_LOG_DEBUG, "Read frame with in pts %"PRId64", out pts %"PRId64"\n",
259  in_pts, frame->pts);
260 
261  s->frames[s->frames_count++] = frame;
262  s->frames_in++;
263 
264  return 1;
265 }
266 
267 /* Write a frame to the output */
269 {
270  AVFrame *frame;
271 
272  av_assert1(s->frames_count == 2 || (s->status && s->frames_count == 1));
273 
274  /* We haven't yet determined the pts of the first frame */
275  if (s->next_pts == AV_NOPTS_VALUE) {
276  if (s->frames[0]->pts != AV_NOPTS_VALUE) {
277  s->next_pts = s->frames[0]->pts;
278  av_log(ctx, AV_LOG_VERBOSE, "Set first pts to %"PRId64"\n", s->next_pts);
279  } else {
280  av_log(ctx, AV_LOG_WARNING, "Discarding initial frame(s) with no "
281  "timestamp.\n");
282  frame = shift_frame(ctx, s);
284  *again = 1;
285  return 0;
286  }
287  }
288 
289  /* There are two conditions where we want to drop a frame:
290  * - If we have two buffered frames and the second frame is acceptable
291  * as the next output frame, then drop the first buffered frame.
292  * - If we have status (EOF) set, drop frames when we hit the
293  * status timestamp. */
294  if ((s->frames_count == 2 && s->frames[1]->pts <= s->next_pts) ||
295  (s->status && s->status_pts <= s->next_pts)) {
296 
297  frame = shift_frame(ctx, s);
299  *again = 1;
300  return 0;
301 
302  /* Output a copy of the first buffered frame */
303  } else {
304  frame = av_frame_clone(s->frames[0]);
305  if (!frame)
306  return AVERROR(ENOMEM);
307  // Make sure Closed Captions will not be duplicated
309  frame->pts = s->next_pts++;
310 
311  av_log(ctx, AV_LOG_DEBUG, "Writing frame with pts %"PRId64" to pts %"PRId64"\n",
312  s->frames[0]->pts, frame->pts);
313  s->cur_frame_out++;
314  *again = 1;
315  return ff_filter_frame(outlink, frame);
316  }
317 }
318 
319 /* Convert status_pts to outlink timebase */
320 static void update_eof_pts(AVFilterContext *ctx, FPSContext *s, AVFilterLink *inlink, AVFilterLink *outlink, int64_t status_pts)
321 {
322  int eof_rounding = (s->eof_action == EOF_ACTION_PASS) ? AV_ROUND_UP : s->rounding;
323  s->status_pts = av_rescale_q_rnd(status_pts, inlink->time_base, outlink->time_base,
324  eof_rounding | AV_ROUND_PASS_MINMAX);
325 
326  av_log(ctx, AV_LOG_DEBUG, "EOF is at pts %"PRId64"\n", s->status_pts);
327 }
328 
330 {
331  FPSContext *s = ctx->priv;
332  AVFilterLink *inlink = ctx->inputs[0];
333  AVFilterLink *outlink = ctx->outputs[0];
334 
335  int ret;
336  int again = 0;
337  int64_t status_pts;
338 
340 
341  /* No buffered status: normal operation */
342  if (!s->status) {
343 
344  /* Read available input frames if we have room */
345  while (s->frames_count < 2 && ff_inlink_check_available_frame(inlink)) {
346  ret = read_frame(ctx, s, inlink, outlink);
347  if (ret < 0)
348  return ret;
349  }
350 
351  /* We do not yet have enough frames to produce output */
352  if (s->frames_count < 2) {
353  /* Check if we've hit EOF (or otherwise that an error status is set) */
354  ret = ff_inlink_acknowledge_status(inlink, &s->status, &status_pts);
355  if (ret > 0)
356  update_eof_pts(ctx, s, inlink, outlink, status_pts);
357 
358  if (!ret) {
359  /* If someone wants us to output, we'd better ask for more input */
361  return 0;
362  }
363  }
364  }
365 
366  /* Buffered frames are available, so generate an output frame */
367  if (s->frames_count > 0) {
368  ret = write_frame(ctx, s, outlink, &again);
369  /* Couldn't generate a frame, so schedule us to perform another step */
370  if (again)
371  ff_filter_set_ready(ctx, 100);
372  return ret;
373  }
374 
375  /* No frames left, so forward the status */
376  if (s->status && s->frames_count == 0) {
377  ff_outlink_set_status(outlink, s->status, s->next_pts);
378  return 0;
379  }
380 
381  return FFERROR_NOT_READY;
382 }
383 
385  {
386  .name = "default",
387  .type = AVMEDIA_TYPE_VIDEO,
388  },
389  { NULL }
390 };
391 
393  {
394  .name = "default",
395  .type = AVMEDIA_TYPE_VIDEO,
396  .config_props = config_props,
397  },
398  { NULL }
399 };
400 
402  .name = "fps",
403  .description = NULL_IF_CONFIG_SMALL("Force constant framerate."),
404  .init = init,
405  .uninit = uninit,
406  .priv_size = sizeof(FPSContext),
407  .priv_class = &fps_class,
408  .activate = activate,
411 };
AV_LOG_WARNING
#define AV_LOG_WARNING
Something somehow does not look correct.
Definition: log.h:187
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
VARS_NB
@ VARS_NB
Definition: vf_fps.c:69
ff_filter_frame
int ff_filter_frame(AVFilterLink *link, AVFrame *frame)
Send a frame of data to the next filter.
Definition: avfilter.c:978
FFERROR_NOT_READY
return FFERROR_NOT_READY
Definition: filter_design.txt:204
AV_FRAME_DATA_A53_CC
@ AV_FRAME_DATA_A53_CC
ATSC A53 Part 4 Closed Captions.
Definition: frame.h:58
AV_TIME_BASE_Q
#define AV_TIME_BASE_Q
Internal time base represented as fractional value.
Definition: avutil.h:260
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
EOF_ACTION_PASS
@ EOF_ACTION_PASS
Definition: vf_fps.c:42
av_frame_free
void av_frame_free(AVFrame **frame)
Free the frame and any dynamically allocated objects in it, e.g.
Definition: frame.c:111
AVFrame
This structure describes decoded (raw) audio or video data.
Definition: frame.h:303
qntsc_fps
static const double qntsc_fps
Definition: vf_fps.c:74
VAR_FPS_NTSC
@ VAR_FPS_NTSC
Definition: vf_fps.c:61
AVOption
AVOption.
Definition: opt.h:248
AV_LOG_VERBOSE
#define AV_LOG_VERBOSE
Detailed information.
Definition: log.h:197
float.h
ntsc_fps
static const double ntsc_fps
Definition: vf_fps.c:72
var_names
static const char *const var_names[]
Definition: vf_fps.c:46
mathematics.h
AVFilter::name
const char * name
Filter name.
Definition: avfilter.h:149
pal_fps
static const double pal_fps
Definition: vf_fps.c:73
VAR_FPS_QNTSC
@ VAR_FPS_QNTSC
Definition: vf_fps.c:63
VAR_FPS_SPAL
@ VAR_FPS_SPAL
Definition: vf_fps.c:66
init
static av_cold int init(AVFilterContext *ctx)
Definition: vf_fps.c:131
FF_FILTER_FORWARD_STATUS_BACK
#define FF_FILTER_FORWARD_STATUS_BACK(outlink, inlink)
Forward the status on an output link to an input link.
Definition: filters.h:199
config_props
static int config_props(AVFilterLink *outlink)
Definition: vf_fps.c:185
uninit
static av_cold void uninit(AVFilterContext *ctx)
Definition: vf_fps.c:170
framerate
int framerate
Definition: h264_levels.c:65
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:1376
EOFAction
EOFAction
Definition: framesync.h:26
AV_ROUND_UP
@ AV_ROUND_UP
Round toward +infinity.
Definition: mathematics.h:83
AVRational::num
int num
Numerator.
Definition: rational.h:59
AVFilterPad
A filter pad used for either input or output.
Definition: internal.h:54
avassert.h
AV_LOG_ERROR
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
Definition: log.h:181
update_eof_pts
static void update_eof_pts(AVFilterContext *ctx, FPSContext *s, AVFilterLink *inlink, AVFilterLink *outlink, int64_t status_pts)
Definition: vf_fps.c:320
av_cold
#define av_cold
Definition: attributes.h:90
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
var_name
var_name
Definition: setts_bsf.c:50
ff_outlink_set_status
static void ff_outlink_set_status(AVFilterLink *link, int status, int64_t pts)
Set the status field of a link from the source filter.
Definition: filters.h:189
FPSContext::eof_action
int eof_action
action performed for last frame in FIFO
Definition: vf_fps.c:88
s
#define s(width, name)
Definition: cbs_vp9.c:257
FPSContext::frames_in
int frames_in
number of frames on input
Definition: vf_fps.c:105
AV_OPT_TYPE_DOUBLE
@ AV_OPT_TYPE_DOUBLE
Definition: opt.h:227
V
#define V
Definition: vf_fps.c:112
av_q2d
static double av_q2d(AVRational a)
Convert an AVRational to a double.
Definition: rational.h:104
outputs
static const AVFilterPad outputs[]
Definition: af_acontrast.c:203
filters.h
AV_LOG_DEBUG
#define AV_LOG_DEBUG
Stuff which is only useful for libav* developers.
Definition: log.h:202
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:423
FPSContext::frames_count
int frames_count
number of buffered frames
Definition: vf_fps.c:99
VAR_FPS_SNTSC
@ VAR_FPS_SNTSC
Definition: vf_fps.c:65
write_frame
static int write_frame(AVFilterContext *ctx, FPSContext *s, AVFilterLink *outlink, int *again)
Definition: vf_fps.c:268
FPSContext::out_pts_off
int64_t out_pts_off
output frame pts offset for start_time handling
Definition: vf_fps.c:92
sntsc_fps
static const double sntsc_fps
Definition: vf_fps.c:76
ntsc_film_fps
static const double ntsc_film_fps
Definition: vf_fps.c:79
OFFSET
#define OFFSET(x)
Definition: vf_fps.c:111
AVClass
Describe the class of an AVClass context structure.
Definition: log.h:67
NULL
#define NULL
Definition: coverity.c:32
AV_ROUND_INF
@ AV_ROUND_INF
Round away from zero.
Definition: mathematics.h:81
avfilter_vf_fps_outputs
static const AVFilterPad avfilter_vf_fps_outputs[]
Definition: vf_fps.c:392
AV_ROUND_NEAR_INF
@ AV_ROUND_NEAR_INF
Round to nearest and halfway cases away from zero.
Definition: mathematics.h:84
FPSContext::status_pts
int64_t status_pts
buffered input status timestamp
Definition: vf_fps.c:96
FPSContext::frames
AVFrame * frames[2]
buffered frames
Definition: vf_fps.c:98
spal_fps
static const double spal_fps
Definition: vf_fps.c:77
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:1331
VAR_FPS_FILM
@ VAR_FPS_FILM
Definition: vf_fps.c:67
FPSContext::status
int status
buffered input status
Definition: vf_fps.c:95
avfilter_vf_fps_inputs
static const AVFilterPad avfilter_vf_fps_inputs[]
Definition: vf_fps.c:384
read_frame
static int read_frame(AVFilterContext *ctx, FPSContext *s, AVFilterLink *inlink, AVFilterLink *outlink)
Definition: vf_fps.c:235
eval.h
FPSContext
Definition: vf_fps.c:81
qpal_fps
static const double qpal_fps
Definition: vf_fps.c:75
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:1351
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:117
av_expr_parse_and_eval
int av_expr_parse_and_eval(double *d, const char *s, const char *const *const_names, const double *const_values, const char *const *func1_names, double(*const *funcs1)(void *, double), const char *const *func2_names, double(*const *funcs2)(void *, double, double), void *opaque, int log_offset, void *log_ctx)
Parse and evaluate an expression.
Definition: eval.c:776
AV_ROUND_ZERO
@ AV_ROUND_ZERO
Round toward zero.
Definition: mathematics.h:80
start_time
static int64_t start_time
Definition: ffplay.c:332
AV_NOPTS_VALUE
#define AV_NOPTS_VALUE
Undefined timestamp value.
Definition: avutil.h:248
ff_vf_fps
const AVFilter ff_vf_fps
Definition: vf_fps.c:401
EOF_ACTION_ROUND
@ EOF_ACTION_ROUND
Definition: vf_fps.c:41
VAR_FPS_QPAL
@ VAR_FPS_QPAL
Definition: vf_fps.c:64
av_frame_remove_side_data
void av_frame_remove_side_data(AVFrame *frame, enum AVFrameSideDataType type)
Remove and free all side data instances of the given type.
Definition: frame.c:690
FPSContext::next_pts
int64_t next_pts
pts of the next frame to output
Definition: vf_fps.c:101
FF_FILTER_FORWARD_WANTED
FF_FILTER_FORWARD_WANTED(outlink, inlink)
EOF_ACTION_NB
@ EOF_ACTION_NB
Definition: vf_fps.c:43
FPSContext::drop
int drop
number of framed dropped
Definition: vf_fps.c:108
internal.h
shift_frame
static AVFrame * shift_frame(AVFilterContext *ctx, FPSContext *s)
Definition: vf_fps.c:142
FPSContext::framerate
char * framerate
expression that defines the target framerate
Definition: vf_fps.c:86
AV_TIME_BASE
#define AV_TIME_BASE
Internal time base represented as integer.
Definition: avutil.h:254
av_assert1
#define av_assert1(cond)
assert() equivalent, that does not lie in speed critical code.
Definition: avassert.h:53
AV_ROUND_DOWN
@ AV_ROUND_DOWN
Round toward -infinity.
Definition: mathematics.h:82
av_d2q
AVRational av_d2q(double d, int max)
Convert a double precision floating point number to a rational.
Definition: rational.c:106
av_inv_q
static av_always_inline AVRational av_inv_q(AVRational q)
Invert a rational.
Definition: rational.h:159
AVFilterPad::name
const char * name
Pad name.
Definition: internal.h:60
AVFilter
Filter definition.
Definition: avfilter.h:145
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
again
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 again
Definition: filter_design.txt:25
AVRational::den
int den
Denominator.
Definition: rational.h:60
AV_OPT_TYPE_INT
@ AV_OPT_TYPE_INT
Definition: opt.h:225
avfilter.h
FPSContext::in_pts_off
int64_t in_pts_off
input frame pts offset for start_time handling
Definition: vf_fps.c:91
film_fps
static const double film_fps
Definition: vf_fps.c:78
F
#define F
Definition: vf_fps.c:113
FPSContext::dup
int dup
number of frames duplicated
Definition: vf_fps.c:107
AVFilterContext
An instance of a filter.
Definition: avfilter.h:333
AVMEDIA_TYPE_VIDEO
@ AVMEDIA_TYPE_VIDEO
Definition: avutil.h:201
FPSContext::start_time
double start_time
pts, in seconds, of the expected first frame
Definition: vf_fps.c:84
AV_ROUND_PASS_MINMAX
@ AV_ROUND_PASS_MINMAX
Flag telling rescaling functions to pass INT64_MIN/MAX through unchanged, avoiding special cases for ...
Definition: mathematics.h:108
AVFILTER_DEFINE_CLASS
AVFILTER_DEFINE_CLASS(fps)
activate
static int activate(AVFilterContext *ctx)
Definition: vf_fps.c:329
fps_options
static const AVOption fps_options[]
Definition: vf_fps.c:114
av_log
#define av_log(a,...)
Definition: tableprint_vlc.h:28
FPSContext::cur_frame_out
int cur_frame_out
number of times current frame has been output
Definition: vf_fps.c:104
VAR_FPS_NTSC_FILM
@ VAR_FPS_NTSC_FILM
Definition: vf_fps.c:68
AV_OPT_TYPE_STRING
@ AV_OPT_TYPE_STRING
Definition: opt.h:229
VAR_SOURCE_FPS
@ VAR_SOURCE_FPS
Definition: vf_fps.c:60
AV_OPT_TYPE_CONST
@ AV_OPT_TYPE_CONST
Definition: opt.h:234
av_rescale_q_rnd
int64_t av_rescale_q_rnd(int64_t a, AVRational bq, AVRational cq, enum AVRounding rnd)
Rescale a 64-bit integer by 2 rational numbers with specified rounding.
Definition: mathematics.c:134
FPSContext::frames_out
int frames_out
number of frames on output
Definition: vf_fps.c:106
FPSContext::rounding
int rounding
AVRounding method for timestamps.
Definition: vf_fps.c:87
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:186
VAR_FPS_PAL
@ VAR_FPS_PAL
Definition: vf_fps.c:62