2 * Copyright (c) 2004 Ville Saari
4 * This file is part of FFmpeg.
6 * FFmpeg is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU General Public
8 * License as published by the Free Software Foundation; either
9 * version 2 of the License, or (at your option) any later version.
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
14 * GNU General Public License for more details.
16 * You should have received a copy of the GNU General Public License along
17 * with FFmpeg; if not, write to the Free Software
18 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
21 #include "libavutil/avassert.h"
22 #include "libavutil/imgutils.h"
23 #include "libavutil/pixdesc.h"
24 #include "libavutil/opt.h"
42 typedef struct PhaseContext {
44 int mode; ///<PhaseMode
45 AVFrame *frame; /* previous frame */
51 #define OFFSET(x) offsetof(PhaseContext, x)
52 #define FLAGS AV_OPT_FLAG_FILTERING_PARAM|AV_OPT_FLAG_VIDEO_PARAM
53 #define CONST(name, help, val, unit) { name, help, 0, AV_OPT_TYPE_CONST, {.i64=val}, 0, 0, FLAGS, unit }
55 static const AVOption phase_options[] = {
56 { "mode", "set phase mode", OFFSET(mode), AV_OPT_TYPE_INT, {.i64=AUTO_ANALYZE}, PROGRESSIVE, AUTO_ANALYZE, FLAGS, "mode" },
57 CONST("p", "progressive", PROGRESSIVE, "mode"),
58 CONST("t", "top first", TOP_FIRST, "mode"),
59 CONST("b", "bottom first", BOTTOM_FIRST, "mode"),
60 CONST("T", "top first analyze", TOP_FIRST_ANALYZE, "mode"),
61 CONST("B", "bottom first analyze", BOTTOM_FIRST_ANALYZE, "mode"),
62 CONST("u", "analyze", ANALYZE, "mode"),
63 CONST("U", "full analyze", FULL_ANALYZE, "mode"),
64 CONST("a", "auto", AUTO, "mode"),
65 CONST("A", "auto analyze", AUTO_ANALYZE, "mode"),
69 AVFILTER_DEFINE_CLASS(phase);
71 static int query_formats(AVFilterContext *ctx)
73 static const enum AVPixelFormat pix_fmts[] = {
74 AV_PIX_FMT_YUVA444P, AV_PIX_FMT_YUVA422P, AV_PIX_FMT_YUVA420P,
75 AV_PIX_FMT_YUVJ444P, AV_PIX_FMT_YUVJ440P, AV_PIX_FMT_YUVJ422P,AV_PIX_FMT_YUVJ420P, AV_PIX_FMT_YUVJ411P,
76 AV_PIX_FMT_YUV444P, AV_PIX_FMT_YUV440P, AV_PIX_FMT_YUV422P, AV_PIX_FMT_YUV420P, AV_PIX_FMT_YUV411P, AV_PIX_FMT_YUV410P,
77 AV_PIX_FMT_GBRP, AV_PIX_FMT_GBRAP, AV_PIX_FMT_GRAY8, AV_PIX_FMT_NONE
80 AVFilterFormats *fmts_list = ff_make_format_list(pix_fmts);
82 return AVERROR(ENOMEM);
83 return ff_set_common_formats(ctx, fmts_list);
86 static int config_input(AVFilterLink *inlink)
88 PhaseContext *s = inlink->dst->priv;
89 const AVPixFmtDescriptor *desc = av_pix_fmt_desc_get(inlink->format);
92 if ((ret = av_image_fill_linesizes(s->linesize, inlink->format, inlink->w)) < 0)
95 s->planeheight[1] = s->planeheight[2] = FF_CEIL_RSHIFT(inlink->h, desc->log2_chroma_h);
96 s->planeheight[0] = s->planeheight[3] = inlink->h;
98 s->nb_planes = av_pix_fmt_count_planes(inlink->format);
104 * This macro interpolates the value of both fields at a point halfway
105 * between lines and takes the squared difference. In field resolution
106 * the point is a quarter pixel below a line in one field and a quarter
107 * pixel above a line in other.
109 * (The result is actually multiplied by 25)
111 #define DIFF(a, as, b, bs) ((t) = ((*(a) - (b)[bs]) << 2) + (a)[(as) << 1] - (b)[-(bs)], (t) * (t))
114 * Find which field combination has the smallest average squared difference
115 * between the fields.
117 static enum PhaseMode analyze_plane(void *ctx, enum PhaseMode mode, AVFrame *old, AVFrame *new)
119 double bdiff, tdiff, pdiff, scale;
120 const int ns = new->linesize[0];
121 const int os = old->linesize[0];
122 const uint8_t *nptr = new->data[0];
123 const uint8_t *optr = old->data[0];
124 const int h = new->height;
125 const int w = new->width;
126 int bdif, tdif, pdif;
129 mode = new->interlaced_frame ? new->top_field_first ?
130 TOP_FIRST : BOTTOM_FIRST : PROGRESSIVE;
131 } else if (mode == AUTO_ANALYZE) {
132 mode = new->interlaced_frame ? new->top_field_first ?
133 TOP_FIRST_ANALYZE : BOTTOM_FIRST_ANALYZE : FULL_ANALYZE;
136 if (mode <= BOTTOM_FIRST) {
137 bdiff = pdiff = tdiff = 65536.0;
140 const uint8_t *rend, *end = nptr + (h - 2) * ns;
142 bdiff = pdiff = tdiff = 0.0;
147 pdif = tdif = bdif = 0;
150 case TOP_FIRST_ANALYZE:
152 for (rend = nptr + w; nptr < rend; nptr++, optr++) {
153 pdif += DIFF(nptr, ns, nptr, ns);
154 tdif += DIFF(nptr, ns, optr, os);
157 for (rend = nptr + w; nptr < rend; nptr++, optr++) {
158 pdif += DIFF(nptr, ns, nptr, ns);
159 tdif += DIFF(optr, os, nptr, ns);
163 case BOTTOM_FIRST_ANALYZE:
165 for (rend = nptr + w; nptr < rend; nptr++, optr++) {
166 pdif += DIFF(nptr, ns, nptr, ns);
167 bdif += DIFF(optr, os, nptr, ns);
170 for (rend = nptr + w; nptr < rend; nptr++, optr++) {
171 pdif += DIFF(nptr, ns, nptr, ns);
172 bdif += DIFF(nptr, ns, optr, os);
178 for (rend = nptr + w; nptr < rend; nptr++, optr++) {
179 tdif += DIFF(nptr, ns, optr, os);
180 bdif += DIFF(optr, os, nptr, ns);
183 for (rend = nptr + w; nptr < rend; nptr++, optr++) {
184 bdif += DIFF(nptr, ns, optr, os);
185 tdif += DIFF(optr, os, nptr, ns);
191 for (rend = nptr + w; nptr < rend; nptr++, optr++) {
192 pdif += DIFF(nptr, ns, nptr, ns);
193 tdif += DIFF(nptr, ns, optr, os);
194 bdif += DIFF(optr, os, nptr, ns);
197 for (rend = nptr + w; nptr < rend; nptr++, optr++) {
198 pdif += DIFF(nptr, ns, nptr, ns);
199 bdif += DIFF(nptr, ns, optr, os);
200 tdif += DIFF(optr, os, nptr, ns);
208 pdiff += (double)pdif;
209 tdiff += (double)tdif;
210 bdiff += (double)bdif;
216 scale = 1.0 / (w * (h - 3)) / 25.0;
221 if (mode == TOP_FIRST_ANALYZE) {
223 } else if (mode == BOTTOM_FIRST_ANALYZE) {
225 } else if (mode == ANALYZE) {
229 if (bdiff < pdiff && bdiff < tdiff) {
231 } else if (tdiff < pdiff && tdiff < bdiff) {
238 av_log(ctx, AV_LOG_DEBUG, "mode=%c tdiff=%f bdiff=%f pdiff=%f\n",
239 mode == BOTTOM_FIRST ? 'b' : mode == TOP_FIRST ? 't' : 'p',
240 tdiff, bdiff, pdiff);
244 static int filter_frame(AVFilterLink *inlink, AVFrame *in)
246 AVFilterContext *ctx = inlink->dst;
247 AVFilterLink *outlink = ctx->outputs[0];
248 PhaseContext *s = ctx->priv;
253 if (ctx->is_disabled) {
254 av_frame_free(&s->frame);
255 /* we keep a reference to the previous frame so the filter can start
256 * being useful as soon as it's not disabled, avoiding the 1-frame
258 s->frame = av_frame_clone(in);
259 return ff_filter_frame(outlink, in);
262 out = ff_get_video_buffer(outlink, outlink->w, outlink->h);
265 return AVERROR(ENOMEM);
267 av_frame_copy_props(out, in);
273 mode = analyze_plane(ctx, s->mode, s->frame, in);
276 for (plane = 0; plane < s->nb_planes; plane++) {
277 const uint8_t *buf = s->frame->data[plane];
278 const uint8_t *from = in->data[plane];
279 uint8_t *to = out->data[plane];
281 for (y = 0, top = 1; y < s->planeheight[plane]; y++, top ^= 1) {
282 memcpy(to, mode == (top ? BOTTOM_FIRST : TOP_FIRST) ? buf : from, s->linesize[plane]);
284 buf += s->frame->linesize[plane];
285 from += in->linesize[plane];
286 to += out->linesize[plane];
291 av_frame_free(&s->frame);
293 return ff_filter_frame(outlink, out);
296 static av_cold void uninit(AVFilterContext *ctx)
298 PhaseContext *s = ctx->priv;
300 av_frame_free(&s->frame);
303 static const AVFilterPad phase_inputs[] = {
306 .type = AVMEDIA_TYPE_VIDEO,
307 .filter_frame = filter_frame,
308 .config_props = config_input,
313 static const AVFilterPad phase_outputs[] = {
316 .type = AVMEDIA_TYPE_VIDEO,
321 AVFilter ff_vf_phase = {
323 .description = NULL_IF_CONFIG_SMALL("Phase shift fields."),
324 .priv_size = sizeof(PhaseContext),
325 .priv_class = &phase_class,
327 .query_formats = query_formats,
328 .inputs = phase_inputs,
329 .outputs = phase_outputs,
330 .flags = AVFILTER_FLAG_SUPPORT_TIMELINE_INTERNAL,