2 * Copyright (C) 2006 Michael Niedermayer <michaelni@gmx.at>
3 * Copyright (C) 2012 Clément Bœsch <u pkh me>
5 * This file is part of FFmpeg.
7 * FFmpeg is free software; you can redistribute it and/or modify
8 * it under the terms of the GNU General Public License as published by
9 * the Free Software Foundation; either version 2 of the License, or
10 * (at your option) any later version.
12 * FFmpeg is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 * GNU General Public License for more details.
17 * You should have received a copy of the GNU General Public License along
18 * with FFmpeg; if not, write to the Free Software Foundation, Inc.,
19 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
24 * Generic equation change filter
25 * Originally written by Michael Niedermayer for the MPlayer project, and
26 * ported by Clément Bœsch for FFmpeg.
29 #include "libavutil/avassert.h"
30 #include "libavutil/avstring.h"
31 #include "libavutil/eval.h"
32 #include "libavutil/opt.h"
33 #include "libavutil/pixdesc.h"
36 typedef struct GEQContext {
38 AVExpr *e[4]; ///< expressions for each plane
39 char *expr_str[4+3]; ///< expression strings for each plane
40 AVFrame *picref; ///< current input buffer
41 int hsub, vsub; ///< chroma subsampling
42 int planes; ///< number of planes
47 enum { Y = 0, U, V, A, G, B, R };
49 #define OFFSET(x) offsetof(GEQContext, x)
50 #define FLAGS AV_OPT_FLAG_VIDEO_PARAM|AV_OPT_FLAG_FILTERING_PARAM
52 static const AVOption geq_options[] = {
53 { "lum_expr", "set luminance expression", OFFSET(expr_str[Y]), AV_OPT_TYPE_STRING, {.str=NULL}, CHAR_MIN, CHAR_MAX, FLAGS },
54 { "lum", "set luminance expression", OFFSET(expr_str[Y]), AV_OPT_TYPE_STRING, {.str=NULL}, CHAR_MIN, CHAR_MAX, FLAGS },
55 { "cb_expr", "set chroma blue expression", OFFSET(expr_str[U]), AV_OPT_TYPE_STRING, {.str=NULL}, CHAR_MIN, CHAR_MAX, FLAGS },
56 { "cb", "set chroma blue expression", OFFSET(expr_str[U]), AV_OPT_TYPE_STRING, {.str=NULL}, CHAR_MIN, CHAR_MAX, FLAGS },
57 { "cr_expr", "set chroma red expression", OFFSET(expr_str[V]), AV_OPT_TYPE_STRING, {.str=NULL}, CHAR_MIN, CHAR_MAX, FLAGS },
58 { "cr", "set chroma red expression", OFFSET(expr_str[V]), AV_OPT_TYPE_STRING, {.str=NULL}, CHAR_MIN, CHAR_MAX, FLAGS },
59 { "alpha_expr", "set alpha expression", OFFSET(expr_str[A]), AV_OPT_TYPE_STRING, {.str=NULL}, CHAR_MIN, CHAR_MAX, FLAGS },
60 { "a", "set alpha expression", OFFSET(expr_str[A]), AV_OPT_TYPE_STRING, {.str=NULL}, CHAR_MIN, CHAR_MAX, FLAGS },
61 { "red_expr", "set red expression", OFFSET(expr_str[R]), AV_OPT_TYPE_STRING, {.str=NULL}, CHAR_MIN, CHAR_MAX, FLAGS },
62 { "r", "set red expression", OFFSET(expr_str[R]), AV_OPT_TYPE_STRING, {.str=NULL}, CHAR_MIN, CHAR_MAX, FLAGS },
63 { "green_expr", "set green expression", OFFSET(expr_str[G]), AV_OPT_TYPE_STRING, {.str=NULL}, CHAR_MIN, CHAR_MAX, FLAGS },
64 { "g", "set green expression", OFFSET(expr_str[G]), AV_OPT_TYPE_STRING, {.str=NULL}, CHAR_MIN, CHAR_MAX, FLAGS },
65 { "blue_expr", "set blue expression", OFFSET(expr_str[B]), AV_OPT_TYPE_STRING, {.str=NULL}, CHAR_MIN, CHAR_MAX, FLAGS },
66 { "b", "set blue expression", OFFSET(expr_str[B]), AV_OPT_TYPE_STRING, {.str=NULL}, CHAR_MIN, CHAR_MAX, FLAGS },
70 AVFILTER_DEFINE_CLASS(geq);
72 static inline double getpix(void *priv, double x, double y, int plane)
75 GEQContext *geq = priv;
76 AVFrame *picref = geq->picref;
77 const uint8_t *src = picref->data[plane];
78 int linesize = picref->linesize[plane];
79 const int w = (plane == 1 || plane == 2) ? AV_CEIL_RSHIFT(picref->width, geq->hsub) : picref->width;
80 const int h = (plane == 1 || plane == 2) ? AV_CEIL_RSHIFT(picref->height, geq->vsub) : picref->height;
85 xi = x = av_clipf(x, 0, w - 2);
86 yi = y = av_clipf(y, 0, h - 2);
92 const uint16_t *src16 = (const uint16_t*)src;
95 return (1-y)*((1-x)*src16[xi + yi * linesize] + x*src16[xi + 1 + yi * linesize])
96 + y *((1-x)*src16[xi + (yi+1) * linesize] + x*src16[xi + 1 + (yi+1) * linesize]);
98 return (1-y)*((1-x)*src[xi + yi * linesize] + x*src[xi + 1 + yi * linesize])
99 + y *((1-x)*src[xi + (yi+1) * linesize] + x*src[xi + 1 + (yi+1) * linesize]);
103 //TODO: cubic interpolate
104 //TODO: keep the last few frames
105 static double lum(void *priv, double x, double y) { return getpix(priv, x, y, 0); }
106 static double cb(void *priv, double x, double y) { return getpix(priv, x, y, 1); }
107 static double cr(void *priv, double x, double y) { return getpix(priv, x, y, 2); }
108 static double alpha(void *priv, double x, double y) { return getpix(priv, x, y, 3); }
110 static const char *const var_names[] = { "X", "Y", "W", "H", "N", "SW", "SH", "T", NULL };
111 enum { VAR_X, VAR_Y, VAR_W, VAR_H, VAR_N, VAR_SW, VAR_SH, VAR_T, VAR_VARS_NB };
113 static av_cold int geq_init(AVFilterContext *ctx)
115 GEQContext *geq = ctx->priv;
118 if (!geq->expr_str[Y] && !geq->expr_str[G] && !geq->expr_str[B] && !geq->expr_str[R]) {
119 av_log(ctx, AV_LOG_ERROR, "A luminance or RGB expression is mandatory\n");
120 ret = AVERROR(EINVAL);
123 geq->is_rgb = !geq->expr_str[Y];
125 if ((geq->expr_str[Y] || geq->expr_str[U] || geq->expr_str[V]) && (geq->expr_str[G] || geq->expr_str[B] || geq->expr_str[R])) {
126 av_log(ctx, AV_LOG_ERROR, "Either YCbCr or RGB but not both must be specified\n");
127 ret = AVERROR(EINVAL);
131 if (!geq->expr_str[U] && !geq->expr_str[V]) {
132 /* No chroma at all: fallback on luma */
133 geq->expr_str[U] = av_strdup(geq->expr_str[Y]);
134 geq->expr_str[V] = av_strdup(geq->expr_str[Y]);
136 /* One chroma unspecified, fallback on the other */
137 if (!geq->expr_str[U]) geq->expr_str[U] = av_strdup(geq->expr_str[V]);
138 if (!geq->expr_str[V]) geq->expr_str[V] = av_strdup(geq->expr_str[U]);
141 if (!geq->expr_str[A]) {
143 snprintf(bps_string, sizeof(bps_string), "%d", (1<<geq->bps) - 1);
144 geq->expr_str[A] = av_strdup(bps_string);
146 if (!geq->expr_str[G])
147 geq->expr_str[G] = av_strdup("g(X,Y)");
148 if (!geq->expr_str[B])
149 geq->expr_str[B] = av_strdup("b(X,Y)");
150 if (!geq->expr_str[R])
151 geq->expr_str[R] = av_strdup("r(X,Y)");
154 (!geq->expr_str[G] || !geq->expr_str[B] || !geq->expr_str[R])
156 (!geq->expr_str[U] || !geq->expr_str[V] || !geq->expr_str[A])) {
157 ret = AVERROR(ENOMEM);
161 for (plane = 0; plane < 4; plane++) {
162 static double (*p[])(void *, double, double) = { lum, cb, cr, alpha };
163 static const char *const func2_yuv_names[] = { "lum", "cb", "cr", "alpha", "p", NULL };
164 static const char *const func2_rgb_names[] = { "g", "b", "r", "alpha", "p", NULL };
165 const char *const *func2_names = geq->is_rgb ? func2_rgb_names : func2_yuv_names;
166 double (*func2[])(void *, double, double) = { lum, cb, cr, alpha, p[plane], NULL };
168 ret = av_expr_parse(&geq->e[plane], geq->expr_str[plane < 3 && geq->is_rgb ? plane+4 : plane], var_names,
169 NULL, NULL, func2_names, func2, 0, ctx);
178 static int geq_query_formats(AVFilterContext *ctx)
180 GEQContext *geq = ctx->priv;
181 static const enum AVPixelFormat yuv_pix_fmts[] = {
182 AV_PIX_FMT_YUV444P, AV_PIX_FMT_YUV422P, AV_PIX_FMT_YUV420P,
183 AV_PIX_FMT_YUV411P, AV_PIX_FMT_YUV410P, AV_PIX_FMT_YUV440P,
184 AV_PIX_FMT_YUVA444P, AV_PIX_FMT_YUVA422P, AV_PIX_FMT_YUVA420P,
186 AV_PIX_FMT_YUV444P9, AV_PIX_FMT_YUV422P9, AV_PIX_FMT_YUV420P9,
187 AV_PIX_FMT_YUVA444P9, AV_PIX_FMT_YUVA422P9, AV_PIX_FMT_YUVA420P9,
188 AV_PIX_FMT_YUV444P10, AV_PIX_FMT_YUV422P10, AV_PIX_FMT_YUV420P10,
189 AV_PIX_FMT_YUV440P10,
190 AV_PIX_FMT_YUVA444P10, AV_PIX_FMT_YUVA422P10, AV_PIX_FMT_YUVA420P10,
192 AV_PIX_FMT_YUV444P12, AV_PIX_FMT_YUV422P12, AV_PIX_FMT_YUV420P12,
194 AV_PIX_FMT_YUV444P14, AV_PIX_FMT_YUV422P14, AV_PIX_FMT_YUV420P14,
195 AV_PIX_FMT_YUV444P16, AV_PIX_FMT_YUV422P16, AV_PIX_FMT_YUV420P16,
196 AV_PIX_FMT_YUVA444P16, AV_PIX_FMT_YUVA422P16, AV_PIX_FMT_YUVA420P16,
200 static const enum AVPixelFormat rgb_pix_fmts[] = {
201 AV_PIX_FMT_GBRP, AV_PIX_FMT_GBRAP,
203 AV_PIX_FMT_GBRP10, AV_PIX_FMT_GBRAP10,
204 AV_PIX_FMT_GBRP12, AV_PIX_FMT_GBRAP12,
206 AV_PIX_FMT_GBRP16, AV_PIX_FMT_GBRAP16,
209 AVFilterFormats *fmts_list;
212 fmts_list = ff_make_format_list(rgb_pix_fmts);
214 fmts_list = ff_make_format_list(yuv_pix_fmts);
216 return AVERROR(ENOMEM);
217 return ff_set_common_formats(ctx, fmts_list);
220 static int geq_config_props(AVFilterLink *inlink)
222 GEQContext *geq = inlink->dst->priv;
223 const AVPixFmtDescriptor *desc = av_pix_fmt_desc_get(inlink->format);
227 geq->hsub = desc->log2_chroma_w;
228 geq->vsub = desc->log2_chroma_h;
229 geq->planes = desc->nb_components;
230 geq->bps = desc->comp[0].depth;
235 static int geq_filter_frame(AVFilterLink *inlink, AVFrame *in)
238 GEQContext *geq = inlink->dst->priv;
239 AVFilterLink *outlink = inlink->dst->outputs[0];
241 double values[VAR_VARS_NB] = {
242 [VAR_N] = inlink->frame_count_out,
243 [VAR_T] = in->pts == AV_NOPTS_VALUE ? NAN : in->pts * av_q2d(inlink->time_base),
247 out = ff_get_video_buffer(outlink, outlink->w, outlink->h);
250 return AVERROR(ENOMEM);
252 av_frame_copy_props(out, in);
254 for (plane = 0; plane < geq->planes && out->data[plane]; plane++) {
256 uint8_t *dst = out->data[plane];
257 uint16_t *dst16 = (uint16_t*)out->data[plane];
258 const int linesize = out->linesize[plane];
259 const int w = (plane == 1 || plane == 2) ? AV_CEIL_RSHIFT(inlink->w, geq->hsub) : inlink->w;
260 const int h = (plane == 1 || plane == 2) ? AV_CEIL_RSHIFT(inlink->h, geq->vsub) : inlink->h;
264 values[VAR_SW] = w / (double)inlink->w;
265 values[VAR_SH] = h / (double)inlink->h;
267 for (y = 0; y < h; y++) {
270 for (x = 0; x < w; x++) {
272 dst16[x] = av_expr_eval(geq->e[plane], values, geq);
274 dst16 += linesize / 2;
276 for (x = 0; x < w; x++) {
278 dst[x] = av_expr_eval(geq->e[plane], values, geq);
285 av_frame_free(&geq->picref);
286 return ff_filter_frame(outlink, out);
289 static av_cold void geq_uninit(AVFilterContext *ctx)
292 GEQContext *geq = ctx->priv;
294 for (i = 0; i < FF_ARRAY_ELEMS(geq->e); i++)
295 av_expr_free(geq->e[i]);
298 static const AVFilterPad geq_inputs[] = {
301 .type = AVMEDIA_TYPE_VIDEO,
302 .config_props = geq_config_props,
303 .filter_frame = geq_filter_frame,
308 static const AVFilterPad geq_outputs[] = {
311 .type = AVMEDIA_TYPE_VIDEO,
316 AVFilter ff_vf_geq = {
318 .description = NULL_IF_CONFIG_SMALL("Apply generic equation to each pixel."),
319 .priv_size = sizeof(GEQContext),
321 .uninit = geq_uninit,
322 .query_formats = geq_query_formats,
323 .inputs = geq_inputs,
324 .outputs = geq_outputs,
325 .priv_class = &geq_class,
326 .flags = AVFILTER_FLAG_SUPPORT_TIMELINE_GENERIC,