vf_overlay.c File Reference

overlay one video on top of another More...

#include "avfilter.h"
#include "formats.h"
#include "libavutil/common.h"
#include "libavutil/eval.h"
#include "libavutil/avstring.h"
#include "libavutil/opt.h"
#include "libavutil/pixdesc.h"
#include "libavutil/imgutils.h"
#include "libavutil/mathematics.h"
#include "libavutil/timestamp.h"
#include "internal.h"
#include "bufferqueue.h"
#include "drawutils.h"
#include "video.h"

Go to the source code of this file.

Data Structures
struct	OverlayContext

Macros
#define	MAIN   0
#define	OVERLAY   1
#define	R   0
#define	G   1
#define	B   2
#define	A   3
#define	Y   0
#define	U   1
#define	V   2
#define	OFFSET(x)   offsetof(OverlayContext, x)
#define	FLAGS   AV_OPT_FLAG_VIDEO_PARAM|AV_OPT_FLAG_FILTERING_PARAM
#define	FAST_DIV255(x)   ((((x) + 128) * 257) >> 16)
#define	UNPREMULTIPLY_ALPHA(x, y)   ((((x) << 16) - ((x) << 9) + (x)) / ((((x) + (y)) << 8) - ((x) + (y)) - (y) * (x)))

Enumerations
enum	var_name {   VAR_B1, VAR_B2, VAR_S1, VAR_S2,   VAR_T1, VAR_T2, VAR_NB, VAR_N,   VAR_T, VAR_S, VAR_VARS_NB, VAR_TB,   VAR_PTS, VAR_START_PTS, VAR_PREV_PTS, VAR_PREV_SELECTED_PTS,   VAR_T, VAR_START_T, VAR_PREV_T, VAR_PREV_SELECTED_T,   VAR_PICT_TYPE, VAR_PICT_TYPE_I, VAR_PICT_TYPE_P, VAR_PICT_TYPE_B,   VAR_PICT_TYPE_S, VAR_PICT_TYPE_SI, VAR_PICT_TYPE_SP, VAR_PICT_TYPE_BI,   VAR_INTERLACE_TYPE, VAR_INTERLACE_TYPE_P, VAR_INTERLACE_TYPE_T, VAR_INTERLACE_TYPE_B,   VAR_CONSUMED_SAMPLES_N, VAR_SAMPLES_N, VAR_SAMPLE_RATE, VAR_N,   VAR_SELECTED_N, VAR_PREV_SELECTED_N, VAR_KEY, VAR_POS,   VAR_SCENE, VAR_VARS_NB, VAR_FRAME_RATE, VAR_INTERLACED,   VAR_N, VAR_NB_CONSUMED_SAMPLES, VAR_NB_SAMPLES, VAR_POS,   VAR_PREV_INPTS, VAR_PREV_INT, VAR_PREV_OUTPTS, VAR_PREV_OUTT,   VAR_PTS, VAR_SAMPLE_RATE, VAR_STARTPTS, VAR_STARTT,   VAR_T, VAR_TB, VAR_RTCTIME, VAR_RTCSTART,   VAR_VARS_NB, VAR_AVTB, VAR_INTB, VAR_SR,   VAR_VARS_NB, VAR_W, VAR_H, VAR_CW,   VAR_CH, VAR_HSUB, VAR_VSUB, VARS_NB,   VAR_IN_W, VAR_IW, VAR_IN_H, VAR_IH,   VAR_OUT_W, VAR_OW, VAR_OUT_H, VAR_OH,   VAR_A, VAR_SAR, VAR_DAR, VAR_HSUB,   VAR_VSUB, VAR_X, VAR_Y, VAR_N,   VAR_POS, VAR_T, VAR_VARS_NB, VAR_DAR,   VAR_HSUB, VAR_VSUB, VAR_LINE_H, VAR_LH,   VAR_MAIN_H, VAR_h, VAR_H, VAR_MAIN_W,   VAR_w, VAR_W, VAR_MAX_GLYPH_A, VAR_ASCENT,   VAR_MAX_GLYPH_D, VAR_DESCENT, VAR_MAX_GLYPH_H, VAR_MAX_GLYPH_W,   VAR_N, VAR_SAR, VAR_T, VAR_TEXT_H,   VAR_TH, VAR_TEXT_W, VAR_TW, VAR_X,   VAR_Y, VAR_VARS_NB, VAR_N, VAR_PTS,   VAR_R, VAR_T, VAR_TB, VAR_NB,   VAR_W, VAR_H, VAR_VAL, VAR_MAXVAL,   VAR_MINVAL, VAR_NEGVAL, VAR_CLIPVAL, VAR_VARS_NB,   VAR_MAIN_W, VAR_MW, VAR_MAIN_H, VAR_MH,   VAR_OVERLAY_W, VAR_OW, VAR_OVERLAY_H, VAR_OH,   VAR_VARS_NB, VAR_IN_W, VAR_IW, VAR_IN_H,   VAR_IH, VAR_OUT_W, VAR_OW, VAR_OUT_H,   VAR_OH, VAR_X, VAR_Y, VAR_A,   VAR_SAR, VAR_DAR, VAR_HSUB, VAR_VSUB,   VARS_NB, VAR_IN_W, VAR_IW, VAR_IN_H,   VAR_IH, VAR_OUT_W, VAR_OW, VAR_OUT_H,   VAR_OH, VAR_A, VAR_SAR, VAR_DAR,   VAR_HSUB, VAR_VSUB, VARS_NB, VAR_X,   VAR_Y, VAR_W, VAR_H, VAR_TIME,   VAR_SPEED, VAR_TEMPO, VAR_ORDER, VAR_PATTERN,   VAR_ROW, VAR_VARS_NB }

Functions
	AVFILTER_DEFINE_CLASS (overlay)
static av_cold int	init (AVFilterContext *ctx, const char *args)
static av_cold void	uninit (AVFilterContext *ctx)
static int	query_formats (AVFilterContext *ctx)
static int	config_input_main (AVFilterLink *inlink)
static int	config_input_overlay (AVFilterLink *inlink)
static int	config_output (AVFilterLink *outlink)
static void	blend_image (AVFilterContext *ctx, AVFilterBufferRef *dst, AVFilterBufferRef *src, int x, int y)
	Blend image in src to destination buffer dst at position (x, y).
static int	try_filter_frame (AVFilterContext *ctx, AVFilterBufferRef *mainpic)
static int	try_filter_next_frame (AVFilterContext *ctx)
static int	flush_frames (AVFilterContext *ctx)
static int	filter_frame_main (AVFilterLink *inlink, AVFilterBufferRef *inpicref)
static int	filter_frame_over (AVFilterLink *inlink, AVFilterBufferRef *inpicref)
static int	request_frame (AVFilterLink *outlink)

Variables
static const char *const	var_names []
static const AVOption	overlay_options []
static enum AVPixelFormat	alpha_pix_fmts []
static const AVFilterPad	avfilter_vf_overlay_inputs []
static const AVFilterPad	avfilter_vf_overlay_outputs []
AVFilter	avfilter_vf_overlay

Detailed Description

overlay one video on top of another

Definition in file vf_overlay.c.

Macro Definition Documentation

#define MAIN   0

Definition at line 61 of file vf_overlay.c.

Referenced by config_input_overlay(), config_output(), Faac_encode_init(), query_formats(), request_frame(), and try_filter_frame().

#define OVERLAY   1

Definition at line 62 of file vf_overlay.c.

Referenced by avfilter_register_all(), config_input_overlay(), query_formats(), request_frame(), and try_filter_frame().

#define R   0

Definition at line 64 of file vf_overlay.c.

Referenced by blend_image().

#define G   1

Definition at line 65 of file vf_overlay.c.

Referenced by blend_image().

#define B   2

Definition at line 66 of file vf_overlay.c.

Referenced by blend_image().

#define A   3

Definition at line 67 of file vf_overlay.c.

#define Y   0

Definition at line 69 of file vf_overlay.c.

#define U   1

Definition at line 70 of file vf_overlay.c.

#define V   2

Definition at line 71 of file vf_overlay.c.

#define OFFSET

(

x

)

offsetof(OverlayContext, x)

Definition at line 100 of file vf_overlay.c.

#define FLAGS   AV_OPT_FLAG_VIDEO_PARAM|AV_OPT_FLAG_FILTERING_PARAM

Definition at line 101 of file vf_overlay.c.

#define FAST_DIV255

(

x

)

((((x) + 128) * 257) >> 16)

Definition at line 307 of file vf_overlay.c.

Referenced by blend_image().

#define UNPREMULTIPLY_ALPHA	(		x,
			y
	)		((((x) << 16) - ((x) << 9) + (x)) / ((((x) + (y)) << 8) - ((x) + (y)) - (y) * (x)))

Definition at line 313 of file vf_overlay.c.

Referenced by blend_image().

Enumeration Type Documentation

enum var_name

Enumerator:

VAR_B1
VAR_B2
VAR_S1
VAR_S2
VAR_T1
VAR_T2
VAR_NB
VAR_N
VAR_T
VAR_S
VAR_VARS_NB
VAR_TB
VAR_PTS
VAR_START_PTS
VAR_PREV_PTS
VAR_PREV_SELECTED_PTS
VAR_T
VAR_START_T
VAR_PREV_T
VAR_PREV_SELECTED_T
VAR_PICT_TYPE
VAR_PICT_TYPE_I
VAR_PICT_TYPE_P
VAR_PICT_TYPE_B
VAR_PICT_TYPE_S
VAR_PICT_TYPE_SI
VAR_PICT_TYPE_SP
VAR_PICT_TYPE_BI
VAR_INTERLACE_TYPE
VAR_INTERLACE_TYPE_P
VAR_INTERLACE_TYPE_T
VAR_INTERLACE_TYPE_B
VAR_CONSUMED_SAMPLES_N
VAR_SAMPLES_N
VAR_SAMPLE_RATE
VAR_N
VAR_SELECTED_N
VAR_PREV_SELECTED_N
VAR_KEY
VAR_POS
VAR_SCENE
VAR_VARS_NB
VAR_FRAME_RATE
VAR_INTERLACED
VAR_N
VAR_NB_CONSUMED_SAMPLES
VAR_NB_SAMPLES
VAR_POS
VAR_PREV_INPTS
VAR_PREV_INT
VAR_PREV_OUTPTS
VAR_PREV_OUTT
VAR_PTS
VAR_SAMPLE_RATE
VAR_STARTPTS
VAR_STARTT
VAR_T
VAR_TB
VAR_RTCTIME
VAR_RTCSTART
VAR_VARS_NB
VAR_AVTB
VAR_INTB
VAR_SR
VAR_VARS_NB
VAR_W
VAR_H
VAR_CW
VAR_CH
VAR_HSUB
VAR_VSUB
VARS_NB
VAR_IN_W
VAR_IW
VAR_IN_H
VAR_IH
VAR_OUT_W
VAR_OW
VAR_OUT_H
VAR_OH
VAR_A
VAR_SAR
VAR_DAR
VAR_HSUB
VAR_VSUB
VAR_X
VAR_Y
VAR_N
VAR_POS
VAR_T
VAR_VARS_NB
VAR_DAR
VAR_HSUB
VAR_VSUB
VAR_LINE_H
VAR_LH
VAR_MAIN_H
VAR_h
VAR_H
VAR_MAIN_W
VAR_w
VAR_W
VAR_MAX_GLYPH_A
VAR_ASCENT
VAR_MAX_GLYPH_D
VAR_DESCENT
VAR_MAX_GLYPH_H
VAR_MAX_GLYPH_W
VAR_N
VAR_SAR
VAR_T
VAR_TEXT_H
VAR_TH
VAR_TEXT_W
VAR_TW
VAR_X
VAR_Y
VAR_VARS_NB
VAR_N
VAR_PTS
VAR_R
VAR_T
VAR_TB
VAR_NB
VAR_W
VAR_H
VAR_VAL
VAR_MAXVAL
VAR_MINVAL
VAR_NEGVAL
VAR_CLIPVAL
VAR_VARS_NB
VAR_MAIN_W
VAR_MW
VAR_MAIN_H
VAR_MH
VAR_OVERLAY_W
VAR_OW
VAR_OVERLAY_H
VAR_OH
VAR_VARS_NB
VAR_IN_W
VAR_IW
VAR_IN_H
VAR_IH
VAR_OUT_W
VAR_OW
VAR_OUT_H
VAR_OH
VAR_X
VAR_Y
VAR_A
VAR_SAR
VAR_DAR
VAR_HSUB
VAR_VSUB
VARS_NB
VAR_IN_W
VAR_IW
VAR_IN_H
VAR_IH
VAR_OUT_W
VAR_OW
VAR_OUT_H
VAR_OH
VAR_A
VAR_SAR
VAR_DAR
VAR_HSUB
VAR_VSUB
VARS_NB
VAR_X
VAR_Y
VAR_W
VAR_H
VAR_TIME
VAR_SPEED
VAR_TEMPO
VAR_ORDER
VAR_PATTERN
VAR_ROW
VAR_VARS_NB

Definition at line 53 of file vf_overlay.c.

Function Documentation

AVFILTER_DEFINE_CLASS

(

overlay

)

static av_cold int init ( AVFilterContext *  ctx, const char *  args  )

static

Definition at line 119 of file vf_overlay.c.

static av_cold void uninit ( AVFilterContext *  ctx )

static

Definition at line 140 of file vf_overlay.c.

static int query_formats ( AVFilterContext *  ctx )

static

Definition at line 151 of file vf_overlay.c.

static int config_input_main ( AVFilterLink *  inlink )

static

Definition at line 215 of file vf_overlay.c.

static int config_input_overlay ( AVFilterLink *  inlink )

static

Definition at line 231 of file vf_overlay.c.

static int config_output ( AVFilterLink *  outlink )

static

Definition at line 294 of file vf_overlay.c.

static void blend_image ( AVFilterContext *  ctx, AVFilterBufferRef *  dst, AVFilterBufferRef *  src, int  x, int  y  )

static

Blend image in src to destination buffer dst at position (x, y).

< the amount of overlay to blend on to main

< the amount of overlay to blend on to main

Definition at line 318 of file vf_overlay.c.

Referenced by try_filter_frame().

static int try_filter_frame ( AVFilterContext *  ctx, AVFilterBufferRef *  mainpic  )

static

Definition at line 506 of file vf_overlay.c.

Referenced by filter_frame_main(), and try_filter_next_frame().

static int try_filter_next_frame ( AVFilterContext *  ctx )

static

Definition at line 549 of file vf_overlay.c.

Referenced by filter_frame_over(), flush_frames(), and request_frame().

static int flush_frames ( AVFilterContext *  ctx )

static

Definition at line 563 of file vf_overlay.c.

Referenced by filter_frame_main(), and filter_frame_over().

static int filter_frame_main ( AVFilterLink *  inlink, AVFilterBufferRef *  inpicref  )

static

Definition at line 571 of file vf_overlay.c.

static int filter_frame_over ( AVFilterLink *  inlink, AVFilterBufferRef *  inpicref  )

static

Definition at line 592 of file vf_overlay.c.

static int request_frame ( AVFilterLink *  outlink )

static

Definition at line 605 of file vf_overlay.c.

Variable Documentation

const char* const var_names[]

static

Initial value:

= {
    "main_w",    "W", 
    "main_h",    "H", 
    "overlay_w", "w", 
    "overlay_h", "h", 
    NULL
}

Definition at line 45 of file vf_overlay.c.

Referenced by config_input_overlay().

const AVOption overlay_options[]

static

Initial value:

= {
    { "x", "set the x expression", OFFSET(x_expr), AV_OPT_TYPE_STRING, {.str = "0"}, CHAR_MIN, CHAR_MAX, FLAGS },
    { "y", "set the y expression", OFFSET(y_expr), AV_OPT_TYPE_STRING, {.str = "0"}, CHAR_MIN, CHAR_MAX, FLAGS },
    { "rgb", "force packed RGB in input and output (deprecated)", OFFSET(allow_packed_rgb), AV_OPT_TYPE_INT, {.i64=0}, 0, 1, FLAGS },
    { "shortest", "force termination when the shortest input terminates", OFFSET(shortest), AV_OPT_TYPE_INT, { .i64 = 0 }, 0, 1, FLAGS },

    { "format", "set output format", OFFSET(format), AV_OPT_TYPE_INT, {.i64=OVERLAY_FORMAT_YUV420}, 0, OVERLAY_FORMAT_NB-1, FLAGS, "format" },
    { "yuv420", "", 0, AV_OPT_TYPE_CONST, {.i64=OVERLAY_FORMAT_YUV420}, .flags = FLAGS, .unit = "format" },
    { "yuv444", "", 0, AV_OPT_TYPE_CONST, {.i64=OVERLAY_FORMAT_YUV444}, .flags = FLAGS, .unit = "format" },
    { "rgb",    "", 0, AV_OPT_TYPE_CONST, {.i64=OVERLAY_FORMAT_RGB},    .flags = FLAGS, .unit = "format" },

    { NULL }
}

Definition at line 103 of file vf_overlay.c.

enum AVPixelFormat alpha_pix_fmts[]

static

Initial value:

= {
    AV_PIX_FMT_YUVA420P, AV_PIX_FMT_YUVA444P,
    AV_PIX_FMT_ARGB, AV_PIX_FMT_ABGR, AV_PIX_FMT_RGBA,
    AV_PIX_FMT_BGRA, AV_PIX_FMT_NONE
}

Definition at line 209 of file vf_overlay.c.

Referenced by config_input_main(), and config_input_overlay().

const AVFilterPad avfilter_vf_overlay_inputs[]

static

Initial value:

= {
    {
        .name         = "main",
        .type         = AVMEDIA_TYPE_VIDEO,
        .get_video_buffer = ff_null_get_video_buffer,
        .config_props = config_input_main,
        .filter_frame = filter_frame_main,
        .min_perms    = AV_PERM_READ | AV_PERM_WRITE | AV_PERM_PRESERVE,
    },
    {
        .name         = "overlay",
        .type         = AVMEDIA_TYPE_VIDEO,
        .config_props = config_input_overlay,
        .filter_frame = filter_frame_over,
        .min_perms    = AV_PERM_READ | AV_PERM_PRESERVE,
    },
    { NULL }
}

Definition at line 635 of file vf_overlay.c.

const AVFilterPad avfilter_vf_overlay_outputs[]

static

Initial value:

= {
    {
        .name          = "default",
        .type          = AVMEDIA_TYPE_VIDEO,
        .rej_perms     = AV_PERM_WRITE,
        .config_props  = config_output,
        .request_frame = request_frame,
    },
    { NULL }
}

Definition at line 654 of file vf_overlay.c.

AVFilter avfilter_vf_overlay

Initial value:

= {
    .name      = "overlay",
    .description = NULL_IF_CONFIG_SMALL("Overlay a video source on top of the input."),

    .init      = init,
    .uninit    = uninit,

    .priv_size = sizeof(OverlayContext),

    .query_formats = query_formats,

    .inputs    = avfilter_vf_overlay_inputs,
    .outputs   = avfilter_vf_overlay_outputs,
    .priv_class = &overlay_class,
}

Definition at line 665 of file vf_overlay.c.