Go to the documentation of this file.
78 static const char *
const var_names[] = {
"X",
"Y",
"W",
"H",
"SW",
"SH",
"T",
"N",
"A",
"B",
"TOP",
"BOTTOM",
NULL };
79 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 };
90 #define OFFSET(x) offsetof(BlendContext, x)
91 #define FLAGS AV_OPT_FLAG_FILTERING_PARAM|AV_OPT_FLAG_VIDEO_PARAM|AV_OPT_FLAG_RUNTIME_PARAM
156 #define COPY(src, depth) \
157 static void blend_copy ## src##_##depth(const uint8_t *top, ptrdiff_t top_linesize, \
158 const uint8_t *bottom, ptrdiff_t bottom_linesize,\
159 uint8_t *dst, ptrdiff_t dst_linesize, \
160 ptrdiff_t width, ptrdiff_t height, \
161 FilterParams *param, double *values, int starty) \
163 av_image_copy_plane(dst, dst_linesize, src, src ## _linesize, \
164 width * depth / 8, height); \
178 #define BLEND_NORMAL(name, type) \
179 static void blend_normal_##name(const uint8_t *_top, ptrdiff_t top_linesize, \
180 const uint8_t *_bottom, ptrdiff_t bottom_linesize,\
181 uint8_t *_dst, ptrdiff_t dst_linesize, \
182 ptrdiff_t width, ptrdiff_t height, \
183 FilterParams *param, double *values, int starty) \
185 const type *top = (type*)_top; \
186 const type *bottom = (type*)_bottom; \
187 type *dst = (type*)_dst; \
188 const float opacity = param->opacity; \
190 dst_linesize /= sizeof(type); \
191 top_linesize /= sizeof(type); \
192 bottom_linesize /= sizeof(type); \
194 for (int i = 0; i < height; i++) { \
195 for (int j = 0; j < width; j++) { \
196 dst[j] = top[j] * opacity + bottom[j] * (1.f - opacity); \
198 dst += dst_linesize; \
199 top += top_linesize; \
200 bottom += bottom_linesize; \
208 #define DEFINE_BLEND_EXPR(type, name, div) \
209 static void blend_expr_## name(const uint8_t *_top, ptrdiff_t top_linesize, \
210 const uint8_t *_bottom, ptrdiff_t bottom_linesize, \
211 uint8_t *_dst, ptrdiff_t dst_linesize, \
212 ptrdiff_t width, ptrdiff_t height, \
213 FilterParams *param, double *values, int starty) \
215 const type *top = (type*)_top; \
216 const type *bottom = (type*)_bottom; \
217 type *dst = (type*)_dst; \
218 AVExpr *e = param->e; \
220 dst_linesize /= div; \
221 top_linesize /= div; \
222 bottom_linesize /= div; \
224 for (y = 0; y < height; y++) { \
225 values[VAR_Y] = y + starty; \
226 for (x = 0; x < width; x++) { \
228 values[VAR_TOP] = values[VAR_A] = top[x]; \
229 values[VAR_BOTTOM] = values[VAR_B] = bottom[x]; \
230 dst[x] = av_expr_eval(e, values, NULL); \
232 dst += dst_linesize; \
233 top += top_linesize; \
234 bottom += bottom_linesize; \
245 int slice_start = (
td->h * jobnr ) / nb_jobs;
248 const uint8_t *top =
td->top->data[
td->plane];
249 const uint8_t *bottom =
td->bottom->data[
td->plane];
250 uint8_t *dst =
td->dst->data[
td->plane];
260 td->param->blend(top + slice_start *
td->top->linesize[
td->plane],
261 td->top->linesize[
td->plane],
262 bottom + slice_start *
td->bottom->linesize[
td->plane],
263 td->bottom->linesize[
td->plane],
264 dst + slice_start *
td->dst->linesize[
td->plane],
265 td->dst->linesize[
td->plane],
288 for (plane = 0; plane <
s->nb_planes; plane++) {
289 int hsub = plane == 1 || plane == 2 ?
s->hsub : 0;
290 int vsub = plane == 1 || plane == 2 ?
s->vsub : 0;
294 ThreadData td = { .top = top_buf, .bottom = bottom_buf, .dst = dst_buf,
295 .w = outw, .h = outh, .param = param, .plane = plane,
311 AVFrame *top_buf, *bottom_buf, *dst_buf;
327 s->tblend = !strcmp(
ctx->filter->name,
"tblend");
366 #define DEFINE_INIT_BLEND_FUNC(depth, nbits) \
367 static av_cold void init_blend_func_##depth##_##nbits##bit(FilterParams *param) \
369 switch (param->mode) { \
370 case BLEND_ADDITION: param->blend = blend_addition_##depth##bit; break; \
371 case BLEND_GRAINMERGE: param->blend = blend_grainmerge_##depth##bit; break; \
372 case BLEND_AND: param->blend = blend_and_##depth##bit; break; \
373 case BLEND_AVERAGE: param->blend = blend_average_##depth##bit; break; \
374 case BLEND_BURN: param->blend = blend_burn_##depth##bit; break; \
375 case BLEND_DARKEN: param->blend = blend_darken_##depth##bit; break; \
376 case BLEND_DIFFERENCE: param->blend = blend_difference_##depth##bit; break; \
377 case BLEND_GRAINEXTRACT: param->blend = blend_grainextract_##depth##bit; break; \
378 case BLEND_DIVIDE: param->blend = blend_divide_##depth##bit; break; \
379 case BLEND_DODGE: param->blend = blend_dodge_##depth##bit; break; \
380 case BLEND_EXCLUSION: param->blend = blend_exclusion_##depth##bit; break; \
381 case BLEND_EXTREMITY: param->blend = blend_extremity_##depth##bit; break; \
382 case BLEND_FREEZE: param->blend = blend_freeze_##depth##bit; break; \
383 case BLEND_GLOW: param->blend = blend_glow_##depth##bit; break; \
384 case BLEND_HARDLIGHT: param->blend = blend_hardlight_##depth##bit; break; \
385 case BLEND_HARDMIX: param->blend = blend_hardmix_##depth##bit; break; \
386 case BLEND_HEAT: param->blend = blend_heat_##depth##bit; break; \
387 case BLEND_LIGHTEN: param->blend = blend_lighten_##depth##bit; break; \
388 case BLEND_LINEARLIGHT: param->blend = blend_linearlight_##depth##bit; break; \
389 case BLEND_MULTIPLY: param->blend = blend_multiply_##depth##bit; break; \
390 case BLEND_MULTIPLY128: param->blend = blend_multiply128_##depth##bit; break; \
391 case BLEND_NEGATION: param->blend = blend_negation_##depth##bit; break; \
392 case BLEND_NORMAL: param->blend = blend_normal_##nbits##bit; break; \
393 case BLEND_OR: param->blend = blend_or_##depth##bit; break; \
394 case BLEND_OVERLAY: param->blend = blend_overlay_##depth##bit; break; \
395 case BLEND_PHOENIX: param->blend = blend_phoenix_##depth##bit; break; \
396 case BLEND_PINLIGHT: param->blend = blend_pinlight_##depth##bit; break; \
397 case BLEND_REFLECT: param->blend = blend_reflect_##depth##bit; break; \
398 case BLEND_SCREEN: param->blend = blend_screen_##depth##bit; break; \
399 case BLEND_SOFTLIGHT: param->blend = blend_softlight_##depth##bit; break; \
400 case BLEND_SUBTRACT: param->blend = blend_subtract_##depth##bit; break; \
401 case BLEND_VIVIDLIGHT: param->blend = blend_vividlight_##depth##bit; break; \
402 case BLEND_XOR: param->blend = blend_xor_##depth##bit; break; \
403 case BLEND_SOFTDIFFERENCE:param->blend=blend_softdifference_##depth##bit;break; \
404 case BLEND_GEOMETRIC: param->blend = blend_geometric_##depth##bit; break; \
405 case BLEND_HARMONIC: param->blend = blend_harmonic_##depth##bit; break; \
406 case BLEND_BLEACH: param->blend = blend_bleach_##depth##bit; break; \
407 case BLEND_STAIN: param->blend = blend_stain_##depth##bit; break; \
408 case BLEND_INTERPOLATE: param->blend = blend_interpolate_##depth##bit; break; \
409 case BLEND_HARDOVERLAY: param->blend = blend_hardoverlay_##depth##bit; break; \
424 init_blend_func_8_8bit(param);
427 init_blend_func_9_16bit(param);
430 init_blend_func_10_16bit(param);
433 init_blend_func_12_16bit(param);
436 init_blend_func_14_16bit(param);
439 init_blend_func_16_16bit(param);
442 init_blend_func_32_32bit(param);
446 if (param->opacity == 0 && param->mode !=
BLEND_NORMAL) {
447 param->blend = depth > 8 ? depth > 16 ? blend_copytop_32 : blend_copytop_16 : blend_copytop_8;
449 if (param->opacity == 1)
450 param->blend = depth > 8 ? depth > 16 ? blend_copytop_32 : blend_copytop_16 : blend_copytop_8;
451 else if (param->opacity == 0)
452 param->blend = depth > 8 ? depth > 16 ? blend_copybottom_32 : blend_copybottom_16 : blend_copybottom_8;
467 if (
s->all_mode >= 0)
468 param->
mode =
s->all_mode;
469 if (
s->all_opacity < 1)
484 param->
blend =
s->depth > 8 ?
s->depth > 16 ? blend_expr_32bit : blend_expr_16bit : blend_expr_8bit;
502 if (toplink->
w != bottomlink->
w || toplink->
h != bottomlink->
h) {
504 "(size %dx%d) do not match the corresponding "
505 "second input link %s parameters (size %dx%d)\n",
506 ctx->input_pads[
TOP].name, toplink->
w, toplink->
h,
507 ctx->input_pads[
BOTTOM].name, bottomlink->
w, bottomlink->
h);
512 outlink->
w = toplink->
w;
513 outlink->
h = toplink->
h;
542 char *res,
int res_len,
int flags)
553 #if CONFIG_BLEND_FILTER
582 .preinit = blend_framesync_preinit,
590 .priv_class = &blend_class,
597 #if CONFIG_TBLEND_FILTER
608 if (
ctx->is_disabled)
626 .filter_frame = tblend_filter_frame,
642 .priv_class = &tblend_class,
AVFrame * ff_get_video_buffer(AVFilterLink *link, int w, int h)
Request a picture buffer with a specific set of permissions.
#define AV_PIX_FMT_YUVA422P16
#define AV_PIX_FMT_GBRAP16
int vsub
chroma subsampling values
int ff_framesync_configure(FFFrameSync *fs)
Configure a frame sync structure.
AVPixelFormat
Pixel format.
Filter the word “frame” indicates either a video frame or a group of audio as stored in an AVFrame structure Format for each input and each output the list of supported formats For video that means pixel format For audio that means channel sample they are references to shared objects When the negotiation mechanism computes the intersection of the formats supported at each end of a all references to both lists are replaced with a reference to the intersection And when a single format is eventually chosen for a link amongst the remaining all references to the list are updated That means that if a filter requires that its input and output have the same format amongst a supported all it has to do is use a reference to the same list of formats query_formats can leave some formats unset and return AVERROR(EAGAIN) to cause the negotiation mechanism toagain later. That can be used by filters with complex requirements to use the format negotiated on one link to set the formats supported on another. Frame references ownership and permissions
void ff_framesync_uninit(FFFrameSync *fs)
Free all memory currently allocated.
int ff_filter_frame(AVFilterLink *link, AVFrame *frame)
Send a frame of data to the next filter.
const AVPixFmtDescriptor * av_pix_fmt_desc_get(enum AVPixelFormat pix_fmt)
#define FILTER_PIXFMTS_ARRAY(array)
The exact code depends on how similar the blocks are and how related they are to the and needs to apply these operations to the correct inlink or outlink if there are several Macros are available to factor that when no extra processing is inlink
void av_frame_free(AVFrame **frame)
Free the frame and any dynamically allocated objects in it, e.g.
#define AV_PIX_FMT_YUVA422P9
This structure describes decoded (raw) audio or video data.
#define AV_PIX_FMT_YUVA420P16
int depth
Number of bits in the component.
#define AV_PIX_FMT_YUVA420P10
#define AV_PIX_FMT_YUV420P10
@ AV_PIX_FMT_YUV440P
planar YUV 4:4:0 (1 Cr & Cb sample per 1x2 Y samples)
static const char *const var_names[]
const char * name
Filter name.
#define AVFILTER_DEFINE_CLASS_EXT(name, desc, options)
A link between two filters.
#define AV_PIX_FMT_YUVA422P10
static int process_command(AVFilterContext *ctx, const char *cmd, const char *args, char *res, int res_len, int flags)
int av_expr_parse(AVExpr **expr, const char *s, const char *const *const_names, const char *const *func1_names, double(*const *funcs1)(void *, double), const char *const *func2_names, double(*const *funcs2)(void *, double, double), int log_offset, void *log_ctx)
Parse an expression.
#define bit(string, value)
int av_pix_fmt_count_planes(enum AVPixelFormat pix_fmt)
#define AV_PIX_FMT_YUVA420P9
#define AV_PIX_FMT_GBRP14
@ AV_PIX_FMT_GBRAP
planar GBRA 4:4:4:4 32bpp
#define AV_PIX_FMT_GBRP10
#define AV_PIX_FMT_YUVA444P16
#define AV_PIX_FMT_YUV422P9
static int config_params(AVFilterContext *ctx)
#define AV_PIX_FMT_GRAY16
void av_expr_free(AVExpr *e)
Free a parsed expression previously created with av_expr_parse().
#define DEFINE_BLEND_EXPR(type, name, div)
static enum AVPixelFormat pix_fmts[]
static const AVOption blend_options[]
A filter pad used for either input or output.
#define AV_PIX_FMT_YUV444P10
@ AV_PIX_FMT_YUVJ411P
planar YUV 4:1:1, 12bpp, (1 Cr & Cb sample per 4x1 Y samples) full scale (JPEG), deprecated in favor ...
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
#define FF_ARRAY_ELEMS(a)
#define AV_PIX_FMT_YUV422P16
@ AV_PIX_FMT_YUVJ422P
planar YUV 4:2:2, 16bpp, full scale (JPEG), deprecated in favor of AV_PIX_FMT_YUV422P and setting col...
#define AV_PIX_FMT_GBRAP10
static int filter_slice(AVFilterContext *ctx, void *arg, int jobnr, int nb_jobs)
#define AV_PIX_FMT_GBRAP12
@ AV_PIX_FMT_YUVA420P
planar YUV 4:2:0, 20bpp, (1 Cr & Cb sample per 2x2 Y & A samples)
#define AV_PIX_FMT_YUV444P16
#define AV_CEIL_RSHIFT(a, b)
static int slice_end(AVCodecContext *avctx, AVFrame *pict)
Handle slice ends.
static double av_q2d(AVRational a)
Convert an AVRational to a double.
AVRational sample_aspect_ratio
agreed upon sample aspect ratio
AVRational frame_rate
Frame rate of the stream on the link, or 1/0 if unknown or variable; if left to 0/0,...
#define AV_PIX_FMT_YUVA444P12
#define AV_PIX_FMT_YUV420P9
#define AV_PIX_FMT_YUV420P16
AVFrame * av_frame_clone(const AVFrame *src)
Create a new frame that references the same data as src.
uint8_t log2_chroma_w
Amount to shift the luma width right to find the chroma width.
@ AV_PIX_FMT_YUV420P
planar YUV 4:2:0, 12bpp, (1 Cr & Cb sample per 2x2 Y samples)
#define AV_PIX_FMT_GRAYF32
FRAMESYNC_DEFINE_CLASS(blend, BlendContext, fs)
#define FILTER_INPUTS(array)
@ AV_PIX_FMT_YUVJ444P
planar YUV 4:4:4, 24bpp, full scale (JPEG), deprecated in favor of AV_PIX_FMT_YUV444P and setting col...
#define AV_PIX_FMT_GRAY10
#define AV_PIX_FMT_GBRP16
Describe the class of an AVClass context structure.
int av_frame_copy_props(AVFrame *dst, const AVFrame *src)
Copy only "metadata" fields from src to dst.
#define fs(width, name, subs,...)
@ AV_PIX_FMT_YUVJ420P
planar YUV 4:2:0, 12bpp, full scale (JPEG), deprecated in favor of AV_PIX_FMT_YUV420P and setting col...
filter_frame For filters that do not use the activate() callback
#define AV_PIX_FMT_YUV440P10
static av_cold int init(AVFilterContext *ctx)
void ff_blend_init_x86(FilterParams *param, int depth)
#define DEFINE_INIT_BLEND_FUNC(depth, nbits)
#define AV_PIX_FMT_YUV422P10
@ AV_PIX_FMT_GRAY8
Y , 8bpp.
#define NULL_IF_CONFIG_SMALL(x)
Return NULL if CONFIG_SMALL is true, otherwise the argument without modification.
int ff_framesync_init_dualinput(FFFrameSync *fs, AVFilterContext *parent)
Initialize a frame sync structure for dualinput.
#define AV_PIX_FMT_GBRPF32
int format
agreed upon media format
#define AV_PIX_FMT_YUV422P12
#define AV_NOPTS_VALUE
Undefined timestamp value.
const AVFilter ff_vf_tblend
#define AV_PIX_FMT_YUV444P12
AVFilterContext * src
source filter
int ff_filter_process_command(AVFilterContext *ctx, const char *cmd, const char *arg, char *res, int res_len, int flags)
Generic processing of user supplied commands that are set in the same way as the filter options.
@ AV_PIX_FMT_YUVA444P
planar YUV 4:4:4 32bpp, (1 Cr & Cb sample per 1x1 Y & A samples)
#define AV_PIX_FMT_YUVA444P10
#define i(width, name, range_min, range_max)
int w
agreed upon image width
const AVFilter ff_vf_blend
#define AV_PIX_FMT_GBRP12
int ff_filter_get_nb_threads(AVFilterContext *ctx)
Get number of threads for current filter instance.
Used for passing data between threads.
@ AV_PIX_FMT_YUVJ440P
planar YUV 4:4:0 full scale (JPEG), deprecated in favor of AV_PIX_FMT_YUV440P and setting color_range
const char * name
Pad name.
#define AV_PIX_FMT_YUV444P9
void ff_blend_init(FilterParams *param, int depth)
static int config_output(AVFilterLink *outlink)
these buffered frames must be flushed immediately if a new input produces new the filter must not call request_frame to get more It must just process the frame or queue it The task of requesting more frames is left to the filter s request_frame method or the application If a filter has several the filter must be ready for frames arriving randomly on any input any filter with several inputs will most likely require some kind of queuing mechanism It is perfectly acceptable to have a limited queue and to drop frames when the inputs are too unbalanced request_frame For filters that do not use the this method is called when a frame is wanted on an output For a it should directly call filter_frame on the corresponding output For a if there are queued frames already one of these frames should be pushed If the filter should request a frame on one of its repeatedly until at least one frame has been pushed Return or at least make progress towards producing a frame
#define AV_PIX_FMT_YUVA444P9
#define AV_PIX_FMT_YUV420P12
#define AV_PIX_FMT_YUV422P14
int h
agreed upon image height
static AVFrame * blend_frame(AVFilterContext *ctx, AVFrame *top_buf, const AVFrame *bottom_buf)
#define AV_PIX_FMT_YUVA422P12
#define AV_PIX_FMT_GBRAPF32
these buffered frames must be flushed immediately if a new input produces new the filter must not call request_frame to get more It must just process the frame or queue it The task of requesting more frames is left to the filter s request_frame method or the application If a filter has several the filter must be ready for frames arriving randomly on any input any filter with several inputs will most likely require some kind of queuing mechanism It is perfectly acceptable to have a limited queue and to drop frames when the inputs are too unbalanced request_frame For filters that do not use the this method is called when a frame is wanted on an output For a it should directly call filter_frame on the corresponding output For a if there are queued frames already one of these frames should be pushed If the filter should request a frame on one of its repeatedly until at least one frame has been pushed Return values
AVComponentDescriptor comp[4]
Parameters that describe how pixels are packed.
AVRational time_base
Define the time base used by the PTS of the frames/samples which will pass through this link.
static av_cold void uninit(AVFilterContext *ctx)
@ AV_PIX_FMT_YUV444P
planar YUV 4:4:4, 24bpp, (1 Cr & Cb sample per 1x1 Y samples)
@ AV_PIX_FMT_GBRP
planar GBR 4:4:4 24bpp
#define AVFILTER_FLAG_SLICE_THREADS
The filter supports multithreading by splitting frames into multiple parts and processing them concur...
char * av_strdup(const char *s)
Duplicate a string.
@ AV_PIX_FMT_YUV422P
planar YUV 4:2:2, 16bpp, (1 Cr & Cb sample per 2x1 Y samples)
Descriptor that unambiguously describes how the bits of a pixel are stored in the up to 4 data planes...
static int blend_frame_for_dualinput(FFFrameSync *fs)
#define BLEND_NORMAL(name, type)
#define FILTER_OUTPUTS(array)
@ AV_PIX_FMT_YUV411P
planar YUV 4:1:1, 12bpp, (1 Cr & Cb sample per 4x1 Y samples)
void(* blend)(const uint8_t *top, ptrdiff_t top_linesize, const uint8_t *bottom, ptrdiff_t bottom_linesize, uint8_t *dst, ptrdiff_t dst_linesize, ptrdiff_t width, ptrdiff_t height, struct FilterParams *param, double *values, int starty)
#define AVFILTER_FLAG_SUPPORT_TIMELINE_INTERNAL
Same as AVFILTER_FLAG_SUPPORT_TIMELINE_GENERIC, except that the filter will have its filter_frame() c...
#define flags(name, subs,...)
@ AV_PIX_FMT_YUV410P
planar YUV 4:1:0, 9bpp, (1 Cr & Cb sample per 4x4 Y samples)
#define AV_PIX_FMT_YUV440P12
#define AV_PIX_FMT_YUV444P14
int ff_framesync_activate(FFFrameSync *fs)
Examine the frames in the filter's input and try to produce output.
int ff_framesync_dualinput_get(FFFrameSync *fs, AVFrame **f0, AVFrame **f1)
#define AV_PIX_FMT_GRAY12
static av_always_inline int ff_filter_execute(AVFilterContext *ctx, avfilter_action_func *func, void *arg, int *ret, int nb_jobs)
uint8_t log2_chroma_h
Amount to shift the luma height right to find the chroma height.
@ AV_PIX_FMT_YUVA422P
planar YUV 4:2:2 24bpp, (1 Cr & Cb sample per 2x1 Y & A samples)
#define AV_PIX_FMT_YUV420P14