3 * Copyright (c) 2002 Philip Gladstone
5 * This module implements a text overlay for a video image. Currently it
6 * supports a fixed overlay or reading the text from a file. The string
7 * is passed through strftime so that it is easy to imprint the date and
10 * You may also overlay an image (even semi-transparent) like TV stations do.
11 * You may move either the text or the image around your video to create
12 * scrolling credits, for example.
14 * Text fonts are being looked for in FONTPATH
18 * -C <rgb.txt> The filename to read RGB color names from
19 * Defaults if none specified:
20 * /usr/share/X11/rgb.txt
21 * /usr/lib/X11/rgb.txt
22 * -c <color> The color of the text
23 * -F <fontname> The font face and size
25 * -f <filename> The filename to read text from
26 * -x <expression> X coordinate of text or image
27 * -y <expression> Y coordinate of text or image
28 * -i <filename> The filename to read a image from
29 * -R <expression> Value for R color
30 * -G <expression> Value for G color
31 * -B <expression> Value for B color
33 * Expressions are functions of:
34 * N // frame number (starting at zero)
45 FONTPATH="/cygdrive/c/WINDOWS/Fonts/"
46 FONTPATH="$FONTPATH:/usr/share/imlib2/data/fonts/"
47 FONTPATH="$FONTPATH:/usr/X11R6/lib/X11/fonts/TTF/"
50 ffmpeg -i input.avi -vhook \
51 'vhook/imlib2.dll -x W*(0.5+0.25*sin(N/47*PI))-w/2 -y H*(0.5+0.50*cos(N/97*PI))-h/2 -i /usr/share/imlib2/data/images/bulb.png'
52 -acodec copy -sameq output.avi
54 ffmpeg -i input.avi -vhook \
55 'vhook/imlib2.dll -c red -F Vera.ttf/20 -x 150+0.5*N -y 70+0.25*N -t Hello'
56 -acodec copy -sameq output.avi
58 * This module is very much intended as an example of what could be done.
60 * One caution is that this is an expensive process -- in particular the
61 * conversion of the image into RGB and back is time consuming. For some
62 * special cases -- e.g. painting black text -- it would be faster to paint
63 * the text into a bitmap and then combine it directly into the YUV
64 * image. However, this code is fast enough to handle 10 fps of 320x240 on a
65 * 900MHz Duron in maybe 15% of the CPU.
67 * See further statistics on Pentium4, 3GHz, FFMpeg is SVN-r6798
68 * Input movie is 20.2 seconds of PAL DV on AVI
69 * Output movie is DVD compliant VOB.
71 ffmpeg -i input.avi -target pal-dvd out.vob
72 # 13.516s just transcode
73 ffmpeg -i input.avi -vhook /usr/local/bin/vhook/null.dll -target pal-dvd out.vob
74 # 23.546s transcode and img_convert
75 ffmpeg -i input.avi -vhook \
76 'vhook/imlib2.dll -c red -F Vera/20 -x 150-0.5*N -y 70+0.25*N -t Hello_person' \
77 -target pal-dvd out.vob
78 # 21.454s transcode, img_convert and move text around
79 ffmpeg -i input.avi -vhook \
80 'vhook/imlib2.dll -x 150-0.5*N -y 70+0.25*N -i /usr/share/imlib2/data/images/bulb.png' \
81 -target pal-dvd out.vob
82 # 20.828s transcode, img_convert and move image around
84 * This file is part of FFmpeg.
86 * FFmpeg is free software; you can redistribute it and/or
87 * modify it under the terms of the GNU Lesser General Public
88 * License as published by the Free Software Foundation; either
89 * version 2.1 of the License, or (at your option) any later version.
91 * FFmpeg is distributed in the hope that it will be useful,
92 * but WITHOUT ANY WARRANTY; without even the implied warranty of
93 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
94 * Lesser General Public License for more details.
96 * You should have received a copy of the GNU Lesser General Public
97 * License along with FFmpeg; if not, write to the Free Software
98 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
101 #include "framehook.h"
111 #include <sys/time.h>
116 const char *const_names[]={
119 "N", // frame number (starting at zero)
129 static int sws_flags = SWS_BICUBIC;
137 AVEvalExpr *eval_r, *eval_g, *eval_b;
138 char *expr_R, *expr_G, *expr_B;
142 struct _CachedImage *cache;
143 Imlib_Image imageOverlaid;
144 AVEvalExpr *eval_x, *eval_y;
145 char *expr_x, *expr_y;
147 int imageOverlaid_width, imageOverlaid_height;
149 // This vhook first converts frame to RGB ...
150 struct SwsContext *toRGB_convert_ctx;
151 // ... and then converts back frame from RGB to initial format
152 struct SwsContext *fromRGB_convert_ctx;
155 typedef struct _CachedImage {
156 struct _CachedImage *next;
162 void Release(void *ctx)
165 ci = (ContextInfo *) ctx;
168 imlib_context_set_image(ci->cache->image);
173 if (ci->imageOverlaid) {
174 imlib_context_set_image(ci->imageOverlaid);
177 ff_eval_free(ci->expr_x);
178 ff_eval_free(ci->expr_y);
179 ff_eval_free(ci->expr_R);
180 ff_eval_free(ci->expr_G);
181 ff_eval_free(ci->expr_B);
182 sws_freeContext(ci->toRGB_convert_ctx);
183 sws_freeContext(ci->fromRGB_convert_ctx);
188 int Configure(void **ctxp, int argc, char *argv[])
193 char *font = "LucidaSansDemiBold/16";
194 char *fp = getenv("FONTPATH");
199 *ctxp = av_mallocz(sizeof(ContextInfo));
200 ci = (ContextInfo *) *ctxp;
209 /* Use ':' to split FONTPATH */
211 while (p = strchr(fp, ':')) {
213 imlib_add_path_to_font_path(fp);
217 imlib_add_path_to_font_path(fp);
220 while ((c = getopt(argc, argv, "R:G:B:C:c:f:F:t:x:y:i:")) > 0) {
223 ci->expr_R = av_strdup(optarg);
227 ci->expr_G = av_strdup(optarg);
231 ci->expr_B = av_strdup(optarg);
244 ci->text = av_strdup(optarg);
247 ci->file = av_strdup(optarg);
250 ci->expr_x = av_strdup(optarg);
253 ci->expr_y = av_strdup(optarg);
256 ci->fileImage = av_strdup(optarg);
259 fprintf(stderr, "Unrecognized argument '%s'\n", argv[optind]);
264 if (ci->eval_colors && !(ci->expr_R && ci->expr_G && ci->expr_B))
266 fprintf(stderr, "You must specify expressions for all or no colors.\n");
270 if (ci->text || ci->file) {
271 ci->fn = imlib_load_font(font);
273 fprintf(stderr, "Failed to load font '%s'\n", font);
276 imlib_context_set_font(ci->fn);
277 imlib_context_set_direction(IMLIB_TEXT_TO_RIGHT);
286 fprintf(stderr, "You must not specify both a color name and expressions for the colors.\n");
291 f = fopen(rgbtxt, "r");
294 f = fopen("/usr/share/X11/rgb.txt", "r");
296 f = fopen("/usr/lib/X11/rgb.txt", "r");
299 fprintf(stderr, "Failed to find RGB color names file\n");
302 while (fgets(buff, sizeof(buff), f)) {
306 if (sscanf(buff, "%d %d %d %64s", &r, &g, &b, colname) == 4 &&
307 strcasecmp(colname, color) == 0) {
311 /* fprintf(stderr, "%s -> %d,%d,%d\n", colname, r, g, b); */
318 fprintf(stderr, "Unable to find color '%s' in rgb.txt\n", color);
321 } else if (ci->eval_colors) {
322 if (!(ci->eval_r = ff_parse(ci->expr_R, const_names, NULL, NULL, NULL, NULL, NULL))){
323 av_log(NULL, AV_LOG_ERROR, "Couldn't parse R expression '%s'\n", ci->expr_R);
326 if (!(ci->eval_g = ff_parse(ci->expr_G, const_names, NULL, NULL, NULL, NULL, NULL))){
327 av_log(NULL, AV_LOG_ERROR, "Couldn't parse G expression '%s'\n", ci->expr_G);
330 if (!(ci->eval_b = ff_parse(ci->expr_B, const_names, NULL, NULL, NULL, NULL, NULL))){
331 av_log(NULL, AV_LOG_ERROR, "Couldn't parse B expression '%s'\n", ci->expr_B);
336 if (!ci->eval_colors)
337 imlib_context_set_color(ci->r, ci->g, ci->b, 255);
339 /* load the image (for example, credits for a movie) */
341 ci->imageOverlaid = imlib_load_image_immediately(ci->fileImage);
342 if (!(ci->imageOverlaid)){
343 av_log(NULL, AV_LOG_ERROR, "Couldn't load image '%s'\n", ci->fileImage);
346 imlib_context_set_image(ci->imageOverlaid);
347 ci->imageOverlaid_width = imlib_image_get_width();
348 ci->imageOverlaid_height = imlib_image_get_height();
351 if (!(ci->eval_x = ff_parse(ci->expr_x, const_names, NULL, NULL, NULL, NULL, NULL))){
352 av_log(NULL, AV_LOG_ERROR, "Couldn't parse x expression '%s'\n", ci->expr_x);
356 if (!(ci->eval_y = ff_parse(ci->expr_y, const_names, NULL, NULL, NULL, NULL, NULL))){
357 av_log(NULL, AV_LOG_ERROR, "Couldn't parse y expression '%s'\n", ci->expr_y);
364 static Imlib_Image get_cached_image(ContextInfo *ci, int width, int height)
368 for (cache = ci->cache; cache; cache = cache->next) {
369 if (width == cache->width && height == cache->height)
376 static void put_cached_image(ContextInfo *ci, Imlib_Image image, int width, int height)
378 CachedImage *cache = av_mallocz(sizeof(*cache));
380 cache->image = image;
381 cache->width = width;
382 cache->height = height;
383 cache->next = ci->cache;
387 void Process(void *ctx, AVPicture *picture, enum PixelFormat pix_fmt, int width, int height, int64_t pts)
389 ContextInfo *ci = (ContextInfo *) ctx;
394 image = get_cached_image(ci, width, height);
397 image = imlib_create_image(width, height);
398 put_cached_image(ci, image, width, height);
401 imlib_context_set_image(image);
402 data = imlib_image_get_data();
404 avpicture_fill(&picture1, (uint8_t *) data, PIX_FMT_RGB32, width, height);
406 // if we already got a SWS context, let's realloc if is not re-useable
407 ci->toRGB_convert_ctx = sws_getCachedContext(ci->toRGB_convert_ctx,
408 width, height, pix_fmt,
409 width, height, PIX_FMT_RGB32,
410 sws_flags, NULL, NULL, NULL);
411 if (ci->toRGB_convert_ctx == NULL) {
412 av_log(NULL, AV_LOG_ERROR,
413 "Cannot initialize the toRGB conversion context\n");
417 // img_convert parameters are 2 first destination, then 4 source
418 // sws_scale parameters are context, 4 first source, then 2 destination
419 sws_scale(ci->toRGB_convert_ctx,
420 picture->data, picture->linesize, 0, height,
421 picture1.data, picture1.linesize);
423 imlib_image_set_has_alpha(0);
426 int wid, hig, h_a, v_a;
429 char *tbp = ci->text;
430 time_t now = time(0);
434 double const_values[]={
437 ci->frame_number, // frame number (starting at zero)
438 height, // frame height
439 width, // frame width
440 ci->imageOverlaid_height, // image height
441 ci->imageOverlaid_width, // image width
448 int fd = open(ci->file, O_RDONLY);
451 tbp = "[File not found]";
453 int l = read(fd, tbuff, sizeof(tbuff) - 1);
466 strftime(buff, sizeof(buff), tbp, localtime(&now));
467 else if (!(ci->imageOverlaid))
468 strftime(buff, sizeof(buff), "[No data]", localtime(&now));
470 ci->x = ff_parse_eval(ci->eval_x, const_values, ci);
471 ci->y = ff_parse_eval(ci->eval_y, const_values, ci);
474 if (ci->eval_colors) {
475 ci->r = ff_parse_eval(ci->eval_r, const_values, ci);
476 ci->g = ff_parse_eval(ci->eval_g, const_values, ci);
477 ci->b = ff_parse_eval(ci->eval_b, const_values, ci);
478 imlib_context_set_color(ci->r, ci->g, ci->b, 255);
481 if (!(ci->imageOverlaid))
482 for (p = buff; p; p = q) {
487 imlib_text_draw_with_return_metrics(ci->x, y, p, &wid, &hig, &h_a, &v_a);
491 if (ci->imageOverlaid) {
492 imlib_context_set_image(image);
493 imlib_blend_image_onto_image(ci->imageOverlaid, 0,
494 0, 0, ci->imageOverlaid_width, ci->imageOverlaid_height,
495 ci->x, ci->y, ci->imageOverlaid_width, ci->imageOverlaid_height);
500 ci->fromRGB_convert_ctx = sws_getCachedContext(ci->fromRGB_convert_ctx,
501 width, height, PIX_FMT_RGB32,
502 width, height, pix_fmt,
503 sws_flags, NULL, NULL, NULL);
504 if (ci->fromRGB_convert_ctx == NULL) {
505 av_log(NULL, AV_LOG_ERROR,
506 "Cannot initialize the fromRGB conversion context\n");
509 // img_convert parameters are 2 first destination, then 4 source
510 // sws_scale parameters are context, 4 first source, then 2 destination
511 sws_scale(ci->fromRGB_convert_ctx,
512 picture1.data, picture1.linesize, 0, height,
513 picture->data, picture->linesize);