Go to the documentation of this file.
34 #include <sys/types.h>
42 #if CONFIG_LIBFONTCONFIG
43 #include <fontconfig/fontconfig.h>
69 #include FT_FREETYPE_H
79 "max_glyph_a",
"ascent",
80 "max_glyph_d",
"descent",
147 #if CONFIG_LIBFONTCONFIG
202 #if CONFIG_LIBFRIBIDI
208 #define OFFSET(x) offsetof(DrawTextContext, x)
209 #define FLAGS AV_OPT_FLAG_FILTERING_PARAM|AV_OPT_FLAG_VIDEO_PARAM
231 #if CONFIG_LIBFONTCONFIG
248 {
"start_number",
"start frame number for n/frame_num variable",
OFFSET(start_number),
AV_OPT_TYPE_INT, {.i64=0}, 0, INT_MAX,
FLAGS},
250 #if CONFIG_LIBFRIBIDI
255 {
"ft_load_flags",
"set font loading flags for libfreetype",
OFFSET(ft_load_flags),
AV_OPT_TYPE_FLAGS, { .i64 = FT_LOAD_DEFAULT }, 0, INT_MAX,
FLAGS,
"ft_load_flags" },
261 {
"vertical_layout",
NULL, 0,
AV_OPT_TYPE_CONST, { .i64 = FT_LOAD_VERTICAL_LAYOUT }, .flags =
FLAGS, .unit =
"ft_load_flags" },
265 {
"ignore_global_advance_width",
NULL, 0,
AV_OPT_TYPE_CONST, { .i64 = FT_LOAD_IGNORE_GLOBAL_ADVANCE_WIDTH }, .flags =
FLAGS, .unit =
"ft_load_flags" },
267 {
"ignore_transform",
NULL, 0,
AV_OPT_TYPE_CONST, { .i64 = FT_LOAD_IGNORE_TRANSFORM }, .flags =
FLAGS, .unit =
"ft_load_flags" },
276 #undef __FTERRORS_H__
277 #define FT_ERROR_START_LIST {
278 #define FT_ERRORDEF(e, v, s) { (e), (s) },
279 #define FT_ERROR_END_LIST { 0, NULL } };
287 #define FT_ERRMSG(e) ft_errors[e].err_msg
289 typedef struct Glyph {
291 FT_Glyph border_glyph;
293 unsigned int fontsize;
295 FT_Bitmap border_bitmap;
304 const Glyph *
a =
key, *bb =
b;
305 int64_t
diff = (int64_t)
a->code - (int64_t)bb->code;
308 return diff > 0 ? 1 : -1;
310 return FFDIFFSIGN((int64_t)
a->fontsize, (int64_t)bb->fontsize);
319 FT_BitmapGlyph bitmapglyph;
325 if (FT_Load_Char(
s->face,
code,
s->ft_load_flags))
334 glyph->fontsize =
s->fontsize;
336 if (FT_Get_Glyph(
s->face->glyph, &glyph->glyph)) {
341 glyph->border_glyph = glyph->glyph;
342 if (FT_Glyph_StrokeBorder(&glyph->border_glyph,
s->stroker, 0, 0) ||
343 FT_Glyph_To_Bitmap(&glyph->border_glyph, FT_RENDER_MODE_NORMAL, 0, 1)) {
347 bitmapglyph = (FT_BitmapGlyph) glyph->border_glyph;
348 glyph->border_bitmap = bitmapglyph->bitmap;
350 if (FT_Glyph_To_Bitmap(&glyph->glyph, FT_RENDER_MODE_NORMAL, 0, 1)) {
354 bitmapglyph = (FT_BitmapGlyph) glyph->glyph;
356 glyph->bitmap = bitmapglyph->bitmap;
357 glyph->bitmap_left = bitmapglyph->left;
358 glyph->bitmap_top = bitmapglyph->top;
359 glyph->advance =
s->face->glyph->advance.x >> 6;
362 FT_Glyph_Get_CBox(glyph->glyph, ft_glyph_bbox_pixels, &glyph->bbox);
389 if ((err = FT_Set_Pixel_Sizes(
s->face, 0, fontsize))) {
395 s->fontsize = fontsize;
405 if (
s->fontsize_pexpr)
408 if (
s->fontsize_expr ==
NULL)
421 unsigned int fontsize =
s->default_fontsize;
423 double size, roundedsize;
426 if (
s->fontsize_expr !=
NULL) {
435 if (!(roundedsize > INT_MIN && roundedsize < INT_MAX)) {
440 fontsize = roundedsize;
448 if (fontsize ==
s->fontsize)
459 err = FT_New_Face(
s->library, path,
index, &
s->face);
461 #if !CONFIG_LIBFONTCONFIG
470 #if CONFIG_LIBFONTCONFIG
474 FcConfig *fontconfig;
475 FcPattern *pat, *best;
476 FcResult
result = FcResultMatch;
483 fontconfig = FcInitLoadConfigAndFonts();
488 pat = FcNameParse(
s->fontfile ?
s->fontfile :
489 (
uint8_t *)(intptr_t)
"default");
495 FcPatternAddString(pat, FC_FAMILY,
s->font);
506 FcPatternAddDouble(pat, FC_SIZE,
size);
509 FcDefaultSubstitute(pat);
511 if (!FcConfigSubstitute(fontconfig, pat, FcMatchPattern)) {
513 FcPatternDestroy(pat);
517 best = FcFontMatch(fontconfig, pat, &
result);
518 FcPatternDestroy(pat);
520 if (!best ||
result != FcResultMatch) {
522 "Cannot find a valid font for the family %s\n",
528 FcPatternGetInteger(best, FC_INDEX, 0, &
index ) != FcResultMatch ||
529 FcPatternGetDouble (best, FC_SIZE, 0, &
size ) != FcResultMatch) {
534 if (FcPatternGetString(best, FC_FILE, 0, &filename) != FcResultMatch) {
542 s->default_fontsize =
size + 0.5;
547 FcConfigDestroy(fontconfig);
549 FcPatternDestroy(best);
563 #if CONFIG_LIBFONTCONFIG
564 err = load_font_fontconfig(
ctx);
579 if ((err =
av_file_map(
s->textfile, &textbuf, &textbuf_size, 0,
ctx)) < 0) {
581 "The text file '%s' could not be read or is empty\n",
586 if (textbuf_size > SIZE_MAX - 1 || !(
tmp =
av_realloc(
s->text, textbuf_size + 1))) {
591 memcpy(
s->text, textbuf, textbuf_size);
592 s->text[textbuf_size] = 0;
600 return c ==
'\n' ||
c ==
'\r' ||
c ==
'\f' ||
c ==
'\v';
603 #if CONFIG_LIBFRIBIDI
609 static const FriBidiFlags
flags = FRIBIDI_FLAGS_DEFAULT |
610 FRIBIDI_FLAGS_ARABIC;
611 FriBidiChar *unicodestr =
NULL;
613 FriBidiParType direction = FRIBIDI_PAR_LTR;
614 FriBidiStrIndex line_start = 0;
615 FriBidiStrIndex line_end = 0;
616 FriBidiLevel *embedding_levels =
NULL;
617 FriBidiArabicProp *ar_props =
NULL;
618 FriBidiCharType *bidi_types =
NULL;
621 len = strlen(
s->text);
625 len = fribidi_charset_to_unicode(FRIBIDI_CHAR_SET_UTF8,
626 s->text,
len, unicodestr);
633 fribidi_get_bidi_types(unicodestr,
len, bidi_types);
636 if (!embedding_levels) {
640 if (!fribidi_get_par_embedding_levels(bidi_types,
len, &direction,
650 fribidi_get_joining_types(unicodestr,
len, ar_props);
651 fribidi_join_arabic(bidi_types,
len, embedding_levels, ar_props);
652 fribidi_shape(
flags, embedding_levels,
len, ar_props, unicodestr);
654 for (line_end = 0, line_start = 0; line_end <
len; line_end++) {
655 if (
is_newline(unicodestr[line_end]) || line_end ==
len - 1) {
656 if (!fribidi_reorder_line(
flags, bidi_types,
657 line_end - line_start + 1, line_start,
658 direction, embedding_levels, unicodestr,
662 line_start = line_end + 1;
667 for (
i = 0, j = 0;
i <
len;
i++)
668 if (unicodestr[
i] != FRIBIDI_CHAR_FILL)
669 unicodestr[j++] = unicodestr[
i];
678 len = fribidi_unicode_to_charset(FRIBIDI_CHAR_SET_UTF8,
679 unicodestr,
len,
s->text);
698 s->fontsize_pexpr =
NULL;
701 s->default_fontsize = 16;
703 if (!
s->fontfile && !CONFIG_LIBFONTCONFIG) {
711 "Both text and text file provided. Please provide only one\n");
718 if (
s->reload && !
s->textfile)
721 if (
s->tc_opt_string) {
723 s->tc_opt_string,
ctx);
734 "Either text, a valid file or a timecode must be provided\n");
738 #if CONFIG_LIBFRIBIDI
740 if ((err = shape_text(
ctx)) < 0)
744 if ((err = FT_Init_FreeType(&(
s->library)))) {
746 "Could not load FreeType: %s\n",
FT_ERRMSG(err));
757 if (FT_Stroker_New(
s->library, &
s->stroker)) {
761 FT_Stroker_Set(
s->stroker,
s->borderw << 6, FT_STROKER_LINECAP_ROUND,
762 FT_STROKER_LINEJOIN_ROUND, 0);
765 s->use_kerning = FT_HAS_KERNING(
s->face);
775 s->tabsize *= glyph->advance;
778 (strchr(
s->text,
'%') || strchr(
s->text,
'\\')))
796 FT_Done_Glyph(glyph->glyph);
797 FT_Done_Glyph(glyph->border_glyph);
811 s->x_pexpr =
s->y_pexpr =
s->a_pexpr =
s->fontsize_pexpr =
NULL;
820 FT_Done_Face(
s->face);
821 FT_Stroker_Done(
s->stroker);
822 FT_Done_FreeType(
s->library);
845 s->var_values[
VAR_HSUB] = 1 <<
s->dc.hsub_max;
846 s->var_values[
VAR_VSUB] = 1 <<
s->dc.vsub_max;
856 s->x_pexpr =
s->y_pexpr =
s->a_pexpr =
NULL;
877 if (!strcmp(cmd,
"reinit")) {
882 new->class = &drawtext_class;
919 char *fct,
unsigned argc,
char **argv,
int tag)
928 char *fct,
unsigned argc,
char **argv,
int tag)
935 fmt = argc >= 1 ? argv[0] :
"flt";
944 if (!strcmp(fmt,
"flt")) {
946 }
else if (!strcmp(fmt,
"hms")) {
957 if (!strcmp(argv[2],
"24HH")) {
958 ms %= 24 * 60 * 60 * 1000;
965 (
int)(ms / (60 * 60 * 1000)),
966 (
int)(ms / (60 * 1000)) % 60,
967 (
int)(ms / 1000) % 60,
970 }
else if (!strcmp(fmt,
"localtime") ||
971 !strcmp(fmt,
"gmtime")) {
973 time_t ms = (time_t)
pts;
974 const char *timefmt = argc >= 3 ? argv[2] :
"%Y-%m-%d %H:%M:%S";
975 if (!strcmp(fmt,
"localtime"))
988 char *fct,
unsigned argc,
char **argv,
int tag)
997 char *fct,
unsigned argc,
char **argv,
int tag)
1010 char *fct,
unsigned argc,
char **argv,
int tag)
1012 const char *fmt = argc ? argv[0] :
"%Y-%m-%d %H:%M:%S";
1026 char *fct,
unsigned argc,
char **argv,
int tag)
1037 "Expression '%s' for the expr text expansion function is not valid\n",
1046 char *fct,
unsigned argc,
char **argv,
int tag)
1053 char fmt_str[30] =
"%";
1066 "Expression '%s' for the expr text expansion function is not valid\n",
1071 if (!strchr(
"xXdu", argv[1][0])) {
1073 " allowed values: 'x', 'X', 'd', 'u'\n", argv[1][0]);
1081 " to print: '%s'\n", argv[2]);
1086 feclearexcept(FE_ALL_EXCEPT);
1088 #if defined(FE_INVALID) && defined(FE_OVERFLOW) && defined(FE_UNDERFLOW)
1089 if ((
ret = fetestexcept(FE_INVALID|FE_OVERFLOW|FE_UNDERFLOW))) {
1090 av_log(
ctx,
AV_LOG_ERROR,
"Conversion of floating-point result to int failed. Control register: 0x%08x. Conversion result: %d\n",
ret, intval);
1097 av_strlcatf(fmt_str,
sizeof(fmt_str),
"%c", argv[1][0]);
1100 res, argv[0], fmt_str);
1127 unsigned argc,
char **argv)
1155 const char *text = *rtext;
1156 char *argv[16] = {
NULL };
1157 unsigned argc = 0,
i;
1185 *rtext = (
char *)text + 1;
1188 for (
i = 0;
i < argc;
i++)
1199 if (*text ==
'\\' && text[1]) {
1202 }
else if (*text ==
'%') {
1219 int x,
int y,
int borderw)
1221 char *text =
s->expanded_text.str;
1225 Glyph *glyph =
NULL;
1227 for (
i = 0, p = text; *p;
i++) {
1229 Glyph
dummy = { 0 };
1231 continue_on_invalid:
1238 dummy.fontsize =
s->fontsize;
1241 bitmap = borderw ? glyph->border_bitmap : glyph->bitmap;
1243 if (glyph->bitmap.pixel_mode != FT_PIXEL_MODE_MONO &&
1244 glyph->bitmap.pixel_mode != FT_PIXEL_MODE_GRAY)
1247 x1 =
s->positions[
i].x+
s->x+x - borderw;
1248 y1 =
s->positions[
i].y+
s->y+y - borderw;
1252 bitmap.buffer, bitmap.pitch,
1253 bitmap.width, bitmap.rows,
1254 bitmap.pixel_mode == FT_PIXEL_MODE_MONO ? 0 : 3,
1265 color->rgba[3] = (
color->rgba[3] *
s->alpha) / 255;
1278 else if (
alpha <= 0)
1290 uint32_t
code = 0, prev_code = 0;
1291 int x = 0, y = 0,
i = 0,
ret;
1292 int max_text_line_w = 0,
len;
1296 int y_min = 32000, y_max = -32000;
1297 int x_min = 32000, x_max = -32000;
1299 Glyph *glyph =
NULL, *prev_glyph =
NULL;
1300 Glyph
dummy = { 0 };
1302 time_t now = time(0);
1304 AVBPrint *bp = &
s->expanded_text;
1314 now=
frame->pts*
av_q2d(
ctx->inputs[0]->time_base) +
s->basetime/1000000;
1316 switch (
s->exp_mode) {
1330 if (
s->tc_opt_string) {
1339 text =
s->expanded_text.str;
1340 if ((
len =
s->expanded_text.len) >
s->nb_positions) {
1341 if (!(
s->positions =
1344 s->nb_positions =
len;
1347 if (
s->fontcolor_expr[0]) {
1368 for (
i = 0, p = text; *p;
i++) {
1370 continue_on_invalid:
1374 dummy.fontsize =
s->fontsize;
1382 y_min =
FFMIN(glyph->bbox.yMin, y_min);
1383 y_max =
FFMAX(glyph->bbox.yMax, y_max);
1384 x_min =
FFMIN(glyph->bbox.xMin, x_min);
1385 x_max =
FFMAX(glyph->bbox.xMax, x_max);
1387 s->max_glyph_h = y_max - y_min;
1388 s->max_glyph_w = x_max - x_min;
1392 for (
i = 0, p = text; *p;
i++) {
1394 continue_on_invalid2:
1397 if (prev_code ==
'\r' &&
code ==
'\n')
1403 max_text_line_w =
FFMAX(max_text_line_w, x);
1404 y +=
s->max_glyph_h +
s->line_spacing;
1412 dummy.fontsize =
s->fontsize;
1416 if (
s->use_kerning && prev_glyph && glyph->code) {
1417 FT_Get_Kerning(
s->face, prev_glyph->code, glyph->code,
1418 ft_kerning_default, &
delta);
1423 s->positions[
i].x = x + glyph->bitmap_left;
1424 s->positions[
i].y = y - glyph->bitmap_top + y_max;
1425 if (
code ==
'\t') x = (x /
s->tabsize + 1)*
s->tabsize;
1426 else x += glyph->advance;
1429 max_text_line_w =
FFMAX(x, max_text_line_w);
1452 box_w = max_text_line_w;
1453 box_h = y +
s->max_glyph_h;
1455 if (
s->fix_bounds) {
1458 int boxoffset =
s->draw_box ?
FFMAX(
s->boxborderw, 0) : 0;
1459 int borderoffset =
s->borderw ?
FFMAX(
s->borderw, 0) : 0;
1461 int offsetleft =
FFMAX3(boxoffset, borderoffset,
1462 (
s->shadowx < 0 ?
FFABS(
s->shadowx) : 0));
1463 int offsettop =
FFMAX3(boxoffset, borderoffset,
1464 (
s->shadowy < 0 ?
FFABS(
s->shadowy) : 0));
1466 int offsetright =
FFMAX3(boxoffset, borderoffset,
1467 (
s->shadowx > 0 ?
s->shadowx : 0));
1468 int offsetbottom =
FFMAX3(boxoffset, borderoffset,
1469 (
s->shadowy > 0 ?
s->shadowy : 0));
1472 if (
s->x - offsetleft < 0)
s->x = offsetleft;
1473 if (
s->y - offsettop < 0)
s->y = offsettop;
1475 if (
s->x + box_w + offsetright >
width)
1477 if (
s->y + box_h + offsetbottom >
height)
1485 s->x -
s->boxborderw,
s->y -
s->boxborderw,
1486 box_w +
s->boxborderw * 2, box_h +
s->boxborderw * 2);
1488 if (
s->shadowx ||
s->shadowy) {
1490 &shadowcolor,
s->shadowx,
s->shadowy, 0)) < 0)
1496 &bordercolor, 0, 0,
s->borderw)) < 0)
1500 &fontcolor, 0, 0, 0)) < 0)
1518 #if CONFIG_LIBFRIBIDI
1519 if (
s->text_shaping)
1520 if ((
ret = shape_text(
ctx)) < 0) {
1527 s->var_values[
VAR_N] =
inlink->frame_count_out +
s->start_number;
1535 s->metadata =
frame->metadata;
1553 .needs_writable = 1,
1568 .description =
NULL_IF_CONFIG_SMALL(
"Draw text on top of video frames using libfreetype library."),
1570 .priv_class = &drawtext_class,
static void error(const char *err)
FT_Library library
freetype font library handle
static const char *const fun2_names[]
#define AV_LOG_WARNING
Something somehow does not look correct.
int(* func)(AVFilterContext *, AVBPrint *, char *, unsigned, char **, int)
#define AV_BPRINT_SIZE_UNLIMITED
#define AV_TIMECODE_STR_SIZE
it s the only field you need to keep assuming you have a context There is some magic you don t need to care about around this just let it vf default minimum maximum flags name is the option name
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
int av_bprint_finalize(AVBPrint *buf, char **ret_str)
Finalize a print buffer.
av_cold void av_lfg_init(AVLFG *c, unsigned int seed)
void av_bprint_init(AVBPrint *buf, unsigned size_init, unsigned size_max)
char * av_get_token(const char **buf, const char *term)
Unescape the given string until a non escaped terminating char, and return the token corresponding to...
static int filter_frame(AVFilterLink *inlink, AVFrame *frame)
int ff_filter_frame(AVFilterLink *link, AVFrame *frame)
Send a frame of data to the next filter.
static int func_pts(AVFilterContext *ctx, AVBPrint *bp, char *fct, unsigned argc, char **argv, int tag)
int av_parse_color(uint8_t *rgba_color, const char *color_string, int slen, void *log_ctx)
Put the RGBA values that correspond to color_string in rgba_color.
void * av_tree_insert(AVTreeNode **tp, void *key, int(*cmp)(const void *key, const void *b), AVTreeNode **next)
Insert or remove an element.
unsigned int default_fontsize
default font size to use
static int func_frame_num(AVFilterContext *ctx, AVBPrint *bp, char *fct, unsigned argc, char **argv, int tag)
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
int tc24hmax
1 if timecode is wrapped to 24 hours, 0 otherwise
void av_frame_free(AVFrame **frame)
Free the frame and any dynamically allocated objects in it, e.g.
static av_cold int end(AVCodecContext *avctx)
This structure describes decoded (raw) audio or video data.
int x
x position to start drawing text
FFDrawColor bordercolor
border color
void av_bprint_strftime(AVBPrint *buf, const char *fmt, const struct tm *tm)
Append a formatted date and time to a print buffer.
int exp_mode
expansion mode to use for the text
size_t nb_positions
number of elements of positions array
static int func_pict_type(AVFilterContext *ctx, AVBPrint *bp, char *fct, unsigned argc, char **argv, int tag)
FT_Stroker stroker
freetype stroker handle
const char * name
Filter name.
static int expand_function(AVFilterContext *ctx, AVBPrint *bp, char **rtext)
struct AVTreeNode * av_tree_node_alloc(void)
Allocate an AVTreeNode.
static int func_metadata(AVFilterContext *ctx, AVBPrint *bp, char *fct, unsigned argc, char **argv, int tag)
#define AVERROR_UNKNOWN
Unknown error, typically from an external library.
A link between two filters.
size_t av_strlcatf(char *dst, size_t size, const char *fmt,...)
void av_tree_enumerate(AVTreeNode *t, void *opaque, int(*cmp)(void *opaque, void *elem), int(*enu)(void *opaque, void *elem))
Apply enu(opaque, &elem) to all the elements in the tree in a given range.
uint32_t av_get_random_seed(void)
Get a seed to use in conjunction with random functions.
int start_number
starting frame number for n/frame_num var
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.
uint8_t * text
text to be drawn
AVBPrint expanded_text
used to contain the expanded text
int av_set_options_string(void *ctx, const char *opts, const char *key_val_sep, const char *pairs_sep)
Parse the key/value pairs list in opts.
unsigned int fontsize
font size to use
static int func_eval_expr(AVFilterContext *ctx, AVBPrint *bp, char *fct, unsigned argc, char **argv, int tag)
char * x_expr
expression for x position
const static uint16_t positions[][14][3]
uint8_t * fontfile
font to be used
int av_file_map(const char *filename, uint8_t **bufptr, size_t *size, int log_offset, void *log_ctx)
Read the file with name filename, and put its content in a newly allocated buffer or map it with mmap...
AVExpr * y_pexpr
parsed expressions for x and y
char * av_timecode_make_string(const AVTimecode *tc, char *buf, int framenum)
Load timecode string in buf.
static int is_newline(uint32_t c)
void ff_blend_mask(FFDrawContext *draw, FFDrawColor *color, uint8_t *dst[], int dst_linesize[], int dst_w, int dst_h, const uint8_t *mask, int mask_linesize, int mask_w, int mask_h, int l2depth, unsigned endianness, int x0, int y0)
Blend an alpha mask with an uniform color.
void av_expr_free(AVExpr *e)
Free a parsed expression previously created with av_expr_parse().
A filter pad used for either input or output.
double var_values[VAR_VARS_NB]
#define GET_UTF8(val, GET_BYTE, ERROR)
Convert a UTF-8 character (up to 4 bytes) to its 32-bit UCS-4 encoded form.
static const AVFilterPad avfilter_vf_drawtext_inputs[]
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
static void update_alpha(DrawTextContext *s)
FT_Face face
freetype font face handle
AVDictionaryEntry * av_dict_get(const AVDictionary *m, const char *key, const AVDictionaryEntry *prev, int flags)
Get a dictionary entry with matching key.
static av_cold int update_fontsize(AVFilterContext *ctx)
int y
y position to start drawing text
static unsigned int av_lfg_get(AVLFG *c)
Get the next random unsigned 32-bit number using an ALFG.
FFDrawColor fontcolor
foreground color
static double av_q2d(AVRational a)
Convert an AVRational to a double.
#define FF_DRAW_PROCESS_ALPHA
Process alpha pixel component.
int boxborderw
box border width
static const AVFilterPad outputs[]
#define AV_LOG_DEBUG
Stuff which is only useful for libav* developers.
double av_expr_eval(AVExpr *e, const double *const_values, void *opaque)
Evaluate a previously parsed expression.
int ff_draw_init(FFDrawContext *draw, enum AVPixelFormat format, unsigned flags)
Init a draw context.
AVExpr * fontsize_pexpr
parsed expressions for fontsize
double(* eval_func2)(void *, double a, double b)
static int command(AVFilterContext *ctx, const char *cmd, const char *arg, char *res, int res_len, int flags)
void av_file_unmap(uint8_t *bufptr, size_t size)
Unmap or free the buffer bufptr created by av_file_map().
#define FFABS(a)
Absolute value, Note, INT_MIN / INT64_MIN result in undefined behavior as they are not representable ...
Describe the class of an AVClass context structure.
and forward the result(frame or status change) to the corresponding input. If nothing is possible
int64_t basetime
base pts time in the real world for display
Rational number (pair of numerator and denominator).
char * fontsize_expr
expression for fontsize
static int query_formats(AVFilterContext *ctx)
static int draw_text(AVFilterContext *ctx, AVFrame *frame, int width, int height)
AVRational tc_rate
frame rate for timecode
int av_parse_time(int64_t *timeval, const char *timestr, int duration)
Parse timestr and return in *time a corresponding number of microseconds.
FT_Vector * positions
positions for each element in the text
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 inputs
static int load_font_file(AVFilterContext *ctx, const char *path, int index)
void av_tree_destroy(AVTreeNode *t)
Undefined Behavior In the C some operations are like signed integer dereferencing freed accessing outside allocated Undefined Behavior must not occur in a C it is not safe even if the output of undefined operations is unused The unsafety may seem nit picking but Optimizing compilers have in fact optimized code on the assumption that no undefined Behavior occurs Optimizing code based on wrong assumptions can and has in some cases lead to effects beyond the output of computations The signed integer overflow problem in speed critical code Code which is highly optimized and works with signed integers sometimes has the problem that often the output of the computation does not c
static const char *const var_names[]
static int av_bprint_is_complete(const AVBPrint *buf)
Test if the print buffer is complete (not truncated).
int reload
reload text file for each frame
static int draw_glyphs(DrawTextContext *s, AVFrame *frame, int width, int height, FFDrawColor *color, int x, int y, int borderw)
static av_cold int set_fontsize(AVFilterContext *ctx, unsigned int fontsize)
static av_cold void uninit(AVFilterContext *ctx)
static int load_font(AVFilterContext *ctx)
Context structure for the Lagged Fibonacci PRNG.
#define NULL_IF_CONFIG_SMALL(x)
Return NULL if CONFIG_SMALL is true, otherwise the argument without modification.
int av_expr_parse_and_eval(double *d, const char *s, const char *const *const_names, const double *const_values, const char *const *func1_names, double(*const *funcs1)(void *, double), const char *const *func2_names, double(*const *funcs2)(void *, double, double), void *opaque, int log_offset, void *log_ctx)
Parse and evaluate an expression.
void ff_blend_rectangle(FFDrawContext *draw, FFDrawColor *color, uint8_t *dst[], int dst_linesize[], int dst_w, int dst_h, int x0, int y0, int w, int h)
Blend a rectangle with an uniform color.
short int draw_box
draw box around text - true or false
#define AV_NOPTS_VALUE
Undefined timestamp value.
#define FFDIFFSIGN(x, y)
Comparator.
static double drand(void *opaque, double min, double max)
AVFILTER_DEFINE_CLASS(drawtext)
static int expand_text(AVFilterContext *ctx, char *text, AVBPrint *bp)
The reader does not expect b to be semantically here and if the code is changed by maybe adding a a division or other the signedness will almost certainly be mistaken To avoid this confusion a new type was SUINT is the C unsigned type but it holds a signed int to use the same example SUINT a
@ AV_TIMECODE_FLAG_24HOURSMAX
timecode wraps after 24 hours
AVBPrint expanded_fontcolor
used to contain the expanded fontcolor spec
static void update_color_with_alpha(DrawTextContext *s, FFDrawColor *color, const FFDrawColor incolor)
#define AVERROR_EXTERNAL
Generic error in an external library.
static const eval_func2 fun2[]
#define AV_LOG_INFO
Standard information.
#define AVFILTER_FLAG_SUPPORT_TIMELINE_GENERIC
Some filters support a generic "enable" expression option that can be used to enable or disable a fil...
void * av_realloc(void *ptr, size_t size)
Allocate, reallocate, or free a block of memory.
char av_get_picture_type_char(enum AVPictureType pict_type)
Return a single letter to describe the given picture type pict_type.
static int glyph_enu_free(void *opaque, void *elem)
#define i(width, name, range_min, range_max)
and forward the test the status of outputs and forward it to the corresponding return FFERROR_NOT_READY If the filters stores internally one or a few frame for some it can consider them to be part of the FIFO and delay acknowledging a status change accordingly Example code
static av_always_inline av_const double round(double x)
#define AV_TIME_BASE
Internal time base represented as integer.
AVFilterFormats * ff_draw_supported_pixel_formats(unsigned flags)
Return the list of pixel formats supported by the draw functions.
#define av_malloc_array(a, b)
static int process_command(AVFilterContext *ctx, const char *cmd, const char *args, char *res, int res_len, int flags)
static av_cold int init(AVFilterContext *ctx)
int tag
opaque argument to func
int max_glyph_h
max glyph height
void * av_mallocz(size_t size)
Allocate a memory block with alignment suitable for all memory accesses (including vectors if availab...
const char * name
Pad name.
static int config_input(AVFilterLink *inlink)
int use_kerning
font kerning is used - true/false
void ff_draw_color(FFDrawContext *draw, FFDrawColor *color, const uint8_t rgba[4])
Prepare a color.
AVTimecode tc
timecode context
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
void av_bprintf(AVBPrint *buf, const char *fmt,...)
#define FF_ARRAY_ELEMS(a)
int ft_load_flags
flags used for loading fonts, see FT_LOAD_*
void av_bprint_clear(AVBPrint *buf)
Reset the string to "" but keep internal allocated data.
static const struct ft_error ft_errors[]
static const AVOption drawtext_options[]
FFDrawColor shadowcolor
shadow color
static int eval_function(AVFilterContext *ctx, AVBPrint *bp, char *fct, unsigned argc, char **argv)
int reinit
tells if the filter is being reinited
static int func_strftime(AVFilterContext *ctx, AVBPrint *bp, char *fct, unsigned argc, char **argv, int tag)
static int func_eval_expr_int_format(AVFilterContext *ctx, AVBPrint *bp, char *fct, unsigned argc, char **argv, int tag)
void * av_tree_find(const AVTreeNode *t, void *key, int(*cmp)(const void *key, const void *b), void *next[2])
char * av_strdup(const char *s)
Duplicate a string.
struct AVTreeNode * glyphs
rendered glyphs, stored using the UTF-32 char code
char * textfile
file with text to be drawn
static int load_textfile(AVFilterContext *ctx)
static const struct drawtext_function functions[]
int av_opt_copy(void *dst, const void *src)
Copy options from src object into dest object.
static av_always_inline int diff(const uint32_t a, const uint32_t b)
static const AVFilterPad avfilter_vf_drawtext_outputs[]
static const int16_t alpha[]
static int glyph_cmp(const void *key, const void *b)
FFDrawColor boxcolor
background color
static int load_glyph(AVFilterContext *ctx, Glyph **glyph_ptr, uint32_t code)
Load glyphs corresponding to the UTF-32 codepoint code.
#define flags(name, subs,...)
static av_cold int parse_fontsize(AVFilterContext *ctx)
int av_timecode_init_from_string(AVTimecode *tc, AVRational rate, const char *str, void *log_ctx)
Parse timecode representation (hh:mm:ss[:;.
char * y_expr
expression for y position
int line_spacing
lines spacing in pixels
void av_bprint_chars(AVBPrint *buf, char c, unsigned n)
Append char c n times to a print buffer.
uint8_t * fontcolor_expr
fontcolor expression to evaluate
int max_glyph_w
max glyph width
char * tc_opt_string
specified timecode option string
static void drawtext(AVFrame *pic, int x, int y, const char *txt, uint32_t color)
int fix_bounds
do we let it go out of frame bounds - t/f