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] = AV_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;
122 mode = new->interlaced_frame ? new->top_field_first ?
123 TOP_FIRST : BOTTOM_FIRST : PROGRESSIVE;
124 } else if (mode == AUTO_ANALYZE) {
125 mode = new->interlaced_frame ? new->top_field_first ?
126 TOP_FIRST_ANALYZE : BOTTOM_FIRST_ANALYZE : FULL_ANALYZE;
129 if (mode <= BOTTOM_FIRST) {
130 bdiff = pdiff = tdiff = 65536.0;
132 const int ns = new->linesize[0];
133 const int os = old->linesize[0];
134 const uint8_t *nptr = new->data[0];
135 const uint8_t *optr = old->data[0];
136 const int h = new->height;
137 const int w = new->width;
138 int bdif, tdif, pdif;
142 const uint8_t *rend, *end = nptr + (h - 2) * ns;
144 bdiff = pdiff = tdiff = 0.0;
149 pdif = tdif = bdif = 0;
152 case TOP_FIRST_ANALYZE:
154 for (rend = nptr + w; nptr < rend; nptr++, optr++) {
155 pdif += DIFF(nptr, ns, nptr, ns);
156 tdif += DIFF(nptr, ns, optr, os);
159 for (rend = nptr + w; nptr < rend; nptr++, optr++) {
160 pdif += DIFF(nptr, ns, nptr, ns);
161 tdif += DIFF(optr, os, nptr, ns);
165 case BOTTOM_FIRST_ANALYZE:
167 for (rend = nptr + w; nptr < rend; nptr++, optr++) {
168 pdif += DIFF(nptr, ns, nptr, ns);
169 bdif += DIFF(optr, os, nptr, ns);
172 for (rend = nptr + w; nptr < rend; nptr++, optr++) {
173 pdif += DIFF(nptr, ns, nptr, ns);
174 bdif += DIFF(nptr, ns, optr, os);
180 for (rend = nptr + w; nptr < rend; nptr++, optr++) {
181 tdif += DIFF(nptr, ns, optr, os);
182 bdif += DIFF(optr, os, nptr, ns);
185 for (rend = nptr + w; nptr < rend; nptr++, optr++) {
186 bdif += DIFF(nptr, ns, optr, os);
187 tdif += DIFF(optr, os, nptr, ns);
193 for (rend = nptr + w; nptr < rend; nptr++, optr++) {
194 pdif += DIFF(nptr, ns, nptr, ns);
195 tdif += DIFF(nptr, ns, optr, os);
196 bdif += DIFF(optr, os, nptr, ns);
199 for (rend = nptr + w; nptr < rend; nptr++, optr++) {
200 pdif += DIFF(nptr, ns, nptr, ns);
201 bdif += DIFF(nptr, ns, optr, os);
202 tdif += DIFF(optr, os, nptr, ns);
210 pdiff += (double)pdif;
211 tdiff += (double)tdif;
212 bdiff += (double)bdif;
218 scale = 1.0 / (w * (h - 3)) / 25.0;
223 if (mode == TOP_FIRST_ANALYZE) {
225 } else if (mode == BOTTOM_FIRST_ANALYZE) {
227 } else if (mode == ANALYZE) {
231 if (bdiff < pdiff && bdiff < tdiff) {
233 } else if (tdiff < pdiff && tdiff < bdiff) {
240 av_log(ctx, AV_LOG_DEBUG, "mode=%c tdiff=%f bdiff=%f pdiff=%f\n",
241 mode == BOTTOM_FIRST ? 'b' : mode == TOP_FIRST ? 't' : 'p',
242 tdiff, bdiff, pdiff);
246 static int filter_frame(AVFilterLink *inlink, AVFrame *in)
248 AVFilterContext *ctx = inlink->dst;
249 AVFilterLink *outlink = ctx->outputs[0];
250 PhaseContext *s = ctx->priv;
255 if (ctx->is_disabled) {
256 av_frame_free(&s->frame);
257 /* we keep a reference to the previous frame so the filter can start
258 * being useful as soon as it's not disabled, avoiding the 1-frame
260 s->frame = av_frame_clone(in);
261 return ff_filter_frame(outlink, in);
264 out = ff_get_video_buffer(outlink, outlink->w, outlink->h);
267 return AVERROR(ENOMEM);
269 av_frame_copy_props(out, in);
275 mode = analyze_plane(ctx, s->mode, s->frame, in);
278 for (plane = 0; plane < s->nb_planes; plane++) {
279 const uint8_t *buf = s->frame->data[plane];
280 const uint8_t *from = in->data[plane];
281 uint8_t *to = out->data[plane];
283 for (y = 0, top = 1; y < s->planeheight[plane]; y++, top ^= 1) {
284 memcpy(to, mode == (top ? BOTTOM_FIRST : TOP_FIRST) ? buf : from, s->linesize[plane]);
286 buf += s->frame->linesize[plane];
287 from += in->linesize[plane];
288 to += out->linesize[plane];
293 av_frame_free(&s->frame);
295 return ff_filter_frame(outlink, out);
298 static av_cold void uninit(AVFilterContext *ctx)
300 PhaseContext *s = ctx->priv;
302 av_frame_free(&s->frame);
305 static const AVFilterPad phase_inputs[] = {
308 .type = AVMEDIA_TYPE_VIDEO,
309 .filter_frame = filter_frame,
310 .config_props = config_input,
315 static const AVFilterPad phase_outputs[] = {
318 .type = AVMEDIA_TYPE_VIDEO,
323 AVFilter ff_vf_phase = {
325 .description = NULL_IF_CONFIG_SMALL("Phase shift fields."),
326 .priv_size = sizeof(PhaseContext),
327 .priv_class = &phase_class,
329 .query_formats = query_formats,
330 .inputs = phase_inputs,
331 .outputs = phase_outputs,
332 .flags = AVFILTER_FLAG_SUPPORT_TIMELINE_INTERNAL,