FFmpeg
yadif_common.c
Go to the documentation of this file.
1 /*
2  * Copyright (C) 2006-2011 Michael Niedermayer <michaelni@gmx.at>
3  * 2010 James Darnley <james.darnley@gmail.com>
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/imgutils.h"
24 #include "internal.h"
25 #include "yadif.h"
26 
27 static int return_frame(AVFilterContext *ctx, int is_second)
28 {
29  YADIFContext *yadif = ctx->priv;
30  AVFilterLink *link = ctx->outputs[0];
31  int tff, ret;
32 
33  if (yadif->parity == -1) {
34  tff = yadif->cur->interlaced_frame ?
35  yadif->cur->top_field_first : 1;
36  } else {
37  tff = yadif->parity ^ 1;
38  }
39 
40  if (is_second) {
41  yadif->out = ff_get_video_buffer(link, link->w, link->h);
42  if (!yadif->out)
43  return AVERROR(ENOMEM);
44 
45  av_frame_copy_props(yadif->out, yadif->cur);
46  yadif->out->interlaced_frame = 0;
47  if (yadif->current_field == YADIF_FIELD_BACK_END)
48  yadif->current_field = YADIF_FIELD_END;
49  }
50 
51  yadif->filter(ctx, yadif->out, tff ^ !is_second, tff);
52 
53  if (is_second) {
54  int64_t cur_pts = yadif->cur->pts;
55  int64_t next_pts = yadif->next->pts;
56 
57  if (next_pts != AV_NOPTS_VALUE && cur_pts != AV_NOPTS_VALUE) {
58  yadif->out->pts = cur_pts + next_pts;
59  } else {
60  yadif->out->pts = AV_NOPTS_VALUE;
61  }
62  }
63  ret = ff_filter_frame(ctx->outputs[0], yadif->out);
64 
65  yadif->frame_pending = (yadif->mode&1) && !is_second;
66  return ret;
67 }
68 
69 static int checkstride(YADIFContext *yadif, const AVFrame *a, const AVFrame *b)
70 {
71  int i;
72  for (i = 0; i < yadif->csp->nb_components; i++)
73  if (a->linesize[i] != b->linesize[i])
74  return 1;
75  return 0;
76 }
77 
78 static void fixstride(AVFilterLink *link, AVFrame *f)
79 {
80  AVFrame *dst = ff_default_get_video_buffer(link, f->width, f->height);
81  if(!dst)
82  return;
83  av_frame_copy_props(dst, f);
84  av_image_copy(dst->data, dst->linesize,
85  (const uint8_t **)f->data, f->linesize,
86  dst->format, dst->width, dst->height);
87  av_frame_unref(f);
88  av_frame_move_ref(f, dst);
89  av_frame_free(&dst);
90 }
91 
92 int ff_yadif_filter_frame(AVFilterLink *link, AVFrame *frame)
93 {
94  AVFilterContext *ctx = link->dst;
95  YADIFContext *yadif = ctx->priv;
96 
97  av_assert0(frame);
98 
99  if (yadif->frame_pending)
100  return_frame(ctx, 1);
101 
102  if (yadif->prev)
103  av_frame_free(&yadif->prev);
104  yadif->prev = yadif->cur;
105  yadif->cur = yadif->next;
106  yadif->next = frame;
107 
108  if (!yadif->cur) {
109  yadif->cur = av_frame_clone(yadif->next);
110  if (!yadif->cur)
111  return AVERROR(ENOMEM);
112  yadif->current_field = YADIF_FIELD_END;
113  }
114 
115  if (checkstride(yadif, yadif->next, yadif->cur)) {
116  av_log(ctx, AV_LOG_VERBOSE, "Reallocating frame due to differing stride\n");
117  fixstride(link, yadif->next);
118  }
119  if (checkstride(yadif, yadif->next, yadif->cur))
120  fixstride(link, yadif->cur);
121  if (yadif->prev && checkstride(yadif, yadif->next, yadif->prev))
122  fixstride(link, yadif->prev);
123  if (checkstride(yadif, yadif->next, yadif->cur) || (yadif->prev && checkstride(yadif, yadif->next, yadif->prev))) {
124  av_log(ctx, AV_LOG_ERROR, "Failed to reallocate frame\n");
125  return -1;
126  }
127 
128  if (!yadif->prev)
129  return 0;
130 
131  if ((yadif->deint && !yadif->cur->interlaced_frame) ||
132  ctx->is_disabled ||
133  (yadif->deint && !yadif->prev->interlaced_frame && yadif->prev->repeat_pict) ||
134  (yadif->deint && !yadif->next->interlaced_frame && yadif->next->repeat_pict)
135  ) {
136  yadif->out = av_frame_clone(yadif->cur);
137  if (!yadif->out)
138  return AVERROR(ENOMEM);
139 
140  av_frame_free(&yadif->prev);
141  if (yadif->out->pts != AV_NOPTS_VALUE)
142  yadif->out->pts *= 2;
143  return ff_filter_frame(ctx->outputs[0], yadif->out);
144  }
145 
146  yadif->out = ff_get_video_buffer(ctx->outputs[0], link->w, link->h);
147  if (!yadif->out)
148  return AVERROR(ENOMEM);
149 
150  av_frame_copy_props(yadif->out, yadif->cur);
151  yadif->out->interlaced_frame = 0;
152 
153  if (yadif->out->pts != AV_NOPTS_VALUE)
154  yadif->out->pts *= 2;
155 
156  return return_frame(ctx, 0);
157 }
158 
159 int ff_yadif_request_frame(AVFilterLink *link)
160 {
161  AVFilterContext *ctx = link->src;
162  YADIFContext *yadif = ctx->priv;
163  int ret;
164 
165  if (yadif->frame_pending) {
166  return_frame(ctx, 1);
167  return 0;
168  }
169 
170  if (yadif->eof)
171  return AVERROR_EOF;
172 
173  ret = ff_request_frame(ctx->inputs[0]);
174 
175  if (ret == AVERROR_EOF && yadif->cur) {
176  AVFrame *next = av_frame_clone(yadif->next);
177 
178  if (!next)
179  return AVERROR(ENOMEM);
180 
181  yadif->current_field = YADIF_FIELD_BACK_END;
182  next->pts = yadif->next->pts * 2 - yadif->cur->pts;
183 
184  ff_yadif_filter_frame(ctx->inputs[0], next);
185  yadif->eof = 1;
186  } else if (ret < 0) {
187  return ret;
188  }
189 
190  return 0;
191 }
192 
193 #define OFFSET(x) offsetof(YADIFContext, x)
194 #define FLAGS AV_OPT_FLAG_VIDEO_PARAM|AV_OPT_FLAG_FILTERING_PARAM
195 
196 #define CONST(name, help, val, unit) { name, help, 0, AV_OPT_TYPE_CONST, {.i64=val}, INT_MIN, INT_MAX, FLAGS, unit }
197 
198 const AVOption ff_yadif_options[] = {
199  { "mode", "specify the interlacing mode", OFFSET(mode), AV_OPT_TYPE_INT, {.i64=YADIF_MODE_SEND_FRAME}, 0, 3, FLAGS, "mode"},
200  CONST("send_frame", "send one frame for each frame", YADIF_MODE_SEND_FRAME, "mode"),
201  CONST("send_field", "send one frame for each field", YADIF_MODE_SEND_FIELD, "mode"),
202  CONST("send_frame_nospatial", "send one frame for each frame, but skip spatial interlacing check", YADIF_MODE_SEND_FRAME_NOSPATIAL, "mode"),
203  CONST("send_field_nospatial", "send one frame for each field, but skip spatial interlacing check", YADIF_MODE_SEND_FIELD_NOSPATIAL, "mode"),
204 
205  { "parity", "specify the assumed picture field parity", OFFSET(parity), AV_OPT_TYPE_INT, {.i64=YADIF_PARITY_AUTO}, -1, 1, FLAGS, "parity" },
206  CONST("tff", "assume top field first", YADIF_PARITY_TFF, "parity"),
207  CONST("bff", "assume bottom field first", YADIF_PARITY_BFF, "parity"),
208  CONST("auto", "auto detect parity", YADIF_PARITY_AUTO, "parity"),
209 
210  { "deint", "specify which frames to deinterlace", OFFSET(deint), AV_OPT_TYPE_INT, {.i64=YADIF_DEINT_ALL}, 0, 1, FLAGS, "deint" },
211  CONST("all", "deinterlace all frames", YADIF_DEINT_ALL, "deint"),
212  CONST("interlaced", "only deinterlace frames marked as interlaced", YADIF_DEINT_INTERLACED, "deint"),
213 
214  { NULL }
215 };
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:101
ff_yadif_request_frame
int ff_yadif_request_frame(AVFilterLink *link)
Definition: yadif_common.c:159
YADIF_MODE_SEND_FIELD
@ YADIF_MODE_SEND_FIELD
send 1 frame for each field
Definition: yadif.h:28
YADIFContext::parity
int parity
YADIFParity.
Definition: yadif.h:54
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
YADIFContext::frame_pending
int frame_pending
Definition: yadif.h:57
ff_filter_frame
int ff_filter_frame(AVFilterLink *link, AVFrame *frame)
Send a frame of data to the next filter.
Definition: avfilter.c:969
AVERROR_EOF
#define AVERROR_EOF
End of file.
Definition: error.h:57
YADIFContext::csp
const AVPixFmtDescriptor * csp
Definition: yadif.h:75
av_frame_free
void av_frame_free(AVFrame **frame)
Free the frame and any dynamically allocated objects in it, e.g.
Definition: frame.c:99
YADIFContext::mode
int mode
YADIFMode.
Definition: yadif.h:53
AVFrame
This structure describes decoded (raw) audio or video data.
Definition: frame.h:330
AVFrame::pts
int64_t pts
Presentation timestamp in time_base units (time when frame should be shown to user).
Definition: frame.h:437
AVFrame::width
int width
Definition: frame.h:402
FLAGS
#define FLAGS
Definition: yadif_common.c:194
AVFrame::top_field_first
int top_field_first
If the content is interlaced, is top field displayed first.
Definition: frame.h:491
AVOption
AVOption.
Definition: opt.h:251
b
#define b
Definition: input.c:41
ff_request_frame
int ff_request_frame(AVFilterLink *link)
Request an input frame from the filter at the other end of the link.
Definition: avfilter.c:415
AV_LOG_VERBOSE
#define AV_LOG_VERBOSE
Detailed information.
Definition: log.h:196
AVFrame::data
uint8_t * data[AV_NUM_DATA_POINTERS]
pointer to the picture/channel planes.
Definition: frame.h:351
YADIF_MODE_SEND_FRAME
@ YADIF_MODE_SEND_FRAME
send 1 frame for each frame
Definition: yadif.h:27
YADIF_MODE_SEND_FIELD_NOSPATIAL
@ YADIF_MODE_SEND_FIELD_NOSPATIAL
send 1 frame for each field but skips spatial interlacing check
Definition: yadif.h:30
ff_default_get_video_buffer
AVFrame * ff_default_get_video_buffer(AVFilterLink *link, int w, int h)
Definition: video.c:96
YADIF_PARITY_AUTO
@ YADIF_PARITY_AUTO
auto detection
Definition: yadif.h:36
YADIFContext::deint
int deint
YADIFDeint.
Definition: yadif.h:55
YADIF_MODE_SEND_FRAME_NOSPATIAL
@ YADIF_MODE_SEND_FRAME_NOSPATIAL
send 1 frame for each frame but skips spatial interlacing check
Definition: yadif.h:29
avassert.h
AV_LOG_ERROR
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
Definition: log.h:180
av_assert0
#define av_assert0(cond)
assert() equivalent, that is always enabled.
Definition: avassert.h:37
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:465
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
NULL
#define NULL
Definition: coverity.c:32
av_frame_copy_props
int av_frame_copy_props(AVFrame *dst, const AVFrame *src)
Copy only "metadata" fields from src to dst.
Definition: frame.c:594
CONST
#define CONST(name, help, val, unit)
Definition: yadif_common.c:196
AVPixFmtDescriptor::nb_components
uint8_t nb_components
The number of components each pixel has, (1-4)
Definition: pixdesc.h:71
YADIFContext::eof
int eof
Definition: yadif.h:76
yadif.h
f
f
Definition: af_crystalizer.c:122
checkstride
static int checkstride(YADIFContext *yadif, const AVFrame *a, const AVFrame *b)
Definition: yadif_common.c:69
AV_NOPTS_VALUE
#define AV_NOPTS_VALUE
Undefined timestamp value.
Definition: avutil.h:248
YADIFContext::out
AVFrame * out
Definition: yadif.h:62
YADIFContext::filter
void(* filter)(AVFilterContext *ctx, AVFrame *dstpic, int parity, int tff)
Definition: yadif.h:64
parity
mcdeint parity
Definition: vf_mcdeint.c:266
AVFrame::format
int format
format of the frame, -1 if unknown or unset Values correspond to enum AVPixelFormat for video frames,...
Definition: frame.h:417
a
The reader does not expect b to be semantically here and if the code is changed by maybe adding a a division or other the signedness will almost certainly be mistaken To avoid this confusion a new type was SUINT is the C unsigned type but it holds a signed int to use the same example SUINT a
Definition: undefined.txt:41
YADIFContext::prev
AVFrame * prev
Definition: yadif.h:61
OFFSET
#define OFFSET(x)
Definition: yadif_common.c:193
internal.h
fixstride
static void fixstride(AVFilterLink *link, AVFrame *f)
Definition: yadif_common.c:78
AVFrame::interlaced_frame
int interlaced_frame
The content of the picture is interlaced.
Definition: frame.h:486
i
#define i(width, name, range_min, range_max)
Definition: cbs_h2645.c:269
YADIFContext
Definition: yadif.h:50
av_frame_move_ref
void av_frame_move_ref(AVFrame *dst, AVFrame *src)
Move everything contained in src to dst and reset src.
Definition: frame.c:507
av_frame_unref
void av_frame_unref(AVFrame *frame)
Unreference all the buffers referenced by frame and reset the frame fields.
Definition: frame.c:478
ff_yadif_options
const AVOption ff_yadif_options[]
Definition: yadif_common.c:198
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
YADIF_DEINT_ALL
@ YADIF_DEINT_ALL
deinterlace all frames
Definition: yadif.h:40
AVFrame::height
int height
Definition: frame.h:402
av_image_copy
void av_image_copy(uint8_t *dst_data[4], int dst_linesizes[4], const uint8_t *src_data[4], const int src_linesizes[4], enum AVPixelFormat pix_fmt, int width, int height)
Copy image in src_data to dst_data.
Definition: imgutils.c:422
YADIFContext::next
AVFrame * next
Definition: yadif.h:60
YADIF_FIELD_END
@ YADIF_FIELD_END
The first or last field in a sequence.
Definition: yadif.h:46
mode
mode
Definition: ebur128.h:83
AV_OPT_TYPE_INT
@ AV_OPT_TYPE_INT
Definition: opt.h:225
AVFilterContext
An instance of a filter.
Definition: avfilter.h:392
YADIF_DEINT_INTERLACED
@ YADIF_DEINT_INTERLACED
only deinterlace frames marked as interlaced
Definition: yadif.h:41
YADIF_FIELD_BACK_END
@ YADIF_FIELD_BACK_END
The last frame in a sequence.
Definition: yadif.h:45
YADIF_PARITY_TFF
@ YADIF_PARITY_TFF
top field first
Definition: yadif.h:34
YADIFContext::current_field
int current_field
YADIFCurrentField.
Definition: yadif.h:86
imgutils.h
AVFrame::linesize
int linesize[AV_NUM_DATA_POINTERS]
For video, a positive or negative value, which is typically indicating the size in bytes of each pict...
Definition: frame.h:375
av_log
#define av_log(a,...)
Definition: tableprint_vlc.h:27
YADIFContext::cur
AVFrame * cur
Definition: yadif.h:59
return_frame
static int return_frame(AVFilterContext *ctx, int is_second)
Definition: yadif_common.c:27
AVFrame::repeat_pict
int repeat_pict
When decoding, this signals how much the picture must be delayed.
Definition: frame.h:481
ff_yadif_filter_frame
int ff_yadif_filter_frame(AVFilterLink *link, AVFrame *frame)
Definition: yadif_common.c:92
YADIF_PARITY_BFF
@ YADIF_PARITY_BFF
bottom field first
Definition: yadif.h:35
Generated on Tue Feb 28 2023 21:34:01 for FFmpeg by   doxygen 1.8.17