libavfilter/vf_tinterlace.c
8fb03b4d
 /*
  * Copyright (c) 2011 Stefano Sabatini
  * Copyright (c) 2010 Baptiste Coudurier
  * Copyright (c) 2003 Michael Zucchi <notzed@ximian.com>
  *
  * This file is part of FFmpeg.
  *
  * FFmpeg is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation; either version 2 of the License, or
  * (at your option) any later version.
  *
  * FFmpeg is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
  *
  * You should have received a copy of the GNU General Public License along
  * with FFmpeg if not, write to the Free Software Foundation, Inc.,
  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  */
 
 /**
  * @file
  * temporal field interlace filter, ported from MPlayer/libmpcodecs
  */
 
 #include "libavutil/imgutils.h"
 #include "avfilter.h"
 #include "internal.h"
 
 typedef struct {
     int mode;                   ///< interlace mode selected
     int frame;                  ///< number of the output frame
     int vsub;                   ///< chroma vertical subsampling
     AVFilterBufferRef *cur;
     AVFilterBufferRef *next;
     uint8_t *black_data[4];     ///< buffer used to fill padded lines
     int black_linesize[4];
 } TInterlaceContext;
 
 #define FULL_SCALE_YUVJ_FORMATS \
     PIX_FMT_YUVJ420P, PIX_FMT_YUVJ422P, PIX_FMT_YUVJ444P, PIX_FMT_YUVJ440P
 
 static enum PixelFormat full_scale_yuvj_pix_fmts[] = {
     FULL_SCALE_YUVJ_FORMATS, PIX_FMT_NONE
 };
 
 static int query_formats(AVFilterContext *ctx)
 {
     static const enum PixelFormat pix_fmts[] = {
         PIX_FMT_YUV420P,  PIX_FMT_YUV422P,  PIX_FMT_YUV444P,
         PIX_FMT_YUV444P,  PIX_FMT_YUV410P,  PIX_FMT_YUVA420P,
         PIX_FMT_GRAY8, FULL_SCALE_YUVJ_FORMATS,
         PIX_FMT_NONE
     };
 
     avfilter_set_common_pixel_formats(ctx, avfilter_make_format_list(pix_fmts));
     return 0;
 }
 
 static av_cold int init(AVFilterContext *ctx, const char *args, void *opaque)
 {
     TInterlaceContext *tinterlace = ctx->priv;
     int n;
     tinterlace->mode = 0;
 
     if (args) {
         n = sscanf(args, "%d", &tinterlace->mode);
 
42a8ac94
         if (n != 1 || tinterlace->mode < 0 || tinterlace->mode > 5) {
8fb03b4d
             av_log(ctx, AV_LOG_ERROR,
42a8ac94
                    "Invalid mode '%s', use an integer between 0 and 5\n", args);
8fb03b4d
             return AVERROR(EINVAL);
         }
     }
 
     return 0;
 }
 
 static av_cold void uninit(AVFilterContext *ctx)
 {
     TInterlaceContext *tinterlace = ctx->priv;
 
     if (tinterlace->cur ) avfilter_unref_buffer(tinterlace->cur );
     if (tinterlace->next) avfilter_unref_buffer(tinterlace->next);
 
     av_freep(&tinterlace->black_data[0]);
 }
 
 static int config_out_props(AVFilterLink *outlink)
 {
     AVFilterContext *ctx = outlink->src;
     AVFilterLink *inlink = outlink->src->inputs[0];
     const AVPixFmtDescriptor *desc = &av_pix_fmt_descriptors[outlink->format];
     TInterlaceContext *tinterlace = ctx->priv;
 
     tinterlace->vsub = desc->log2_chroma_h;
     outlink->w = inlink->w;
     outlink->h = tinterlace->mode == 0 || tinterlace->mode == 3 ?
         inlink->h*2 : inlink->h;
 
     if (tinterlace->mode == 3) {
         uint8_t black[4] = { 16, 128, 128, 16 };
         int i, ret;
         if (ff_fmt_is_in(outlink->format, full_scale_yuvj_pix_fmts))
             black[0] = black[3] = 0;
         ret = av_image_alloc(tinterlace->black_data, tinterlace->black_linesize,
                              outlink->w, outlink->h, outlink->format, 1);
         if (ret < 0)
             return ret;
 
         /* fill black picture with black */
         for (i = 0; i < 4 && tinterlace->black_data[i]; i++) {
             int h = i == 1 || i == 2 ? outlink->h >> desc->log2_chroma_h : outlink->h;
             memset(tinterlace->black_data[i], black[i],
                    tinterlace->black_linesize[i] * h);
         }
     }
     av_log(ctx, AV_LOG_INFO, "mode:%d h:%d -> h:%d\n",
            tinterlace->mode, inlink->h, outlink->h);
 
     return 0;
 }
 
 #define FIELD_UPPER           0
 #define FIELD_LOWER           1
 #define FIELD_UPPER_AND_LOWER 2
 
 /**
  * Copy picture field from src to dst.
  *
  * @param src_field copy from upper, lower field or both
  * @param interleave leave a padding line between each copied field
  * @param dst_field copy to upper or lower field,
  *        only meaningful when interleave is selected
  */
 static inline
 void copy_picture_field(uint8_t *dst[4], int dst_linesize[4],
                         uint8_t *src[4], int src_linesize[4],
                         enum PixelFormat format, int w, int src_h,
                         int src_field, int interleave, int dst_field)
 {
     const AVPixFmtDescriptor *desc = &av_pix_fmt_descriptors[format];
     int plane, vsub = desc->log2_chroma_h;
     int k = src_field == FIELD_UPPER_AND_LOWER ? 1 : 2;
 
     for (plane = 0; plane < desc->nb_components; plane++) {
         int lines = plane == 1 || plane == 2 ? src_h >> vsub : src_h;
         int linesize = av_image_get_linesize(format, w, plane);
         uint8_t *dstp = dst[plane];
         uint8_t *srcp = src[plane];
         lines /= k;
         if (src_field == FIELD_LOWER)
             srcp += src_linesize[plane];
         if (interleave && dst_field == FIELD_LOWER)
             dstp += dst_linesize[plane];
         av_image_copy_plane(dstp, dst_linesize[plane] * (interleave ? 2 : 1),
                             srcp, src_linesize[plane]*k, linesize, lines);
     }
 }
 
 static void start_frame(AVFilterLink *inlink, AVFilterBufferRef *picref)
 {
     AVFilterContext *ctx = inlink->dst;
     TInterlaceContext *tinterlace = ctx->priv;
 
     if (tinterlace->cur)
         avfilter_unref_buffer(tinterlace->cur);
     tinterlace->cur  = tinterlace->next;
     tinterlace->next = picref;
 }
 
 static void end_frame(AVFilterLink *inlink)
 {
     AVFilterContext *ctx = inlink->dst;
     AVFilterLink *outlink = ctx->outputs[0];
     TInterlaceContext *tinterlace = ctx->priv;
     AVFilterBufferRef *cur  = tinterlace->cur;
     AVFilterBufferRef *next = tinterlace->next;
     AVFilterBufferRef *out  = NULL;
42a8ac94
     int field, tff;
8fb03b4d
 
     /* we need at least two frames */
     if (!tinterlace->cur)
         return;
 
     switch (tinterlace->mode) {
     case 0: /* move the odd frame into the upper field of the new image, even into
              * the lower field, generating a double-height video at half framerate */
         out = avfilter_get_video_buffer(outlink, AV_PERM_WRITE, outlink->w, outlink->h);
         avfilter_copy_buffer_ref_props(out, cur);
         out->video->h = outlink->h;
         out->video->interlaced = 1;
         out->video->top_field_first = 1;
 
         /* write odd frame lines into the upper field of the new frame */
         copy_picture_field(out->data, out->linesize,
                            cur->data, cur->linesize,
                            inlink->format, inlink->w, inlink->h,
                            FIELD_UPPER_AND_LOWER, 1, FIELD_UPPER);
         /* write even frame lines into the lower field of the new frame */
         copy_picture_field(out->data, out->linesize,
                            next->data, next->linesize,
                            inlink->format, inlink->w, inlink->h,
                            FIELD_UPPER_AND_LOWER, 1, FIELD_LOWER);
         avfilter_unref_buffer(tinterlace->next);
         tinterlace->next = NULL;
         break;
 
     case 1: /* only output even frames, odd  frames are dropped; height unchanged, half framerate */
     case 2: /* only output odd  frames, even frames are dropped; height unchanged, half framerate */
         out = avfilter_ref_buffer(tinterlace->mode == 2 ? cur : next, AV_PERM_READ);
         avfilter_unref_buffer(tinterlace->next);
         tinterlace->next = NULL;
         break;
 
     case 3: /* expand each frame to double height, but pad alternate
              * lines with black; framerate unchanged */
         out = avfilter_get_video_buffer(outlink, AV_PERM_WRITE, outlink->w, outlink->h);
         avfilter_copy_buffer_ref_props(out, cur);
         out->video->h = outlink->h;
 
         field = (1 + tinterlace->frame) & 1 ? FIELD_UPPER : FIELD_LOWER;
         /* copy upper and lower fields */
         copy_picture_field(out->data, out->linesize,
                            cur->data, cur->linesize,
                            inlink->format, inlink->w, inlink->h,
                            FIELD_UPPER_AND_LOWER, 1, field);
         /* pad with black the other field */
         copy_picture_field(out->data, out->linesize,
                            tinterlace->black_data, tinterlace->black_linesize,
                            inlink->format, inlink->w, inlink->h,
                            FIELD_UPPER_AND_LOWER, 1, !field);
         break;
 
42a8ac94
         /* interleave upper/lower lines from odd frames with lower/upper lines from even frames,
          * halving the frame rate and preserving image height */
     case 4: /* top    field first */
     case 5: /* bottom field first */
         tff = tinterlace->mode == 4;
8fb03b4d
         out = avfilter_get_video_buffer(outlink, AV_PERM_WRITE, outlink->w, outlink->h);
         avfilter_copy_buffer_ref_props(out, cur);
         out->video->interlaced = 1;
42a8ac94
         out->video->top_field_first = tff;
8fb03b4d
 
42a8ac94
         /* copy upper/lower field from cur */
8fb03b4d
         copy_picture_field(out->data, out->linesize,
                            cur->data, cur->linesize,
                            inlink->format, inlink->w, inlink->h,
42a8ac94
                            tff ? FIELD_UPPER : FIELD_LOWER, 1, tff ? FIELD_UPPER : FIELD_LOWER);
         /* copy lower/upper field from next */
8fb03b4d
         copy_picture_field(out->data, out->linesize,
                            next->data, next->linesize,
                            inlink->format, inlink->w, inlink->h,
42a8ac94
                            tff ? FIELD_LOWER : FIELD_UPPER, 1, tff ? FIELD_LOWER : FIELD_UPPER);
8fb03b4d
         avfilter_unref_buffer(tinterlace->next);
         tinterlace->next = NULL;
         break;
     }
 
     avfilter_start_frame(outlink, out);
     avfilter_draw_slice(outlink, 0, outlink->h, 1);
     avfilter_end_frame(outlink);
 
     tinterlace->frame++;
 }
 
 static int poll_frame(AVFilterLink *outlink)
 {
     TInterlaceContext *tinterlace = outlink->src->priv;
     AVFilterLink *inlink = outlink->src->inputs[0];
     int ret, val;
 
     val = avfilter_poll_frame(inlink);
 
     if (val == 1 && !tinterlace->next) {
         if ((ret = avfilter_request_frame(inlink)) < 0)
             return ret;
         val = avfilter_poll_frame(inlink);
     }
     assert(tinterlace->next);
 
     return val;
 }
 
 static int request_frame(AVFilterLink *outlink)
 {
     TInterlaceContext *tinterlace = outlink->src->priv;
     AVFilterLink *inlink = outlink->src->inputs[0];
 
     do {
         int ret;
 
         if ((ret = avfilter_request_frame(inlink)) < 0)
             return ret;
     } while (!tinterlace->cur);
 
     return 0;
 }
 
 static void null_draw_slice(AVFilterLink *link, int y, int h, int slice_dir) { }
 
 AVFilter avfilter_vf_tinterlace = {
     .name          = "tinterlace",
     .description   = NULL_IF_CONFIG_SMALL("Perform temporal field interlacing."),
     .priv_size     = sizeof(TInterlaceContext),
     .init          = init,
     .uninit        = uninit,
     .query_formats = query_formats,
 
     .inputs = (const AVFilterPad[]) {
         { .name          = "default",
           .type          = AVMEDIA_TYPE_VIDEO,
           .start_frame   = start_frame,
           .draw_slice    = null_draw_slice,
           .end_frame     = end_frame, },
         { .name = NULL}
     },
     .outputs = (const AVFilterPad[]) {
         { .name          = "default",
           .type          = AVMEDIA_TYPE_VIDEO,
           .config_props  = config_out_props,
           .poll_frame    = poll_frame,
           .request_frame = request_frame },
         { .name = NULL}
     },
 };