2 * Copyright (c) 2013 Paul B Mahol
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
21 #include "libavutil/imgutils.h"
22 #include "libavutil/eval.h"
23 #include "libavutil/opt.h"
24 #include "libavutil/pixfmt.h"
26 #include "bufferqueue.h"
63 static const char *const var_names[] = { "X", "Y", "W", "H", "SW", "SH", "T", "N", "A", "B", "TOP", "BOTTOM", NULL };
64 enum { VAR_X, VAR_Y, VAR_W, VAR_H, VAR_SW, VAR_SH, VAR_T, VAR_N, VAR_A, VAR_B, VAR_TOP, VAR_BOTTOM, VAR_VARS_NB };
66 typedef struct FilterParams {
68 double values[VAR_VARS_NB];
72 void (*blend)(const uint8_t *top, int top_linesize,
73 const uint8_t *bottom, int bottom_linesize,
74 uint8_t *dst, int dst_linesize,
75 int width, int height, struct FilterParams *param);
80 struct FFBufQueue queue_top;
81 struct FFBufQueue queue_bottom;
82 int hsub, vsub; ///< chroma subsampling values
86 enum BlendMode all_mode;
89 FilterParams params[4];
92 #define OFFSET(x) offsetof(BlendContext, x)
93 #define FLAGS AV_OPT_FLAG_FILTERING_PARAM|AV_OPT_FLAG_VIDEO_PARAM
95 static const AVOption blend_options[] = {
96 { "c0_mode", "set component #0 blend mode", OFFSET(params[0].mode), AV_OPT_TYPE_INT, {.i64=0}, 0, BLEND_NB-1, FLAGS, "mode"},
97 { "c1_mode", "set component #1 blend mode", OFFSET(params[1].mode), AV_OPT_TYPE_INT, {.i64=0}, 0, BLEND_NB-1, FLAGS, "mode"},
98 { "c2_mode", "set component #2 blend mode", OFFSET(params[2].mode), AV_OPT_TYPE_INT, {.i64=0}, 0, BLEND_NB-1, FLAGS, "mode"},
99 { "c3_mode", "set component #3 blend mode", OFFSET(params[3].mode), AV_OPT_TYPE_INT, {.i64=0}, 0, BLEND_NB-1, FLAGS, "mode"},
100 { "all_mode", "set blend mode for all components", OFFSET(all_mode), AV_OPT_TYPE_INT, {.i64=-1},-1, BLEND_NB-1, FLAGS, "mode"},
101 { "addition", "", 0, AV_OPT_TYPE_CONST, {.i64=BLEND_ADDITION}, 0, 0, FLAGS, "mode" },
102 { "and", "", 0, AV_OPT_TYPE_CONST, {.i64=BLEND_AND}, 0, 0, FLAGS, "mode" },
103 { "average", "", 0, AV_OPT_TYPE_CONST, {.i64=BLEND_AVERAGE}, 0, 0, FLAGS, "mode" },
104 { "burn", "", 0, AV_OPT_TYPE_CONST, {.i64=BLEND_BURN}, 0, 0, FLAGS, "mode" },
105 { "darken", "", 0, AV_OPT_TYPE_CONST, {.i64=BLEND_DARKEN}, 0, 0, FLAGS, "mode" },
106 { "difference", "", 0, AV_OPT_TYPE_CONST, {.i64=BLEND_DIFFERENCE}, 0, 0, FLAGS, "mode" },
107 { "divide", "", 0, AV_OPT_TYPE_CONST, {.i64=BLEND_DIVIDE}, 0, 0, FLAGS, "mode" },
108 { "dodge", "", 0, AV_OPT_TYPE_CONST, {.i64=BLEND_DODGE}, 0, 0, FLAGS, "mode" },
109 { "exclusion", "", 0, AV_OPT_TYPE_CONST, {.i64=BLEND_EXCLUSION}, 0, 0, FLAGS, "mode" },
110 { "hardlight", "", 0, AV_OPT_TYPE_CONST, {.i64=BLEND_HARDLIGHT}, 0, 0, FLAGS, "mode" },
111 { "lighten", "", 0, AV_OPT_TYPE_CONST, {.i64=BLEND_LIGHTEN}, 0, 0, FLAGS, "mode" },
112 { "multiply", "", 0, AV_OPT_TYPE_CONST, {.i64=BLEND_MULTIPLY}, 0, 0, FLAGS, "mode" },
113 { "negation", "", 0, AV_OPT_TYPE_CONST, {.i64=BLEND_NEGATION}, 0, 0, FLAGS, "mode" },
114 { "normal", "", 0, AV_OPT_TYPE_CONST, {.i64=BLEND_NORMAL}, 0, 0, FLAGS, "mode" },
115 { "or", "", 0, AV_OPT_TYPE_CONST, {.i64=BLEND_OR}, 0, 0, FLAGS, "mode" },
116 { "overlay", "", 0, AV_OPT_TYPE_CONST, {.i64=BLEND_OVERLAY}, 0, 0, FLAGS, "mode" },
117 { "phoenix", "", 0, AV_OPT_TYPE_CONST, {.i64=BLEND_PHOENIX}, 0, 0, FLAGS, "mode" },
118 { "pinlight", "", 0, AV_OPT_TYPE_CONST, {.i64=BLEND_PINLIGHT}, 0, 0, FLAGS, "mode" },
119 { "reflect", "", 0, AV_OPT_TYPE_CONST, {.i64=BLEND_REFLECT}, 0, 0, FLAGS, "mode" },
120 { "screen", "", 0, AV_OPT_TYPE_CONST, {.i64=BLEND_SCREEN}, 0, 0, FLAGS, "mode" },
121 { "softlight", "", 0, AV_OPT_TYPE_CONST, {.i64=BLEND_SOFTLIGHT}, 0, 0, FLAGS, "mode" },
122 { "subtract", "", 0, AV_OPT_TYPE_CONST, {.i64=BLEND_SUBTRACT}, 0, 0, FLAGS, "mode" },
123 { "vividlight", "", 0, AV_OPT_TYPE_CONST, {.i64=BLEND_VIVIDLIGHT}, 0, 0, FLAGS, "mode" },
124 { "xor", "", 0, AV_OPT_TYPE_CONST, {.i64=BLEND_XOR}, 0, 0, FLAGS, "mode" },
125 { "c0_expr", "set color component #0 expression", OFFSET(params[0].expr_str), AV_OPT_TYPE_STRING, {.str=NULL}, CHAR_MIN, CHAR_MAX, FLAGS },
126 { "c1_expr", "set color component #1 expression", OFFSET(params[1].expr_str), AV_OPT_TYPE_STRING, {.str=NULL}, CHAR_MIN, CHAR_MAX, FLAGS },
127 { "c2_expr", "set color component #2 expression", OFFSET(params[2].expr_str), AV_OPT_TYPE_STRING, {.str=NULL}, CHAR_MIN, CHAR_MAX, FLAGS },
128 { "c3_expr", "set color component #3 expression", OFFSET(params[3].expr_str), AV_OPT_TYPE_STRING, {.str=NULL}, CHAR_MIN, CHAR_MAX, FLAGS },
129 { "all_expr", "set expression for all color components", OFFSET(all_expr), AV_OPT_TYPE_STRING, {.str=NULL}, CHAR_MIN, CHAR_MAX, FLAGS },
130 { "c0_opacity", "set color component #0 opacity", OFFSET(params[0].opacity), AV_OPT_TYPE_DOUBLE, {.dbl=1}, 0, 1, FLAGS },
131 { "c1_opacity", "set color component #1 opacity", OFFSET(params[1].opacity), AV_OPT_TYPE_DOUBLE, {.dbl=1}, 0, 1, FLAGS },
132 { "c2_opacity", "set color component #2 opacity", OFFSET(params[2].opacity), AV_OPT_TYPE_DOUBLE, {.dbl=1}, 0, 1, FLAGS },
133 { "c3_opacity", "set color component #3 opacity", OFFSET(params[3].opacity), AV_OPT_TYPE_DOUBLE, {.dbl=1}, 0, 1, FLAGS },
134 { "all_opacity", "set opacity for all color components", OFFSET(all_opacity), AV_OPT_TYPE_DOUBLE, {.dbl=1}, 0, 1, FLAGS},
138 AVFILTER_DEFINE_CLASS(blend);
140 static void blend_normal(const uint8_t *top, int top_linesize,
141 const uint8_t *bottom, int bottom_linesize,
142 uint8_t *dst, int dst_linesize,
143 int width, int height, FilterParams *param)
145 av_image_copy_plane(dst, dst_linesize, top, top_linesize, width, height);
148 #define DEFINE_BLEND(name, expr) \
149 static void blend_## name(const uint8_t *top, int top_linesize, \
150 const uint8_t *bottom, int bottom_linesize, \
151 uint8_t *dst, int dst_linesize, \
152 int width, int height, FilterParams *param) \
154 double opacity = param->opacity; \
157 for (i = 0; i < height; i++) { \
158 for (j = 0; j < width; j++) { \
159 dst[j] = top[j] + ((expr) - top[j]) * opacity; \
161 dst += dst_linesize; \
162 top += top_linesize; \
163 bottom += bottom_linesize; \
170 #define MULTIPLY(x, a, b) (x * ((a * b) / 255))
171 #define SCREEN(x, a, b) (255 - x * ((255 - a) * (255 - b) / 255))
172 #define BURN(a, b) ((a == 0) ? a : FFMAX(0, 255 - ((255 - b) << 8) / a))
173 #define DODGE(a, b) ((a == 255) ? a : FFMIN(255, ((b << 8) / (255 - a))))
175 DEFINE_BLEND(addition, FFMIN(255, A + B))
176 DEFINE_BLEND(average, (A + B) / 2)
177 DEFINE_BLEND(subtract, FFMAX(0, A - B))
178 DEFINE_BLEND(multiply, MULTIPLY(1, A, B))
179 DEFINE_BLEND(negation, 255 - FFABS(255 - A - B))
180 DEFINE_BLEND(difference, FFABS(A - B))
181 DEFINE_BLEND(screen, SCREEN(1, A, B))
182 DEFINE_BLEND(overlay, (A < 128) ? MULTIPLY(2, A, B) : SCREEN(2, A, B))
183 DEFINE_BLEND(hardlight, (B < 128) ? MULTIPLY(2, B, A) : SCREEN(2, B, A))
184 DEFINE_BLEND(darken, FFMIN(A, B))
185 DEFINE_BLEND(lighten, FFMAX(A, B))
186 DEFINE_BLEND(divide, ((float)A / ((float)B) * 255))
187 DEFINE_BLEND(dodge, DODGE(A, B))
188 DEFINE_BLEND(burn, BURN(A, B))
189 DEFINE_BLEND(softlight, (A > 127) ? B + (255 - B) * (A - 127.5) / 127.5 * (0.5 - FFABS(B - 127.5) / 255): B - B * ((127.5 - A) / 127.5) * (0.5 - FFABS(B - 127.5)/255))
190 DEFINE_BLEND(exclusion, A + B - 2 * A * B / 255)
191 DEFINE_BLEND(pinlight, (B < 128) ? FFMIN(A, 2 * B) : FFMAX(A, 2 * (B - 128)))
192 DEFINE_BLEND(phoenix, FFMIN(A, B) - FFMAX(A, B) + 255)
193 DEFINE_BLEND(reflect, (B == 255) ? B : FFMIN(255, (A * A / (255 - B))))
194 DEFINE_BLEND(and, A & B)
195 DEFINE_BLEND(or, A | B)
196 DEFINE_BLEND(xor, A ^ B)
197 DEFINE_BLEND(vividlight, (B < 128) ? BURN(A, 2 * B) : DODGE(A, 2 * (B - 128)))
199 static void blend_expr(const uint8_t *top, int top_linesize,
200 const uint8_t *bottom, int bottom_linesize,
201 uint8_t *dst, int dst_linesize,
202 int width, int height,
205 AVExpr *e = param->e;
206 double *values = param->values;
209 for (y = 0; y < height; y++) {
211 for (x = 0; x < width; x++) {
213 values[VAR_TOP] = values[VAR_A] = top[x];
214 values[VAR_BOTTOM] = values[VAR_B] = bottom[x];
215 dst[x] = av_expr_eval(e, values, NULL);
219 bottom += bottom_linesize;
223 static av_cold int init(AVFilterContext *ctx, const char *args)
225 BlendContext *b = ctx->priv;
228 b->class = &blend_class;
229 av_opt_set_defaults(b);
231 if ((ret = av_set_options_string(b, args, "=", ":")) < 0)
234 for (plane = 0; plane < FF_ARRAY_ELEMS(b->params); plane++) {
235 FilterParams *param = &b->params[plane];
237 if (b->all_mode >= 0)
238 param->mode = b->all_mode;
239 if (b->all_opacity < 1)
240 param->opacity = b->all_opacity;
242 switch (param->mode) {
243 case BLEND_ADDITION: param->blend = blend_addition; break;
244 case BLEND_AND: param->blend = blend_and; break;
245 case BLEND_AVERAGE: param->blend = blend_average; break;
246 case BLEND_BURN: param->blend = blend_burn; break;
247 case BLEND_DARKEN: param->blend = blend_darken; break;
248 case BLEND_DIFFERENCE: param->blend = blend_difference; break;
249 case BLEND_DIVIDE: param->blend = blend_divide; break;
250 case BLEND_DODGE: param->blend = blend_dodge; break;
251 case BLEND_EXCLUSION: param->blend = blend_exclusion; break;
252 case BLEND_HARDLIGHT: param->blend = blend_hardlight; break;
253 case BLEND_LIGHTEN: param->blend = blend_lighten; break;
254 case BLEND_MULTIPLY: param->blend = blend_multiply; break;
255 case BLEND_NEGATION: param->blend = blend_negation; break;
256 case BLEND_NORMAL: param->blend = blend_normal; break;
257 case BLEND_OR: param->blend = blend_or; break;
258 case BLEND_OVERLAY: param->blend = blend_overlay; break;
259 case BLEND_PHOENIX: param->blend = blend_phoenix; break;
260 case BLEND_PINLIGHT: param->blend = blend_pinlight; break;
261 case BLEND_REFLECT: param->blend = blend_reflect; break;
262 case BLEND_SCREEN: param->blend = blend_screen; break;
263 case BLEND_SOFTLIGHT: param->blend = blend_softlight; break;
264 case BLEND_SUBTRACT: param->blend = blend_subtract; break;
265 case BLEND_VIVIDLIGHT: param->blend = blend_vividlight; break;
266 case BLEND_XOR: param->blend = blend_xor; break;
269 if (b->all_expr && !param->expr_str) {
270 param->expr_str = av_strdup(b->all_expr);
271 if (!param->expr_str)
272 return AVERROR(ENOMEM);
274 if (param->expr_str) {
275 ret = av_expr_parse(¶m->e, param->expr_str, var_names,
276 NULL, NULL, NULL, NULL, 0, ctx);
279 param->blend = blend_expr;
286 static int query_formats(AVFilterContext *ctx)
288 static const enum AVPixelFormat pix_fmts[] = {
289 AV_PIX_FMT_YUVA444P, AV_PIX_FMT_YUVA422P, AV_PIX_FMT_YUVA420P,
290 AV_PIX_FMT_YUV444P, AV_PIX_FMT_YUV422P, AV_PIX_FMT_YUV420P, AV_PIX_FMT_YUVJ420P, AV_PIX_FMT_YUVJ422P,AV_PIX_FMT_YUVJ444P,
291 AV_PIX_FMT_GBRP, AV_PIX_FMT_GRAY8, AV_PIX_FMT_NONE
294 ff_set_common_formats(ctx, ff_make_format_list(pix_fmts));
298 static int config_output(AVFilterLink *outlink)
300 AVFilterContext *ctx = outlink->src;
301 AVFilterLink *toplink = ctx->inputs[TOP];
302 AVFilterLink *bottomlink = ctx->inputs[BOTTOM];
304 if (toplink->format != bottomlink->format) {
305 av_log(ctx, AV_LOG_ERROR, "inputs must be of same pixel format\n");
306 return AVERROR(EINVAL);
308 if (toplink->w != bottomlink->w ||
309 toplink->h != bottomlink->h ||
310 toplink->sample_aspect_ratio.num != bottomlink->sample_aspect_ratio.num ||
311 toplink->sample_aspect_ratio.den != bottomlink->sample_aspect_ratio.den) {
312 av_log(ctx, AV_LOG_ERROR, "First input link %s parameters "
313 "(size %dx%d, SAR %d:%d) do not match the corresponding "
314 "second input link %s parameters (%dx%d, SAR %d:%d)\n",
315 ctx->input_pads[TOP].name, toplink->w, toplink->h,
316 toplink->sample_aspect_ratio.num,
317 toplink->sample_aspect_ratio.den,
318 ctx->input_pads[BOTTOM].name, bottomlink->w, bottomlink->h,
319 bottomlink->sample_aspect_ratio.num,
320 bottomlink->sample_aspect_ratio.den);
321 return AVERROR(EINVAL);
324 outlink->w = toplink->w;
325 outlink->h = bottomlink->h;
326 outlink->time_base = toplink->time_base;
327 outlink->sample_aspect_ratio = toplink->sample_aspect_ratio;
328 outlink->frame_rate = toplink->frame_rate;
332 static int config_input_top(AVFilterLink *inlink)
334 BlendContext *b = inlink->dst->priv;
335 const AVPixFmtDescriptor *pix_desc = av_pix_fmt_desc_get(inlink->format);
337 b->hsub = pix_desc->log2_chroma_w;
338 b->vsub = pix_desc->log2_chroma_h;
342 static av_cold void uninit(AVFilterContext *ctx)
344 BlendContext *b = ctx->priv;
348 ff_bufqueue_discard_all(&b->queue_top);
349 ff_bufqueue_discard_all(&b->queue_bottom);
351 for (i = 0; i < FF_ARRAY_ELEMS(b->params); i++)
352 av_expr_free(b->params[i].e);
355 static int request_frame(AVFilterLink *outlink)
357 AVFilterContext *ctx = outlink->src;
358 BlendContext *b = ctx->priv;
361 b->frame_requested = 1;
362 while (b->frame_requested) {
363 in = ff_bufqueue_peek(&b->queue_top, 0) ? BOTTOM : TOP;
364 ret = ff_request_frame(ctx->inputs[in]);
371 static void blend_frame(AVFilterContext *ctx,
376 BlendContext *b = ctx->priv;
377 AVFilterLink *inlink = ctx->inputs[0];
381 for (plane = 0; dst_buf->data[plane]; plane++) {
382 int hsub = plane == 1 || plane == 2 ? b->hsub : 0;
383 int vsub = plane == 1 || plane == 2 ? b->vsub : 0;
384 int outw = dst_buf->width >> hsub;
385 int outh = dst_buf->height >> vsub;
386 uint8_t *dst = dst_buf->data[plane];
387 uint8_t *top = top_buf->data[plane];
388 uint8_t *bottom = bottom_buf->data[plane];
390 param = &b->params[plane];
391 param->values[VAR_N] = b->framenum++;
392 param->values[VAR_T] = dst_buf->pts == AV_NOPTS_VALUE ? NAN : dst_buf->pts * av_q2d(inlink->time_base);
393 param->values[VAR_W] = outw;
394 param->values[VAR_H] = outh;
395 param->values[VAR_SW] = outw / dst_buf->width;
396 param->values[VAR_SH] = outh / dst_buf->height;
397 param->blend(top, top_buf->linesize[plane],
398 bottom, bottom_buf->linesize[plane],
399 dst, dst_buf->linesize[plane], outw, outh, param);
403 static int filter_frame(AVFilterLink *inlink, AVFrame *buf)
405 AVFilterContext *ctx = inlink->dst;
406 AVFilterLink *outlink = ctx->outputs[0];
407 BlendContext *b = ctx->priv;
410 int is_bottom = (inlink == ctx->inputs[BOTTOM]);
411 struct FFBufQueue *queue =
412 (is_bottom ? &b->queue_bottom : &b->queue_top);
413 ff_bufqueue_add(ctx, queue, buf);
416 AVFrame *top_buf, *bottom_buf, *out_buf;
418 if (!ff_bufqueue_peek(&b->queue_top, 0) ||
419 !ff_bufqueue_peek(&b->queue_bottom, 0)) break;
421 top_buf = ff_bufqueue_get(&b->queue_top);
422 bottom_buf = ff_bufqueue_get(&b->queue_bottom);
424 out_buf = ff_get_video_buffer(outlink, outlink->w, outlink->h);
426 return AVERROR(ENOMEM);
428 av_frame_copy_props(out_buf, top_buf);
430 b->frame_requested = 0;
431 blend_frame(ctx, top_buf, bottom_buf, out_buf);
432 ret = ff_filter_frame(ctx->outputs[0], out_buf);
433 av_frame_free(&top_buf);
434 av_frame_free(&bottom_buf);
439 static const AVFilterPad blend_inputs[] = {
442 .type = AVMEDIA_TYPE_VIDEO,
443 .config_props = config_input_top,
444 .filter_frame = filter_frame,
447 .type = AVMEDIA_TYPE_VIDEO,
448 .filter_frame = filter_frame,
453 static const AVFilterPad blend_outputs[] = {
456 .type = AVMEDIA_TYPE_VIDEO,
457 .config_props = config_output,
458 .request_frame = request_frame,
463 AVFilter avfilter_vf_blend = {
465 .description = NULL_IF_CONFIG_SMALL("Blend two video frames into each other."),
468 .priv_size = sizeof(BlendContext),
469 .query_formats = query_formats,
470 .inputs = blend_inputs,
471 .outputs = blend_outputs,
472 .priv_class = &blend_class,