FFmpeg
Loading...
Searching...
No Matches
vf_drawtext.c
Go to the documentation of this file.
1/*
2 * Copyright (c) 2023 Francesco Carusi
3 * Copyright (c) 2011 Stefano Sabatini
4 * Copyright (c) 2010 S.N. Hemanth Meenakshisundaram
5 * Copyright (c) 2003 Gustavo Sverzut Barbieri <gsbarbieri@yahoo.com.br>
6 *
7 * This file is part of FFmpeg.
8 *
9 * FFmpeg is free software; you can redistribute it and/or
10 * modify it under the terms of the GNU Lesser General Public
11 * License as published by the Free Software Foundation; either
12 * version 2.1 of the License, or (at your option) any later version.
13 *
14 * FFmpeg is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
17 * Lesser General Public License for more details.
18 *
19 * You should have received a copy of the GNU Lesser General Public
20 * License along with FFmpeg; if not, write to the Free Software
21 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
22 */
23
24/**
25 * @file
26 * drawtext filter, based on the original vhook/drawtext.c
27 * filter by Gustavo Sverzut Barbieri
28 */
29
30#include "config.h"
31
32#if HAVE_SYS_TIME_H
33#include <sys/time.h>
34#endif
35#include <sys/types.h>
36#include <sys/stat.h>
37#include <time.h>
38#if HAVE_UNISTD_H
39#include <unistd.h>
40#endif
41#include <fenv.h>
42
43#if CONFIG_LIBFONTCONFIG
44#include <fontconfig/fontconfig.h>
45#endif
46
47#include "libavutil/avstring.h"
48#include "libavutil/bprint.h"
49#include "libavutil/common.h"
50#include "libavutil/eval.h"
51#include "libavutil/mem.h"
52#include "libavutil/opt.h"
55#include "libavutil/time.h"
56#include "libavutil/timecode.h"
58#include "libavutil/tree.h"
59#include "libavutil/lfg.h"
61#include "avfilter.h"
62#include "drawutils.h"
63#include "filters.h"
64#include "formats.h"
65#include "textutils.h"
66#include "video.h"
67
68#if CONFIG_LIBFRIBIDI
69#include <fribidi.h>
70#endif
71
72#include <ft2build.h>
73#include FT_FREETYPE_H
74#include FT_GLYPH_H
75#include FT_STROKER_H
76
77#include <hb.h>
78#include <hb-ft.h>
79
80// Ceiling operation for positive integers division
81#define POS_CEIL(x, y) ((x)/(y) + ((x)%(y) != 0))
82
83static const char *const var_names[] = {
84 "dar",
85 "hsub", "vsub",
86 "line_h", "lh", ///< line height
87 "main_h", "h", "H", ///< height of the input video
88 "main_w", "w", "W", ///< width of the input video
89 "max_glyph_a", "ascent", ///< max glyph ascender
90 "max_glyph_d", "descent", ///< min glyph descender
91 "max_glyph_h", ///< max glyph height
92 "max_glyph_w", ///< max glyph width
93 "font_a", ///< font-defined ascent
94 "font_d", ///< font-defined descent
95 "top_a", ///< max glyph ascender of the top line
96 "bottom_d", ///< max glyph descender of the bottom line
97 "n", ///< number of frame
98 "sar",
99 "t", ///< timestamp expressed in seconds
100 "text_h", "th", ///< height of the rendered text
101 "text_w", "tw", ///< width of the rendered text
102 "x",
103 "y",
104 "pict_type",
105 "duration",
106 NULL
107};
108
109static const char *const fun2_names[] = {
110 "rand"
111};
112
113static double drand(void *opaque, double min, double max)
114{
115 return min + (max-min) / UINT_MAX * av_lfg_get(opaque);
116}
117
118typedef double (*eval_func2)(void *, double a, double b);
119
120static const eval_func2 fun2[] = {
121 drand,
122 NULL
123};
124
150
156
162
164 TA_LEFT = (1 << 0),
165 TA_RIGHT = (1 << 1),
166 TA_TOP = (1 << 2),
167 TA_BOTTOM = (1 << 3),
168};
169
170typedef struct HarfbuzzData {
171 hb_buffer_t* buf;
172 hb_font_t* font;
173 unsigned int glyph_count;
174 hb_glyph_info_t* glyph_info;
175 hb_glyph_position_t* glyph_pos;
177
178/** Information about a single glyph in a text line */
179typedef struct GlyphInfo {
180 uint32_t code; ///< the glyph code point
181 int x; ///< the x position of the glyph
182 int y; ///< the y position of the glyph
183 int shift_x64; ///< the horizontal shift of the glyph in 26.6 units
184 int shift_y64; ///< the vertical shift of the glyph in 26.6 units
185} GlyphInfo;
186
187/** Information about a single line of text */
188typedef struct TextLine {
189 int offset_left64; ///< offset between the origin and
190 /// the leftmost pixel of the first glyph
191 int offset_right64; ///< maximum offset between the origin and
192 /// the rightmost pixel of the last glyph
193 int width64; ///< width of the line
194 HarfbuzzData hb_data; ///< libharfbuzz data of this text line
195 GlyphInfo* glyphs; ///< array of glyphs in this text line
196 int cluster_offset; ///< the offset at which this line begins
197} TextLine;
198
199/** A glyph as loaded and rendered using libfreetype */
200typedef struct Glyph {
201 FT_Glyph glyph;
202 FT_Glyph border_glyph;
203 uint32_t code;
204 unsigned int fontsize;
205 /** Glyph bitmaps with 1/4 pixel precision in both directions */
206 FT_BitmapGlyph bglyph[16];
207 /** Outlined glyph bitmaps with 1/4 pixel precision in both directions */
208 FT_BitmapGlyph border_bglyph[16];
209 FT_BBox bbox;
210} Glyph;
211
212/** Global text metrics */
213typedef struct TextMetrics {
214 int offset_top64; ///< ascender amount of the first line (in 26.6 units)
215 int offset_bottom64; ///< descender amount of the last line (in 26.6 units)
216 int offset_left64; ///< maximum offset between the origin and
217 /// the leftmost pixel of the first glyph
218 /// of each line (in 26.6 units)
219 int offset_right64; ///< maximum offset between the origin and
220 /// the rightmost pixel of the last glyph
221 /// of each line (in 26.6 units)
222 int line_height64; ///< the font-defined line height
223 int width; ///< width of the longest line - ceil(width64/64)
224 int height; ///< total height of the text - ceil(height64/64)
225
226 int min_y64; ///< minimum value of bbox.yMin among glyphs (in 26.6 units)
227 int max_y64; ///< maximum value of bbox.yMax among glyphs (in 26.6 units)
228 int min_x64; ///< minimum value of bbox.xMin among glyphs (in 26.6 units)
229 int max_x64; ///< maximum value of bbox.xMax among glyphs (in 26.6 units)
230
231 // Position of the background box (without borders)
232 int rect_x; ///< x position of the box
233 int rect_y; ///< y position of the box
235
236typedef struct DrawTextContext {
237 const AVClass *class;
238 int exp_mode; ///< expansion mode to use for the text
239 FFExpandTextContext expand_text; ///< expand text in case exp_mode == NORMAL
240 int reinit; ///< tells if the filter is being reinited
241#if CONFIG_LIBFONTCONFIG
242 uint8_t *font; ///< font to be used
243#endif
244 uint8_t *fontfile; ///< font to be used
245 uint8_t *text; ///< text to be drawn
246 AVBPrint expanded_text; ///< used to contain the expanded text
247 uint8_t *fontcolor_expr; ///< fontcolor expression to evaluate
248 AVBPrint expanded_fontcolor; ///< used to contain the expanded fontcolor spec
249 int ft_load_flags; ///< flags used for loading fonts, see FT_LOAD_*
250 char *textfile; ///< file with text to be drawn
251 double x; ///< x position to start drawing text
252 double y; ///< y position to start drawing text
253 int max_glyph_w; ///< max glyph width
254 int max_glyph_h; ///< max glyph height
256 int borderw; ///< border width
257 char *fontsize_expr; ///< expression for fontsize
258 AVExpr *fontsize_pexpr; ///< parsed expressions for fontsize
259 unsigned int fontsize; ///< font size to use
260 unsigned int default_fontsize; ///< default font size to use
261
262 int line_spacing; ///< lines spacing in pixels
263 short int draw_box; ///< draw box around text - true or false
264 char *boxborderw; ///< box border width (padding)
265 /// allowed formats: "all", "vert|oriz", "top|right|bottom|left"
266 int bb_top; ///< the size of the top box border
267 int bb_right; ///< the size of the right box border
268 int bb_bottom; ///< the size of the bottom box border
269 int bb_left; ///< the size of the left box border
270 int box_width; ///< the width of box
271 int box_height; ///< the height of box
272 int tabsize; ///< tab size
273 int fix_bounds; ///< do we let it go out of frame bounds - t/f
274
276 FFDrawColor fontcolor; ///< foreground color
277 FFDrawColor shadowcolor; ///< shadow color
278 FFDrawColor bordercolor; ///< border color
279 FFDrawColor boxcolor; ///< background color
280
281 FT_Library library; ///< freetype font library handle
282 FT_Face face; ///< freetype font face handle
283 FT_Stroker stroker; ///< freetype stroker handle
284 struct AVTreeNode *glyphs; ///< rendered glyphs, stored using the UTF-32 char code
285 char *x_expr; ///< expression for x position
286 char *y_expr; ///< expression for y position
287 AVExpr *x_pexpr, *y_pexpr; ///< parsed expressions for x and y
288 int64_t basetime; ///< base pts time in the real world for display
290 char *a_expr;
292 int alpha;
293 AVLFG prng; ///< random
294 char *tc_opt_string; ///< specified timecode option string
295 AVRational tc_rate; ///< frame rate for timecode
296 AVTimecode tc; ///< timecode context
297 int tc24hmax; ///< 1 if timecode is wrapped to 24 hours, 0 otherwise
298 int reload; ///< reload text file at specified frame interval
299 int start_number; ///< starting frame number for n/frame_num var
300 char *text_source_string; ///< the string to specify text data source
302#if CONFIG_LIBFRIBIDI
303 int text_shaping; ///< 1 to shape the text before drawing it
304#endif
306
307 int boxw; ///< the value of the boxw parameter
308 int boxh; ///< the value of the boxh parameter
309 int text_align; ///< the horizontal and vertical text alignment
310 int y_align; ///< the value of the y_align parameter
311
312 TextLine *lines; ///< computed information about text lines
313 int line_count; ///< the number of text lines
314 uint32_t *tab_clusters; ///< the position of tab characters in the text
315 int tab_count; ///< the number of tab characters
316 int blank_advance64; ///< the size of the space character
317 int tab_warning_printed; ///< ensure the tab warning to be printed only once
319
320#define OFFSET(x) offsetof(DrawTextContext, x)
321#define FLAGS AV_OPT_FLAG_FILTERING_PARAM|AV_OPT_FLAG_VIDEO_PARAM
322#define TFLAGS AV_OPT_FLAG_FILTERING_PARAM|AV_OPT_FLAG_VIDEO_PARAM|AV_OPT_FLAG_RUNTIME_PARAM
323
324static const AVOption drawtext_options[]= {
325 {"fontfile", "set font file", OFFSET(fontfile), AV_OPT_TYPE_STRING, {.str=NULL}, 0, 0, FLAGS},
326 {"text", "set text", OFFSET(text), AV_OPT_TYPE_STRING, {.str=NULL}, 0, 0, TFLAGS},
327 {"textfile", "set text file", OFFSET(textfile), AV_OPT_TYPE_STRING, {.str=NULL}, 0, 0, FLAGS},
328 {"fontcolor", "set foreground color", OFFSET(fontcolor.rgba), AV_OPT_TYPE_COLOR, {.str="black"}, 0, 0, TFLAGS},
329 {"fontcolor_expr", "set foreground color expression", OFFSET(fontcolor_expr), AV_OPT_TYPE_STRING, {.str=""}, 0, 0, FLAGS},
330 {"boxcolor", "set box color", OFFSET(boxcolor.rgba), AV_OPT_TYPE_COLOR, {.str="white"}, 0, 0, TFLAGS},
331 {"bordercolor", "set border color", OFFSET(bordercolor.rgba), AV_OPT_TYPE_COLOR, {.str="black"}, 0, 0, TFLAGS},
332 {"shadowcolor", "set shadow color", OFFSET(shadowcolor.rgba), AV_OPT_TYPE_COLOR, {.str="black"}, 0, 0, TFLAGS},
333 {"box", "set box", OFFSET(draw_box), AV_OPT_TYPE_BOOL, {.i64=0}, 0, 1, TFLAGS},
334 {"boxborderw", "set box borders width", OFFSET(boxborderw), AV_OPT_TYPE_STRING, {.str="0"}, 0, 0, TFLAGS},
335 {"line_spacing", "set line spacing in pixels", OFFSET(line_spacing), AV_OPT_TYPE_INT, {.i64=0}, INT_MIN, INT_MAX, TFLAGS},
336 {"fontsize", "set font size", OFFSET(fontsize_expr), AV_OPT_TYPE_STRING, {.str=NULL}, 0, 0, TFLAGS},
337 {"text_align", "set text alignment", OFFSET(text_align), AV_OPT_TYPE_FLAGS, {.i64=0}, 0, (TA_LEFT|TA_RIGHT|TA_TOP|TA_BOTTOM), TFLAGS, .unit = "text_align"},
338 { "left", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = TA_LEFT }, .flags = TFLAGS, .unit = "text_align" },
339 { "L", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = TA_LEFT }, .flags = TFLAGS, .unit = "text_align" },
340 { "right", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = TA_RIGHT }, .flags = TFLAGS, .unit = "text_align" },
341 { "R", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = TA_RIGHT }, .flags = TFLAGS, .unit = "text_align" },
342 { "center", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = (TA_LEFT|TA_RIGHT) }, .flags = TFLAGS, .unit = "text_align" },
343 { "C", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = (TA_LEFT|TA_RIGHT) }, .flags = TFLAGS, .unit = "text_align" },
344 { "top", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = TA_TOP }, .flags = TFLAGS, .unit = "text_align" },
345 { "T", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = TA_TOP }, .flags = TFLAGS, .unit = "text_align" },
346 { "bottom", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = TA_BOTTOM }, .flags = TFLAGS, .unit = "text_align" },
347 { "B", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = TA_BOTTOM }, .flags = TFLAGS, .unit = "text_align" },
348 { "middle", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = (TA_TOP|TA_BOTTOM) }, .flags = TFLAGS, .unit = "text_align" },
349 { "M", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = (TA_TOP|TA_BOTTOM) }, .flags = TFLAGS, .unit = "text_align" },
350 {"x", "set x expression", OFFSET(x_expr), AV_OPT_TYPE_STRING, {.str="0"}, 0, 0, TFLAGS},
351 {"y", "set y expression", OFFSET(y_expr), AV_OPT_TYPE_STRING, {.str="0"}, 0, 0, TFLAGS},
352 {"boxw", "set box width", OFFSET(boxw), AV_OPT_TYPE_INT, {.i64=0}, 0, INT_MAX, TFLAGS},
353 {"boxh", "set box height", OFFSET(boxh), AV_OPT_TYPE_INT, {.i64=0}, 0, INT_MAX, TFLAGS},
354 {"shadowx", "set shadow x offset", OFFSET(shadowx), AV_OPT_TYPE_INT, {.i64=0}, INT_MIN, INT_MAX, TFLAGS},
355 {"shadowy", "set shadow y offset", OFFSET(shadowy), AV_OPT_TYPE_INT, {.i64=0}, INT_MIN, INT_MAX, TFLAGS},
356 {"borderw", "set border width", OFFSET(borderw), AV_OPT_TYPE_INT, {.i64=0}, INT_MIN, INT_MAX, TFLAGS},
357 {"tabsize", "set tab size", OFFSET(tabsize), AV_OPT_TYPE_INT, {.i64=4}, 0, INT_MAX, TFLAGS},
358 {"basetime", "set base time", OFFSET(basetime), AV_OPT_TYPE_INT64, {.i64=AV_NOPTS_VALUE}, INT64_MIN, INT64_MAX, FLAGS},
359#if CONFIG_LIBFONTCONFIG
360 { "font", "Font name", OFFSET(font), AV_OPT_TYPE_STRING, { .str = "Sans" }, .flags = FLAGS },
361#endif
362
363 {"expansion", "set the expansion mode", OFFSET(exp_mode), AV_OPT_TYPE_INT, {.i64=EXP_NORMAL}, 0, 2, FLAGS, .unit = "expansion"},
364 {"none", "set no expansion", OFFSET(exp_mode), AV_OPT_TYPE_CONST, {.i64=EXP_NONE}, 0, 0, FLAGS, .unit = "expansion"},
365 {"normal", "set normal expansion", OFFSET(exp_mode), AV_OPT_TYPE_CONST, {.i64=EXP_NORMAL}, 0, 0, FLAGS, .unit = "expansion"},
366 {"strftime", "set strftime expansion (deprecated)", OFFSET(exp_mode), AV_OPT_TYPE_CONST, {.i64=EXP_STRFTIME}, 0, 0, FLAGS, .unit = "expansion"},
367 {"y_align", "set the y alignment", OFFSET(y_align), AV_OPT_TYPE_INT, {.i64=YA_TEXT}, 0, 2, TFLAGS, .unit = "y_align"},
368 {"text", "y is referred to the top of the first text line", OFFSET(y_align), AV_OPT_TYPE_CONST, {.i64=YA_TEXT}, 0, 0, FLAGS, .unit = "y_align"},
369 {"baseline", "y is referred to the baseline of the first line", OFFSET(y_align), AV_OPT_TYPE_CONST, {.i64=YA_BASELINE}, 0, 0, FLAGS, .unit = "y_align"},
370 {"font", "y is referred to the font defined line metrics", OFFSET(y_align), AV_OPT_TYPE_CONST, {.i64=YA_FONT}, 0, 0, FLAGS, .unit = "y_align"},
371
372 {"timecode", "set initial timecode", OFFSET(tc_opt_string), AV_OPT_TYPE_STRING, {.str=NULL}, 0, 0, FLAGS},
373 {"tc24hmax", "set 24 hours max (timecode only)", OFFSET(tc24hmax), AV_OPT_TYPE_BOOL, {.i64=0}, 0, 1, FLAGS},
374 {"timecode_rate", "set rate (timecode only)", OFFSET(tc_rate), AV_OPT_TYPE_RATIONAL, {.dbl=0}, 0, INT_MAX, FLAGS},
375 {"r", "set rate (timecode only)", OFFSET(tc_rate), AV_OPT_TYPE_RATIONAL, {.dbl=0}, 0, INT_MAX, FLAGS},
376 {"rate", "set rate (timecode only)", OFFSET(tc_rate), AV_OPT_TYPE_RATIONAL, {.dbl=0}, 0, INT_MAX, FLAGS},
377 {"reload", "reload text file at specified frame interval", OFFSET(reload), AV_OPT_TYPE_INT, {.i64=0}, 0, INT_MAX, FLAGS},
378 {"alpha", "apply alpha while rendering", OFFSET(a_expr), AV_OPT_TYPE_STRING, {.str = "1"}, .flags = TFLAGS},
379 {"fix_bounds", "check and fix text coords to avoid clipping", OFFSET(fix_bounds), AV_OPT_TYPE_BOOL, {.i64=0}, 0, 1, FLAGS},
380 {"start_number", "start frame number for n/frame_num variable", OFFSET(start_number), AV_OPT_TYPE_INT, {.i64=0}, 0, INT_MAX, FLAGS},
381 {"text_source", "the source of text", OFFSET(text_source_string), AV_OPT_TYPE_STRING, {.str=NULL}, 0, 1, FLAGS },
382
383#if CONFIG_LIBFRIBIDI
384 {"text_shaping", "attempt to shape text before drawing", OFFSET(text_shaping), AV_OPT_TYPE_BOOL, {.i64=1}, 0, 1, FLAGS},
385#endif
386
387 /* FT_LOAD_* flags */
388 { "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, .unit = "ft_load_flags" },
389 { "default", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = FT_LOAD_DEFAULT }, .flags = FLAGS, .unit = "ft_load_flags" },
390 { "no_scale", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = FT_LOAD_NO_SCALE }, .flags = FLAGS, .unit = "ft_load_flags" },
391 { "no_hinting", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = FT_LOAD_NO_HINTING }, .flags = FLAGS, .unit = "ft_load_flags" },
392 { "render", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = FT_LOAD_RENDER }, .flags = FLAGS, .unit = "ft_load_flags" },
393 { "no_bitmap", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = FT_LOAD_NO_BITMAP }, .flags = FLAGS, .unit = "ft_load_flags" },
394 { "vertical_layout", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = FT_LOAD_VERTICAL_LAYOUT }, .flags = FLAGS, .unit = "ft_load_flags" },
395 { "force_autohint", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = FT_LOAD_FORCE_AUTOHINT }, .flags = FLAGS, .unit = "ft_load_flags" },
396 { "crop_bitmap", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = FT_LOAD_CROP_BITMAP }, .flags = FLAGS, .unit = "ft_load_flags" },
397 { "pedantic", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = FT_LOAD_PEDANTIC }, .flags = FLAGS, .unit = "ft_load_flags" },
398 { "ignore_global_advance_width", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = FT_LOAD_IGNORE_GLOBAL_ADVANCE_WIDTH }, .flags = FLAGS, .unit = "ft_load_flags" },
399 { "no_recurse", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = FT_LOAD_NO_RECURSE }, .flags = FLAGS, .unit = "ft_load_flags" },
400 { "ignore_transform", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = FT_LOAD_IGNORE_TRANSFORM }, .flags = FLAGS, .unit = "ft_load_flags" },
401 { "monochrome", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = FT_LOAD_MONOCHROME }, .flags = FLAGS, .unit = "ft_load_flags" },
402 { "linear_design", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = FT_LOAD_LINEAR_DESIGN }, .flags = FLAGS, .unit = "ft_load_flags" },
403 { "no_autohint", NULL, 0, AV_OPT_TYPE_CONST, { .i64 = FT_LOAD_NO_AUTOHINT }, .flags = FLAGS, .unit = "ft_load_flags" },
404 { NULL }
405};
406
408
409#undef __FTERRORS_H__
410#define FT_ERROR_START_LIST {
411#define FT_ERRORDEF(e, v, s) { (e), (s) },
412#define FT_ERROR_END_LIST { 0, NULL } };
413
414static const struct ft_error {
415 int err;
416 const char *err_msg;
417} ft_errors[] =
418#include FT_ERRORS_H
419
420#define FT_ERRMSG(e) ft_errors[e].err_msg
421
422static int glyph_cmp(const void *key, const void *b)
423{
424 const Glyph *a = key, *bb = b;
425 int64_t diff = (int64_t)a->code - (int64_t)bb->code;
426
427 if (diff != 0)
428 return diff > 0 ? 1 : -1;
429 else
430 return FFDIFFSIGN((int64_t)a->fontsize, (int64_t)bb->fontsize);
431}
432
433static av_cold int set_fontsize(AVFilterContext *ctx, unsigned int fontsize)
434{
435 int err;
436 DrawTextContext *s = ctx->priv;
437
438 if ((err = FT_Set_Pixel_Sizes(s->face, 0, fontsize))) {
439 av_log(ctx, AV_LOG_ERROR, "Could not set font size to %d pixels: %s\n",
440 fontsize, FT_ERRMSG(err));
441 return AVERROR(EINVAL);
442 }
443
444 // Whenever the underlying FT_Face changes, harfbuzz has to be notified of the change.
445 for (int line = 0; line < s->line_count; line++) {
446 TextLine *cur_line = &s->lines[line];
447 hb_ft_font_changed(cur_line->hb_data.font);
448 }
449
450 s->fontsize = fontsize;
451
452 return 0;
453}
454
455static av_cold int parse_fontsize(AVFilterContext *ctx)
456{
457 DrawTextContext *s = ctx->priv;
458 int err;
459
460 if (s->fontsize_pexpr)
461 return 0;
462
463 if (s->fontsize_expr == NULL)
464 return AVERROR(EINVAL);
465
466 if ((err = av_expr_parse(&s->fontsize_pexpr, s->fontsize_expr, var_names,
467 NULL, NULL, fun2_names, fun2, 0, ctx)) < 0)
468 return err;
469
470 return 0;
471}
472
473static av_cold int update_fontsize(AVFilterContext *ctx)
474{
475 DrawTextContext *s = ctx->priv;
476 unsigned int fontsize = s->default_fontsize;
477 int err;
478 double size, roundedsize;
479
480 // if no fontsize specified use the default
481 if (s->fontsize_expr != NULL) {
482 if ((err = parse_fontsize(ctx)) < 0)
483 return err;
484
485 size = av_expr_eval(s->fontsize_pexpr, s->var_values, &s->prng);
486 if (!isnan(size)) {
487 roundedsize = round(size);
488 // test for overflow before cast
489 if (!(roundedsize > INT_MIN && roundedsize < INT_MAX)) {
490 av_log(ctx, AV_LOG_ERROR, "fontsize overflow\n");
491 return AVERROR(EINVAL);
492 }
493 fontsize = roundedsize;
494 }
495 }
496
497 if (fontsize == 0)
498 fontsize = 1;
499
500 // no change
501 if (fontsize == s->fontsize)
502 return 0;
503
504 return set_fontsize(ctx, fontsize);
505}
506
507static int load_font_file(AVFilterContext *ctx, const char *path, int index)
508{
509 DrawTextContext *s = ctx->priv;
510 int err;
511
512 err = FT_New_Face(s->library, path, index, &s->face);
513 if (err) {
514#if !CONFIG_LIBFONTCONFIG
515 av_log(ctx, AV_LOG_ERROR, "Could not load font \"%s\": %s\n",
516 s->fontfile, FT_ERRMSG(err));
517#endif
518 return AVERROR(EINVAL);
519 }
520 return 0;
521}
522
523#if CONFIG_LIBFONTCONFIG
524static int load_font_fontconfig(AVFilterContext *ctx)
525{
526 DrawTextContext *s = ctx->priv;
527 FcConfig *fontconfig;
528 FcPattern *pat, *best;
529 FcResult result = FcResultMatch;
530 FcChar8 *filename;
531 int index;
532 double size;
533 int err = AVERROR(ENOENT);
534 int parse_err;
535
536 fontconfig = FcInitLoadConfigAndFonts();
537 if (!fontconfig) {
538 av_log(ctx, AV_LOG_ERROR, "impossible to init fontconfig\n");
539 return AVERROR_UNKNOWN;
540 }
541 pat = FcNameParse(s->fontfile ? s->fontfile :
542 (uint8_t *)(intptr_t)"default");
543 if (!pat) {
544 av_log(ctx, AV_LOG_ERROR, "could not parse fontconfig pat");
545 return AVERROR(EINVAL);
546 }
547
548 FcPatternAddString(pat, FC_FAMILY, s->font);
549
550 parse_err = parse_fontsize(ctx);
551 if (!parse_err) {
552 double size = av_expr_eval(s->fontsize_pexpr, s->var_values, &s->prng);
553
554 if (isnan(size)) {
555 av_log(ctx, AV_LOG_ERROR, "impossible to find font information");
556 return AVERROR(EINVAL);
557 }
558
559 FcPatternAddDouble(pat, FC_SIZE, size);
560 }
561
562 FcDefaultSubstitute(pat);
563
564 if (!FcConfigSubstitute(fontconfig, pat, FcMatchPattern)) {
565 av_log(ctx, AV_LOG_ERROR, "could not substitute fontconfig options"); /* very unlikely */
566 FcPatternDestroy(pat);
567 return AVERROR(ENOMEM);
568 }
569
570 best = FcFontMatch(fontconfig, pat, &result);
571 FcPatternDestroy(pat);
572
573 if (!best || result != FcResultMatch) {
575 "Cannot find a valid font for the family %s\n",
576 s->font);
577 goto fail;
578 }
579
580 if (
581 FcPatternGetInteger(best, FC_INDEX, 0, &index ) != FcResultMatch ||
582 FcPatternGetDouble (best, FC_SIZE, 0, &size ) != FcResultMatch) {
583 av_log(ctx, AV_LOG_ERROR, "impossible to find font information");
584 return AVERROR(EINVAL);
585 }
586
587 if (FcPatternGetString(best, FC_FILE, 0, &filename) != FcResultMatch) {
588 av_log(ctx, AV_LOG_ERROR, "No file path for %s\n",
589 s->font);
590 goto fail;
591 }
592
593 av_log(ctx, AV_LOG_VERBOSE, "Using \"%s\"\n", filename);
594 if (parse_err)
595 s->default_fontsize = size + 0.5;
596
597 err = load_font_file(ctx, filename, index);
598 if (err)
599 return err;
600 FcConfigDestroy(fontconfig);
601fail:
602 FcPatternDestroy(best);
603 return err;
604}
605#endif
606
607static int load_font(AVFilterContext *ctx)
608{
609 DrawTextContext *s = ctx->priv;
610 int err;
611
612 /* load the face, and set up the encoding, which is by default UTF-8 */
613 err = load_font_file(ctx, s->fontfile, 0);
614 if (!err)
615 return 0;
616#if CONFIG_LIBFONTCONFIG
617 err = load_font_fontconfig(ctx);
618 if (!err)
619 return 0;
620#endif
621 return err;
622}
623
624#if CONFIG_LIBFRIBIDI
625static int shape_text(AVFilterContext *ctx)
626{
627 DrawTextContext *s = ctx->priv;
628 uint8_t *tmp;
629 int ret = AVERROR(ENOMEM);
630 static const FriBidiFlags flags = FRIBIDI_FLAGS_DEFAULT |
631 FRIBIDI_FLAGS_ARABIC;
632 FriBidiChar *unicodestr = NULL;
633 FriBidiStrIndex len;
634 FriBidiParType direction = FRIBIDI_PAR_LTR;
635 FriBidiStrIndex line_start = 0;
636 FriBidiStrIndex line_end = 0;
637 FriBidiLevel *embedding_levels = NULL;
638 FriBidiArabicProp *ar_props = NULL;
639 FriBidiCharType *bidi_types = NULL;
640 FriBidiStrIndex i,j;
641
642 len = strlen(s->text);
643 if (!(unicodestr = av_malloc_array(len, sizeof(*unicodestr)))) {
644 goto out;
645 }
646 len = fribidi_charset_to_unicode(FRIBIDI_CHAR_SET_UTF8,
647 s->text, len, unicodestr);
648
649 bidi_types = av_malloc_array(len, sizeof(*bidi_types));
650 if (!bidi_types) {
651 goto out;
652 }
653
654 fribidi_get_bidi_types(unicodestr, len, bidi_types);
655
656 embedding_levels = av_malloc_array(len, sizeof(*embedding_levels));
657 if (!embedding_levels) {
658 goto out;
659 }
660
661 if (!fribidi_get_par_embedding_levels(bidi_types, len, &direction,
662 embedding_levels)) {
663 goto out;
664 }
665
666 ar_props = av_malloc_array(len, sizeof(*ar_props));
667 if (!ar_props) {
668 goto out;
669 }
670
671 fribidi_get_joining_types(unicodestr, len, ar_props);
672 fribidi_join_arabic(bidi_types, len, embedding_levels, ar_props);
673 fribidi_shape(flags, embedding_levels, len, ar_props, unicodestr);
674
675 for (line_end = 0, line_start = 0; line_end < len; line_end++) {
676 if (ff_is_newline(unicodestr[line_end]) || line_end == len - 1) {
677 if (!fribidi_reorder_line(flags, bidi_types,
678 line_end - line_start + 1, line_start,
679 direction, embedding_levels, unicodestr,
680 NULL)) {
681 goto out;
682 }
683 line_start = line_end + 1;
684 }
685 }
686
687 /* Remove zero-width fill chars put in by libfribidi */
688 for (i = 0, j = 0; i < len; i++)
689 if (unicodestr[i] != FRIBIDI_CHAR_FILL)
690 unicodestr[j++] = unicodestr[i];
691 len = j;
692
693 if (!(tmp = av_realloc(s->text, (len * 4 + 1) * sizeof(*s->text)))) {
694 /* Use len * 4, as a unicode character can be up to 4 bytes in UTF-8 */
695 goto out;
696 }
697
698 s->text = tmp;
699 len = fribidi_unicode_to_charset(FRIBIDI_CHAR_SET_UTF8,
700 unicodestr, len, s->text);
701
702 ret = 0;
703
704out:
705 av_free(unicodestr);
706 av_free(embedding_levels);
707 av_free(ar_props);
708 av_free(bidi_types);
709 return ret;
710}
711#endif
712
713static enum AVFrameSideDataType text_source_string_parse(const char *text_source_string)
714{
715 av_assert0(text_source_string);
716 if (!strcmp(text_source_string, "side_data_detection_bboxes")) {
718 } else {
719 return AVERROR(EINVAL);
720 }
721}
722
723static inline int get_subpixel_idx(int shift_x64, int shift_y64)
724{
725 int idx = (shift_x64 >> 2) + (shift_y64 >> 4);
726 return idx;
727}
728
729// Loads and (optionally) renders a glyph
730static int load_glyph(AVFilterContext *ctx, Glyph **glyph_ptr, uint32_t code, int8_t shift_x64, int8_t shift_y64)
731{
732 DrawTextContext *s = ctx->priv;
733 Glyph dummy = { 0 };
734 Glyph *glyph;
735 FT_Vector shift;
736 struct AVTreeNode *node = NULL;
737 int ret = 0;
738 int cached = 0;
739
740 /* get glyph */
741 dummy.code = code;
742 dummy.fontsize = s->fontsize;
743 glyph = av_tree_find(s->glyphs, &dummy, glyph_cmp, NULL);
744 cached = !!glyph;
745 if (!glyph) {
746 if (FT_Load_Glyph(s->face, code, s->ft_load_flags)) {
747 return AVERROR(EINVAL);
748 }
749 glyph = av_mallocz(sizeof(*glyph));
750 if (!glyph) {
751 ret = AVERROR(ENOMEM);
752 goto error;
753 }
754 glyph->code = code;
755 glyph->fontsize = s->fontsize;
756 if (FT_Get_Glyph(s->face->glyph, &glyph->glyph)) {
757 ret = AVERROR(EINVAL);
758 goto error;
759 }
760 if (s->borderw) {
761 FT_Glyph tmp = glyph->glyph;
762 if (FT_Glyph_StrokeBorder(&tmp, s->stroker, 0, 0)) {
763 ret = AVERROR_EXTERNAL;
764 goto error;
765 }
766 glyph->border_glyph = tmp;
767 }
768 /* measure text height to calculate text_height (or the maximum text height) */
769 FT_Glyph_Get_CBox(glyph->glyph, FT_GLYPH_BBOX_SUBPIXELS, &glyph->bbox);
770
771 /* cache the newly created glyph */
772 if (!(node = av_tree_node_alloc())) {
773 ret = AVERROR(ENOMEM);
774 goto error;
775 }
776 av_tree_insert(&s->glyphs, glyph, glyph_cmp, &node);
777 cached = 1;
778 } else {
779 if (s->borderw && !glyph->border_glyph) {
780 FT_Glyph tmp = glyph->glyph;
781 if (FT_Glyph_StrokeBorder(&tmp, s->stroker, 0, 0)) {
782 ret = AVERROR_EXTERNAL;
783 goto error;
784 }
785 glyph->border_glyph = tmp;
786 }
787 }
788
789 // Check if a bitmap is needed
790 if (shift_x64 >= 0 && shift_y64 >= 0) {
791 // Get the bitmap subpixel index (0 -> 15)
792 int idx = get_subpixel_idx(shift_x64, shift_y64);
793 shift.x = shift_x64;
794 shift.y = shift_y64;
795
796 if (!glyph->bglyph[idx]) {
797 FT_Glyph tmp_glyph = glyph->glyph;
798 if (FT_Glyph_To_Bitmap(&tmp_glyph, FT_RENDER_MODE_NORMAL, &shift, 0)) {
799 ret = AVERROR_EXTERNAL;
800 goto error;
801 }
802 glyph->bglyph[idx] = (FT_BitmapGlyph)tmp_glyph;
803 }
804 if (glyph->bglyph[idx]->bitmap.pixel_mode == FT_PIXEL_MODE_MONO) {
805 av_log(ctx, AV_LOG_ERROR, "Monocromatic (1bpp) fonts are not supported.\n");
806 ret = AVERROR(EINVAL);
807 goto error;
808 }
809 if (s->borderw && !glyph->border_bglyph[idx]) {
810 FT_Glyph tmp_glyph = glyph->border_glyph;
811 if (FT_Glyph_To_Bitmap(&tmp_glyph, FT_RENDER_MODE_NORMAL, &shift, 0)) {
812 ret = AVERROR_EXTERNAL;
813 goto error;
814 }
815 glyph->border_bglyph[idx] = (FT_BitmapGlyph)tmp_glyph;
816 }
817 }
818 if (glyph_ptr) {
819 *glyph_ptr = glyph;
820 }
821 return 0;
822
823error:
824 if (glyph && !cached) {
825 if (glyph->border_glyph && glyph->border_glyph != glyph->glyph)
826 FT_Done_Glyph(glyph->border_glyph);
827 if (glyph->glyph)
828 FT_Done_Glyph(glyph->glyph);
829 av_freep(&glyph);
830 }
831 av_freep(&node);
832 return ret;
833}
834
835// Convert a string formatted as "n1|n2|...|nN" into an integer array
836static int string_to_array(const char *source, int *result, int result_size)
837{
838 int counter = 0, size = strlen(source) + 1;
839 char *saveptr, *curval, *dup = av_malloc(size);
840 if (!dup)
841 return 0;
842 av_strlcpy(dup, source, size);
843 if (result_size > 0 && (curval = av_strtok(dup, "|", &saveptr))) {
844 do {
845 result[counter++] = atoi(curval);
846 } while ((curval = av_strtok(NULL, "|", &saveptr)) && counter < result_size);
847 }
848 av_free(dup);
849 return counter;
850}
851
852static int func_pict_type(void *ctx, AVBPrint *bp, const char *function_name, unsigned argc, char **argv)
853{
854 DrawTextContext *s = ((AVFilterContext *)ctx)->priv;
855
856 av_bprintf(bp, "%c", av_get_picture_type_char(s->var_values[VAR_PICT_TYPE]));
857 return 0;
858}
859
860static int func_pts(void *ctx, AVBPrint *bp, const char *function_name, unsigned argc, char **argv)
861{
862 DrawTextContext *s = ((AVFilterContext *)ctx)->priv;
863 const char *fmt;
864 const char *strftime_fmt = NULL;
865 const char *delta = NULL;
866 double pts = s->var_values[VAR_T];
867
868 // argv: pts, FMT, [DELTA, 24HH | strftime_fmt]
869
870 fmt = argc >= 1 ? argv[0] : "flt";
871 if (argc >= 2) {
872 delta = argv[1];
873 }
874 if (argc >= 3) {
875 if (!strcmp(fmt, "hms")) {
876 if (!strcmp(argv[2], "24HH")) {
877 av_log(ctx, AV_LOG_WARNING, "pts third argument 24HH is deprecated, use pts:hms24hh instead\n");
878 fmt = "hms24";
879 } else {
880 av_log(ctx, AV_LOG_ERROR, "Invalid argument '%s', '24HH' was expected\n", argv[2]);
881 return AVERROR(EINVAL);
882 }
883 } else {
884 strftime_fmt = argv[2];
885 }
886 }
887
888 return ff_print_pts(ctx, bp, pts, delta, fmt, strftime_fmt);
889}
890
891static int func_frame_num(void *ctx, AVBPrint *bp, const char *function_name, unsigned argc, char **argv)
892{
893 DrawTextContext *s = ((AVFilterContext *)ctx)->priv;
894
895 av_bprintf(bp, "%d", (int)s->var_values[VAR_N]);
896 return 0;
897}
898
899static int func_metadata(void *ctx, AVBPrint *bp, const char *function_name, unsigned argc, char **argv)
900{
901 DrawTextContext *s = ((AVFilterContext *)ctx)->priv;
902 AVDictionaryEntry *e = av_dict_get(s->metadata, argv[0], NULL, 0);
903
904 if (e && e->value)
905 av_bprintf(bp, "%s", e->value);
906 else if (argc >= 2)
907 av_bprintf(bp, "%s", argv[1]);
908 return 0;
909}
910
911static int func_strftime(void *ctx, AVBPrint *bp, const char *function_name, unsigned argc, char **argv)
912{
913 const char *strftime_fmt = argc ? argv[0] : NULL;
914
915 return ff_print_time(ctx, bp, strftime_fmt, !strcmp(function_name, "localtime"));
916}
917
918static int func_eval_expr(void *ctx, AVBPrint *bp, const char *function_name, unsigned argc, char **argv)
919{
920 DrawTextContext *s = ((AVFilterContext *)ctx)->priv;
921
922 return ff_print_eval_expr(ctx, bp, argv[0],
924 var_names, s->var_values, &s->prng);
925}
926
927static int func_eval_expr_int_format(void *ctx, AVBPrint *bp, const char *function_name, unsigned argc, char **argv)
928{
929 DrawTextContext *s = ((AVFilterContext *)ctx)->priv;
930 int ret;
931 int positions = -1;
932
933 /*
934 * argv[0] expression to be converted to `int`
935 * argv[1] format: 'x', 'X', 'd' or 'u'
936 * argv[2] positions printed (optional)
937 */
938
939 if (argc == 3) {
940 ret = sscanf(argv[2], "%u", &positions);
941 if (ret != 1) {
942 av_log(ctx, AV_LOG_ERROR, "expr_int_format(): Invalid number of positions"
943 " to print: '%s'\n", argv[2]);
944 return AVERROR(EINVAL);
945 }
946 }
947
948 return ff_print_formatted_eval_expr(ctx, bp, argv[0],
950 var_names, s->var_values,
951 &s->prng,
952 argv[1][0], positions);
953}
954
956 { "e", 1, 1, func_eval_expr },
957 { "eif", 2, 3, func_eval_expr_int_format },
958 { "expr", 1, 1, func_eval_expr },
959 { "expr_int_format", 2, 3, func_eval_expr_int_format },
960 { "frame_num", 0, 0, func_frame_num },
961 { "gmtime", 0, 1, func_strftime },
962 { "localtime", 0, 1, func_strftime },
963 { "metadata", 1, 2, func_metadata },
964 { "n", 0, 0, func_frame_num },
965 { "pict_type", 0, 0, func_pict_type },
966 { "pts", 0, 3, func_pts }
968
970{
971 int err;
972 DrawTextContext *s = ctx->priv;
973
974 av_expr_free(s->fontsize_pexpr);
975 s->fontsize_pexpr = NULL;
976
977 s->fontsize = 0;
978 s->default_fontsize = 16;
979
980 if (!s->fontfile && !CONFIG_LIBFONTCONFIG) {
981 av_log(ctx, AV_LOG_ERROR, "No font filename provided\n");
982 return AVERROR(EINVAL);
983 }
984
985 if (s->textfile) {
986 if (s->text) {
988 "Both text and text file provided. Please provide only one\n");
989 return AVERROR(EINVAL);
990 }
991 if ((err = ff_load_textfile(ctx, (const char *)s->textfile, &s->text, NULL)) < 0)
992 return err;
993 }
994
995 if (s->reload && !s->textfile)
996 av_log(ctx, AV_LOG_WARNING, "No file to reload\n");
997
998 if (s->tc_opt_string) {
999 int ret = av_timecode_init_from_string(&s->tc, s->tc_rate,
1000 s->tc_opt_string, ctx);
1001 if (ret < 0)
1002 return ret;
1003 if (s->tc24hmax)
1004 s->tc.flags |= AV_TIMECODE_FLAG_24HOURSMAX;
1005 if (!s->text)
1006 s->text = av_strdup("");
1007 }
1008
1009 if (s->text_source_string) {
1010 s->text_source = text_source_string_parse(s->text_source_string);
1011 if ((int)s->text_source < 0) {
1012 av_log(ctx, AV_LOG_ERROR, "Error text source: %s\n", s->text_source_string);
1013 return AVERROR(EINVAL);
1014 }
1015 }
1016
1017 if (s->text_source == AV_FRAME_DATA_DETECTION_BBOXES) {
1018 if (s->text) {
1019 av_log(ctx, AV_LOG_WARNING, "Multiple texts provided, will use text_source only\n");
1020 av_free(s->text);
1021 }
1024 if (!s->text)
1025 return AVERROR(ENOMEM);
1026 }
1027
1028 if (!s->text) {
1030 "Either text, a valid file, a timecode or text source must be provided\n");
1031 return AVERROR(EINVAL);
1032 }
1033
1034 s->expand_text = (FFExpandTextContext) {
1035 .log_ctx = ctx,
1036 .functions = expand_text_functions,
1037 .functions_nb = FF_ARRAY_ELEMS(expand_text_functions)
1038 };
1039
1040#if CONFIG_LIBFRIBIDI
1041 if (s->text_shaping)
1042 if ((err = shape_text(ctx)) < 0)
1043 return err;
1044#endif
1045
1046 if ((err = FT_Init_FreeType(&(s->library)))) {
1048 "Could not load FreeType: %s\n", FT_ERRMSG(err));
1049 return AVERROR(EINVAL);
1050 }
1051
1052 if ((err = load_font(ctx)) < 0)
1053 return err;
1054
1055 if ((err = update_fontsize(ctx)) < 0)
1056 return err;
1057
1058 // Always init the stroker, may be needed if borderw is set via command
1059 if (FT_Stroker_New(s->library, &s->stroker)) {
1060 av_log(ctx, AV_LOG_ERROR, "Could not init FT stroker\n");
1061 return AVERROR_EXTERNAL;
1062 }
1063
1064 if (s->borderw) {
1065 FT_Stroker_Set(s->stroker, s->borderw << 6, FT_STROKER_LINECAP_ROUND,
1066 FT_STROKER_LINEJOIN_ROUND, 0);
1067 }
1068
1069 /* load the fallback glyph with code 0 */
1070 load_glyph(ctx, NULL, 0, 0, 0);
1071
1072 if (s->exp_mode == EXP_STRFTIME &&
1073 (strchr(s->text, '%') || strchr(s->text, '\\')))
1074 av_log(ctx, AV_LOG_WARNING, "expansion=strftime is deprecated.\n");
1075
1076 av_bprint_init(&s->expanded_text, 0, AV_BPRINT_SIZE_UNLIMITED);
1077 av_bprint_init(&s->expanded_fontcolor, 0, AV_BPRINT_SIZE_UNLIMITED);
1078
1079 return 0;
1080}
1081
1083 AVFilterFormatsConfig **cfg_in,
1084 AVFilterFormatsConfig **cfg_out)
1085{
1086 return ff_set_common_formats2(ctx, cfg_in, cfg_out,
1088}
1089
1090static int glyph_enu_border_free(void *opaque, void *elem)
1091{
1092 Glyph *glyph = elem;
1093
1094 if (glyph->border_glyph != NULL) {
1095 for (int t = 0; t < 16; ++t) {
1096 FT_Glyph bbg = (FT_Glyph)glyph->border_bglyph[t];
1097 if (bbg && bbg != glyph->border_glyph)
1098 FT_Done_Glyph(bbg);
1099 glyph->border_bglyph[t] = NULL;
1100 }
1101 FT_Done_Glyph(glyph->border_glyph);
1102 glyph->border_glyph = NULL;
1103 }
1104 return 0;
1105}
1106
1107static int glyph_enu_free(void *opaque, void *elem)
1108{
1109 Glyph *glyph = elem;
1110
1111 for (int t = 0; t < 16; ++t) {
1112 FT_Glyph bg = (FT_Glyph)glyph->bglyph[t];
1113 FT_Glyph bbg = (FT_Glyph)glyph->border_bglyph[t];
1114 if (bg && bg != glyph->glyph && bg != glyph->border_glyph)
1115 FT_Done_Glyph(bg);
1116 if (bbg && bbg != glyph->glyph && bbg != glyph->border_glyph)
1117 FT_Done_Glyph(bbg);
1118 }
1119 if (glyph->border_glyph && glyph->border_glyph != glyph->glyph)
1120 FT_Done_Glyph(glyph->border_glyph);
1121 FT_Done_Glyph(glyph->glyph);
1122 av_free(elem);
1123 return 0;
1124}
1125
1127{
1128 DrawTextContext *s = ctx->priv;
1129
1130 av_expr_free(s->x_pexpr);
1131 av_expr_free(s->y_pexpr);
1132 av_expr_free(s->a_pexpr);
1133 av_expr_free(s->fontsize_pexpr);
1134
1135 s->x_pexpr = s->y_pexpr = s->a_pexpr = s->fontsize_pexpr = NULL;
1136
1138 av_tree_destroy(s->glyphs);
1139 s->glyphs = NULL;
1140
1141 FT_Done_Face(s->face);
1142 FT_Stroker_Done(s->stroker);
1143 FT_Done_FreeType(s->library);
1144
1145 av_bprint_finalize(&s->expanded_text, NULL);
1146 av_bprint_finalize(&s->expanded_fontcolor, NULL);
1147}
1148
1149static int config_input(AVFilterLink *inlink)
1150{
1151 AVFilterContext *ctx = inlink->dst;
1152 DrawTextContext *s = ctx->priv;
1153 char *expr;
1154 int ret;
1155
1156 ret = ff_draw_init_from_link(&s->dc, inlink, FF_DRAW_PROCESS_ALPHA);
1157 if (ret < 0) {
1158 av_log(ctx, AV_LOG_ERROR, "Failed to initialize FFDrawContext\n");
1159 return ret;
1160 }
1161 ff_draw_color(&s->dc, &s->fontcolor, s->fontcolor.rgba);
1162 ff_draw_color(&s->dc, &s->shadowcolor, s->shadowcolor.rgba);
1163 ff_draw_color(&s->dc, &s->bordercolor, s->bordercolor.rgba);
1164 ff_draw_color(&s->dc, &s->boxcolor, s->boxcolor.rgba);
1165
1166 s->var_values[VAR_w] = s->var_values[VAR_W] = s->var_values[VAR_MAIN_W] = inlink->w;
1167 s->var_values[VAR_h] = s->var_values[VAR_H] = s->var_values[VAR_MAIN_H] = inlink->h;
1168 s->var_values[VAR_SAR] = inlink->sample_aspect_ratio.num ? av_q2d(inlink->sample_aspect_ratio) : 1;
1169 s->var_values[VAR_DAR] = (double)inlink->w / inlink->h * s->var_values[VAR_SAR];
1170 s->var_values[VAR_HSUB] = 1 << s->dc.hsub_max;
1171 s->var_values[VAR_VSUB] = 1 << s->dc.vsub_max;
1172 s->var_values[VAR_X] = NAN;
1173 s->var_values[VAR_Y] = NAN;
1174 s->var_values[VAR_T] = NAN;
1175
1176 av_lfg_init(&s->prng, av_get_random_seed());
1177
1178 av_expr_free(s->x_pexpr);
1179 av_expr_free(s->y_pexpr);
1180 av_expr_free(s->a_pexpr);
1181 s->x_pexpr = s->y_pexpr = s->a_pexpr = NULL;
1182
1183 if ((ret = av_expr_parse(&s->x_pexpr, expr = s->x_expr, var_names,
1184 NULL, NULL, fun2_names, fun2, 0, ctx)) < 0 ||
1185 (ret = av_expr_parse(&s->y_pexpr, expr = s->y_expr, var_names,
1186 NULL, NULL, fun2_names, fun2, 0, ctx)) < 0 ||
1187 (ret = av_expr_parse(&s->a_pexpr, expr = s->a_expr, var_names,
1188 NULL, NULL, fun2_names, fun2, 0, ctx)) < 0) {
1189 av_log(ctx, AV_LOG_ERROR, "Failed to parse expression: %s \n", expr);
1190 return AVERROR(EINVAL);
1191 }
1192
1193 return 0;
1194}
1195
1196static int command(AVFilterContext *ctx, const char *cmd, const char *arg, char *res, int res_len, int flags)
1197{
1198 DrawTextContext *old = ctx->priv;
1199 DrawTextContext *new = NULL;
1200 int ret;
1201
1202 if (!strcmp(cmd, "reinit")) {
1203 new = av_mallocz(sizeof(DrawTextContext));
1204 if (!new)
1205 return AVERROR(ENOMEM);
1206
1207 new->class = &drawtext_class;
1208 ret = av_opt_copy(new, old);
1209 if (ret < 0)
1210 goto fail;
1211
1212 ctx->priv = new;
1213 ret = av_set_options_string(ctx, arg, "=", ":");
1214 if (ret < 0) {
1215 ctx->priv = old;
1216 goto fail;
1217 }
1218
1219 ret = init(ctx);
1220 if (ret < 0) {
1221 uninit(ctx);
1222 ctx->priv = old;
1223 goto fail;
1224 }
1225
1226 new->reinit = 1;
1227
1228 ctx->priv = old;
1229 uninit(ctx);
1230 av_opt_free(old);
1231 av_freep(&old);
1232
1233 ctx->priv = new;
1234 return config_input(ctx->inputs[0]);
1235 } else {
1236 int old_borderw = old->borderw;
1237 if ((ret = ff_filter_process_command(ctx, cmd, arg, res, res_len, flags)) < 0) {
1238 return ret;
1239 }
1240 if (old->borderw != old_borderw) {
1241 FT_Stroker_Set(old->stroker, old->borderw << 6, FT_STROKER_LINECAP_ROUND,
1242 FT_STROKER_LINEJOIN_ROUND, 0);
1243 // Dispose the old border glyphs
1245 } else if (strcmp(cmd, "fontsize") == 0) {
1247 old->fontsize_pexpr = NULL;
1248 old->blank_advance64 = 0;
1249 }
1250 return config_input(ctx->inputs[0]);
1251 }
1252
1253fail:
1254 av_log(ctx, AV_LOG_ERROR, "Failed to process command. Continuing with existing parameters.\n");
1255 av_freep(&new);
1256 return ret;
1257}
1258
1260{
1261 *color = incolor;
1262 color->rgba[3] = (color->rgba[3] * s->alpha) / 255;
1263 ff_draw_color(&s->dc, color, color->rgba);
1264}
1265
1267{
1268 double alpha = av_expr_eval(s->a_pexpr, s->var_values, &s->prng);
1269
1270 if (isnan(alpha))
1271 return;
1272
1273 if (alpha >= 1.0)
1274 s->alpha = 255;
1275 else if (alpha <= 0)
1276 s->alpha = 0;
1277 else
1278 s->alpha = 256 * alpha;
1279}
1280
1283 TextMetrics *metrics,
1284 int x, int y, int borderw)
1285{
1286 DrawTextContext *s = ctx->priv;
1287 int g, l, x1, y1, w1, h1, idx;
1288 int dx = 0, dy = 0, pdx = 0;
1289 GlyphInfo *info;
1290 Glyph dummy = { 0 }, *glyph;
1291 FT_Bitmap bitmap;
1292 FT_BitmapGlyph b_glyph;
1293 uint8_t j_left = 0, j_right = 0, j_top = 0, j_bottom = 0;
1294 int line_w, offset_y = 0;
1295 int clip_x = 0, clip_y = 0;
1296
1297 j_left = !!(s->text_align & TA_LEFT);
1298 j_right = !!(s->text_align & TA_RIGHT);
1299 j_top = !!(s->text_align & TA_TOP);
1300 j_bottom = !!(s->text_align & TA_BOTTOM);
1301
1302 if (j_top && j_bottom) {
1303 offset_y = (s->box_height - metrics->height) / 2;
1304 } else if (j_bottom) {
1305 offset_y = s->box_height - metrics->height;
1306 }
1307
1308 if ((!j_left || j_right) && !s->tab_warning_printed && s->tab_count > 0) {
1309 s->tab_warning_printed = 1;
1310 av_log(ctx, AV_LOG_WARNING, "Tab characters are only supported with left horizontal alignment\n");
1311 }
1312
1313 clip_x = FFMIN(metrics->rect_x + s->box_width + s->bb_right, frame->width);
1314 clip_y = FFMIN(metrics->rect_y + s->box_height + s->bb_bottom, frame->height);
1315
1316 for (l = 0; l < s->line_count; ++l) {
1317 TextLine *line = &s->lines[l];
1318 line_w = POS_CEIL(line->width64, 64);
1319 for (g = 0; g < line->hb_data.glyph_count; ++g) {
1320 info = &line->glyphs[g];
1321 dummy.fontsize = s->fontsize;
1322 dummy.code = info->code;
1323 glyph = av_tree_find(s->glyphs, &dummy, glyph_cmp, NULL);
1324 if (!glyph) {
1325 return AVERROR(EINVAL);
1326 }
1327
1328 idx = get_subpixel_idx(info->shift_x64, info->shift_y64);
1329 b_glyph = borderw ? glyph->border_bglyph[idx] : glyph->bglyph[idx];
1330 bitmap = b_glyph->bitmap;
1331 x1 = x + info->x + b_glyph->left;
1332 y1 = y + info->y - b_glyph->top + offset_y;
1333 w1 = bitmap.width;
1334 h1 = bitmap.rows;
1335
1336 if (j_left && j_right) {
1337 x1 += (s->box_width - line_w) / 2;
1338 } else if (j_right) {
1339 x1 += s->box_width - line_w;
1340 }
1341
1342 // Offset of the glyph's bitmap in the visible region
1343 dx = dy = 0;
1344 if (x1 < metrics->rect_x - s->bb_left) {
1345 dx = metrics->rect_x - s->bb_left - x1;
1346 x1 = metrics->rect_x - s->bb_left;
1347 }
1348 if (y1 < metrics->rect_y - s->bb_top) {
1349 dy = metrics->rect_y - s->bb_top - y1;
1350 y1 = metrics->rect_y - s->bb_top;
1351 }
1352
1353 // check if the glyph is empty or out of the clipping region
1354 if (dx >= w1 || dy >= h1 || x1 >= clip_x || y1 >= clip_y) {
1355 continue;
1356 }
1357
1358 pdx = dx + dy * bitmap.pitch;
1359 w1 = FFMIN(clip_x - x1, w1 - dx);
1360 h1 = FFMIN(clip_y - y1, h1 - dy);
1361
1362 ff_blend_mask(&s->dc, color, frame->data, frame->linesize, clip_x, clip_y,
1363 bitmap.buffer + pdx, bitmap.pitch, w1, h1, 3, 0, x1, y1);
1364 }
1365 }
1366
1367 return 0;
1368}
1369
1370// Shapes a line of text using libharfbuzz
1372 HarfbuzzData *hb, const char *text, int textLen)
1373{
1374 unsigned codepoints;
1375
1376 hb->buf = hb_buffer_create();
1377 if (!hb_buffer_allocation_successful(hb->buf))
1378 goto fail;
1379 hb_buffer_add_utf8(hb->buf, text, textLen, 0, -1);
1380 /* Preserve the existing FriBidi visual-order pipeline and the explicit
1381 * language while letting HarfBuzz infer only the script, so complex
1382 * scripts (Bengali / Indic / USE) are dispatched to the correct shaper.
1383 * Setting the language explicitly keeps shaping deterministic and avoids
1384 * the locale-dependent, non-threadsafe first hb_language_get_default(). */
1385 hb_buffer_set_direction(hb->buf, HB_DIRECTION_LTR);
1386 hb_buffer_set_language(hb->buf, hb_language_from_string("en", -1));
1387 hb_buffer_guess_segment_properties(hb->buf);
1388 /* Sample the buffer length here, before hb_shape() flips the buffer's
1389 * content type from UNICODE to GLYPHS. */
1390 codepoints = hb_buffer_get_length(hb->buf);
1391 hb->font = hb_ft_font_create_referenced(s->face);
1392 if (hb->font == NULL)
1393 goto fail;
1394 hb_shape(hb->font, hb->buf, NULL, 0);
1395 hb->glyph_info = hb_buffer_get_glyph_infos(hb->buf, &hb->glyph_count);
1396 hb->glyph_pos = hb_buffer_get_glyph_positions(hb->buf, &hb->glyph_count);
1397
1399 char script_tag[5] = { 0 };
1400 hb_script_t script = hb_buffer_get_script(hb->buf);
1401 hb_direction_t dir = hb_buffer_get_direction(hb->buf);
1402 hb_tag_to_string(hb_script_to_iso15924_tag(script), script_tag);
1404 "shape: script=%s direction=%s codepoints=%u glyphs=%u\n",
1405 script_tag, hb_direction_to_string(dir),
1406 codepoints, hb->glyph_count);
1407 }
1408
1409 return 0;
1410fail:
1411 hb_buffer_destroy(hb->buf);
1412 hb->buf = NULL;
1413 return AVERROR(ENOMEM);
1414}
1415
1416static void hb_destroy(HarfbuzzData *hb)
1417{
1418 hb_font_destroy(hb->font);
1419 hb_buffer_destroy(hb->buf);
1420 hb->buf = NULL;
1421 hb->font = NULL;
1422 hb->glyph_info = NULL;
1423 hb->glyph_pos = NULL;
1424}
1425
1427{
1428 DrawTextContext *s = ctx->priv;
1429 char *text = s->expanded_text.str;
1430 char *textdup = NULL;
1431 int width64 = 0, w64 = 0;
1432 int cur_min_y64 = 0, first_max_y64 = -32000;
1433 int first_min_x64 = 32000, last_max_x64 = -32000;
1434 int min_y64 = 32000, max_y64 = -32000, min_x64 = 32000, max_x64 = -32000;
1435 int line_count = 0;
1436 uint32_t code = 0;
1437 Glyph *glyph = NULL;
1438
1439 int i, tab_idx = 0, last_tab_idx = 0, line_offset = 0;
1440 uint8_t *start, *p;
1441 int ret = 0;
1442
1443 // Count the lines and the tab characters
1444 s->tab_count = 0;
1445 for (i = 0, p = text; 1; i++) {
1446 GET_UTF8(code, *p ? *p++ : 0, code = 0xfffd; goto continue_on_failed;);
1447continue_on_failed:
1448 if (ff_is_newline(code) || code == 0) {
1449 ++line_count;
1450 if (code == 0) {
1451 break;
1452 }
1453 } else if (code == '\t') {
1454 ++s->tab_count;
1455 }
1456 }
1457
1458 // Evaluate the width of the space character if needed to replace tabs
1459 if (s->tab_count > 0 && !s->blank_advance64) {
1460 HarfbuzzData hb_data;
1461 ret = shape_text_hb(ctx, s, &hb_data, " ", 1);
1462 if(ret != 0) {
1463 goto done;
1464 }
1465 s->blank_advance64 = hb_data.glyph_pos[0].x_advance;
1466 hb_destroy(&hb_data);
1467 }
1468
1469 s->line_count = line_count;
1470 s->lines = av_calloc(line_count, sizeof(TextLine));
1471 s->tab_clusters = av_calloc(s->tab_count, sizeof(uint32_t));
1472 if ((line_count > 0 && !s->lines) ||
1473 (s->tab_count > 0 && !s->tab_clusters)) {
1474 ret = AVERROR(ENOMEM);
1475 goto done;
1476 }
1477 for (i = 0; i < s->tab_count; ++i) {
1478 s->tab_clusters[i] = -1;
1479 }
1480
1481 start = textdup = av_strdup(text);
1482 if (textdup == NULL) {
1483 ret = AVERROR(ENOMEM);
1484 goto done;
1485 }
1486 line_count = 0;
1487 for (i = 0, p = textdup; 1; i++) {
1488 if (*p == '\t') {
1489 s->tab_clusters[tab_idx++] = i;
1490 *p = ' ';
1491 }
1492 size_t len = p - start;
1493 GET_UTF8(code, *p ? *p++ : 0, code = 0xfffd; goto continue_on_failed2;);
1494continue_on_failed2:
1495 if (ff_is_newline(code) || code == 0) {
1496 TextLine *cur_line = &s->lines[line_count];
1497 HarfbuzzData *hb = &cur_line->hb_data;
1498 cur_line->cluster_offset = line_offset;
1499 ret = shape_text_hb(ctx, s, hb, start, len);
1500 if (ret != 0) {
1501 goto done;
1502 }
1503 w64 = 0;
1504 cur_min_y64 = 32000;
1505 for (int t = 0; t < hb->glyph_count; ++t) {
1506 uint8_t is_tab = last_tab_idx < s->tab_count &&
1507 hb->glyph_info[t].cluster == s->tab_clusters[last_tab_idx] - line_offset;
1508 if (is_tab) {
1509 ++last_tab_idx;
1510 }
1511 ret = load_glyph(ctx, &glyph, hb->glyph_info[t].codepoint, -1, -1);
1512 if (ret != 0) {
1513 goto done;
1514 }
1515 if (line_count == 0) {
1516 first_max_y64 = FFMAX(glyph->bbox.yMax, first_max_y64);
1517 }
1518 if (t == 0) {
1519 cur_line->offset_left64 = glyph->bbox.xMin;
1520 first_min_x64 = FFMIN(glyph->bbox.xMin, first_min_x64);
1521 }
1522 if (t == hb->glyph_count - 1) {
1523 // The following code measures the width of the line up to the last
1524 // character's horizontal advance
1525 int last_char_width = hb->glyph_pos[t].x_advance;
1526
1527 // The following code measures the width of the line up to the rightmost
1528 // visible pixel of the last character
1529 // int last_char_width = glyph->bbox.xMax;
1530
1531 w64 += last_char_width;
1532 last_max_x64 = FFMAX(last_char_width, last_max_x64);
1533 cur_line->offset_right64 = last_char_width;
1534 } else {
1535 if (is_tab) {
1536 int size = s->blank_advance64 * s->tabsize;
1537 w64 = (w64 / size + 1) * size;
1538 } else {
1539 w64 += hb->glyph_pos[t].x_advance;
1540 }
1541 }
1542 cur_min_y64 = FFMIN(glyph->bbox.yMin, cur_min_y64);
1543 min_y64 = FFMIN(glyph->bbox.yMin, min_y64);
1544 max_y64 = FFMAX(glyph->bbox.yMax, max_y64);
1545 min_x64 = FFMIN(glyph->bbox.xMin, min_x64);
1546 max_x64 = FFMAX(glyph->bbox.xMax, max_x64);
1547 }
1548
1549 cur_line->width64 = w64;
1550
1551 av_log(ctx, AV_LOG_DEBUG, " Line: %d -- glyphs count: %d - width64: %d - offset_left64: %d - offset_right64: %d)\n",
1552 line_count, hb->glyph_count, cur_line->width64, cur_line->offset_left64, cur_line->offset_right64);
1553
1554 if (w64 > width64) {
1555 width64 = w64;
1556 }
1557 start = p;
1558 ++line_count;
1559 line_offset = i + 1;
1560 }
1561
1562 if (code == 0) break;
1563 }
1564
1565 metrics->line_height64 = s->face->size->metrics.height;
1566
1567 metrics->width = POS_CEIL(width64, 64);
1568 if (s->y_align == YA_FONT) {
1569 metrics->height = POS_CEIL(metrics->line_height64 * line_count, 64);
1570 } else {
1571 int height64 = (metrics->line_height64 + s->line_spacing * 64) *
1572 (FFMAX(0, line_count - 1)) + first_max_y64 - cur_min_y64;
1573 metrics->height = POS_CEIL(height64, 64);
1574 }
1575 metrics->offset_top64 = first_max_y64;
1576 metrics->offset_right64 = last_max_x64;
1577 metrics->offset_bottom64 = cur_min_y64;
1578 metrics->offset_left64 = first_min_x64;
1579 metrics->min_x64 = min_x64;
1580 metrics->min_y64 = min_y64;
1581 metrics->max_x64 = max_x64;
1582 metrics->max_y64 = max_y64;
1583
1584done:
1585 av_free(textdup);
1586 if (ret < 0) {
1587 if (s->lines) {
1588 for (int l = 0; l < s->line_count; ++l)
1589 hb_destroy(&s->lines[l].hb_data);
1590 }
1591 av_freep(&s->lines);
1592 av_freep(&s->tab_clusters);
1593 s->line_count = 0;
1594 }
1595 return ret;
1596}
1597
1599{
1600 DrawTextContext *s = ctx->priv;
1601 AVFilterLink *inlink = ctx->inputs[0];
1602 FilterLink *inl = ff_filter_link(inlink);
1603 int x = 0, y = 0, ret;
1604 int shift_x64, shift_y64;
1605 int x64, y64;
1606 Glyph *glyph = NULL;
1607
1608 time_t now = time(0);
1609 struct tm ltime;
1610 AVBPrint *bp = &s->expanded_text;
1611
1612 FFDrawColor fontcolor;
1613 FFDrawColor shadowcolor;
1614 FFDrawColor bordercolor;
1615 FFDrawColor boxcolor;
1616
1617 int width = frame->width;
1618 int height = frame->height;
1619 int rec_x = 0, rec_y = 0, rec_width = 0, rec_height = 0;
1620 int is_outside = 0;
1621 int last_tab_idx = 0;
1622
1623 TextMetrics metrics;
1624
1625 av_bprint_clear(bp);
1626
1627 if (s->basetime != AV_NOPTS_VALUE)
1628 now= frame->pts*av_q2d(ctx->inputs[0]->time_base) + s->basetime/1000000;
1629
1630 switch (s->exp_mode) {
1631 case EXP_NONE:
1632 av_bprintf(bp, "%s", s->text);
1633 break;
1634 case EXP_NORMAL:
1635 if ((ret = ff_expand_text(&s->expand_text, s->text, &s->expanded_text)) < 0)
1636 return ret;
1637 break;
1638 case EXP_STRFTIME:
1639 localtime_r(&now, &ltime);
1640 av_bprint_strftime(bp, s->text, &ltime);
1641 break;
1642 }
1643
1644 if (s->tc_opt_string) {
1645 char tcbuf[AV_TIMECODE_STR_SIZE];
1646 av_timecode_make_string(&s->tc, tcbuf, inl->frame_count_out);
1647 av_bprint_clear(bp);
1648 av_bprintf(bp, "%s%s", s->text, tcbuf);
1649 }
1650
1651 if (!av_bprint_is_complete(bp))
1652 return AVERROR(ENOMEM);
1653
1654 if (s->fontcolor_expr[0]) {
1655 /* If expression is set, evaluate and replace the static value */
1656 av_bprint_clear(&s->expanded_fontcolor);
1657 if ((ret = ff_expand_text(&s->expand_text, s->fontcolor_expr, &s->expanded_fontcolor)) < 0)
1658 return ret;
1659 if (!av_bprint_is_complete(&s->expanded_fontcolor))
1660 return AVERROR(ENOMEM);
1661 av_log(ctx, AV_LOG_DEBUG, "Evaluated fontcolor is '%s'\n", s->expanded_fontcolor.str);
1662 ret = av_parse_color(s->fontcolor.rgba, s->expanded_fontcolor.str, -1, s);
1663 if (ret)
1664 return ret;
1665 ff_draw_color(&s->dc, &s->fontcolor, s->fontcolor.rgba);
1666 }
1667
1668 if ((ret = update_fontsize(ctx)) < 0) {
1669 return ret;
1670 }
1671
1672 if ((ret = measure_text(ctx, &metrics)) < 0) {
1673 return ret;
1674 }
1675
1676 s->max_glyph_h = POS_CEIL(metrics.max_y64 - metrics.min_y64, 64);
1677 s->max_glyph_w = POS_CEIL(metrics.max_x64 - metrics.min_x64, 64);
1678
1679 s->var_values[VAR_TW] = s->var_values[VAR_TEXT_W] = metrics.width;
1680 s->var_values[VAR_TH] = s->var_values[VAR_TEXT_H] = metrics.height;
1681
1682 s->var_values[VAR_MAX_GLYPH_W] = s->max_glyph_w;
1683 s->var_values[VAR_MAX_GLYPH_H] = s->max_glyph_h;
1684 s->var_values[VAR_MAX_GLYPH_A] = s->var_values[VAR_ASCENT] = POS_CEIL(metrics.max_y64, 64);
1685 s->var_values[VAR_FONT_A] = s->face->size->metrics.ascender / 64;
1686 s->var_values[VAR_MAX_GLYPH_D] = s->var_values[VAR_DESCENT] = POS_CEIL(metrics.min_y64, 64);
1687 s->var_values[VAR_FONT_D] = -s->face->size->metrics.descender / 64;
1688
1689 s->var_values[VAR_TOP_A] = POS_CEIL(metrics.offset_top64, 64);
1690 s->var_values[VAR_BOTTOM_D] = -POS_CEIL(metrics.offset_bottom64, 64);
1691 s->var_values[VAR_LINE_H] = s->var_values[VAR_LH] = metrics.line_height64 / 64.;
1692
1693 if (s->text_source == AV_FRAME_DATA_DETECTION_BBOXES) {
1694 s->var_values[VAR_X] = s->x;
1695 s->var_values[VAR_Y] = s->y;
1696 } else {
1697 s->x = s->var_values[VAR_X] = av_expr_eval(s->x_pexpr, s->var_values, &s->prng);
1698 s->y = s->var_values[VAR_Y] = av_expr_eval(s->y_pexpr, s->var_values, &s->prng);
1699 /* It is necessary if x is expressed from y */
1700 s->x = s->var_values[VAR_X] = av_expr_eval(s->x_pexpr, s->var_values, &s->prng);
1701 }
1702
1703 update_alpha(s);
1704 update_color_with_alpha(s, &fontcolor , s->fontcolor );
1705 update_color_with_alpha(s, &shadowcolor, s->shadowcolor);
1706 update_color_with_alpha(s, &bordercolor, s->bordercolor);
1707 update_color_with_alpha(s, &boxcolor , s->boxcolor );
1708
1709 if (s->draw_box && s->boxborderw) {
1710 int bbsize[4];
1711 int count;
1712 count = string_to_array(s->boxborderw, bbsize, 4);
1713 if (count == 1) {
1714 s->bb_top = s->bb_right = s->bb_bottom = s->bb_left = bbsize[0];
1715 } else if (count == 2) {
1716 s->bb_top = s->bb_bottom = bbsize[0];
1717 s->bb_right = s->bb_left = bbsize[1];
1718 } else if (count == 3) {
1719 s->bb_top = bbsize[0];
1720 s->bb_right = s->bb_left = bbsize[1];
1721 s->bb_bottom = bbsize[2];
1722 } else if (count == 4) {
1723 s->bb_top = bbsize[0];
1724 s->bb_right = bbsize[1];
1725 s->bb_bottom = bbsize[2];
1726 s->bb_left = bbsize[3];
1727 }
1728 } else {
1729 s->bb_top = s->bb_right = s->bb_bottom = s->bb_left = 0;
1730 }
1731
1732 if (s->fix_bounds) {
1733 /* calculate footprint of text effects */
1734 int borderoffset = s->borderw ? FFMAX(s->borderw, 0) : 0;
1735
1736 int offsetleft = FFMAX3(FFMAX(s->bb_left, 0), borderoffset,
1737 (s->shadowx < 0 ? FFABS(s->shadowx) : 0));
1738 int offsettop = FFMAX3(FFMAX(s->bb_top, 0), borderoffset,
1739 (s->shadowy < 0 ? FFABS(s->shadowy) : 0));
1740 int offsetright = FFMAX3(FFMAX(s->bb_right, 0), borderoffset,
1741 (s->shadowx > 0 ? s->shadowx : 0));
1742 int offsetbottom = FFMAX3(FFMAX(s->bb_bottom, 0), borderoffset,
1743 (s->shadowy > 0 ? s->shadowy : 0));
1744
1745 if (s->x - offsetleft < 0) s->x = offsetleft;
1746 if (s->y - offsettop < 0) s->y = offsettop;
1747
1748 if (s->x + metrics.width + offsetright > width)
1749 s->x = FFMAX(width - metrics.width - offsetright, 0);
1750 if (s->y + metrics.height + offsetbottom > height)
1751 s->y = FFMAX(height - metrics.height - offsetbottom, 0);
1752 }
1753
1754 x = 0;
1755 y = 0;
1756 x64 = (int)(s->x * 64.);
1757 if (s->y_align == YA_FONT) {
1758 y64 = (int)(s->y * 64. + s->face->size->metrics.ascender);
1759 } else if (s->y_align == YA_BASELINE) {
1760 y64 = (int)(s->y * 64.);
1761 } else {
1762 y64 = (int)(s->y * 64. + metrics.offset_top64);
1763 }
1764
1765 for (int l = 0; l < s->line_count; ++l) {
1766 TextLine *line = &s->lines[l];
1767 HarfbuzzData *hb = &line->hb_data;
1768 line->glyphs = av_mallocz(hb->glyph_count * sizeof(GlyphInfo));
1769
1770 for (int t = 0; t < hb->glyph_count; ++t) {
1771 GlyphInfo *g_info = &line->glyphs[t];
1772 uint8_t is_tab = last_tab_idx < s->tab_count &&
1773 hb->glyph_info[t].cluster == s->tab_clusters[last_tab_idx] - line->cluster_offset;
1774 int true_x, true_y;
1775 if (is_tab) {
1776 ++last_tab_idx;
1777 }
1778 true_x = x + hb->glyph_pos[t].x_offset;
1779 true_y = y + hb->glyph_pos[t].y_offset;
1780 shift_x64 = (((x64 + true_x) >> 4) & 0b0011) << 4;
1781 shift_y64 = ((4 - (((y64 + true_y) >> 4) & 0b0011)) & 0b0011) << 4;
1782
1783 ret = load_glyph(ctx, &glyph, hb->glyph_info[t].codepoint, shift_x64, shift_y64);
1784 if (ret != 0) {
1785 goto fail;
1786 }
1787 g_info->code = hb->glyph_info[t].codepoint;
1788 g_info->x = (x64 + true_x) >> 6;
1789 g_info->y = ((y64 + true_y) >> 6) + (shift_y64 > 0 ? 1 : 0);
1790 g_info->shift_x64 = shift_x64;
1791 g_info->shift_y64 = shift_y64;
1792
1793 if (!is_tab) {
1794 x += hb->glyph_pos[t].x_advance;
1795 } else {
1796 int size = s->blank_advance64 * s->tabsize;
1797 x = (x / size + 1) * size;
1798 }
1799 y += hb->glyph_pos[t].y_advance;
1800 }
1801
1802 y += metrics.line_height64 + s->line_spacing * 64;
1803 x = 0;
1804 }
1805
1806 metrics.rect_x = s->x;
1807 if (s->y_align == YA_BASELINE) {
1808 metrics.rect_y = s->y - metrics.offset_top64 / 64;
1809 } else {
1810 metrics.rect_y = s->y;
1811 }
1812
1813 s->box_width = s->boxw == 0 ? metrics.width : s->boxw;
1814 s->box_height = s->boxh == 0 ? metrics.height : s->boxh;
1815
1816 if (!s->draw_box) {
1817 // Create a border for the clipping region to take into account subpixel
1818 // errors in text measurement and effects.
1819 int borderoffset = s->borderw ? FFMAX(s->borderw, 0) : 0;
1820 s->bb_left = borderoffset + (s->shadowx < 0 ? FFABS(s->shadowx) : 0) + 1;
1821 s->bb_top = borderoffset + (s->shadowy < 0 ? FFABS(s->shadowy) : 0) + 1;
1822 s->bb_right = borderoffset + (s->shadowx > 0 ? s->shadowx : 0) + 1;
1823 s->bb_bottom = borderoffset + (s->shadowy > 0 ? s->shadowy : 0) + 1;
1824 }
1825
1826 /* Check if the whole box is out of the frame */
1827 is_outside = metrics.rect_x - s->bb_left >= width ||
1828 metrics.rect_y - s->bb_top >= height ||
1829 metrics.rect_x + s->box_width + s->bb_right <= 0 ||
1830 metrics.rect_y + s->box_height + s->bb_bottom <= 0;
1831
1832 if (!is_outside) {
1833 /* draw box */
1834 if (s->draw_box) {
1835 rec_x = metrics.rect_x - s->bb_left;
1836 rec_y = metrics.rect_y - s->bb_top;
1837 rec_width = s->box_width + s->bb_right + s->bb_left;
1838 rec_height = s->box_height + s->bb_bottom + s->bb_top;
1839 ff_blend_rectangle(&s->dc, &boxcolor,
1840 frame->data, frame->linesize, width, height,
1841 rec_x, rec_y, rec_width, rec_height);
1842 }
1843
1844 if (s->shadowx || s->shadowy) {
1845 if ((ret = draw_glyphs(ctx, frame, &shadowcolor, &metrics,
1846 s->shadowx, s->shadowy, s->borderw)) < 0) {
1847 goto fail;
1848 }
1849 }
1850
1851 if (s->borderw) {
1852 if ((ret = draw_glyphs(ctx, frame, &bordercolor, &metrics,
1853 0, 0, s->borderw)) < 0) {
1854 goto fail;
1855 }
1856 }
1857
1858 if ((ret = draw_glyphs(ctx, frame, &fontcolor, &metrics, 0,
1859 0, 0)) < 0) {
1860 goto fail;
1861 }
1862 }
1863
1864 ret = 0;
1865fail:
1866 // FREE data structures
1867 for (int l = 0; l < s->line_count; ++l) {
1868 TextLine *line = &s->lines[l];
1869 av_freep(&line->glyphs);
1870 hb_destroy(&line->hb_data);
1871 }
1872 av_freep(&s->lines);
1873 av_freep(&s->tab_clusters);
1874 s->line_count = 0;
1875
1876 return ret;
1877}
1878
1880{
1881 FilterLink *inl = ff_filter_link(inlink);
1882 AVFilterContext *ctx = inlink->dst;
1883 AVFilterLink *outlink = ctx->outputs[0];
1884 DrawTextContext *s = ctx->priv;
1885 int ret;
1887 const AVDetectionBBox *bbox;
1888 AVFrameSideData *sd;
1889 int loop = 1;
1890
1891 if (s->text_source == AV_FRAME_DATA_DETECTION_BBOXES) {
1893 if (sd) {
1895 loop = header->nb_bboxes;
1896 } else {
1897 av_log(ctx, AV_LOG_WARNING, "No detection bboxes.\n");
1898 return ff_filter_frame(outlink, frame);
1899 }
1900 }
1901
1902 if (s->reload && !(inl->frame_count_out % s->reload)) {
1903 if ((ret = ff_load_textfile(ctx, (const char *)s->textfile, &s->text, NULL)) < 0) {
1905 return ret;
1906 }
1907#if CONFIG_LIBFRIBIDI
1908 if (s->text_shaping)
1909 if ((ret = shape_text(ctx)) < 0) {
1911 return ret;
1912 }
1913#endif
1914 }
1915
1916 s->var_values[VAR_N] = inl->frame_count_out + s->start_number;
1917 s->var_values[VAR_T] = frame->pts == AV_NOPTS_VALUE ?
1918 NAN : frame->pts * av_q2d(inlink->time_base);
1919
1920 s->var_values[VAR_PICT_TYPE] = frame->pict_type;
1921 s->var_values[VAR_DURATION] = frame->duration * av_q2d(inlink->time_base);
1922
1923 s->metadata = frame->metadata;
1924
1925 for (int i = 0; i < loop; i++) {
1926 if (header) {
1928 strcpy(s->text, bbox->detect_label);
1929 for (int j = 0; j < bbox->classify_count; j++) {
1930 strcat(s->text, ", ");
1931 strcat(s->text, bbox->classify_labels[j]);
1932 }
1933 s->x = bbox->x;
1934 s->y = bbox->y - s->fontsize;
1935 }
1936 ret = draw_text(ctx, frame);
1937 if (ret < 0) {
1939 return ret;
1940 }
1941 }
1942
1943 return ff_filter_frame(outlink, frame);
1944}
1945
1947 {
1948 .name = "default",
1949 .type = AVMEDIA_TYPE_VIDEO,
1951 .filter_frame = filter_frame,
1952 .config_props = config_input,
1953 },
1954};
1955
1957 .p.name = "drawtext",
1958 .p.description = NULL_IF_CONFIG_SMALL("Draw text on top of video frames using libfreetype library."),
1959 .p.priv_class = &drawtext_class,
1961 .priv_size = sizeof(DrawTextContext),
1962 .init = init,
1963 .uninit = uninit,
1967 .process_command = command,
1968};
@ VAR_T
Definition aeval.c:53
static int query_formats(const AVFilterContext *ctx, AVFilterFormatsConfig **cfg_in, AVFilterFormatsConfig **cfg_out)
Definition aeval.c:246
static int config_input(AVFilterLink *inlink)
#define TFLAGS
Definition af_afade.c:66
static void drawtext(AVFrame *pic, int x, int y, const char *txt, uint32_t color)
Definition af_aiir.c:1036
const FFFilter ff_vf_drawtext
static FILE * out
static AVFormatContext * ctx
#define av_assert0(cond)
assert() equivalent, that is always enabled.
Definition avassert.h:42
@ VAR_H
Definition avfilter.c:565
@ VAR_W
Definition avfilter.c:564
int ff_filter_frame(AVFilterLink *link, AVFrame *frame)
Send a frame of data to the next filter.
Definition avfilter.c:1068
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.
Definition avfilter.c:906
Main libavfilter public API header.
@ VAR_VSUB
Definition boxblur.c:42
@ VAR_HSUB
Definition boxblur.c:41
void av_bprintf(AVBPrint *buf, const char *fmt,...)
Definition bprint.c:122
void av_bprint_init(AVBPrint *buf, unsigned size_init, unsigned size_max)
Definition bprint.c:69
AVBPrint public header.
#define AV_BPRINT_SIZE_UNLIMITED
#define flags(name, subs,...)
Definition cbs_h264.c:74
#define i(width, name, range_min, range_max)
Definition cbs_h264.c:63
#define s(width, name)
Definition cbs_vp9.c:198
#define FLAGS
Definition cmdutils.c:598
common internal and external API header
#define GET_UTF8(val, GET_BYTE, ERROR)
Convert a UTF-8 character (up to 4 bytes) to its 32-bit UCS-4 encoded form.
Definition common.h:477
#define FFABS(a)
Absolute value, Note, INT_MIN / INT64_MIN result in undefined behavior as they are not representable ...
Definition common.h:74
#define NULL
Definition coverity.c:32
long long int64_t
Definition coverity.c:34
#define min(a, b)
#define max(a, b)
static AVFrame * frame
#define AV_DETECTION_BBOX_LABEL_NAME_MAX_SIZE
#define AV_NUM_DETECTION_BBOX_CLASSIFY
At most 4 classifications based on the detected bounding box.
static av_always_inline AVDetectionBBox * av_get_detection_bbox(const AVDetectionBBoxHeader *header, unsigned int idx)
static int filter_frame(DBEDecodeContext *s, AVFrame *frame)
Definition dolby_e.c:1067
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.
Definition drawutils.c:378
void ff_draw_color(FFDrawContext *draw, FFDrawColor *color, const uint8_t rgba[4])
Prepare a color.
Definition drawutils.c:179
AVFilterFormats * ff_draw_supported_pixel_formats(unsigned flags)
Return the list of pixel formats supported by the draw functions.
Definition drawutils.c:670
int ff_draw_init_from_link(FFDrawContext *draw, const AVFilterLink *link, unsigned flags)
Init a draw context, taking the format, colorspace and range from the given filter link.
Definition drawutils.c:168
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.
Definition drawutils.c:557
misc drawing utilities
#define FF_DRAW_PROCESS_ALPHA
Process alpha pixel component.
Definition drawutils.h:64
int(* init)(AVBSFContext *ctx)
Definition dts2pts.c:608
void av_expr_free(AVExpr *e)
Free a parsed expression previously created with av_expr_parse().
Definition eval.c:368
double av_expr_eval(AVExpr *e, const double *const_values, void *opaque)
Evaluate a previously parsed expression.
Definition eval.c:824
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.
Definition eval.c:735
simple arithmetic expression evaluator
@ VAR_PICT_TYPE
Definition f_select.c:111
const char * key
static int dummy
Definition ffplay.c:3754
static int loop
Definition ffplay.c:338
int ff_set_common_formats2(const AVFilterContext *ctx, AVFilterFormatsConfig **cfg_in, AVFilterFormatsConfig **cfg_out, AVFilterFormats *formats)
Definition formats.c:1137
#define fail
Definition test.h:479
@ AV_OPT_TYPE_CONST
Special option type for declaring named constants.
Definition opt.h:298
@ AV_OPT_TYPE_RATIONAL
Underlying C type is AVRational.
Definition opt.h:279
@ AV_OPT_TYPE_FLAGS
Underlying C type is unsigned int.
Definition opt.h:254
@ AV_OPT_TYPE_INT64
Underlying C type is int64_t.
Definition opt.h:262
@ AV_OPT_TYPE_INT
Underlying C type is int.
Definition opt.h:258
@ AV_OPT_TYPE_BOOL
Underlying C type is int.
Definition opt.h:326
@ AV_OPT_TYPE_STRING
Underlying C type is a uint8_t* that is either NULL or points to a C string allocated with the av_mal...
Definition opt.h:275
@ AV_OPT_TYPE_COLOR
Underlying C type is uint8_t[4].
Definition opt.h:322
#define AVFILTER_FLAG_SUPPORT_TIMELINE_GENERIC
Some filters support a generic "enable" expression option that can be used to enable or disable a fil...
Definition avfilter.h:196
static int av_bprint_is_complete(const AVBPrint *buf)
Test if the print buffer is complete (not truncated).
Definition bprint.h:218
int av_bprint_finalize(AVBPrint *buf, char **ret_str)
Finalize a print buffer.
Definition bprint.c:235
void av_bprint_strftime(AVBPrint *buf, const char *fmt, const struct tm *tm)
Append a formatted date and time to a print buffer.
Definition bprint.c:166
void av_bprint_clear(AVBPrint *buf)
Reset the string to "" but keep internal allocated data.
Definition bprint.c:227
uint32_t av_get_random_seed(void)
Get a seed to use in conjunction with random functions.
AVDictionaryEntry * av_dict_get(const AVDictionary *m, const char *key, const AVDictionaryEntry *prev, int flags)
Get a dictionary entry with matching key.
Definition dict.c:60
#define AVERROR_UNKNOWN
Unknown error, typically from an external library.
Definition error.h:73
#define AVERROR_EXTERNAL
Generic error in an external library.
Definition error.h:59
#define AVERROR(e)
Definition error.h:45
AVFrameSideData * av_frame_get_side_data(const AVFrame *frame, enum AVFrameSideDataType type)
Definition frame.c:659
void av_frame_free(AVFrame **frame)
Free the frame and any dynamically allocated objects in it, e.g.
Definition frame.c:64
AVFrameSideDataType
Definition frame.h:49
@ AV_FRAME_DATA_DETECTION_BBOXES
Bounding boxes for object detection and classification, as described by AVDetectionBBoxHeader.
Definition frame.h:194
#define AV_LOG_DEBUG
Stuff which is only useful for libav* developers.
Definition log.h:231
#define AV_LOG_WARNING
Something somehow does not look correct.
Definition log.h:216
#define AV_LOG_VERBOSE
Detailed information.
Definition log.h:226
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
Definition log.h:210
int av_log_get_level(void)
Get the current log level.
Definition log.c:471
static double av_q2d(AVRational a)
Convert an AVRational to a double.
Definition rational.h:104
@ AVMEDIA_TYPE_VIDEO
Definition avutil.h:200
char av_get_picture_type_char(enum AVPictureType pict_type)
Return a single letter to describe the given picture type pict_type.
Definition utils.c:40
char * av_strtok(char *s, const char *delim, char **saveptr)
Split the string into several tokens which can be accessed by successive calls to av_strtok().
Definition avstring.c:179
size_t av_strlcpy(char *dst, const char *src, size_t size)
Copy the string src to dst, but no more than size - 1 bytes, and null-terminate dst.
Definition avstring.c:85
#define AV_NOPTS_VALUE
Undefined timestamp value.
Definition avutil.h:247
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.
Definition tree.c:155
void * av_tree_insert(AVTreeNode **tp, void *key, int(*cmp)(const void *key, const void *b), AVTreeNode **next)
Insert or remove an element.
Definition tree.c:59
void av_tree_destroy(AVTreeNode *t)
Definition tree.c:146
struct AVTreeNode * av_tree_node_alloc(void)
Allocate an AVTreeNode.
Definition tree.c:34
void av_opt_free(void *obj)
Free all allocated objects in obj.
Definition opt.c:2027
int av_opt_copy(void *dst, const void *src)
Copy options from src object into dest object.
Definition opt.c:2217
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.
Definition opt.c:1895
int index
Definition gxfenc.c:90
int a
static const int16_t alpha[]
Definition ilbcdata.h:55
#define b
Definition input.c:43
static av_cold void uninit(AVBitStreamFilterContext *ctx)
av_cold void av_lfg_init(AVLFG *c, unsigned int seed)
Definition lfg.c:32
static unsigned int av_lfg_get(AVLFG *c)
Get the next random unsigned 32-bit number using an ALFG.
Definition lfg.h:53
static int shift(int a, int b)
Definition bonk.c:261
const char * arg
Definition jacosubdec.c:65
#define FILTER_INPUTS(array)
Definition filters.h:264
#define FILTER_OUTPUTS(array)
Definition filters.h:265
#define AVFILTERPAD_FLAG_NEEDS_WRITABLE
The filter expects writable frames from its input link, duplicating data buffers if needed.
Definition filters.h:59
static FilterLink * ff_filter_link(AVFilterLink *link)
Definition filters.h:199
#define AVFILTER_DEFINE_CLASS(fname)
Definition filters.h:478
#define FILTER_QUERY_FUNC2(func)
Definition filters.h:241
@ VAR_X
Definition vf_blend.c:55
@ VAR_Y
Definition vf_blend.c:55
#define av_cold
Definition attributes.h:117
#define NULL_IF_CONFIG_SMALL(x)
Return NULL if CONFIG_SMALL is true, otherwise the argument without modification.
Definition internal.h:88
#define isnan(x)
Definition libm.h:342
static av_always_inline av_const double round(double x)
Definition libm.h:446
#define FFMAX3(a, b, c)
Definition macros.h:48
#define FFMIN(a, b)
Definition macros.h:49
#define FFMAX(a, b)
Definition macros.h:47
#define FFDIFFSIGN(x, y)
Comparator.
Definition macros.h:45
#define NAN
void * av_calloc(size_t nmemb, size_t size)
Definition mem.c:264
Memory handling functions.
var_name
Definition noise.c:46
@ VAR_N
Definition noise.c:47
@ VAR_VARS_NB
Definition noise.c:59
@ VAR_DURATION
Definition noise.c:54
static const char *const var_names[]
Definition noise.c:30
#define av_strdup(s)
Definition ops_static.c:55
#define av_realloc(p, s)
Definition ops_static.c:54
#define av_malloc(s)
Definition ops_static.c:52
AVOptions.
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.
Definition parseutils.c:359
misc parsing utilities
@ VAR_w
Definition qrencode.c:59
static int func_eval_expr(void *ctx, AVBPrint *bp, const char *function_name, unsigned argc, char **argv)
Definition qrencode.c:248
static int func_strftime(void *ctx, AVBPrint *bp, const char *function_name, unsigned argc, char **argv)
Definition qrencode.c:226
static const ff_eval_func2 fun2[]
Definition qrencode.c:190
static int func_pts(void *ctx, AVBPrint *bp, const char *function_name, unsigned argc, char **argv)
Definition qrencode.c:195
static double drand(void *opaque, double min, double max)
Definition qrencode.c:185
static int func_frame_num(void *ctx, AVBPrint *bp, const char *function_name, unsigned argc, char **argv)
Definition qrencode.c:217
static const char *const fun2_names[]
Definition qrencode.c:181
static const FFExpandTextFunction expand_text_functions[]
Definition qrencode.c:287
@ VAR_SAR
Definition scale_eval.c:49
@ VAR_DAR
Definition scale_eval.c:50
static const uint8_t header[24]
Definition sdr2.c:68
#define FF_ARRAY_ELEMS(a)
const uint8_t * code
Definition spdifenc.c:433
Describe the class of an AVClass context structure.
Definition log.h:76
char detect_label[AV_DETECTION_BBOX_LABEL_NAME_MAX_SIZE]
Detect result with confidence.
int x
Distance in pixels from the left/top edge of the frame, together with width and height,...
char classify_labels[AV_NUM_DETECTION_BBOX_CLASSIFY][AV_DETECTION_BBOX_LABEL_NAME_MAX_SIZE]
uint32_t classify_count
char * value
Definition dict.h:92
Definition eval.c:171
An instance of a filter.
Definition avfilter.h:273
Lists of formats / etc.
Definition avfilter.h:120
A filter pad used for either input or output.
Definition filters.h:40
Structure to hold side data for an AVFrame.
Definition frame.h:327
uint8_t * data
Definition frame.h:329
This structure describes decoded (raw) audio or video data.
Definition frame.h:472
Context structure for the Lagged Fibonacci PRNG.
Definition lfg.h:33
AVOption.
Definition opt.h:428
Rational number (pair of numerator and denominator).
Definition rational.h:58
int num
Numerator.
Definition rational.h:59
void * elem
Definition tree.c:28
double y
y position to start drawing text
int start_number
starting frame number for n/frame_num var
int text_align
the horizontal and vertical text alignment
FFDrawColor shadowcolor
shadow color
int max_glyph_w
max glyph width
AVRational tc_rate
frame rate for timecode
int box_width
the width of box
int box_height
the height of box
FT_Stroker stroker
freetype stroker handle
FFDrawColor bordercolor
border color
char * text_source_string
the string to specify text data source
int tab_warning_printed
ensure the tab warning to be printed only once
int reinit
tells if the filter is being reinited
int fix_bounds
do we let it go out of frame bounds - t/f
uint8_t * fontcolor_expr
fontcolor expression to evaluate
AVDictionary * metadata
FFDrawColor boxcolor
background color
AVExpr * fontsize_pexpr
parsed expressions for fontsize
uint8_t * fontfile
font to be used
char * fontsize_expr
expression for fontsize
AVBPrint expanded_text
used to contain the expanded text
int max_glyph_h
max glyph height
double var_values[VAR_VARS_NB]
FFDrawColor fontcolor
foreground color
FT_Face face
freetype font face handle
short int draw_box
draw box around text - true or false
int bb_bottom
the size of the bottom box border
double x
x position to start drawing text
AVBPrint expanded_fontcolor
used to contain the expanded fontcolor spec
FFDrawContext dc
char * x_expr
expression for x position
struct AVTreeNode * glyphs
rendered glyphs, stored using the UTF-32 char code
uint32_t * tab_clusters
the position of tab characters in the text
AVLFG prng
random
char * textfile
file with text to be drawn
TextLine * lines
computed information about text lines
int bb_top
the size of the top box border
int bb_left
the size of the left box border
int ft_load_flags
flags used for loading fonts, see FT_LOAD_*
int bb_right
the size of the right box border
int exp_mode
expansion mode to use for the text
unsigned int default_fontsize
default font size to use
int line_spacing
lines spacing in pixels
int boxw
the value of the boxw parameter
int reload
reload text file at specified frame interval
FFExpandTextContext expand_text
expand text in case exp_mode == NORMAL
char * y_expr
expression for y position
int line_count
the number of text lines
uint8_t * text
text to be drawn
int borderw
border width
int tab_count
the number of tab characters
unsigned int fontsize
font size to use
int64_t basetime
base pts time in the real world for display
int blank_advance64
the size of the space character
int boxh
the value of the boxh parameter
enum AVFrameSideDataType text_source
int y_align
the value of the y_align parameter
char * tc_opt_string
specified timecode option string
char * boxborderw
box border width (padding) allowed formats: "all", "vert|oriz", "top|right|bottom|left"
int tc24hmax
1 if timecode is wrapped to 24 hours, 0 otherwise
AVExpr * y_pexpr
parsed expressions for x and y
AVTimecode tc
timecode context
int tabsize
tab size
FT_Library library
freetype font library handle
Text expander context, used to encapsulate the logic to expand a given text template.
Definition textutils.h:66
Function used to expand a template sequence in the format %{FUNCTION_NAME[:PARAMS]}...
Definition textutils.h:36
Information about a single glyph in a text line.
int x
the x position of the glyph
int y
the y position of the glyph
int shift_x64
the horizontal shift of the glyph in 26.6 units
uint32_t code
the glyph code point
int shift_y64
the vertical shift of the glyph in 26.6 units
A glyph as loaded and rendered using libfreetype.
FT_BitmapGlyph border_bglyph[16]
Outlined glyph bitmaps with 1/4 pixel precision in both directions.
unsigned int fontsize
FT_Glyph border_glyph
uint32_t code
FT_BBox bbox
FT_Glyph glyph
FT_BitmapGlyph bglyph[16]
Glyph bitmaps with 1/4 pixel precision in both directions.
hb_glyph_info_t * glyph_info
hb_glyph_position_t * glyph_pos
hb_buffer_t * buf
hb_font_t * font
unsigned int glyph_count
Information about a single line of text.
int offset_right64
maximum offset between the origin and the rightmost pixel of the last glyph
int offset_left64
offset between the origin and the leftmost pixel of the first glyph
GlyphInfo * glyphs
array of glyphs in this text line
int width64
width of the line
int cluster_offset
the offset at which this line begins
HarfbuzzData hb_data
libharfbuzz data of this text line
Global text metrics.
int offset_right64
maximum offset between the origin and the rightmost pixel of the last glyph of each line (in 26....
int offset_left64
maximum offset between the origin and the leftmost pixel of the first glyph of each line (in 26....
int min_x64
minimum value of bbox.xMin among glyphs (in 26.6 units)
int rect_y
y position of the box
int line_height64
the font-defined line height
int offset_top64
ascender amount of the first line (in 26.6 units)
int width
width of the longest line - ceil(width64/64)
int min_y64
minimum value of bbox.yMin among glyphs (in 26.6 units)
int offset_bottom64
descender amount of the last line (in 26.6 units)
int max_x64
maximum value of bbox.xMax among glyphs (in 26.6 units)
int max_y64
maximum value of bbox.yMax among glyphs (in 26.6 units)
int height
total height of the text - ceil(height64/64)
int rect_x
x position of the box
const char * err_msg
#define av_free(p)
#define av_malloc_array(a, b)
#define av_mallocz(s)
#define av_freep(p)
#define av_log(a,...)
static void error(const char *err)
static uint8_t tmp[40]
Definition aes_ctr.c:52
#define height
Definition dsp.h:89
#define width
Definition dsp.h:89
int ff_print_pts(void *log_ctx, AVBPrint *bp, double pts, const char *delta, const char *fmt, const char *strftime_fmt)
Definition textutils.c:150
int ff_load_textfile(void *log_ctx, const char *textfile, unsigned char **text, size_t *text_size)
Definition textutils.c:354
int ff_expand_text(FFExpandTextContext *expand_text, const char *text, AVBPrint *bp)
Expand text template.
Definition textutils.c:124
int ff_print_time(void *log_ctx, AVBPrint *bp, const char *strftime_fmt, char localtime)
Definition textutils.c:203
int ff_print_formatted_eval_expr(void *log_ctx, AVBPrint *bp, const char *expr, const char *const *fun_names, const ff_eval_func2 *fun_values, const char *const *var_names, const double *var_values, void *eval_ctx, const char format, int positions)
Definition textutils.c:304
int ff_print_eval_expr(void *log_ctx, AVBPrint *bp, const char *expr, const char *const *fun_names, const ff_eval_func2 *fun_values, const char *const *var_names, const double *var_values, void *eval_ctx)
Definition textutils.c:282
text utilities
#define localtime_r
int av_timecode_init_from_string(AVTimecode *tc, AVRational rate, const char *str, void *log_ctx)
Parse timecode representation (hh:mm:ss[:;.
Definition timecode.c:241
char * av_timecode_make_string(const AVTimecode *tc, char *buf, int framenum_arg)
Load timecode string in buf.
Definition timecode.c:104
Timecode helpers header.
#define AV_TIMECODE_STR_SIZE
Definition timecode.h:33
@ AV_TIMECODE_FLAG_24HOURSMAX
timecode wraps after 24 hours
Definition timecode.h:37
static int64_t pts
void * av_tree_find(const AVTreeNode *t, void *key, int(*cmp)(const void *key, const void *b), void *next[2])
Definition tree.c:39
A tree container.
int size
const char * g
Definition vf_curves.c:128
@ VAR_BOTTOM_D
@ VAR_TEXT_H
@ VAR_DESCENT
@ VAR_FONT_A
@ VAR_MAX_GLYPH_D
@ VAR_TW
@ VAR_MAIN_H
@ VAR_LH
@ VAR_ASCENT
@ VAR_TEXT_W
@ VAR_MAX_GLYPH_A
@ VAR_MAX_GLYPH_W
@ VAR_MAIN_W
@ VAR_VARS_NB
@ VAR_FONT_D
@ VAR_TH
@ VAR_TOP_A
@ VAR_h
@ VAR_LINE_H
@ VAR_MAX_GLYPH_H
static const AVFilterPad avfilter_vf_drawtext_inputs[]
double(* eval_func2)(void *, double a, double b)
text_alignment
@ TA_RIGHT
@ TA_TOP
@ TA_LEFT
@ TA_BOTTOM
expansion_mode
@ EXP_STRFTIME
@ EXP_NORMAL
@ EXP_NONE
#define POS_CEIL(x, y)
Definition vf_drawtext.c:81
static const AVOption drawtext_options[]
static int config_input(AVFilterLink *inlink)
static int filter_frame(AVFilterLink *inlink, AVFrame *frame)
#define FT_ERRMSG(e)
static void update_alpha(DrawTextContext *s)
static int glyph_enu_border_free(void *opaque, void *elem)
y_alignment
@ YA_BASELINE
@ YA_TEXT
@ YA_FONT
static double drand(void *opaque, double min, double max)
static void update_color_with_alpha(DrawTextContext *s, FFDrawColor *color, const FFDrawColor incolor)
static int query_formats(const AVFilterContext *ctx, AVFilterFormatsConfig **cfg_in, AVFilterFormatsConfig **cfg_out)
static int draw_text(AVFilterContext *ctx, AVFrame *frame)
static void hb_destroy(HarfbuzzData *hb)
static av_cold void uninit(AVFilterContext *ctx)
static const struct ft_error ft_errors[]
static int measure_text(AVFilterContext *ctx, TextMetrics *metrics)
#define OFFSET(x)
static int shape_text_hb(AVFilterContext *ctx, DrawTextContext *s, HarfbuzzData *hb, const char *text, int textLen)
static int draw_glyphs(AVFilterContext *ctx, AVFrame *frame, FFDrawColor *color, TextMetrics *metrics, int x, int y, int borderw)
static int command(AVFilterContext *ctx, const char *cmd, const char *arg, char *res, int res_len, int flags)
static int glyph_enu_free(void *opaque, void *elem)
static av_always_inline int diff(const struct color_info *a, const struct color_info *b, const int trans_thresh)
static const uint16_t positions[][14][3]
const AVFilterPad ff_video_default_filterpad[1]
An AVFilterPad array whose only entry has name "default" and is of type AVMEDIA_TYPE_VIDEO.
Definition video.c:37
float delta
int len