libavfilter/vf_crop.c
190c1669
 /*
3fa77bde
  * Copyright (c) 2007 Bobby Bingham
190c1669
  *
  * This file is part of FFmpeg.
  *
  * FFmpeg is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Lesser General Public
  * License as published by the Free Software Foundation; either
  * version 2.1 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
  * Lesser General Public License for more details.
  *
  * You should have received a copy of the GNU Lesser 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
  */
 
 /**
ba87f080
  * @file
190c1669
  * video crop filter
  */
 
1d9c2dc8
 #include <stdio.h>
 
190c1669
 #include "avfilter.h"
b74a1da4
 #include "formats.h"
9d0bfc50
 #include "internal.h"
c04c533f
 #include "video.h"
75b67a8a
 #include "libavutil/eval.h"
 #include "libavutil/avstring.h"
1d9c2dc8
 #include "libavutil/internal.h"
75b67a8a
 #include "libavutil/libm.h"
7ffe76e5
 #include "libavutil/imgutils.h"
0ebcdf5c
 #include "libavutil/mathematics.h"
1e5492ff
 #include "libavutil/opt.h"
190c1669
 
b0f29db5
 static const char *const var_names[] = {
75b67a8a
     "in_w", "iw",   ///< width  of the input video
     "in_h", "ih",   ///< height of the input video
     "out_w", "ow",  ///< width  of the cropped video
     "out_h", "oh",  ///< height of the cropped video
45f9e053
     "a",
     "sar",
     "dar",
     "hsub",
     "vsub",
75b67a8a
     "x",
     "y",
     "n",            ///< number of frame
     "pos",          ///< position in the file
     "t",            ///< timestamp expressed in seconds
     NULL
 };
 
 enum var_name {
1afab338
     VAR_IN_W,  VAR_IW,
     VAR_IN_H,  VAR_IH,
     VAR_OUT_W, VAR_OW,
     VAR_OUT_H, VAR_OH,
45f9e053
     VAR_A,
     VAR_SAR,
     VAR_DAR,
     VAR_HSUB,
     VAR_VSUB,
1afab338
     VAR_X,
     VAR_Y,
     VAR_N,
1d86fe69
     VAR_POS,
1afab338
     VAR_T,
     VAR_VARS_NB
75b67a8a
 };
 
58400ac1
 typedef struct CropContext {
1e5492ff
     const AVClass *class;
190c1669
     int  x;             ///< x offset of the non-cropped area with respect to the input area
     int  y;             ///< y offset of the non-cropped area with respect to the input area
     int  w;             ///< width of the cropped area
     int  h;             ///< height of the cropped area
 
f49cb8e6
     AVRational out_sar; ///< output sample aspect ratio
     int keep_aspect;    ///< keep display aspect ratio when cropping
4d7d7480
     int exact;          ///< exact cropping, for subsampled formats
f49cb8e6
 
b59d12b1
     int max_step[4];    ///< max pixel step for each plane, expressed as a number of bytes
190c1669
     int hsub, vsub;     ///< chroma subsampling
1e5492ff
     char *x_expr, *y_expr, *w_expr, *h_expr;
75b67a8a
     AVExpr *x_pexpr, *y_pexpr;  /* parsed expressions for x and y */
1afab338
     double var_values[VAR_VARS_NB];
190c1669
 } CropContext;
 
 static int query_formats(AVFilterContext *ctx)
 {
253e1552
     AVFilterFormats *formats = NULL;
6aaac24d
     int fmt, ret;
190c1669
 
f3fdc32e
     for (fmt = 0; av_pix_fmt_desc_get(fmt); fmt++) {
253e1552
         const AVPixFmtDescriptor *desc = av_pix_fmt_desc_get(fmt);
         if (!(desc->flags & (AV_PIX_FMT_FLAG_HWACCEL | AV_PIX_FMT_FLAG_BITSTREAM)) &&
6aaac24d
             !((desc->log2_chroma_w || desc->log2_chroma_h) && !(desc->flags & AV_PIX_FMT_FLAG_PLANAR)) &&
             (ret = ff_add_format(&formats, fmt)) < 0)
             return ret;
253e1552
     }
 
a0854c08
     return ff_set_common_formats(ctx, formats);
190c1669
 }
 
75b67a8a
 static av_cold void uninit(AVFilterContext *ctx)
 {
7f839595
     CropContext *s = ctx->priv;
75b67a8a
 
7f839595
     av_expr_free(s->x_pexpr);
     s->x_pexpr = NULL;
     av_expr_free(s->y_pexpr);
     s->y_pexpr = NULL;
75b67a8a
 }
 
 static inline int normalize_double(int *n, double d)
 {
     int ret = 0;
 
     if (isnan(d)) {
         ret = AVERROR(EINVAL);
     } else if (d > INT_MAX || d < INT_MIN) {
         *n = d > INT_MAX ? INT_MAX : INT_MIN;
         ret = AVERROR(EINVAL);
     } else
2a486869
         *n = lrint(d);
75b67a8a
 
     return ret;
 }
 
190c1669
 static int config_input(AVFilterLink *link)
 {
     AVFilterContext *ctx = link->dst;
7f839595
     CropContext *s = ctx->priv;
59ee9f78
     const AVPixFmtDescriptor *pix_desc = av_pix_fmt_desc_get(link->format);
75b67a8a
     int ret;
     const char *expr;
     double res;
 
7f839595
     s->var_values[VAR_IN_W]  = s->var_values[VAR_IW] = ctx->inputs[0]->w;
     s->var_values[VAR_IN_H]  = s->var_values[VAR_IH] = ctx->inputs[0]->h;
e77647c5
     s->var_values[VAR_A]     = (float) link->w / link->h;
     s->var_values[VAR_SAR]   = link->sample_aspect_ratio.num ? av_q2d(link->sample_aspect_ratio) : 1;
     s->var_values[VAR_DAR]   = s->var_values[VAR_A] * s->var_values[VAR_SAR];
     s->var_values[VAR_HSUB]  = 1<<pix_desc->log2_chroma_w;
     s->var_values[VAR_VSUB]  = 1<<pix_desc->log2_chroma_h;
7f839595
     s->var_values[VAR_X]     = NAN;
     s->var_values[VAR_Y]     = NAN;
     s->var_values[VAR_OUT_W] = s->var_values[VAR_OW] = NAN;
     s->var_values[VAR_OUT_H] = s->var_values[VAR_OH] = NAN;
     s->var_values[VAR_N]     = 0;
     s->var_values[VAR_T]     = NAN;
e77647c5
     s->var_values[VAR_POS]   = NAN;
7f839595
 
     av_image_fill_max_pixsteps(s->max_step, NULL, pix_desc);
     s->hsub = pix_desc->log2_chroma_w;
     s->vsub = pix_desc->log2_chroma_h;
 
e77647c5
     if ((ret = av_expr_parse_and_eval(&res, (expr = s->w_expr),
7f839595
                                       var_names, s->var_values,
671563d9
                                       NULL, NULL, NULL, NULL, NULL, 0, ctx)) < 0)
         goto fail_expr;
7f839595
     s->var_values[VAR_OUT_W] = s->var_values[VAR_OW] = res;
e77647c5
     if ((ret = av_expr_parse_and_eval(&res, (expr = s->h_expr),
7f839595
                                       var_names, s->var_values,
671563d9
                                       NULL, NULL, NULL, NULL, NULL, 0, ctx)) < 0)
         goto fail_expr;
7f839595
     s->var_values[VAR_OUT_H] = s->var_values[VAR_OH] = res;
75b67a8a
     /* evaluate again ow as it may depend on oh */
e77647c5
     if ((ret = av_expr_parse_and_eval(&res, (expr = s->w_expr),
7f839595
                                       var_names, s->var_values,
671563d9
                                       NULL, NULL, NULL, NULL, NULL, 0, ctx)) < 0)
         goto fail_expr;
 
7f839595
     s->var_values[VAR_OUT_W] = s->var_values[VAR_OW] = res;
     if (normalize_double(&s->w, s->var_values[VAR_OUT_W]) < 0 ||
         normalize_double(&s->h, s->var_values[VAR_OUT_H]) < 0) {
75b67a8a
         av_log(ctx, AV_LOG_ERROR,
                "Too big value or invalid expression for out_w/ow or out_h/oh. "
                "Maybe the expression for out_w:'%s' or for out_h:'%s' is self-referencing.\n",
e77647c5
                s->w_expr, s->h_expr);
75b67a8a
         return AVERROR(EINVAL);
     }
4d7d7480
 
     if (!s->exact) {
         s->w &= ~((1 << s->hsub) - 1);
         s->h &= ~((1 << s->vsub) - 1);
     }
190c1669
 
6592cd22
     av_expr_free(s->x_pexpr);
     av_expr_free(s->y_pexpr);
     s->x_pexpr = s->y_pexpr = NULL;
7f839595
     if ((ret = av_expr_parse(&s->x_pexpr, s->x_expr, var_names,
75b67a8a
                              NULL, NULL, NULL, NULL, 0, ctx)) < 0 ||
7f839595
         (ret = av_expr_parse(&s->y_pexpr, s->y_expr, var_names,
75b67a8a
                              NULL, NULL, NULL, NULL, 0, ctx)) < 0)
         return AVERROR(EINVAL);
190c1669
 
e77647c5
     if (s->keep_aspect) {
f49cb8e6
         AVRational dar = av_mul_q(link->sample_aspect_ratio,
                                   (AVRational){ link->w, link->h });
e77647c5
         av_reduce(&s->out_sar.num, &s->out_sar.den,
                   dar.num * s->h, dar.den * s->w, INT_MAX);
f49cb8e6
     } else
e77647c5
         s->out_sar = link->sample_aspect_ratio;
f49cb8e6
 
b536e2fa
     av_log(ctx, AV_LOG_VERBOSE, "w:%d h:%d sar:%d/%d -> w:%d h:%d sar:%d/%d\n",
d9f26a0d
            link->w, link->h, link->sample_aspect_ratio.num, link->sample_aspect_ratio.den,
e77647c5
            s->w, s->h, s->out_sar.num, s->out_sar.den);
16d14d64
 
7f839595
     if (s->w <= 0 || s->h <= 0 ||
         s->w > link->w || s->h > link->h) {
190c1669
         av_log(ctx, AV_LOG_ERROR,
75b67a8a
                "Invalid too big or non positive size for width '%d' or height '%d'\n",
7f839595
                s->w, s->h);
d6bb31a4
         return AVERROR(EINVAL);
190c1669
     }
 
75b67a8a
     /* set default, required in the case the first computed value for x/y is NAN */
7f839595
     s->x = (link->w - s->w) / 2;
     s->y = (link->h - s->h) / 2;
4d7d7480
     if (!s->exact) {
         s->x &= ~((1 << s->hsub) - 1);
         s->y &= ~((1 << s->vsub) - 1);
     }
190c1669
     return 0;
75b67a8a
 
 fail_expr:
     av_log(NULL, AV_LOG_ERROR, "Error when evaluating the expression '%s'\n", expr);
     return ret;
190c1669
 }
 
 static int config_output(AVFilterLink *link)
 {
7f839595
     CropContext *s = link->src->priv;
190c1669
 
7f839595
     link->w = s->w;
     link->h = s->h;
e77647c5
     link->sample_aspect_ratio = s->out_sar;
190c1669
 
     return 0;
 }
 
7e350379
 static int filter_frame(AVFilterLink *link, AVFrame *frame)
190c1669
 {
75b67a8a
     AVFilterContext *ctx = link->dst;
7f839595
     CropContext *s = ctx->priv;
59ee9f78
     const AVPixFmtDescriptor *desc = av_pix_fmt_desc_get(link->format);
190c1669
     int i;
 
7f839595
     frame->width  = s->w;
     frame->height = s->h;
ebc8d974
 
183ce55b
     s->var_values[VAR_N] = link->frame_count_out;
7f839595
     s->var_values[VAR_T] = frame->pts == AV_NOPTS_VALUE ?
71f82c38
         NAN : frame->pts * av_q2d(link->time_base);
6af050d7
     s->var_values[VAR_POS] = frame->pkt_pos == -1 ?
         NAN : frame->pkt_pos;
7f839595
     s->var_values[VAR_X] = av_expr_eval(s->x_pexpr, s->var_values, NULL);
     s->var_values[VAR_Y] = av_expr_eval(s->y_pexpr, s->var_values, NULL);
27fe8930
     /* It is necessary if x is expressed from y  */
7f839595
     s->var_values[VAR_X] = av_expr_eval(s->x_pexpr, s->var_values, NULL);
 
     normalize_double(&s->x, s->var_values[VAR_X]);
     normalize_double(&s->y, s->var_values[VAR_Y]);
 
     if (s->x < 0)
         s->x = 0;
     if (s->y < 0)
         s->y = 0;
     if ((unsigned)s->x + (unsigned)s->w > link->w)
         s->x = link->w - s->w;
     if ((unsigned)s->y + (unsigned)s->h > link->h)
         s->y = link->h - s->h;
4d7d7480
     if (!s->exact) {
         s->x &= ~((1 << s->hsub) - 1);
         s->y &= ~((1 << s->vsub) - 1);
     }
75b67a8a
 
40d552da
     av_log(ctx, AV_LOG_TRACE, "n:%d t:%f pos:%f x:%d y:%d x+w:%d y+h:%d\n",
e77647c5
             (int)s->var_values[VAR_N], s->var_values[VAR_T], s->var_values[VAR_POS],
             s->x, s->y, s->x+s->w, s->y+s->h);
75b67a8a
 
7f839595
     frame->data[0] += s->y * frame->linesize[0];
     frame->data[0] += s->x * s->max_step[0];
190c1669
 
d6fc031c
     if (!(desc->flags & AV_PIX_FMT_FLAG_PAL || desc->flags & FF_PSEUDOPAL)) {
190c1669
         for (i = 1; i < 3; i ++) {
71f82c38
             if (frame->data[i]) {
7f839595
                 frame->data[i] += (s->y >> s->vsub) * frame->linesize[i];
                 frame->data[i] += (s->x * s->max_step[i]) >> s->hsub;
190c1669
             }
         }
     }
 
     /* alpha plane */
71f82c38
     if (frame->data[3]) {
7f839595
         frame->data[3] += s->y * frame->linesize[3];
         frame->data[3] += s->x * s->max_step[3];
190c1669
     }
 
71f82c38
     return ff_filter_frame(link->dst->outputs[0], frame);
75b67a8a
 }
 
d2b78fe6
 static int process_command(AVFilterContext *ctx, const char *cmd, const char *args,
                            char *res, int res_len, int flags)
 {
     CropContext *s = ctx->priv;
     int ret;
 
     if (   !strcmp(cmd, "out_w")  || !strcmp(cmd, "w")
         || !strcmp(cmd, "out_h")  || !strcmp(cmd, "h")
         || !strcmp(cmd, "x")      || !strcmp(cmd, "y")) {
 
         int old_x = s->x;
         int old_y = s->y;
         int old_w = s->w;
         int old_h = s->h;
 
         AVFilterLink *outlink = ctx->outputs[0];
         AVFilterLink *inlink  = ctx->inputs[0];
 
         av_opt_set(s, cmd, args, 0);
 
         if ((ret = config_input(inlink)) < 0) {
             s->x = old_x;
             s->y = old_y;
             s->w = old_w;
             s->h = old_h;
             return ret;
         }
 
         ret = config_output(outlink);
 
     } else
         ret = AVERROR(ENOSYS);
 
     return ret;
 }
 
fba0156a
 #define OFFSET(x) offsetof(CropContext, x)
200e04c7
 #define FLAGS AV_OPT_FLAG_FILTERING_PARAM|AV_OPT_FLAG_VIDEO_PARAM
 
 static const AVOption crop_options[] = {
     { "out_w",       "set the width crop area expression",   OFFSET(w_expr), AV_OPT_TYPE_STRING, {.str = "iw"}, CHAR_MIN, CHAR_MAX, FLAGS },
     { "w",           "set the width crop area expression",   OFFSET(w_expr), AV_OPT_TYPE_STRING, {.str = "iw"}, CHAR_MIN, CHAR_MAX, FLAGS },
     { "out_h",       "set the height crop area expression",  OFFSET(h_expr), AV_OPT_TYPE_STRING, {.str = "ih"}, CHAR_MIN, CHAR_MAX, FLAGS },
     { "h",           "set the height crop area expression",  OFFSET(h_expr), AV_OPT_TYPE_STRING, {.str = "ih"}, CHAR_MIN, CHAR_MAX, FLAGS },
     { "x",           "set the x crop area expression",       OFFSET(x_expr), AV_OPT_TYPE_STRING, {.str = "(in_w-out_w)/2"}, CHAR_MIN, CHAR_MAX, FLAGS },
     { "y",           "set the y crop area expression",       OFFSET(y_expr), AV_OPT_TYPE_STRING, {.str = "(in_h-out_h)/2"}, CHAR_MIN, CHAR_MAX, FLAGS },
fa83b551
     { "keep_aspect", "keep aspect ratio",                    OFFSET(keep_aspect), AV_OPT_TYPE_BOOL, {.i64=0}, 0, 1, FLAGS },
4d7d7480
     { "exact",       "do exact cropping",                    OFFSET(exact),  AV_OPT_TYPE_BOOL, {.i64=0}, 0, 1, FLAGS },
b211607b
     { NULL }
fba0156a
 };
 
200e04c7
 AVFILTER_DEFINE_CLASS(crop);
fba0156a
 
568c70e7
 static const AVFilterPad avfilter_vf_crop_inputs[] = {
     {
b211607b
         .name         = "default",
         .type         = AVMEDIA_TYPE_VIDEO,
         .filter_frame = filter_frame,
         .config_props = config_input,
568c70e7
     },
     { NULL }
 };
 
 static const AVFilterPad avfilter_vf_crop_outputs[] = {
     {
         .name         = "default",
         .type         = AVMEDIA_TYPE_VIDEO,
         .config_props = config_output,
     },
     { NULL }
 };
 
cd43ca04
 AVFilter ff_vf_crop = {
d2b78fe6
     .name            = "crop",
     .description     = NULL_IF_CONFIG_SMALL("Crop the input video."),
     .priv_size       = sizeof(CropContext),
     .priv_class      = &crop_class,
     .query_formats   = query_formats,
     .uninit          = uninit,
     .inputs          = avfilter_vf_crop_inputs,
     .outputs         = avfilter_vf_crop_outputs,
     .process_command = process_command,
190c1669
 };