2 * Copyright (c) 2007 Bobby Bingham
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 Lesser General Public
8 * License as published by the Free Software Foundation; either
9 * version 2.1 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 GNU
14 * Lesser General Public License for more details.
16 * You should have received a copy of the GNU Lesser General Public
17 * License along with FFmpeg; if not, write to the Free Software
18 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
32 #include "libavutil/eval.h"
33 #include "libavutil/avstring.h"
34 #include "libavutil/internal.h"
35 #include "libavutil/libm.h"
36 #include "libavutil/imgutils.h"
37 #include "libavutil/mathematics.h"
38 #include "libavutil/opt.h"
40 static const char *const var_names[] = {
41 "in_w", "iw", ///< width of the input video
42 "in_h", "ih", ///< height of the input video
43 "out_w", "ow", ///< width of the cropped video
44 "out_h", "oh", ///< height of the cropped video
52 "n", ///< number of frame
54 "pos", ///< position in the file
56 "t", ///< timestamp expressed in seconds
80 typedef struct CropContext {
82 int x; ///< x offset of the non-cropped area with respect to the input area
83 int y; ///< y offset of the non-cropped area with respect to the input area
84 int w; ///< width of the cropped area
85 int h; ///< height of the cropped area
87 AVRational out_sar; ///< output sample aspect ratio
88 int keep_aspect; ///< keep display aspect ratio when cropping
89 int exact; ///< exact cropping, for subsampled formats
91 int max_step[4]; ///< max pixel step for each plane, expressed as a number of bytes
92 int hsub, vsub; ///< chroma subsampling
93 char *x_expr, *y_expr, *w_expr, *h_expr;
94 AVExpr *x_pexpr, *y_pexpr; /* parsed expressions for x and y */
95 double var_values[VAR_VARS_NB];
98 static int query_formats(AVFilterContext *ctx)
100 int reject_flags = AV_PIX_FMT_FLAG_BITSTREAM | FF_PIX_FMT_FLAG_SW_FLAT_SUB;
102 return ff_set_common_formats(ctx, ff_formats_pixdesc_filter(0, reject_flags));
105 static av_cold void uninit(AVFilterContext *ctx)
107 CropContext *s = ctx->priv;
109 av_expr_free(s->x_pexpr);
111 av_expr_free(s->y_pexpr);
115 static inline int normalize_double(int *n, double d)
120 ret = AVERROR(EINVAL);
121 } else if (d > INT_MAX || d < INT_MIN) {
122 *n = d > INT_MAX ? INT_MAX : INT_MIN;
123 ret = AVERROR(EINVAL);
130 static int config_input(AVFilterLink *link)
132 AVFilterContext *ctx = link->dst;
133 CropContext *s = ctx->priv;
134 const AVPixFmtDescriptor *pix_desc = av_pix_fmt_desc_get(link->format);
139 s->var_values[VAR_IN_W] = s->var_values[VAR_IW] = ctx->inputs[0]->w;
140 s->var_values[VAR_IN_H] = s->var_values[VAR_IH] = ctx->inputs[0]->h;
141 s->var_values[VAR_A] = (float) link->w / link->h;
142 s->var_values[VAR_SAR] = link->sample_aspect_ratio.num ? av_q2d(link->sample_aspect_ratio) : 1;
143 s->var_values[VAR_DAR] = s->var_values[VAR_A] * s->var_values[VAR_SAR];
144 s->var_values[VAR_HSUB] = 1<<pix_desc->log2_chroma_w;
145 s->var_values[VAR_VSUB] = 1<<pix_desc->log2_chroma_h;
146 s->var_values[VAR_X] = NAN;
147 s->var_values[VAR_Y] = NAN;
148 s->var_values[VAR_OUT_W] = s->var_values[VAR_OW] = NAN;
149 s->var_values[VAR_OUT_H] = s->var_values[VAR_OH] = NAN;
150 s->var_values[VAR_N] = 0;
151 s->var_values[VAR_T] = NAN;
153 s->var_values[VAR_POS] = NAN;
156 av_image_fill_max_pixsteps(s->max_step, NULL, pix_desc);
158 if (pix_desc->flags & AV_PIX_FMT_FLAG_HWACCEL) {
162 s->hsub = pix_desc->log2_chroma_w;
163 s->vsub = pix_desc->log2_chroma_h;
166 av_expr_parse_and_eval(&res, (expr = s->w_expr),
167 var_names, s->var_values,
168 NULL, NULL, NULL, NULL, NULL, 0, ctx);
169 s->var_values[VAR_OUT_W] = s->var_values[VAR_OW] = res;
170 if ((ret = av_expr_parse_and_eval(&res, (expr = s->h_expr),
171 var_names, s->var_values,
172 NULL, NULL, NULL, NULL, NULL, 0, ctx)) < 0)
174 s->var_values[VAR_OUT_H] = s->var_values[VAR_OH] = res;
175 /* evaluate again ow as it may depend on oh */
176 if ((ret = av_expr_parse_and_eval(&res, (expr = s->w_expr),
177 var_names, s->var_values,
178 NULL, NULL, NULL, NULL, NULL, 0, ctx)) < 0)
181 s->var_values[VAR_OUT_W] = s->var_values[VAR_OW] = res;
182 if (normalize_double(&s->w, s->var_values[VAR_OUT_W]) < 0 ||
183 normalize_double(&s->h, s->var_values[VAR_OUT_H]) < 0) {
184 av_log(ctx, AV_LOG_ERROR,
185 "Too big value or invalid expression for out_w/ow or out_h/oh. "
186 "Maybe the expression for out_w:'%s' or for out_h:'%s' is self-referencing.\n",
187 s->w_expr, s->h_expr);
188 return AVERROR(EINVAL);
192 s->w &= ~((1 << s->hsub) - 1);
193 s->h &= ~((1 << s->vsub) - 1);
196 av_expr_free(s->x_pexpr);
197 av_expr_free(s->y_pexpr);
198 s->x_pexpr = s->y_pexpr = NULL;
199 if ((ret = av_expr_parse(&s->x_pexpr, s->x_expr, var_names,
200 NULL, NULL, NULL, NULL, 0, ctx)) < 0 ||
201 (ret = av_expr_parse(&s->y_pexpr, s->y_expr, var_names,
202 NULL, NULL, NULL, NULL, 0, ctx)) < 0)
203 return AVERROR(EINVAL);
205 if (s->keep_aspect) {
206 AVRational dar = av_mul_q(link->sample_aspect_ratio,
207 (AVRational){ link->w, link->h });
208 av_reduce(&s->out_sar.num, &s->out_sar.den,
209 dar.num * s->h, dar.den * s->w, INT_MAX);
211 s->out_sar = link->sample_aspect_ratio;
213 av_log(ctx, AV_LOG_VERBOSE, "w:%d h:%d sar:%d/%d -> w:%d h:%d sar:%d/%d\n",
214 link->w, link->h, link->sample_aspect_ratio.num, link->sample_aspect_ratio.den,
215 s->w, s->h, s->out_sar.num, s->out_sar.den);
217 if (s->w <= 0 || s->h <= 0 ||
218 s->w > link->w || s->h > link->h) {
219 av_log(ctx, AV_LOG_ERROR,
220 "Invalid too big or non positive size for width '%d' or height '%d'\n",
222 return AVERROR(EINVAL);
225 /* set default, required in the case the first computed value for x/y is NAN */
226 s->x = (link->w - s->w) / 2;
227 s->y = (link->h - s->h) / 2;
229 s->x &= ~((1 << s->hsub) - 1);
230 s->y &= ~((1 << s->vsub) - 1);
235 av_log(ctx, AV_LOG_ERROR, "Error when evaluating the expression '%s'\n", expr);
239 static int config_output(AVFilterLink *link)
241 CropContext *s = link->src->priv;
242 const AVPixFmtDescriptor *desc = av_pix_fmt_desc_get(link->format);
244 if (desc->flags & AV_PIX_FMT_FLAG_HWACCEL) {
245 // Hardware frames adjust the cropping regions rather than
246 // changing the frame size.
251 link->sample_aspect_ratio = s->out_sar;
256 static int filter_frame(AVFilterLink *link, AVFrame *frame)
258 AVFilterContext *ctx = link->dst;
259 CropContext *s = ctx->priv;
260 const AVPixFmtDescriptor *desc = av_pix_fmt_desc_get(link->format);
263 s->var_values[VAR_N] = link->frame_count_out;
264 s->var_values[VAR_T] = frame->pts == AV_NOPTS_VALUE ?
265 NAN : frame->pts * av_q2d(link->time_base);
267 FF_DISABLE_DEPRECATION_WARNINGS
268 s->var_values[VAR_POS] = frame->pkt_pos == -1 ?
269 NAN : frame->pkt_pos;
270 FF_ENABLE_DEPRECATION_WARNINGS
272 s->var_values[VAR_X] = av_expr_eval(s->x_pexpr, s->var_values, NULL);
273 s->var_values[VAR_Y] = av_expr_eval(s->y_pexpr, s->var_values, NULL);
274 /* It is necessary if x is expressed from y */
275 s->var_values[VAR_X] = av_expr_eval(s->x_pexpr, s->var_values, NULL);
277 normalize_double(&s->x, s->var_values[VAR_X]);
278 normalize_double(&s->y, s->var_values[VAR_Y]);
284 if ((unsigned)s->x + (unsigned)s->w > link->w)
285 s->x = link->w - s->w;
286 if ((unsigned)s->y + (unsigned)s->h > link->h)
287 s->y = link->h - s->h;
289 s->x &= ~((1 << s->hsub) - 1);
290 s->y &= ~((1 << s->vsub) - 1);
293 av_log(ctx, AV_LOG_TRACE, "n:%d t:%f x:%d y:%d x+w:%d y+h:%d\n",
294 (int)s->var_values[VAR_N], s->var_values[VAR_T],
295 s->x, s->y, s->x+s->w, s->y+s->h);
297 if (desc->flags & AV_PIX_FMT_FLAG_HWACCEL) {
298 frame->crop_top += s->y;
299 frame->crop_left += s->x;
300 frame->crop_bottom = frame->height - frame->crop_top - frame->crop_bottom - s->h;
301 frame->crop_right = frame->width - frame->crop_left - frame->crop_right - s->w;
304 frame->height = s->h;
306 frame->data[0] += s->y * frame->linesize[0];
307 frame->data[0] += s->x * s->max_step[0];
309 if (!(desc->flags & AV_PIX_FMT_FLAG_PAL)) {
310 for (i = 1; i < 3; i ++) {
311 if (frame->data[i]) {
312 frame->data[i] += (s->y >> s->vsub) * frame->linesize[i];
313 frame->data[i] += (s->x * s->max_step[i]) >> s->hsub;
319 if (frame->data[3]) {
320 frame->data[3] += s->y * frame->linesize[3];
321 frame->data[3] += s->x * s->max_step[3];
325 return ff_filter_frame(link->dst->outputs[0], frame);
328 static int process_command(AVFilterContext *ctx, const char *cmd, const char *args,
329 char *res, int res_len, int flags)
331 CropContext *s = ctx->priv;
334 if ( !strcmp(cmd, "out_w") || !strcmp(cmd, "w")
335 || !strcmp(cmd, "out_h") || !strcmp(cmd, "h")
336 || !strcmp(cmd, "x") || !strcmp(cmd, "y")) {
343 AVFilterLink *outlink = ctx->outputs[0];
344 AVFilterLink *inlink = ctx->inputs[0];
346 av_opt_set(s, cmd, args, 0);
348 if ((ret = config_input(inlink)) < 0) {
356 ret = config_output(outlink);
359 ret = AVERROR(ENOSYS);
364 #define OFFSET(x) offsetof(CropContext, x)
365 #define FLAGS AV_OPT_FLAG_FILTERING_PARAM|AV_OPT_FLAG_VIDEO_PARAM
366 #define TFLAGS AV_OPT_FLAG_FILTERING_PARAM|AV_OPT_FLAG_VIDEO_PARAM|AV_OPT_FLAG_RUNTIME_PARAM
368 static const AVOption crop_options[] = {
369 { "out_w", "set the width crop area expression", OFFSET(w_expr), AV_OPT_TYPE_STRING, {.str = "iw"}, 0, 0, TFLAGS },
370 { "w", "set the width crop area expression", OFFSET(w_expr), AV_OPT_TYPE_STRING, {.str = "iw"}, 0, 0, TFLAGS },
371 { "out_h", "set the height crop area expression", OFFSET(h_expr), AV_OPT_TYPE_STRING, {.str = "ih"}, 0, 0, TFLAGS },
372 { "h", "set the height crop area expression", OFFSET(h_expr), AV_OPT_TYPE_STRING, {.str = "ih"}, 0, 0, TFLAGS },
373 { "x", "set the x crop area expression", OFFSET(x_expr), AV_OPT_TYPE_STRING, {.str = "(in_w-out_w)/2"}, 0, 0, TFLAGS },
374 { "y", "set the y crop area expression", OFFSET(y_expr), AV_OPT_TYPE_STRING, {.str = "(in_h-out_h)/2"}, 0, 0, TFLAGS },
375 { "keep_aspect", "keep aspect ratio", OFFSET(keep_aspect), AV_OPT_TYPE_BOOL, {.i64=0}, 0, 1, FLAGS },
376 { "exact", "do exact cropping", OFFSET(exact), AV_OPT_TYPE_BOOL, {.i64=0}, 0, 1, FLAGS },
380 AVFILTER_DEFINE_CLASS(crop);
382 static const AVFilterPad avfilter_vf_crop_inputs[] = {
385 .type = AVMEDIA_TYPE_VIDEO,
386 .filter_frame = filter_frame,
387 .config_props = config_input,
391 static const AVFilterPad avfilter_vf_crop_outputs[] = {
394 .type = AVMEDIA_TYPE_VIDEO,
395 .config_props = config_output,
399 const AVFilter ff_vf_crop = {
401 .description = NULL_IF_CONFIG_SMALL("Crop the input video."),
402 .priv_size = sizeof(CropContext),
403 .priv_class = &crop_class,
405 FILTER_INPUTS(avfilter_vf_crop_inputs),
406 FILTER_OUTPUTS(avfilter_vf_crop_outputs),
407 FILTER_QUERY_FUNC(query_formats),
408 .process_command = process_command,