Merge svn changes up to r29277
[mplayer.git] / libass / ass_render.c
blob9f1686fa962c09ac9659f8f1c0708cb07899d91a
1 // -*- c-basic-offset: 8; indent-tabs-mode: t -*-
2 // vim:ts=8:sw=8:noet:ai:
3 /*
4 * Copyright (C) 2006 Evgeniy Stepanov <eugeni.stepanov@gmail.com>
6 * This file is part of libass.
8 * libass is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License as published by
10 * the Free Software Foundation; either version 2 of the License, or
11 * (at your option) any later version.
13 * libass is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
18 * You should have received a copy of the GNU General Public License along
19 * with libass; if not, write to the Free Software Foundation, Inc.,
20 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
23 #include "config.h"
25 #include <assert.h>
26 #include <math.h>
27 #include <inttypes.h>
28 #include <ft2build.h>
29 #include FT_FREETYPE_H
30 #include FT_STROKER_H
31 #include FT_GLYPH_H
32 #include FT_SYNTHESIS_H
34 #include "mputils.h"
36 #include "ass.h"
37 #include "ass_font.h"
38 #include "ass_bitmap.h"
39 #include "ass_cache.h"
40 #include "ass_utils.h"
41 #include "ass_fontconfig.h"
42 #include "ass_library.h"
44 #define MAX_GLYPHS 3000
45 #define MAX_LINES 300
46 #define BLUR_MAX_RADIUS 50.0
47 #define MAX_BE 100
48 #define ROUND(x) ((int) ((x) + .5))
49 #define SUBPIXEL_MASK 56 // d6 bitmask for subpixel accuracy adjustment
51 static int last_render_id = 0;
53 typedef struct ass_settings_s {
54 int frame_width;
55 int frame_height;
56 double font_size_coeff; // font size multiplier
57 double line_spacing; // additional line spacing (in frame pixels)
58 int top_margin; // height of top margin. Everything except toptitles is shifted down by top_margin.
59 int bottom_margin; // height of bottom margin. (frame_height - top_margin - bottom_margin) is original video height.
60 int left_margin;
61 int right_margin;
62 int use_margins; // 0 - place all subtitles inside original frame
63 // 1 - use margins for placing toptitles and subtitles
64 double aspect; // frame aspect ratio, d_width / d_height.
65 ass_hinting_t hinting;
67 char* default_font;
68 char* default_family;
69 } ass_settings_t;
71 // a rendered event
72 typedef struct event_images_s {
73 ass_image_t* imgs;
74 int top, height;
75 int detect_collisions;
76 int shift_direction;
77 ass_event_t* event;
78 } event_images_t;
80 struct ass_renderer_s {
81 ass_library_t* library;
82 FT_Library ftlibrary;
83 fc_instance_t* fontconfig_priv;
84 ass_settings_t settings;
85 int render_id;
86 ass_synth_priv_t* synth_priv;
88 ass_image_t* images_root; // rendering result is stored here
89 ass_image_t* prev_images_root;
91 event_images_t* eimg; // temporary buffer for sorting rendered events
92 int eimg_size; // allocated buffer size
95 typedef enum {EF_NONE = 0, EF_KARAOKE, EF_KARAOKE_KF, EF_KARAOKE_KO} effect_t;
97 // describes a glyph
98 // glyph_info_t and text_info_t are used for text centering and word-wrapping operations
99 typedef struct glyph_info_s {
100 unsigned symbol;
101 FT_Glyph glyph;
102 FT_Glyph outline_glyph;
103 bitmap_t* bm; // glyph bitmap
104 bitmap_t* bm_o; // outline bitmap
105 bitmap_t* bm_s; // shadow bitmap
106 FT_BBox bbox;
107 FT_Vector pos;
108 char linebreak; // the first (leading) glyph of some line ?
109 uint32_t c[4]; // colors
110 FT_Vector advance; // 26.6
111 effect_t effect_type;
112 int effect_timing; // time duration of current karaoke word
113 // after process_karaoke_effects: distance in pixels from the glyph origin.
114 // part of the glyph to the left of it is displayed in a different color.
115 int effect_skip_timing; // delay after the end of last karaoke word
116 int asc, desc; // font max ascender and descender
117 // int height;
118 int be; // blur edges
119 double blur; // gaussian blur
120 double shadow;
121 double frx, fry, frz; // rotation
123 bitmap_hash_key_t hash_key;
124 } glyph_info_t;
126 typedef struct line_info_s {
127 int asc, desc;
128 } line_info_t;
130 typedef struct text_info_s {
131 glyph_info_t* glyphs;
132 int length;
133 line_info_t lines[MAX_LINES];
134 int n_lines;
135 int height;
136 } text_info_t;
139 // Renderer state.
140 // Values like current font face, color, screen position, clipping and so on are stored here.
141 typedef struct render_context_s {
142 ass_event_t* event;
143 ass_style_t* style;
145 ass_font_t* font;
146 char* font_path;
147 double font_size;
149 FT_Stroker stroker;
150 int alignment; // alignment overrides go here; if zero, style value will be used
151 double frx, fry, frz;
152 enum { EVENT_NORMAL, // "normal" top-, sub- or mid- title
153 EVENT_POSITIONED, // happens after pos(,), margins are ignored
154 EVENT_HSCROLL, // "Banner" transition effect, text_width is unlimited
155 EVENT_VSCROLL // "Scroll up", "Scroll down" transition effects
156 } evt_type;
157 double pos_x, pos_y; // position
158 double org_x, org_y; // origin
159 char have_origin; // origin is explicitly defined; if 0, get_base_point() is used
160 double scale_x, scale_y;
161 double hspacing; // distance between letters, in pixels
162 double border; // outline width
163 uint32_t c[4]; // colors(Primary, Secondary, so on) in RGBA
164 int clip_x0, clip_y0, clip_x1, clip_y1;
165 char detect_collisions;
166 uint32_t fade; // alpha from \fad
167 char be; // blur edges
168 double blur; // gaussian blur
169 double shadow;
170 int drawing_mode; // not implemented; when != 0 text is discarded, except for style override tags
172 effect_t effect_type;
173 int effect_timing;
174 int effect_skip_timing;
176 enum { SCROLL_LR, // left-to-right
177 SCROLL_RL,
178 SCROLL_TB, // top-to-bottom
179 SCROLL_BT
180 } scroll_direction; // for EVENT_HSCROLL, EVENT_VSCROLL
181 int scroll_shift;
183 // face properties
184 char* family;
185 unsigned bold;
186 unsigned italic;
187 int treat_family_as_pattern;
189 } render_context_t;
191 // frame-global data
192 typedef struct frame_context_s {
193 ass_renderer_t* ass_priv;
194 int width, height; // screen dimensions
195 int orig_height; // frame height ( = screen height - margins )
196 int orig_width; // frame width ( = screen width - margins )
197 int orig_height_nocrop; // frame height ( = screen height - margins + cropheight)
198 int orig_width_nocrop; // frame width ( = screen width - margins + cropwidth)
199 ass_track_t* track;
200 long long time; // frame's timestamp, ms
201 double font_scale;
202 double font_scale_x; // x scale applied to all glyphs to preserve text aspect ratio
203 double border_scale;
204 } frame_context_t;
206 static ass_renderer_t* ass_renderer;
207 static ass_settings_t* global_settings;
208 static text_info_t text_info;
209 static render_context_t render_context;
210 static frame_context_t frame_context;
212 struct render_priv_s {
213 int top, height;
214 int render_id;
217 static void ass_lazy_track_init(void)
219 ass_track_t* track = frame_context.track;
220 if (track->PlayResX && track->PlayResY)
221 return;
222 if (!track->PlayResX && !track->PlayResY) {
223 mp_msg(MSGT_ASS, MSGL_WARN, MSGTR_LIBASS_NeitherPlayResXNorPlayResYDefined);
224 track->PlayResX = 384;
225 track->PlayResY = 288;
226 } else {
227 double orig_aspect = (global_settings->aspect * frame_context.height * frame_context.orig_width) /
228 frame_context.orig_height / frame_context.width;
229 if (!track->PlayResY && track->PlayResX == 1280) {
230 track->PlayResY = 1024;
231 mp_msg(MSGT_ASS, MSGL_WARN, MSGTR_LIBASS_PlayResYUndefinedSettingY, track->PlayResY);
232 } else if (!track->PlayResY) {
233 track->PlayResY = track->PlayResX / orig_aspect + .5;
234 mp_msg(MSGT_ASS, MSGL_WARN, MSGTR_LIBASS_PlayResYUndefinedSettingY, track->PlayResY);
235 } else if (!track->PlayResX && track->PlayResY == 1024) {
236 track->PlayResX = 1280;
237 mp_msg(MSGT_ASS, MSGL_WARN, MSGTR_LIBASS_PlayResXUndefinedSettingX, track->PlayResX);
238 } else if (!track->PlayResX) {
239 track->PlayResX = track->PlayResY * orig_aspect + .5;
240 mp_msg(MSGT_ASS, MSGL_WARN, MSGTR_LIBASS_PlayResXUndefinedSettingX, track->PlayResX);
245 ass_renderer_t* ass_renderer_init(ass_library_t* library)
247 int error;
248 FT_Library ft;
249 ass_renderer_t* priv = 0;
250 int vmajor, vminor, vpatch;
252 memset(&render_context, 0, sizeof(render_context));
253 memset(&frame_context, 0, sizeof(frame_context));
254 memset(&text_info, 0, sizeof(text_info));
256 error = FT_Init_FreeType( &ft );
257 if ( error ) {
258 mp_msg(MSGT_ASS, MSGL_FATAL, MSGTR_LIBASS_FT_Init_FreeTypeFailed);
259 goto ass_init_exit;
262 FT_Library_Version(ft, &vmajor, &vminor, &vpatch);
263 mp_msg(MSGT_ASS, MSGL_V, "FreeType library version: %d.%d.%d\n",
264 vmajor, vminor, vpatch);
265 mp_msg(MSGT_ASS, MSGL_V, "FreeType headers version: %d.%d.%d\n",
266 FREETYPE_MAJOR, FREETYPE_MINOR, FREETYPE_PATCH);
268 priv = calloc(1, sizeof(ass_renderer_t));
269 if (!priv) {
270 FT_Done_FreeType(ft);
271 goto ass_init_exit;
274 priv->synth_priv = ass_synth_init(BLUR_MAX_RADIUS);
276 priv->library = library;
277 priv->ftlibrary = ft;
278 // images_root and related stuff is zero-filled in calloc
280 ass_font_cache_init();
281 ass_bitmap_cache_init();
282 ass_composite_cache_init();
283 ass_glyph_cache_init();
285 text_info.glyphs = calloc(MAX_GLYPHS, sizeof(glyph_info_t));
287 ass_init_exit:
288 if (priv) mp_msg(MSGT_ASS, MSGL_INFO, MSGTR_LIBASS_Init);
289 else mp_msg(MSGT_ASS, MSGL_ERR, MSGTR_LIBASS_InitFailed);
291 return priv;
294 void ass_renderer_done(ass_renderer_t* priv)
296 ass_font_cache_done();
297 ass_bitmap_cache_done();
298 ass_composite_cache_done();
299 ass_glyph_cache_done();
300 if (render_context.stroker) {
301 FT_Stroker_Done(render_context.stroker);
302 render_context.stroker = 0;
304 if (priv && priv->ftlibrary) FT_Done_FreeType(priv->ftlibrary);
305 if (priv && priv->fontconfig_priv) fontconfig_done(priv->fontconfig_priv);
306 if (priv && priv->synth_priv) ass_synth_done(priv->synth_priv);
307 if (priv && priv->eimg) free(priv->eimg);
308 if (priv) free(priv);
309 if (text_info.glyphs) free(text_info.glyphs);
313 * \brief Create a new ass_image_t
314 * Parameters are the same as ass_image_t fields.
316 static ass_image_t* my_draw_bitmap(unsigned char* bitmap, int bitmap_w, int bitmap_h, int stride, int dst_x, int dst_y, uint32_t color)
318 ass_image_t* img = calloc(1, sizeof(ass_image_t));
320 img->w = bitmap_w;
321 img->h = bitmap_h;
322 img->stride = stride;
323 img->bitmap = bitmap;
324 img->color = color;
325 img->dst_x = dst_x;
326 img->dst_y = dst_y;
328 return img;
332 * \brief convert bitmap glyph into ass_image_t struct(s)
333 * \param bit freetype bitmap glyph, FT_PIXEL_MODE_GRAY
334 * \param dst_x bitmap x coordinate in video frame
335 * \param dst_y bitmap y coordinate in video frame
336 * \param color first color, RGBA
337 * \param color2 second color, RGBA
338 * \param brk x coordinate relative to glyph origin, color is used to the left of brk, color2 - to the right
339 * \param tail pointer to the last image's next field, head of the generated list should be stored here
340 * \return pointer to the new list tail
341 * Performs clipping. Uses my_draw_bitmap for actual bitmap convertion.
343 static ass_image_t** render_glyph(bitmap_t* bm, int dst_x, int dst_y, uint32_t color, uint32_t color2, int brk, ass_image_t** tail)
345 // brk is relative to dst_x
346 // color = color left of brk
347 // color2 = color right of brk
348 int b_x0, b_y0, b_x1, b_y1; // visible part of the bitmap
349 int clip_x0, clip_y0, clip_x1, clip_y1;
350 int tmp;
351 ass_image_t* img;
353 dst_x += bm->left;
354 dst_y += bm->top;
355 brk -= bm->left;
357 // clipping
358 clip_x0 = render_context.clip_x0;
359 clip_y0 = render_context.clip_y0;
360 clip_x1 = render_context.clip_x1;
361 clip_y1 = render_context.clip_y1;
362 b_x0 = 0;
363 b_y0 = 0;
364 b_x1 = bm->w;
365 b_y1 = bm->h;
367 tmp = dst_x - clip_x0;
368 if (tmp < 0) {
369 mp_msg(MSGT_ASS, MSGL_DBG2, "clip left\n");
370 b_x0 = - tmp;
372 tmp = dst_y - clip_y0;
373 if (tmp < 0) {
374 mp_msg(MSGT_ASS, MSGL_DBG2, "clip top\n");
375 b_y0 = - tmp;
377 tmp = clip_x1 - dst_x - bm->w;
378 if (tmp < 0) {
379 mp_msg(MSGT_ASS, MSGL_DBG2, "clip right\n");
380 b_x1 = bm->w + tmp;
382 tmp = clip_y1 - dst_y - bm->h;
383 if (tmp < 0) {
384 mp_msg(MSGT_ASS, MSGL_DBG2, "clip bottom\n");
385 b_y1 = bm->h + tmp;
388 if ((b_y0 >= b_y1) || (b_x0 >= b_x1))
389 return tail;
391 if (brk > b_x0) { // draw left part
392 if (brk > b_x1) brk = b_x1;
393 img = my_draw_bitmap(bm->buffer + bm->w * b_y0 + b_x0,
394 brk - b_x0, b_y1 - b_y0, bm->w,
395 dst_x + b_x0, dst_y + b_y0, color);
396 *tail = img;
397 tail = &img->next;
399 if (brk < b_x1) { // draw right part
400 if (brk < b_x0) brk = b_x0;
401 img = my_draw_bitmap(bm->buffer + bm->w * b_y0 + brk,
402 b_x1 - brk, b_y1 - b_y0, bm->w,
403 dst_x + brk, dst_y + b_y0, color2);
404 *tail = img;
405 tail = &img->next;
407 return tail;
411 * \brief Calculate overlapping area of two consecutive bitmaps and in case they
412 * overlap, composite them together
413 * Mainly useful for translucent glyphs and especially borders, to avoid the
414 * luminance adding up where they overlap (which looks ugly)
416 static void render_overlap(ass_image_t** last_tail, ass_image_t** tail, bitmap_hash_key_t *last_hash, bitmap_hash_key_t* hash) {
417 int left, top, bottom, right;
418 int old_left, old_top, w, h, cur_left, cur_top;
419 int x, y, opos, cpos;
420 char m;
421 composite_hash_key_t hk;
422 composite_hash_val_t *hv;
423 composite_hash_key_t *nhk;
424 int ax = (*last_tail)->dst_x;
425 int ay = (*last_tail)->dst_y;
426 int aw = (*last_tail)->w;
427 int as = (*last_tail)->stride;
428 int ah = (*last_tail)->h;
429 int bx = (*tail)->dst_x;
430 int by = (*tail)->dst_y;
431 int bw = (*tail)->w;
432 int bs = (*tail)->stride;
433 int bh = (*tail)->h;
434 unsigned char* a;
435 unsigned char* b;
437 if ((*last_tail)->bitmap == (*tail)->bitmap)
438 return;
440 if ((*last_tail)->color != (*tail)->color)
441 return;
443 // Calculate overlap coordinates
444 left = (ax > bx) ? ax : bx;
445 top = (ay > by) ? ay : by;
446 right = ((ax+aw) < (bx+bw)) ? (ax+aw) : (bx+bw);
447 bottom = ((ay+ah) < (by+bh)) ? (ay+ah) : (by+bh);
448 if ((right <= left) || (bottom <= top))
449 return;
450 old_left = left-ax;
451 old_top = top-ay;
452 w = right-left;
453 h = bottom-top;
454 cur_left = left-bx;
455 cur_top = top-by;
457 // Query cache
458 memset(&hk, 0, sizeof(hk));
459 memcpy(&hk.a, last_hash, sizeof(*last_hash));
460 memcpy(&hk.b, hash, sizeof(*hash));
461 hk.aw = aw;
462 hk.ah = ah;
463 hk.bw = bw;
464 hk.bh = bh;
465 hk.ax = ax;
466 hk.ay = ay;
467 hk.bx = bx;
468 hk.by = by;
469 hv = cache_find_composite(&hk);
470 if (hv) {
471 (*last_tail)->bitmap = hv->a;
472 (*tail)->bitmap = hv->b;
473 return;
476 // Allocate new bitmaps and copy over data
477 a = (*last_tail)->bitmap;
478 b = (*tail)->bitmap;
479 (*last_tail)->bitmap = malloc(as*ah);
480 (*tail)->bitmap = malloc(bs*bh);
481 memcpy((*last_tail)->bitmap, a, as*ah);
482 memcpy((*tail)->bitmap, b, bs*bh);
484 // Composite overlapping area
485 for (y=0; y<h; y++)
486 for (x=0; x<w; x++) {
487 opos = (old_top+y)*(as) + (old_left+x);
488 cpos = (cur_top+y)*(bs) + (cur_left+x);
489 m = (a[opos] > b[cpos]) ? a[opos] : b[cpos];
490 (*last_tail)->bitmap[opos] = 0;
491 (*tail)->bitmap[cpos] = m;
494 // Insert bitmaps into the cache
495 nhk = calloc(1, sizeof(*nhk));
496 memcpy(nhk, &hk, sizeof(*nhk));
497 hv = calloc(1, sizeof(*hv));
498 hv->a = (*last_tail)->bitmap;
499 hv->b = (*tail)->bitmap;
500 cache_add_composite(nhk, hv);
504 * \brief Convert text_info_t struct to ass_image_t list
505 * Splits glyphs in halves when needed (for \kf karaoke).
507 static ass_image_t* render_text(text_info_t* text_info, int dst_x, int dst_y)
509 int pen_x, pen_y;
510 int i;
511 bitmap_t* bm;
512 ass_image_t* head;
513 ass_image_t** tail = &head;
514 ass_image_t** last_tail = 0;
515 ass_image_t** here_tail = 0;
516 bitmap_hash_key_t* last_hash = 0;
518 for (i = 0; i < text_info->length; ++i) {
519 glyph_info_t* info = text_info->glyphs + i;
520 if ((info->symbol == 0) || (info->symbol == '\n') || !info->bm_s || (info->shadow == 0))
521 continue;
523 pen_x = dst_x + info->pos.x + ROUND(info->shadow * frame_context.border_scale);
524 pen_y = dst_y + info->pos.y + ROUND(info->shadow * frame_context.border_scale);
525 bm = info->bm_s;
527 here_tail = tail;
528 tail = render_glyph(bm, pen_x, pen_y, info->c[3], 0, 1000000, tail);
529 if (last_tail && tail != here_tail && ((info->c[3] & 0xff) > 0))
530 render_overlap(last_tail, here_tail, last_hash, &info->hash_key);
531 last_tail = here_tail;
532 last_hash = &info->hash_key;
535 last_tail = 0;
536 for (i = 0; i < text_info->length; ++i) {
537 glyph_info_t* info = text_info->glyphs + i;
538 if ((info->symbol == 0) || (info->symbol == '\n') || !info->bm_o)
539 continue;
541 pen_x = dst_x + info->pos.x;
542 pen_y = dst_y + info->pos.y;
543 bm = info->bm_o;
545 if ((info->effect_type == EF_KARAOKE_KO) && (info->effect_timing <= info->bbox.xMax)) {
546 // do nothing
547 } else {
548 here_tail = tail;
549 tail = render_glyph(bm, pen_x, pen_y, info->c[2], 0, 1000000, tail);
550 if (last_tail && tail != here_tail && ((info->c[2] & 0xff) > 0))
551 render_overlap(last_tail, here_tail, last_hash, &info->hash_key);
552 last_tail = here_tail;
553 last_hash = &info->hash_key;
556 for (i = 0; i < text_info->length; ++i) {
557 glyph_info_t* info = text_info->glyphs + i;
558 if ((info->symbol == 0) || (info->symbol == '\n') || !info->bm)
559 continue;
561 pen_x = dst_x + info->pos.x;
562 pen_y = dst_y + info->pos.y;
563 bm = info->bm;
565 if ((info->effect_type == EF_KARAOKE) || (info->effect_type == EF_KARAOKE_KO)) {
566 if (info->effect_timing > info->bbox.xMax)
567 tail = render_glyph(bm, pen_x, pen_y, info->c[0], 0, 1000000, tail);
568 else
569 tail = render_glyph(bm, pen_x, pen_y, info->c[1], 0, 1000000, tail);
570 } else if (info->effect_type == EF_KARAOKE_KF) {
571 tail = render_glyph(bm, pen_x, pen_y, info->c[0], info->c[1], info->effect_timing, tail);
572 } else
573 tail = render_glyph(bm, pen_x, pen_y, info->c[0], 0, 1000000, tail);
576 *tail = 0;
577 return head;
581 * \brief Mapping between script and screen coordinates
583 static int x2scr(double x) {
584 return x*frame_context.orig_width_nocrop / frame_context.track->PlayResX +
585 FFMAX(global_settings->left_margin, 0);
587 static double x2scr_pos(double x) {
588 return x*frame_context.orig_width / frame_context.track->PlayResX +
589 global_settings->left_margin;
592 * \brief Mapping between script and screen coordinates
594 static double y2scr(double y) {
595 return y * frame_context.orig_height_nocrop / frame_context.track->PlayResY +
596 FFMAX(global_settings->top_margin, 0);
598 static double y2scr_pos(double y) {
599 return y * frame_context.orig_height / frame_context.track->PlayResY +
600 global_settings->top_margin;
603 // the same for toptitles
604 static int y2scr_top(double y) {
605 if (global_settings->use_margins)
606 return y * frame_context.orig_height_nocrop / frame_context.track->PlayResY;
607 else
608 return y * frame_context.orig_height_nocrop / frame_context.track->PlayResY +
609 FFMAX(global_settings->top_margin, 0);
611 // the same for subtitles
612 static int y2scr_sub(double y) {
613 if (global_settings->use_margins)
614 return y * frame_context.orig_height_nocrop / frame_context.track->PlayResY +
615 FFMAX(global_settings->top_margin, 0) +
616 FFMAX(global_settings->bottom_margin, 0);
617 else
618 return y * frame_context.orig_height_nocrop / frame_context.track->PlayResY +
619 FFMAX(global_settings->top_margin, 0);
622 static void compute_string_bbox( text_info_t* info, FT_BBox *abbox ) {
623 FT_BBox bbox;
624 int i;
626 if (text_info.length > 0) {
627 bbox.xMin = 32000;
628 bbox.xMax = -32000;
629 bbox.yMin = - d6_to_int(text_info.lines[0].asc) + text_info.glyphs[0].pos.y;
630 bbox.yMax = d6_to_int(text_info.height - text_info.lines[0].asc) + text_info.glyphs[0].pos.y;
632 for (i = 0; i < text_info.length; ++i) {
633 int s = text_info.glyphs[i].pos.x;
634 int e = s + d6_to_int(text_info.glyphs[i].advance.x);
635 bbox.xMin = FFMIN(bbox.xMin, s);
636 bbox.xMax = FFMAX(bbox.xMax, e);
638 } else
639 bbox.xMin = bbox.xMax = bbox.yMin = bbox.yMax = 0;
641 /* return string bbox */
642 *abbox = bbox;
647 * \brief Check if starting part of (*p) matches sample. If true, shift p to the first symbol after the matching part.
649 static inline int mystrcmp(char** p, const char* sample) {
650 int len = strlen(sample);
651 if (strncmp(*p, sample, len) == 0) {
652 (*p) += len;
653 return 1;
654 } else
655 return 0;
658 static void change_font_size(double sz)
660 double size = sz * frame_context.font_scale;
662 if (size < 1)
663 size = 1;
664 else if (size > frame_context.height * 2)
665 size = frame_context.height * 2;
667 ass_font_set_size(render_context.font, size);
669 render_context.font_size = sz;
673 * \brief Change current font, using setting from render_context.
675 static void update_font(void)
677 unsigned val;
678 ass_renderer_t* priv = frame_context.ass_priv;
679 ass_font_desc_t desc;
680 desc.family = strdup(render_context.family);
681 desc.treat_family_as_pattern = render_context.treat_family_as_pattern;
683 val = render_context.bold;
684 // 0 = normal, 1 = bold, >1 = exact weight
685 if (val == 0) val = 80; // normal
686 else if (val == 1) val = 200; // bold
687 desc.bold = val;
689 val = render_context.italic;
690 if (val == 0) val = 0; // normal
691 else if (val == 1) val = 110; //italic
692 desc.italic = val;
694 render_context.font = ass_font_new(priv->library, priv->ftlibrary, priv->fontconfig_priv, &desc);
695 free(desc.family);
697 if (render_context.font)
698 change_font_size(render_context.font_size);
702 * \brief Change border width
703 * negative value resets border to style value
705 static void change_border(double border)
707 int b;
708 if (!render_context.font) return;
710 if (border < 0) {
711 if (render_context.style->BorderStyle == 1)
712 border = render_context.style->Outline;
713 else
714 border = 1.;
716 render_context.border = border;
718 b = 64 * border * frame_context.border_scale;
719 if (b > 0) {
720 if (!render_context.stroker) {
721 int error;
722 #if (FREETYPE_MAJOR > 2) || ((FREETYPE_MAJOR == 2) && (FREETYPE_MINOR > 1))
723 error = FT_Stroker_New( ass_renderer->ftlibrary, &render_context.stroker );
724 #else // < 2.2
725 error = FT_Stroker_New( render_context.font->faces[0]->memory, &render_context.stroker );
726 #endif
727 if (error) {
728 mp_msg(MSGT_ASS, MSGL_V, "failed to get stroker\n");
729 render_context.stroker = 0;
732 if (render_context.stroker)
733 FT_Stroker_Set( render_context.stroker, b,
734 FT_STROKER_LINECAP_ROUND,
735 FT_STROKER_LINEJOIN_ROUND,
736 0 );
737 } else {
738 FT_Stroker_Done(render_context.stroker);
739 render_context.stroker = 0;
743 #define _r(c) ((c)>>24)
744 #define _g(c) (((c)>>16)&0xFF)
745 #define _b(c) (((c)>>8)&0xFF)
746 #define _a(c) ((c)&0xFF)
749 * \brief Calculate a weighted average of two colors
750 * calculates c1*(1-a) + c2*a, but separately for each component except alpha
752 static void change_color(uint32_t* var, uint32_t new, double pwr)
754 (*var)= ((uint32_t)(_r(*var) * (1 - pwr) + _r(new) * pwr) << 24) +
755 ((uint32_t)(_g(*var) * (1 - pwr) + _g(new) * pwr) << 16) +
756 ((uint32_t)(_b(*var) * (1 - pwr) + _b(new) * pwr) << 8) +
757 _a(*var);
760 // like change_color, but for alpha component only
761 static void change_alpha(uint32_t* var, uint32_t new, double pwr)
763 *var = (_r(*var) << 24) + (_g(*var) << 16) + (_b(*var) << 8) + (_a(*var) * (1 - pwr) + _a(new) * pwr);
767 * \brief Multiply two alpha values
768 * \param a first value
769 * \param b second value
770 * \return result of multiplication
771 * Parameters and result are limited by 0xFF.
773 static uint32_t mult_alpha(uint32_t a, uint32_t b)
775 return 0xFF - (0xFF - a) * (0xFF - b) / 0xFF;
779 * \brief Calculate alpha value by piecewise linear function
780 * Used for \fad, \fade implementation.
782 static unsigned interpolate_alpha(long long now,
783 long long t1, long long t2, long long t3, long long t4,
784 unsigned a1, unsigned a2, unsigned a3)
786 unsigned a;
787 double cf;
788 if (now <= t1) {
789 a = a1;
790 } else if (now >= t4) {
791 a = a3;
792 } else if (now < t2) { // and > t1
793 cf = ((double)(now - t1)) / (t2 - t1);
794 a = a1 * (1 - cf) + a2 * cf;
795 } else if (now > t3) {
796 cf = ((double)(now - t3)) / (t4 - t3);
797 a = a2 * (1 - cf) + a3 * cf;
798 } else { // t2 <= now <= t3
799 a = a2;
802 return a;
805 static void reset_render_context(void);
808 * \brief Parse style override tag.
809 * \param p string to parse
810 * \param pwr multiplier for some tag effects (comes from \t tags)
812 static char* parse_tag(char* p, double pwr) {
813 #define skip_to(x) while ((*p != (x)) && (*p != '}') && (*p != 0)) { ++p;}
814 #define skip(x) if (*p == (x)) ++p; else { return p; }
816 skip_to('\\');
817 skip('\\');
818 if ((*p == '}') || (*p == 0))
819 return p;
821 // New tags introduced in vsfilter 2.39
822 if (mystrcmp(&p, "xbord")) {
823 double val;
824 if (mystrtod(&p, &val))
825 mp_msg(MSGT_ASS, MSGL_V, "stub: \\xbord%.2f\n", val);
826 } else if (mystrcmp(&p, "ybord")) {
827 double val;
828 if (mystrtod(&p, &val))
829 mp_msg(MSGT_ASS, MSGL_V, "stub: \\ybord%.2f\n", val);
830 } else if (mystrcmp(&p, "xshad")) {
831 int val;
832 if (mystrtoi(&p, &val))
833 mp_msg(MSGT_ASS, MSGL_V, "stub: \\xshad%d\n", val);
834 } else if (mystrcmp(&p, "yshad")) {
835 int val;
836 if (mystrtoi(&p, &val))
837 mp_msg(MSGT_ASS, MSGL_V, "stub: \\yshad%d\n", val);
838 } else if (mystrcmp(&p, "fax")) {
839 int val;
840 if (mystrtoi(&p, &val))
841 mp_msg(MSGT_ASS, MSGL_V, "stub: \\fax%d\n", val);
842 } else if (mystrcmp(&p, "fay")) {
843 int val;
844 if (mystrtoi(&p, &val))
845 mp_msg(MSGT_ASS, MSGL_V, "stub: \\fay%d\n", val);
846 } else if (mystrcmp(&p, "iclip")) {
847 int x0, y0, x1, y1;
848 int res = 1;
849 skip('(');
850 res &= mystrtoi(&p, &x0);
851 skip(',');
852 res &= mystrtoi(&p, &y0);
853 skip(',');
854 res &= mystrtoi(&p, &x1);
855 skip(',');
856 res &= mystrtoi(&p, &y1);
857 skip(')');
858 mp_msg(MSGT_ASS, MSGL_V, "stub: \\iclip(%d,%d,%d,%d)\n", x0, y0, x1, y1);
859 } else if (mystrcmp(&p, "blur")) {
860 double val;
861 if (mystrtod(&p, &val)) {
862 val = (val < 0) ? 0 : val;
863 val = (val > BLUR_MAX_RADIUS) ? BLUR_MAX_RADIUS : val;
864 render_context.blur = val;
865 } else
866 render_context.blur = 0.0;
867 // ASS standard tags
868 } else if (mystrcmp(&p, "fsc")) {
869 char tp = *p++;
870 double val;
871 if (tp == 'x') {
872 if (mystrtod(&p, &val)) {
873 val /= 100;
874 render_context.scale_x = render_context.scale_x * ( 1 - pwr) + val * pwr;
875 } else
876 render_context.scale_x = render_context.style->ScaleX;
877 } else if (tp == 'y') {
878 if (mystrtod(&p, &val)) {
879 val /= 100;
880 render_context.scale_y = render_context.scale_y * ( 1 - pwr) + val * pwr;
881 } else
882 render_context.scale_y = render_context.style->ScaleY;
884 } else if (mystrcmp(&p, "fsp")) {
885 double val;
886 if (mystrtod(&p, &val))
887 render_context.hspacing = render_context.hspacing * ( 1 - pwr ) + val * pwr;
888 else
889 render_context.hspacing = render_context.style->Spacing;
890 } else if (mystrcmp(&p, "fs")) {
891 double val;
892 if (mystrtod(&p, &val))
893 val = render_context.font_size * ( 1 - pwr ) + val * pwr;
894 else
895 val = render_context.style->FontSize;
896 if (render_context.font)
897 change_font_size(val);
898 } else if (mystrcmp(&p, "bord")) {
899 double val;
900 if (mystrtod(&p, &val))
901 val = render_context.border * ( 1 - pwr ) + val * pwr;
902 else
903 val = -1.; // reset to default
904 change_border(val);
905 } else if (mystrcmp(&p, "move")) {
906 double x1, x2, y1, y2;
907 long long t1, t2, delta_t, t;
908 double x, y;
909 double k;
910 skip('(');
911 mystrtod(&p, &x1);
912 skip(',');
913 mystrtod(&p, &y1);
914 skip(',');
915 mystrtod(&p, &x2);
916 skip(',');
917 mystrtod(&p, &y2);
918 if (*p == ',') {
919 skip(',');
920 mystrtoll(&p, &t1);
921 skip(',');
922 mystrtoll(&p, &t2);
923 mp_msg(MSGT_ASS, MSGL_DBG2, "movement6: (%f, %f) -> (%f, %f), (%" PRId64 " .. %" PRId64 ")\n",
924 x1, y1, x2, y2, (int64_t)t1, (int64_t)t2);
925 } else {
926 t1 = 0;
927 t2 = render_context.event->Duration;
928 mp_msg(MSGT_ASS, MSGL_DBG2, "movement: (%f, %f) -> (%f, %f)\n", x1, y1, x2, y2);
930 skip(')');
931 delta_t = t2 - t1;
932 t = frame_context.time - render_context.event->Start;
933 if (t < t1)
934 k = 0.;
935 else if (t > t2)
936 k = 1.;
937 else k = ((double)(t - t1)) / delta_t;
938 x = k * (x2 - x1) + x1;
939 y = k * (y2 - y1) + y1;
940 if (render_context.evt_type != EVENT_POSITIONED) {
941 render_context.pos_x = x;
942 render_context.pos_y = y;
943 render_context.detect_collisions = 0;
944 render_context.evt_type = EVENT_POSITIONED;
946 } else if (mystrcmp(&p, "frx")) {
947 double val;
948 if (mystrtod(&p, &val)) {
949 val *= M_PI / 180;
950 render_context.frx = val * pwr + render_context.frx * (1-pwr);
951 } else
952 render_context.frx = 0.;
953 } else if (mystrcmp(&p, "fry")) {
954 double val;
955 if (mystrtod(&p, &val)) {
956 val *= M_PI / 180;
957 render_context.fry = val * pwr + render_context.fry * (1-pwr);
958 } else
959 render_context.fry = 0.;
960 } else if (mystrcmp(&p, "frz") || mystrcmp(&p, "fr")) {
961 double val;
962 if (mystrtod(&p, &val)) {
963 val *= M_PI / 180;
964 render_context.frz = val * pwr + render_context.frz * (1-pwr);
965 } else
966 render_context.frz = M_PI * render_context.style->Angle / 180.;
967 } else if (mystrcmp(&p, "fn")) {
968 char* start = p;
969 char* family;
970 skip_to('\\');
971 if (p > start) {
972 family = malloc(p - start + 1);
973 strncpy(family, start, p - start);
974 family[p - start] = '\0';
975 } else
976 family = strdup(render_context.style->FontName);
977 if (render_context.family)
978 free(render_context.family);
979 render_context.family = family;
980 update_font();
981 } else if (mystrcmp(&p, "alpha")) {
982 uint32_t val;
983 int i;
984 if (strtocolor(&p, &val)) {
985 unsigned char a = val >> 24;
986 for (i = 0; i < 4; ++i)
987 change_alpha(&render_context.c[i], a, pwr);
988 } else {
989 change_alpha(&render_context.c[0], render_context.style->PrimaryColour, pwr);
990 change_alpha(&render_context.c[1], render_context.style->SecondaryColour, pwr);
991 change_alpha(&render_context.c[2], render_context.style->OutlineColour, pwr);
992 change_alpha(&render_context.c[3], render_context.style->BackColour, pwr);
994 // FIXME: simplify
995 } else if (mystrcmp(&p, "an")) {
996 int val;
997 if (mystrtoi(&p, &val) && val) {
998 int v = (val - 1) / 3; // 0, 1 or 2 for vertical alignment
999 mp_msg(MSGT_ASS, MSGL_DBG2, "an %d\n", val);
1000 if (v != 0) v = 3 - v;
1001 val = ((val - 1) % 3) + 1; // horizontal alignment
1002 val += v*4;
1003 mp_msg(MSGT_ASS, MSGL_DBG2, "align %d\n", val);
1004 render_context.alignment = val;
1005 } else
1006 render_context.alignment = render_context.style->Alignment;
1007 } else if (mystrcmp(&p, "a")) {
1008 int val;
1009 if (mystrtoi(&p, &val) && val)
1010 render_context.alignment = val;
1011 else
1012 render_context.alignment = render_context.style->Alignment;
1013 } else if (mystrcmp(&p, "pos")) {
1014 double v1, v2;
1015 skip('(');
1016 mystrtod(&p, &v1);
1017 skip(',');
1018 mystrtod(&p, &v2);
1019 skip(')');
1020 mp_msg(MSGT_ASS, MSGL_DBG2, "pos(%f, %f)\n", v1, v2);
1021 if (render_context.evt_type == EVENT_POSITIONED) {
1022 mp_msg(MSGT_ASS, MSGL_V, "Subtitle has a new \\pos "
1023 "after \\move or \\pos, ignoring\n");
1024 } else {
1025 render_context.evt_type = EVENT_POSITIONED;
1026 render_context.detect_collisions = 0;
1027 render_context.pos_x = v1;
1028 render_context.pos_y = v2;
1030 } else if (mystrcmp(&p, "fad")) {
1031 int a1, a2, a3;
1032 long long t1, t2, t3, t4;
1033 if (*p == 'e') ++p; // either \fad or \fade
1034 skip('(');
1035 mystrtoi(&p, &a1);
1036 skip(',');
1037 mystrtoi(&p, &a2);
1038 if (*p == ')') {
1039 // 2-argument version (\fad, according to specs)
1040 // a1 and a2 are fade-in and fade-out durations
1041 t1 = 0;
1042 t4 = render_context.event->Duration;
1043 t2 = a1;
1044 t3 = t4 - a2;
1045 a1 = 0xFF;
1046 a2 = 0;
1047 a3 = 0xFF;
1048 } else {
1049 // 6-argument version (\fade)
1050 // a1 and a2 (and a3) are opacity values
1051 skip(',');
1052 mystrtoi(&p, &a3);
1053 skip(',');
1054 mystrtoll(&p, &t1);
1055 skip(',');
1056 mystrtoll(&p, &t2);
1057 skip(',');
1058 mystrtoll(&p, &t3);
1059 skip(',');
1060 mystrtoll(&p, &t4);
1062 skip(')');
1063 render_context.fade = interpolate_alpha(frame_context.time - render_context.event->Start, t1, t2, t3, t4, a1, a2, a3);
1064 } else if (mystrcmp(&p, "org")) {
1065 int v1, v2;
1066 skip('(');
1067 mystrtoi(&p, &v1);
1068 skip(',');
1069 mystrtoi(&p, &v2);
1070 skip(')');
1071 mp_msg(MSGT_ASS, MSGL_DBG2, "org(%d, %d)\n", v1, v2);
1072 // render_context.evt_type = EVENT_POSITIONED;
1073 if (!render_context.have_origin) {
1074 render_context.org_x = v1;
1075 render_context.org_y = v2;
1076 render_context.have_origin = 1;
1077 render_context.detect_collisions = 0;
1079 } else if (mystrcmp(&p, "t")) {
1080 double v[3];
1081 int v1, v2;
1082 double v3;
1083 int cnt;
1084 long long t1, t2, t, delta_t;
1085 double k;
1086 skip('(');
1087 for (cnt = 0; cnt < 3; ++cnt) {
1088 if (*p == '\\')
1089 break;
1090 v[cnt] = strtod(p, &p);
1091 skip(',');
1093 if (cnt == 3) {
1094 v1 = v[0]; v2 = v[1]; v3 = v[2];
1095 } else if (cnt == 2) {
1096 v1 = v[0]; v2 = v[1]; v3 = 1.;
1097 } else if (cnt == 1) {
1098 v1 = 0; v2 = render_context.event->Duration; v3 = v[0];
1099 } else { // cnt == 0
1100 v1 = 0; v2 = render_context.event->Duration; v3 = 1.;
1102 render_context.detect_collisions = 0;
1103 t1 = v1;
1104 t2 = v2;
1105 delta_t = v2 - v1;
1106 if (v3 < 0.)
1107 v3 = 0.;
1108 t = frame_context.time - render_context.event->Start; // FIXME: move to render_context
1109 if (t <= t1)
1110 k = 0.;
1111 else if (t >= t2)
1112 k = 1.;
1113 else {
1114 assert(delta_t != 0.);
1115 k = pow(((double)(t - t1)) / delta_t, v3);
1117 while (*p == '\\')
1118 p = parse_tag(p, k); // maybe k*pwr ? no, specs forbid nested \t's
1119 skip_to(')'); // in case there is some unknown tag or a comment
1120 skip(')');
1121 } else if (mystrcmp(&p, "clip")) {
1122 int x0, y0, x1, y1;
1123 int res = 1;
1124 skip('(');
1125 res &= mystrtoi(&p, &x0);
1126 skip(',');
1127 res &= mystrtoi(&p, &y0);
1128 skip(',');
1129 res &= mystrtoi(&p, &x1);
1130 skip(',');
1131 res &= mystrtoi(&p, &y1);
1132 skip(')');
1133 if (res) {
1134 render_context.clip_x0 = render_context.clip_x0 * (1-pwr) + x0 * pwr;
1135 render_context.clip_x1 = render_context.clip_x1 * (1-pwr) + x1 * pwr;
1136 render_context.clip_y0 = render_context.clip_y0 * (1-pwr) + y0 * pwr;
1137 render_context.clip_y1 = render_context.clip_y1 * (1-pwr) + y1 * pwr;
1138 } else {
1139 render_context.clip_x0 = 0;
1140 render_context.clip_y0 = 0;
1141 render_context.clip_x1 = frame_context.track->PlayResX;
1142 render_context.clip_y1 = frame_context.track->PlayResY;
1144 } else if (mystrcmp(&p, "c")) {
1145 uint32_t val;
1146 if (!strtocolor(&p, &val))
1147 val = render_context.style->PrimaryColour;
1148 mp_msg(MSGT_ASS, MSGL_DBG2, "color: %X\n", val);
1149 change_color(&render_context.c[0], val, pwr);
1150 } else if ((*p >= '1') && (*p <= '4') && (++p) && (mystrcmp(&p, "c") || mystrcmp(&p, "a"))) {
1151 char n = *(p-2);
1152 int cidx = n - '1';
1153 char cmd = *(p-1);
1154 uint32_t val;
1155 assert((n >= '1') && (n <= '4'));
1156 if (!strtocolor(&p, &val))
1157 switch(n) {
1158 case '1': val = render_context.style->PrimaryColour; break;
1159 case '2': val = render_context.style->SecondaryColour; break;
1160 case '3': val = render_context.style->OutlineColour; break;
1161 case '4': val = render_context.style->BackColour; break;
1162 default : val = 0; break; // impossible due to assert; avoid compilation warning
1164 switch (cmd) {
1165 case 'c': change_color(render_context.c + cidx, val, pwr); break;
1166 case 'a': change_alpha(render_context.c + cidx, val >> 24, pwr); break;
1167 default: mp_msg(MSGT_ASS, MSGL_WARN, MSGTR_LIBASS_BadCommand, n, cmd); break;
1169 mp_msg(MSGT_ASS, MSGL_DBG2, "single c/a at %f: %c%c = %X \n", pwr, n, cmd, render_context.c[cidx]);
1170 } else if (mystrcmp(&p, "r")) {
1171 reset_render_context();
1172 } else if (mystrcmp(&p, "be")) {
1173 int val;
1174 if (mystrtoi(&p, &val)) {
1175 // Clamp to a safe upper limit, since high values need excessive CPU
1176 val = (val < 0) ? 0 : val;
1177 val = (val > MAX_BE) ? MAX_BE : val;
1178 render_context.be = val;
1179 } else
1180 render_context.be = 0;
1181 } else if (mystrcmp(&p, "b")) {
1182 int b;
1183 if (mystrtoi(&p, &b)) {
1184 if (pwr >= .5)
1185 render_context.bold = b;
1186 } else
1187 render_context.bold = render_context.style->Bold;
1188 update_font();
1189 } else if (mystrcmp(&p, "i")) {
1190 int i;
1191 if (mystrtoi(&p, &i)) {
1192 if (pwr >= .5)
1193 render_context.italic = i;
1194 } else
1195 render_context.italic = render_context.style->Italic;
1196 update_font();
1197 } else if (mystrcmp(&p, "kf") || mystrcmp(&p, "K")) {
1198 int val = 0;
1199 mystrtoi(&p, &val);
1200 render_context.effect_type = EF_KARAOKE_KF;
1201 if (render_context.effect_timing)
1202 render_context.effect_skip_timing += render_context.effect_timing;
1203 render_context.effect_timing = val * 10;
1204 } else if (mystrcmp(&p, "ko")) {
1205 int val = 0;
1206 mystrtoi(&p, &val);
1207 render_context.effect_type = EF_KARAOKE_KO;
1208 if (render_context.effect_timing)
1209 render_context.effect_skip_timing += render_context.effect_timing;
1210 render_context.effect_timing = val * 10;
1211 } else if (mystrcmp(&p, "k")) {
1212 int val = 0;
1213 mystrtoi(&p, &val);
1214 render_context.effect_type = EF_KARAOKE;
1215 if (render_context.effect_timing)
1216 render_context.effect_skip_timing += render_context.effect_timing;
1217 render_context.effect_timing = val * 10;
1218 } else if (mystrcmp(&p, "shad")) {
1219 int val;
1220 if (mystrtoi(&p, &val))
1221 render_context.shadow = val;
1222 else
1223 render_context.shadow = render_context.style->Shadow;
1224 } else if (mystrcmp(&p, "pbo")) {
1225 int val = 0;
1226 mystrtoi(&p, &val); // ignored
1227 } else if (mystrcmp(&p, "p")) {
1228 int val;
1229 if (!mystrtoi(&p, &val))
1230 val = 0;
1231 render_context.drawing_mode = !!val;
1234 return p;
1236 #undef skip
1237 #undef skip_to
1241 * \brief Get next ucs4 char from string, parsing and executing style overrides
1242 * \param str string pointer
1243 * \return ucs4 code of the next char
1244 * On return str points to the unparsed part of the string
1246 static unsigned get_next_char(char** str)
1248 char* p = *str;
1249 unsigned chr;
1250 if (*p == '{') { // '\0' goes here
1251 p++;
1252 while (1) {
1253 p = parse_tag(p, 1.);
1254 if (*p == '}') { // end of tag
1255 p++;
1256 if (*p == '{') {
1257 p++;
1258 continue;
1259 } else
1260 break;
1261 } else if (*p != '\\')
1262 mp_msg(MSGT_ASS, MSGL_V, "Unable to parse: \"%s\" \n", p);
1263 if (*p == 0)
1264 break;
1267 if (*p == '\t') {
1268 ++p;
1269 *str = p;
1270 return ' ';
1272 if (*p == '\\') {
1273 if ((*(p+1) == 'N') || ((*(p+1) == 'n') && (frame_context.track->WrapStyle == 2))) {
1274 p += 2;
1275 *str = p;
1276 return '\n';
1277 } else if ((*(p+1) == 'n') || (*(p+1) == 'h')) {
1278 p += 2;
1279 *str = p;
1280 return ' ';
1283 chr = utf8_get_char((const char **)&p);
1284 *str = p;
1285 return chr;
1288 static void apply_transition_effects(ass_event_t* event)
1290 int v[4];
1291 int cnt;
1292 char* p = event->Effect;
1294 if (!p || !*p) return;
1296 cnt = 0;
1297 while (cnt < 4 && (p = strchr(p, ';'))) {
1298 v[cnt++] = atoi(++p);
1301 if (strncmp(event->Effect, "Banner;", 7) == 0) {
1302 int delay;
1303 if (cnt < 1) {
1304 mp_msg(MSGT_ASS, MSGL_V, "Error parsing effect: %s \n", event->Effect);
1305 return;
1307 if (cnt >= 2 && v[1] == 0) // right-to-left
1308 render_context.scroll_direction = SCROLL_RL;
1309 else // left-to-right
1310 render_context.scroll_direction = SCROLL_LR;
1312 delay = v[0];
1313 if (delay == 0) delay = 1; // ?
1314 render_context.scroll_shift = (frame_context.time - render_context.event->Start) / delay;
1315 render_context.evt_type = EVENT_HSCROLL;
1316 return;
1319 if (strncmp(event->Effect, "Scroll up;", 10) == 0) {
1320 render_context.scroll_direction = SCROLL_BT;
1321 } else if (strncmp(event->Effect, "Scroll down;", 12) == 0) {
1322 render_context.scroll_direction = SCROLL_TB;
1323 } else {
1324 mp_msg(MSGT_ASS, MSGL_V, "Unknown transition effect: %s \n", event->Effect);
1325 return;
1327 // parse scroll up/down parameters
1329 int delay;
1330 int y0, y1;
1331 if (cnt < 3) {
1332 mp_msg(MSGT_ASS, MSGL_V, "Error parsing effect: %s \n", event->Effect);
1333 return;
1335 delay = v[2];
1336 if (delay == 0) delay = 1; // ?
1337 render_context.scroll_shift = (frame_context.time - render_context.event->Start) / delay;
1338 if (v[0] < v[1]) {
1339 y0 = v[0]; y1 = v[1];
1340 } else {
1341 y0 = v[1]; y1 = v[0];
1343 if (y1 == 0)
1344 y1 = frame_context.track->PlayResY; // y0=y1=0 means fullscreen scrolling
1345 render_context.clip_y0 = y0;
1346 render_context.clip_y1 = y1;
1347 render_context.evt_type = EVENT_VSCROLL;
1348 render_context.detect_collisions = 0;
1354 * \brief partially reset render_context to style values
1355 * Works like {\r}: resets some style overrides
1357 static void reset_render_context(void)
1359 render_context.c[0] = render_context.style->PrimaryColour;
1360 render_context.c[1] = render_context.style->SecondaryColour;
1361 render_context.c[2] = render_context.style->OutlineColour;
1362 render_context.c[3] = render_context.style->BackColour;
1363 render_context.font_size = render_context.style->FontSize;
1365 if (render_context.family)
1366 free(render_context.family);
1367 render_context.family = strdup(render_context.style->FontName);
1368 render_context.treat_family_as_pattern = render_context.style->treat_fontname_as_pattern;
1369 render_context.bold = render_context.style->Bold;
1370 render_context.italic = render_context.style->Italic;
1371 update_font();
1373 change_border(-1.);
1374 render_context.scale_x = render_context.style->ScaleX;
1375 render_context.scale_y = render_context.style->ScaleY;
1376 render_context.hspacing = render_context.style->Spacing;
1377 render_context.be = 0;
1378 render_context.blur = 0.0;
1379 render_context.shadow = render_context.style->Shadow;
1380 render_context.frx = render_context.fry = 0.;
1381 render_context.frz = M_PI * render_context.style->Angle / 180.;
1383 // FIXME: does not reset unsupported attributes.
1387 * \brief Start new event. Reset render_context.
1389 static void init_render_context(ass_event_t* event)
1391 render_context.event = event;
1392 render_context.style = frame_context.track->styles + event->Style;
1394 reset_render_context();
1396 render_context.evt_type = EVENT_NORMAL;
1397 render_context.alignment = render_context.style->Alignment;
1398 render_context.pos_x = 0;
1399 render_context.pos_y = 0;
1400 render_context.org_x = 0;
1401 render_context.org_y = 0;
1402 render_context.have_origin = 0;
1403 render_context.clip_x0 = 0;
1404 render_context.clip_y0 = 0;
1405 render_context.clip_x1 = frame_context.track->PlayResX;
1406 render_context.clip_y1 = frame_context.track->PlayResY;
1407 render_context.detect_collisions = 1;
1408 render_context.fade = 0;
1409 render_context.drawing_mode = 0;
1410 render_context.effect_type = EF_NONE;
1411 render_context.effect_timing = 0;
1412 render_context.effect_skip_timing = 0;
1414 apply_transition_effects(event);
1417 static void free_render_context(void)
1422 * \brief Get normal and outline (border) glyphs
1423 * \param symbol ucs4 char
1424 * \param info out: struct filled with extracted data
1425 * \param advance subpixel shift vector used for cache lookup
1426 * Tries to get both glyphs from cache.
1427 * If they can't be found, gets a glyph from font face, generates outline with FT_Stroker,
1428 * and add them to cache.
1429 * The glyphs are returned in info->glyph and info->outline_glyph
1431 static void get_outline_glyph(int symbol, glyph_info_t* info, FT_Vector* advance)
1433 int error;
1434 glyph_hash_val_t* val;
1435 glyph_hash_key_t key;
1436 memset(&key, 0, sizeof(key));
1437 key.font = render_context.font;
1438 key.size = render_context.font_size;
1439 key.ch = symbol;
1440 key.scale_x = (render_context.scale_x * 0xFFFF);
1441 key.scale_y = (render_context.scale_y * 0xFFFF);
1442 key.advance = *advance;
1443 key.bold = render_context.bold;
1444 key.italic = render_context.italic;
1445 key.outline = render_context.border * 0xFFFF;
1447 memset(info, 0, sizeof(glyph_info_t));
1449 val = cache_find_glyph(&key);
1450 if (val) {
1451 FT_Glyph_Copy(val->glyph, &info->glyph);
1452 if (val->outline_glyph)
1453 FT_Glyph_Copy(val->outline_glyph, &info->outline_glyph);
1454 info->bbox = val->bbox_scaled;
1455 info->advance.x = val->advance.x;
1456 info->advance.y = val->advance.y;
1457 } else {
1458 glyph_hash_val_t v;
1459 info->glyph = ass_font_get_glyph(frame_context.ass_priv->fontconfig_priv, render_context.font, symbol, global_settings->hinting);
1460 if (!info->glyph)
1461 return;
1462 info->advance.x = d16_to_d6(info->glyph->advance.x);
1463 info->advance.y = d16_to_d6(info->glyph->advance.y);
1464 FT_Glyph_Get_CBox( info->glyph, FT_GLYPH_BBOX_PIXELS, &info->bbox);
1466 if (render_context.stroker) {
1467 info->outline_glyph = info->glyph;
1468 error = FT_Glyph_StrokeBorder( &(info->outline_glyph), render_context.stroker, 0 , 0 ); // don't destroy original
1469 if (error) {
1470 mp_msg(MSGT_ASS, MSGL_WARN, MSGTR_LIBASS_FT_Glyph_Stroke_Error, error);
1474 memset(&v, 0, sizeof(v));
1475 FT_Glyph_Copy(info->glyph, &v.glyph);
1476 if (info->outline_glyph)
1477 FT_Glyph_Copy(info->outline_glyph, &v.outline_glyph);
1478 v.advance = info->advance;
1479 v.bbox_scaled = info->bbox;
1480 cache_add_glyph(&key, &v);
1484 static void transform_3d(FT_Vector shift, FT_Glyph* glyph, FT_Glyph* glyph2, double frx, double fry, double frz);
1487 * \brief Get bitmaps for a glyph
1488 * \param info glyph info
1489 * Tries to get glyph bitmaps from bitmap cache.
1490 * If they can't be found, they are generated by rotating and rendering the glyph.
1491 * After that, bitmaps are added to the cache.
1492 * They are returned in info->bm (glyph), info->bm_o (outline) and info->bm_s (shadow).
1494 static void get_bitmap_glyph(glyph_info_t* info)
1496 bitmap_hash_val_t* val;
1497 bitmap_hash_key_t* key = &info->hash_key;
1499 val = cache_find_bitmap(key);
1500 /* val = 0; */
1502 if (val) {
1503 info->bm = val->bm;
1504 info->bm_o = val->bm_o;
1505 info->bm_s = val->bm_s;
1506 } else {
1507 FT_Vector shift;
1508 bitmap_hash_val_t hash_val;
1509 int error;
1510 info->bm = info->bm_o = info->bm_s = 0;
1511 if (info->glyph && info->symbol != '\n' && info->symbol != 0) {
1512 // calculating rotation shift vector (from rotation origin to the glyph basepoint)
1513 shift.x = int_to_d6(info->hash_key.shift_x);
1514 shift.y = int_to_d6(info->hash_key.shift_y);
1515 // apply rotation
1516 transform_3d(shift, &info->glyph, &info->outline_glyph, info->frx, info->fry, info->frz);
1518 // render glyph
1519 error = glyph_to_bitmap(ass_renderer->synth_priv,
1520 info->glyph, info->outline_glyph,
1521 &info->bm, &info->bm_o,
1522 &info->bm_s, info->be, info->blur * frame_context.border_scale);
1523 if (error)
1524 info->symbol = 0;
1526 // add bitmaps to cache
1527 hash_val.bm_o = info->bm_o;
1528 hash_val.bm = info->bm;
1529 hash_val.bm_s = info->bm_s;
1530 cache_add_bitmap(&(info->hash_key), &hash_val);
1533 // deallocate glyphs
1534 if (info->glyph)
1535 FT_Done_Glyph(info->glyph);
1536 if (info->outline_glyph)
1537 FT_Done_Glyph(info->outline_glyph);
1541 * This function goes through text_info and calculates text parameters.
1542 * The following text_info fields are filled:
1543 * height
1544 * lines[].height
1545 * lines[].asc
1546 * lines[].desc
1548 static void measure_text(void)
1550 int cur_line = 0, max_asc = 0, max_desc = 0;
1551 int i;
1552 text_info.height = 0;
1553 for (i = 0; i < text_info.length + 1; ++i) {
1554 if ((i == text_info.length) || text_info.glyphs[i].linebreak) {
1555 text_info.lines[cur_line].asc = max_asc;
1556 text_info.lines[cur_line].desc = max_desc;
1557 text_info.height += max_asc + max_desc;
1558 cur_line ++;
1559 max_asc = max_desc = 0;
1561 if (i < text_info.length) {
1562 glyph_info_t* cur = text_info.glyphs + i;
1563 if (cur->asc > max_asc)
1564 max_asc = cur->asc;
1565 if (cur->desc > max_desc)
1566 max_desc = cur->desc;
1569 text_info.height += (text_info.n_lines - 1) * double_to_d6(global_settings->line_spacing);
1573 * \brief rearrange text between lines
1574 * \param max_text_width maximal text line width in pixels
1575 * The algo is similar to the one in libvo/sub.c:
1576 * 1. Place text, wrapping it when current line is full
1577 * 2. Try moving words from the end of a line to the beginning of the next one while it reduces
1578 * the difference in lengths between this two lines.
1579 * The result may not be optimal, but usually is good enough.
1581 static void wrap_lines_smart(int max_text_width)
1583 int i, j;
1584 glyph_info_t *cur, *s1, *e1, *s2, *s3, *w;
1585 int last_space;
1586 int break_type;
1587 int exit;
1588 int pen_shift_x;
1589 int pen_shift_y;
1590 int cur_line;
1592 last_space = -1;
1593 text_info.n_lines = 1;
1594 break_type = 0;
1595 s1 = text_info.glyphs; // current line start
1596 for (i = 0; i < text_info.length; ++i) {
1597 int break_at, s_offset, len;
1598 cur = text_info.glyphs + i;
1599 break_at = -1;
1600 s_offset = s1->bbox.xMin + s1->pos.x;
1601 len = (cur->bbox.xMax + cur->pos.x) - s_offset;
1603 if (cur->symbol == '\n') {
1604 break_type = 2;
1605 break_at = i;
1606 mp_msg(MSGT_ASS, MSGL_DBG2, "forced line break at %d\n", break_at);
1609 if ((len >= max_text_width) && (frame_context.track->WrapStyle != 2)) {
1610 break_type = 1;
1611 break_at = last_space;
1612 if (break_at == -1)
1613 break_at = i - 1;
1614 if (break_at == -1)
1615 break_at = 0;
1616 mp_msg(MSGT_ASS, MSGL_DBG2, "overfill at %d\n", i);
1617 mp_msg(MSGT_ASS, MSGL_DBG2, "line break at %d\n", break_at);
1620 if (break_at != -1) {
1621 // need to use one more line
1622 // marking break_at+1 as start of a new line
1623 int lead = break_at + 1; // the first symbol of the new line
1624 if (text_info.n_lines >= MAX_LINES) {
1625 // to many lines !
1626 // no more linebreaks
1627 for (j = lead; j < text_info.length; ++j)
1628 text_info.glyphs[j].linebreak = 0;
1629 break;
1631 if (lead < text_info.length)
1632 text_info.glyphs[lead].linebreak = break_type;
1633 last_space = -1;
1634 s1 = text_info.glyphs + lead;
1635 s_offset = s1->bbox.xMin + s1->pos.x;
1636 text_info.n_lines ++;
1639 if (cur->symbol == ' ')
1640 last_space = i;
1642 // make sure the hard linebreak is not forgotten when
1643 // there was a new soft linebreak just inserted
1644 if (cur->symbol == '\n' && break_type == 1)
1645 i--;
1647 #define DIFF(x,y) (((x) < (y)) ? (y - x) : (x - y))
1648 exit = 0;
1649 while (!exit) {
1650 exit = 1;
1651 w = s3 = text_info.glyphs;
1652 s1 = s2 = 0;
1653 for (i = 0; i <= text_info.length; ++i) {
1654 cur = text_info.glyphs + i;
1655 if ((i == text_info.length) || cur->linebreak) {
1656 s1 = s2;
1657 s2 = s3;
1658 s3 = cur;
1659 if (s1 && (s2->linebreak == 1)) { // have at least 2 lines, and linebreak is 'soft'
1660 int l1, l2, l1_new, l2_new;
1662 w = s2;
1663 do { --w; } while ((w > s1) && (w->symbol == ' '));
1664 while ((w > s1) && (w->symbol != ' ')) { --w; }
1665 e1 = w;
1666 while ((e1 > s1) && (e1->symbol == ' ')) { --e1; }
1667 if (w->symbol == ' ') ++w;
1669 l1 = ((s2-1)->bbox.xMax + (s2-1)->pos.x) - (s1->bbox.xMin + s1->pos.x);
1670 l2 = ((s3-1)->bbox.xMax + (s3-1)->pos.x) - (s2->bbox.xMin + s2->pos.x);
1671 l1_new = (e1->bbox.xMax + e1->pos.x) - (s1->bbox.xMin + s1->pos.x);
1672 l2_new = ((s3-1)->bbox.xMax + (s3-1)->pos.x) - (w->bbox.xMin + w->pos.x);
1674 if (DIFF(l1_new, l2_new) < DIFF(l1, l2)) {
1675 w->linebreak = 1;
1676 s2->linebreak = 0;
1677 exit = 0;
1681 if (i == text_info.length)
1682 break;
1686 assert(text_info.n_lines >= 1);
1687 #undef DIFF
1689 measure_text();
1691 pen_shift_x = 0;
1692 pen_shift_y = 0;
1693 cur_line = 1;
1694 for (i = 0; i < text_info.length; ++i) {
1695 cur = text_info.glyphs + i;
1696 if (cur->linebreak) {
1697 int height = text_info.lines[cur_line - 1].desc + text_info.lines[cur_line].asc;
1698 cur_line ++;
1699 pen_shift_x = - cur->pos.x;
1700 pen_shift_y += d6_to_int(height + double_to_d6(global_settings->line_spacing));
1701 mp_msg(MSGT_ASS, MSGL_DBG2, "shifting from %d to %d by (%d, %d)\n", i, text_info.length - 1, pen_shift_x, pen_shift_y);
1703 cur->pos.x += pen_shift_x;
1704 cur->pos.y += pen_shift_y;
1709 * \brief determine karaoke effects
1710 * Karaoke effects cannot be calculated during parse stage (get_next_char()),
1711 * so they are done in a separate step.
1712 * Parse stage: when karaoke style override is found, its parameters are stored in the next glyph's
1713 * (the first glyph of the karaoke word)'s effect_type and effect_timing.
1714 * This function:
1715 * 1. sets effect_type for all glyphs in the word (_karaoke_ word)
1716 * 2. sets effect_timing for all glyphs to x coordinate of the border line between the left and right karaoke parts
1717 * (left part is filled with PrimaryColour, right one - with SecondaryColour).
1719 static void process_karaoke_effects(void)
1721 glyph_info_t *cur, *cur2;
1722 glyph_info_t *s1, *e1; // start and end of the current word
1723 glyph_info_t *s2; // start of the next word
1724 int i;
1725 int timing; // current timing
1726 int tm_start, tm_end; // timings at start and end of the current word
1727 int tm_current;
1728 double dt;
1729 int x;
1730 int x_start, x_end;
1732 tm_current = frame_context.time - render_context.event->Start;
1733 timing = 0;
1734 s1 = s2 = 0;
1735 for (i = 0; i <= text_info.length; ++i) {
1736 cur = text_info.glyphs + i;
1737 if ((i == text_info.length) || (cur->effect_type != EF_NONE)) {
1738 s1 = s2;
1739 s2 = cur;
1740 if (s1) {
1741 e1 = s2 - 1;
1742 tm_start = timing + s1->effect_skip_timing;
1743 tm_end = tm_start + s1->effect_timing;
1744 timing = tm_end;
1745 x_start = 1000000;
1746 x_end = -1000000;
1747 for (cur2 = s1; cur2 <= e1; ++cur2) {
1748 x_start = FFMIN(x_start, cur2->bbox.xMin + cur2->pos.x);
1749 x_end = FFMAX(x_end, cur2->bbox.xMax + cur2->pos.x);
1752 dt = (tm_current - tm_start);
1753 if ((s1->effect_type == EF_KARAOKE) || (s1->effect_type == EF_KARAOKE_KO)) {
1754 if (dt > 0)
1755 x = x_end + 1;
1756 else
1757 x = x_start;
1758 } else if (s1->effect_type == EF_KARAOKE_KF) {
1759 dt /= (tm_end - tm_start);
1760 x = x_start + (x_end - x_start) * dt;
1761 } else {
1762 mp_msg(MSGT_ASS, MSGL_ERR, MSGTR_LIBASS_UnknownEffectType_InternalError);
1763 continue;
1766 for (cur2 = s1; cur2 <= e1; ++cur2) {
1767 cur2->effect_type = s1->effect_type;
1768 cur2->effect_timing = x - cur2->pos.x;
1776 * \brief Calculate base point for positioning and rotation
1777 * \param bbox text bbox
1778 * \param alignment alignment
1779 * \param bx, by out: base point coordinates
1781 static void get_base_point(FT_BBox bbox, int alignment, int* bx, int* by)
1783 const int halign = alignment & 3;
1784 const int valign = alignment & 12;
1785 if (bx)
1786 switch(halign) {
1787 case HALIGN_LEFT:
1788 *bx = bbox.xMin;
1789 break;
1790 case HALIGN_CENTER:
1791 *bx = (bbox.xMax + bbox.xMin) / 2;
1792 break;
1793 case HALIGN_RIGHT:
1794 *bx = bbox.xMax;
1795 break;
1797 if (by)
1798 switch(valign) {
1799 case VALIGN_TOP:
1800 *by = bbox.yMin;
1801 break;
1802 case VALIGN_CENTER:
1803 *by = (bbox.yMax + bbox.yMin) / 2;
1804 break;
1805 case VALIGN_SUB:
1806 *by = bbox.yMax;
1807 break;
1812 * \brief Apply transformation to outline points of a glyph
1813 * Applies rotations given by frx, fry and frz and projects the points back
1814 * onto the screen plane.
1816 static void transform_3d_points(FT_Vector shift, FT_Glyph glyph, double frx, double fry, double frz) {
1817 double sx = sin(frx);
1818 double sy = sin(fry);
1819 double sz = sin(frz);
1820 double cx = cos(frx);
1821 double cy = cos(fry);
1822 double cz = cos(frz);
1823 FT_Outline *outline = &((FT_OutlineGlyph) glyph)->outline;
1824 FT_Vector* p = outline->points;
1825 double x, y, z, xx, yy, zz;
1826 int i;
1828 for (i=0; i<outline->n_points; i++) {
1829 x = p[i].x + shift.x;
1830 y = p[i].y + shift.y;
1831 z = 0.;
1833 xx = x*cz + y*sz;
1834 yy = -(x*sz - y*cz);
1835 zz = z;
1837 x = xx;
1838 y = yy*cx + zz*sx;
1839 z = yy*sx - zz*cx;
1841 xx = x*cy + z*sy;
1842 yy = y;
1843 zz = x*sy - z*cy;
1845 zz = FFMAX(zz, -19000);
1847 x = (xx * 20000) / (zz + 20000);
1848 y = (yy * 20000) / (zz + 20000);
1849 p[i].x = x - shift.x + 0.5;
1850 p[i].y = y - shift.y + 0.5;
1855 * \brief Apply 3d transformation to several objects
1856 * \param shift FreeType vector
1857 * \param glyph FreeType glyph
1858 * \param glyph2 FreeType glyph
1859 * \param frx x-axis rotation angle
1860 * \param fry y-axis rotation angle
1861 * \param frz z-axis rotation angle
1862 * Rotates both glyphs by frx, fry and frz. Shift vector is added before rotation and subtracted after it.
1864 static void transform_3d(FT_Vector shift, FT_Glyph* glyph, FT_Glyph* glyph2, double frx, double fry, double frz)
1866 frx = - frx;
1867 frz = - frz;
1868 if (frx != 0. || fry != 0. || frz != 0.) {
1869 if (glyph && *glyph)
1870 transform_3d_points(shift, *glyph, frx, fry, frz);
1872 if (glyph2 && *glyph2)
1873 transform_3d_points(shift, *glyph2, frx, fry, frz);
1879 * \brief Main ass rendering function, glues everything together
1880 * \param event event to render
1881 * \param event_images struct containing resulting images, will also be initialized
1882 * Process event, appending resulting ass_image_t's to images_root.
1884 static int ass_render_event(ass_event_t* event, event_images_t* event_images)
1886 char* p;
1887 FT_UInt previous;
1888 FT_UInt num_glyphs;
1889 FT_Vector pen;
1890 unsigned code;
1891 FT_BBox bbox;
1892 int i, j;
1893 FT_Vector shift;
1894 int MarginL, MarginR, MarginV;
1895 int last_break;
1896 int alignment, halign, valign;
1897 int device_x = 0, device_y = 0;
1899 if (event->Style >= frame_context.track->n_styles) {
1900 mp_msg(MSGT_ASS, MSGL_WARN, MSGTR_LIBASS_NoStyleFound);
1901 return 1;
1903 if (!event->Text) {
1904 mp_msg(MSGT_ASS, MSGL_WARN, MSGTR_LIBASS_EmptyEvent);
1905 return 1;
1908 init_render_context(event);
1910 text_info.length = 0;
1911 pen.x = 0;
1912 pen.y = 0;
1913 previous = 0;
1914 num_glyphs = 0;
1915 p = event->Text;
1916 // Event parsing.
1917 while (1) {
1918 // get next char, executing style override
1919 // this affects render_context
1920 do {
1921 code = get_next_char(&p);
1922 } while (code && render_context.drawing_mode); // skip everything in drawing mode
1924 // face could have been changed in get_next_char
1925 if (!render_context.font) {
1926 free_render_context();
1927 return 1;
1930 if (code == 0)
1931 break;
1933 if (text_info.length >= MAX_GLYPHS) {
1934 mp_msg(MSGT_ASS, MSGL_WARN, MSGTR_LIBASS_MAX_GLYPHS_Reached,
1935 (int)(event - frame_context.track->events), event->Start, event->Duration, event->Text);
1936 break;
1939 if ( previous && code ) {
1940 FT_Vector delta;
1941 delta = ass_font_get_kerning(render_context.font, previous, code);
1942 pen.x += delta.x * render_context.scale_x;
1943 pen.y += delta.y * render_context.scale_y;
1946 shift.x = pen.x & SUBPIXEL_MASK;
1947 shift.y = pen.y & SUBPIXEL_MASK;
1949 if (render_context.evt_type == EVENT_POSITIONED) {
1950 shift.x += double_to_d6(x2scr_pos(render_context.pos_x)) & SUBPIXEL_MASK;
1951 shift.y -= double_to_d6(y2scr_pos(render_context.pos_y)) & SUBPIXEL_MASK;
1954 ass_font_set_transform(render_context.font,
1955 render_context.scale_x * frame_context.font_scale_x,
1956 render_context.scale_y,
1957 &shift );
1959 get_outline_glyph(code, text_info.glyphs + text_info.length, &shift);
1961 text_info.glyphs[text_info.length].pos.x = pen.x >> 6;
1962 text_info.glyphs[text_info.length].pos.y = pen.y >> 6;
1964 pen.x += text_info.glyphs[text_info.length].advance.x;
1965 pen.x += double_to_d6(render_context.hspacing);
1966 pen.y += text_info.glyphs[text_info.length].advance.y;
1968 previous = code;
1970 text_info.glyphs[text_info.length].symbol = code;
1971 text_info.glyphs[text_info.length].linebreak = 0;
1972 for (i = 0; i < 4; ++i) {
1973 uint32_t clr = render_context.c[i];
1974 change_alpha(&clr, mult_alpha(_a(clr), render_context.fade), 1.);
1975 text_info.glyphs[text_info.length].c[i] = clr;
1977 text_info.glyphs[text_info.length].effect_type = render_context.effect_type;
1978 text_info.glyphs[text_info.length].effect_timing = render_context.effect_timing;
1979 text_info.glyphs[text_info.length].effect_skip_timing = render_context.effect_skip_timing;
1980 text_info.glyphs[text_info.length].be = render_context.be;
1981 text_info.glyphs[text_info.length].blur = render_context.blur;
1982 text_info.glyphs[text_info.length].shadow = render_context.shadow;
1983 text_info.glyphs[text_info.length].frx = render_context.frx;
1984 text_info.glyphs[text_info.length].fry = render_context.fry;
1985 text_info.glyphs[text_info.length].frz = render_context.frz;
1986 ass_font_get_asc_desc(render_context.font, code,
1987 &text_info.glyphs[text_info.length].asc,
1988 &text_info.glyphs[text_info.length].desc);
1989 text_info.glyphs[text_info.length].asc *= render_context.scale_y;
1990 text_info.glyphs[text_info.length].desc *= render_context.scale_y;
1992 // fill bitmap_hash_key
1993 text_info.glyphs[text_info.length].hash_key.font = render_context.font;
1994 text_info.glyphs[text_info.length].hash_key.size = render_context.font_size;
1995 text_info.glyphs[text_info.length].hash_key.outline = render_context.border * 0xFFFF;
1996 text_info.glyphs[text_info.length].hash_key.scale_x = render_context.scale_x * 0xFFFF;
1997 text_info.glyphs[text_info.length].hash_key.scale_y = render_context.scale_y * 0xFFFF;
1998 text_info.glyphs[text_info.length].hash_key.frx = render_context.frx * 0xFFFF;
1999 text_info.glyphs[text_info.length].hash_key.fry = render_context.fry * 0xFFFF;
2000 text_info.glyphs[text_info.length].hash_key.frz = render_context.frz * 0xFFFF;
2001 text_info.glyphs[text_info.length].hash_key.bold = render_context.bold;
2002 text_info.glyphs[text_info.length].hash_key.italic = render_context.italic;
2003 text_info.glyphs[text_info.length].hash_key.ch = code;
2004 text_info.glyphs[text_info.length].hash_key.advance = shift;
2005 text_info.glyphs[text_info.length].hash_key.be = render_context.be;
2006 text_info.glyphs[text_info.length].hash_key.blur = render_context.blur;
2008 text_info.length++;
2010 render_context.effect_type = EF_NONE;
2011 render_context.effect_timing = 0;
2012 render_context.effect_skip_timing = 0;
2015 if (text_info.length == 0) {
2016 // no valid symbols in the event; this can be smth like {comment}
2017 free_render_context();
2018 return 1;
2021 // depends on glyph x coordinates being monotonous, so it should be done before line wrap
2022 process_karaoke_effects();
2024 // alignments
2025 alignment = render_context.alignment;
2026 halign = alignment & 3;
2027 valign = alignment & 12;
2029 MarginL = (event->MarginL) ? event->MarginL : render_context.style->MarginL;
2030 MarginR = (event->MarginR) ? event->MarginR : render_context.style->MarginR;
2031 MarginV = (event->MarginV) ? event->MarginV : render_context.style->MarginV;
2033 if (render_context.evt_type != EVENT_HSCROLL) {
2034 int max_text_width;
2036 // calculate max length of a line
2037 max_text_width = x2scr(frame_context.track->PlayResX - MarginR) - x2scr(MarginL);
2039 // rearrange text in several lines
2040 wrap_lines_smart(max_text_width);
2042 // align text
2043 last_break = -1;
2044 for (i = 1; i < text_info.length + 1; ++i) { // (text_info.length + 1) is the end of the last line
2045 if ((i == text_info.length) || text_info.glyphs[i].linebreak) {
2046 int width, shift = 0;
2047 glyph_info_t* first_glyph = text_info.glyphs + last_break + 1;
2048 glyph_info_t* last_glyph = text_info.glyphs + i - 1;
2050 while ((last_glyph > first_glyph) && ((last_glyph->symbol == '\n') || (last_glyph->symbol == 0)))
2051 last_glyph --;
2053 width = last_glyph->pos.x + d6_to_int(last_glyph->advance.x) - first_glyph->pos.x;
2054 if (halign == HALIGN_LEFT) { // left aligned, no action
2055 shift = 0;
2056 } else if (halign == HALIGN_RIGHT) { // right aligned
2057 shift = max_text_width - width;
2058 } else if (halign == HALIGN_CENTER) { // centered
2059 shift = (max_text_width - width) / 2;
2061 for (j = last_break + 1; j < i; ++j) {
2062 text_info.glyphs[j].pos.x += shift;
2064 last_break = i - 1;
2067 } else { // render_context.evt_type == EVENT_HSCROLL
2068 measure_text();
2071 // determing text bounding box
2072 compute_string_bbox(&text_info, &bbox);
2074 // determine device coordinates for text
2076 // x coordinate for everything except positioned events
2077 if (render_context.evt_type == EVENT_NORMAL ||
2078 render_context.evt_type == EVENT_VSCROLL) {
2079 device_x = x2scr(MarginL);
2080 } else if (render_context.evt_type == EVENT_HSCROLL) {
2081 if (render_context.scroll_direction == SCROLL_RL)
2082 device_x = x2scr(frame_context.track->PlayResX - render_context.scroll_shift);
2083 else if (render_context.scroll_direction == SCROLL_LR)
2084 device_x = x2scr(render_context.scroll_shift) - (bbox.xMax - bbox.xMin);
2087 // y coordinate for everything except positioned events
2088 if (render_context.evt_type == EVENT_NORMAL ||
2089 render_context.evt_type == EVENT_HSCROLL) {
2090 if (valign == VALIGN_TOP) { // toptitle
2091 device_y = y2scr_top(MarginV) + d6_to_int(text_info.lines[0].asc);
2092 } else if (valign == VALIGN_CENTER) { // midtitle
2093 int scr_y = y2scr(frame_context.track->PlayResY / 2);
2094 device_y = scr_y - (bbox.yMax - bbox.yMin) / 2;
2095 } else { // subtitle
2096 int scr_y;
2097 if (valign != VALIGN_SUB)
2098 mp_msg(MSGT_ASS, MSGL_V, "Invalid valign, supposing 0 (subtitle)\n");
2099 scr_y = y2scr_sub(frame_context.track->PlayResY - MarginV);
2100 device_y = scr_y;
2101 device_y -= d6_to_int(text_info.height);
2102 device_y += d6_to_int(text_info.lines[0].asc);
2104 } else if (render_context.evt_type == EVENT_VSCROLL) {
2105 if (render_context.scroll_direction == SCROLL_TB)
2106 device_y = y2scr(render_context.clip_y0 + render_context.scroll_shift) - (bbox.yMax - bbox.yMin);
2107 else if (render_context.scroll_direction == SCROLL_BT)
2108 device_y = y2scr(render_context.clip_y1 - render_context.scroll_shift);
2111 // positioned events are totally different
2112 if (render_context.evt_type == EVENT_POSITIONED) {
2113 int base_x = 0;
2114 int base_y = 0;
2115 mp_msg(MSGT_ASS, MSGL_DBG2, "positioned event at %f, %f\n", render_context.pos_x, render_context.pos_y);
2116 get_base_point(bbox, alignment, &base_x, &base_y);
2117 device_x = x2scr_pos(render_context.pos_x) - base_x;
2118 device_y = y2scr_pos(render_context.pos_y) - base_y;
2121 // fix clip coordinates (they depend on alignment)
2122 if (render_context.evt_type == EVENT_NORMAL ||
2123 render_context.evt_type == EVENT_HSCROLL ||
2124 render_context.evt_type == EVENT_VSCROLL) {
2125 render_context.clip_x0 = x2scr(render_context.clip_x0);
2126 render_context.clip_x1 = x2scr(render_context.clip_x1);
2127 if (valign == VALIGN_TOP) {
2128 render_context.clip_y0 = y2scr_top(render_context.clip_y0);
2129 render_context.clip_y1 = y2scr_top(render_context.clip_y1);
2130 } else if (valign == VALIGN_CENTER) {
2131 render_context.clip_y0 = y2scr(render_context.clip_y0);
2132 render_context.clip_y1 = y2scr(render_context.clip_y1);
2133 } else if (valign == VALIGN_SUB) {
2134 render_context.clip_y0 = y2scr_sub(render_context.clip_y0);
2135 render_context.clip_y1 = y2scr_sub(render_context.clip_y1);
2137 } else if (render_context.evt_type == EVENT_POSITIONED) {
2138 render_context.clip_x0 = x2scr_pos(render_context.clip_x0);
2139 render_context.clip_x1 = x2scr_pos(render_context.clip_x1);
2140 render_context.clip_y0 = y2scr_pos(render_context.clip_y0);
2141 render_context.clip_y1 = y2scr_pos(render_context.clip_y1);
2144 // calculate rotation parameters
2146 FT_Vector center;
2148 if (render_context.have_origin) {
2149 center.x = x2scr(render_context.org_x);
2150 center.y = y2scr(render_context.org_y);
2151 } else {
2152 int bx = 0, by = 0;
2153 get_base_point(bbox, alignment, &bx, &by);
2154 center.x = device_x + bx;
2155 center.y = device_y + by;
2158 for (i = 0; i < text_info.length; ++i) {
2159 glyph_info_t* info = text_info.glyphs + i;
2161 if (info->hash_key.frx || info->hash_key.fry || info->hash_key.frz) {
2162 info->hash_key.shift_x = info->pos.x + device_x - center.x;
2163 info->hash_key.shift_y = - (info->pos.y + device_y - center.y);
2164 } else {
2165 info->hash_key.shift_x = 0;
2166 info->hash_key.shift_y = 0;
2171 // convert glyphs to bitmaps
2172 for (i = 0; i < text_info.length; ++i)
2173 get_bitmap_glyph(text_info.glyphs + i);
2175 memset(event_images, 0, sizeof(*event_images));
2176 event_images->top = device_y - d6_to_int(text_info.lines[0].asc);
2177 event_images->height = d6_to_int(text_info.height);
2178 event_images->detect_collisions = render_context.detect_collisions;
2179 event_images->shift_direction = (valign == VALIGN_TOP) ? 1 : -1;
2180 event_images->event = event;
2181 event_images->imgs = render_text(&text_info, device_x, device_y);
2183 free_render_context();
2185 return 0;
2189 * \brief deallocate image list
2190 * \param img list pointer
2192 static void ass_free_images(ass_image_t* img)
2194 while (img) {
2195 ass_image_t* next = img->next;
2196 free(img);
2197 img = next;
2201 static void ass_reconfigure(ass_renderer_t* priv)
2203 priv->render_id = ++last_render_id;
2204 ass_glyph_cache_reset();
2205 ass_bitmap_cache_reset();
2206 ass_composite_cache_reset();
2207 ass_free_images(priv->prev_images_root);
2208 priv->prev_images_root = 0;
2211 void ass_set_frame_size(ass_renderer_t* priv, int w, int h)
2213 if (priv->settings.frame_width != w || priv->settings.frame_height != h) {
2214 priv->settings.frame_width = w;
2215 priv->settings.frame_height = h;
2216 if (priv->settings.aspect == 0.)
2217 priv->settings.aspect = ((double)w) / h;
2218 ass_reconfigure(priv);
2222 void ass_set_margins(ass_renderer_t* priv, int t, int b, int l, int r)
2224 if (priv->settings.left_margin != l ||
2225 priv->settings.right_margin != r ||
2226 priv->settings.top_margin != t ||
2227 priv->settings.bottom_margin != b) {
2228 priv->settings.left_margin = l;
2229 priv->settings.right_margin = r;
2230 priv->settings.top_margin = t;
2231 priv->settings.bottom_margin = b;
2232 ass_reconfigure(priv);
2236 void ass_set_use_margins(ass_renderer_t* priv, int use)
2238 priv->settings.use_margins = use;
2241 void ass_set_aspect_ratio(ass_renderer_t* priv, double ar)
2243 if (priv->settings.aspect != ar) {
2244 priv->settings.aspect = ar;
2245 ass_reconfigure(priv);
2249 void ass_set_font_scale(ass_renderer_t* priv, double font_scale)
2251 if (priv->settings.font_size_coeff != font_scale) {
2252 priv->settings.font_size_coeff = font_scale;
2253 ass_reconfigure(priv);
2257 void ass_set_hinting(ass_renderer_t* priv, ass_hinting_t ht)
2259 if (priv->settings.hinting != ht) {
2260 priv->settings.hinting = ht;
2261 ass_reconfigure(priv);
2265 void ass_set_line_spacing(ass_renderer_t* priv, double line_spacing)
2267 priv->settings.line_spacing = line_spacing;
2270 static int ass_set_fonts_(ass_renderer_t* priv, const char* default_font, const char* default_family, int fc)
2272 if (priv->settings.default_font)
2273 free(priv->settings.default_font);
2274 if (priv->settings.default_family)
2275 free(priv->settings.default_family);
2277 priv->settings.default_font = default_font ? strdup(default_font) : 0;
2278 priv->settings.default_family = default_family ? strdup(default_family) : 0;
2280 if (priv->fontconfig_priv)
2281 fontconfig_done(priv->fontconfig_priv);
2282 priv->fontconfig_priv = fontconfig_init(priv->library, priv->ftlibrary, default_family, default_font, fc);
2284 return !!priv->fontconfig_priv;
2287 int ass_set_fonts(ass_renderer_t* priv, const char* default_font, const char* default_family)
2289 return ass_set_fonts_(priv, default_font, default_family, 1);
2292 int ass_set_fonts_nofc(ass_renderer_t* priv, const char* default_font, const char* default_family)
2294 return ass_set_fonts_(priv, default_font, default_family, 0);
2298 * \brief Start a new frame
2300 static int ass_start_frame(ass_renderer_t *priv, ass_track_t* track, long long now)
2302 ass_renderer = priv;
2303 global_settings = &priv->settings;
2305 if (!priv->settings.frame_width && !priv->settings.frame_height)
2306 return 1; // library not initialized
2308 if (track->n_events == 0)
2309 return 1; // nothing to do
2311 frame_context.ass_priv = priv;
2312 frame_context.width = global_settings->frame_width;
2313 frame_context.height = global_settings->frame_height;
2314 frame_context.orig_width = global_settings->frame_width - global_settings->left_margin - global_settings->right_margin;
2315 frame_context.orig_height = global_settings->frame_height - global_settings->top_margin - global_settings->bottom_margin;
2316 frame_context.orig_width_nocrop = global_settings->frame_width -
2317 FFMAX(global_settings->left_margin, 0) -
2318 FFMAX(global_settings->right_margin, 0);
2319 frame_context.orig_height_nocrop = global_settings->frame_height -
2320 FFMAX(global_settings->top_margin, 0) -
2321 FFMAX(global_settings->bottom_margin, 0);
2322 frame_context.track = track;
2323 frame_context.time = now;
2325 ass_lazy_track_init();
2327 frame_context.font_scale = global_settings->font_size_coeff *
2328 frame_context.orig_height / frame_context.track->PlayResY;
2329 if (frame_context.track->ScaledBorderAndShadow)
2330 frame_context.border_scale = ((double)frame_context.orig_height) / frame_context.track->PlayResY;
2331 else
2332 frame_context.border_scale = 1.;
2334 frame_context.font_scale_x = 1.;
2336 priv->prev_images_root = priv->images_root;
2337 priv->images_root = 0;
2339 return 0;
2342 static int cmp_event_layer(const void* p1, const void* p2)
2344 ass_event_t* e1 = ((event_images_t*)p1)->event;
2345 ass_event_t* e2 = ((event_images_t*)p2)->event;
2346 if (e1->Layer < e2->Layer)
2347 return -1;
2348 if (e1->Layer > e2->Layer)
2349 return 1;
2350 if (e1->ReadOrder < e2->ReadOrder)
2351 return -1;
2352 if (e1->ReadOrder > e2->ReadOrder)
2353 return 1;
2354 return 0;
2357 #define MAX_EVENTS 100
2359 static render_priv_t* get_render_priv(ass_event_t* event)
2361 if (!event->render_priv)
2362 event->render_priv = calloc(1, sizeof(render_priv_t));
2363 // FIXME: check render_id
2364 if (ass_renderer->render_id != event->render_priv->render_id) {
2365 memset(event->render_priv, 0, sizeof(render_priv_t));
2366 event->render_priv->render_id = ass_renderer->render_id;
2368 return event->render_priv;
2371 typedef struct segment_s {
2372 int a, b; // top and height
2373 } segment_t;
2375 static int overlap(segment_t* s1, segment_t* s2)
2377 if (s1->a >= s2->b || s2->a >= s1->b)
2378 return 0;
2379 return 1;
2382 static int cmp_segment(const void* p1, const void* p2)
2384 return ((segment_t*)p1)->a - ((segment_t*)p2)->a;
2387 static void shift_event(event_images_t* ei, int shift)
2389 ass_image_t* cur = ei->imgs;
2390 while (cur) {
2391 cur->dst_y += shift;
2392 // clip top and bottom
2393 if (cur->dst_y < 0) {
2394 int clip = - cur->dst_y;
2395 cur->h -= clip;
2396 cur->bitmap += clip * cur->stride;
2397 cur->dst_y = 0;
2399 if (cur->dst_y + cur->h >= frame_context.height) {
2400 int clip = cur->dst_y + cur->h - frame_context.height;
2401 cur->h -= clip;
2403 if (cur->h <= 0) {
2404 cur->h = 0;
2405 cur->dst_y = 0;
2407 cur = cur->next;
2409 ei->top += shift;
2412 // dir: 1 - move down
2413 // -1 - move up
2414 static int fit_segment(segment_t* s, segment_t* fixed, int* cnt, int dir)
2416 int i;
2417 int shift = 0;
2419 if (dir == 1) // move down
2420 for (i = 0; i < *cnt; ++i) {
2421 if (s->b + shift <= fixed[i].a || s->a + shift >= fixed[i].b)
2422 continue;
2423 shift = fixed[i].b - s->a;
2425 else // dir == -1, move up
2426 for (i = *cnt-1; i >= 0; --i) {
2427 if (s->b + shift <= fixed[i].a || s->a + shift >= fixed[i].b)
2428 continue;
2429 shift = fixed[i].a - s->b;
2432 fixed[*cnt].a = s->a + shift;
2433 fixed[*cnt].b = s->b + shift;
2434 (*cnt)++;
2435 qsort(fixed, *cnt, sizeof(segment_t), cmp_segment);
2437 return shift;
2440 static void fix_collisions(event_images_t* imgs, int cnt)
2442 segment_t used[MAX_EVENTS];
2443 int cnt_used = 0;
2444 int i, j;
2446 // fill used[] with fixed events
2447 for (i = 0; i < cnt; ++i) {
2448 render_priv_t* priv;
2449 if (!imgs[i].detect_collisions) continue;
2450 priv = get_render_priv(imgs[i].event);
2451 if (priv->height > 0) { // it's a fixed event
2452 segment_t s;
2453 s.a = priv->top;
2454 s.b = priv->top + priv->height;
2455 if (priv->height != imgs[i].height) { // no, it's not
2456 mp_msg(MSGT_ASS, MSGL_WARN, MSGTR_LIBASS_EventHeightHasChanged);
2457 priv->top = 0;
2458 priv->height = 0;
2460 for (j = 0; j < cnt_used; ++j)
2461 if (overlap(&s, used + j)) { // no, it's not
2462 priv->top = 0;
2463 priv->height = 0;
2465 if (priv->height > 0) { // still a fixed event
2466 used[cnt_used].a = priv->top;
2467 used[cnt_used].b = priv->top + priv->height;
2468 cnt_used ++;
2469 shift_event(imgs + i, priv->top - imgs[i].top);
2473 qsort(used, cnt_used, sizeof(segment_t), cmp_segment);
2475 // try to fit other events in free spaces
2476 for (i = 0; i < cnt; ++i) {
2477 render_priv_t* priv;
2478 if (!imgs[i].detect_collisions) continue;
2479 priv = get_render_priv(imgs[i].event);
2480 if (priv->height == 0) { // not a fixed event
2481 int shift;
2482 segment_t s;
2483 s.a = imgs[i].top;
2484 s.b = imgs[i].top + imgs[i].height;
2485 shift = fit_segment(&s, used, &cnt_used, imgs[i].shift_direction);
2486 if (shift) shift_event(imgs + i, shift);
2487 // make it fixed
2488 priv->top = imgs[i].top;
2489 priv->height = imgs[i].height;
2496 * \brief compare two images
2497 * \param i1 first image
2498 * \param i2 second image
2499 * \return 0 if identical, 1 if different positions, 2 if different content
2501 static int ass_image_compare(ass_image_t *i1, ass_image_t *i2)
2503 if (i1->w != i2->w) return 2;
2504 if (i1->h != i2->h) return 2;
2505 if (i1->stride != i2->stride) return 2;
2506 if (i1->color != i2->color) return 2;
2507 if (i1->bitmap != i2->bitmap)
2508 return 2;
2509 if (i1->dst_x != i2->dst_x) return 1;
2510 if (i1->dst_y != i2->dst_y) return 1;
2511 return 0;
2515 * \brief compare current and previous image list
2516 * \param priv library handle
2517 * \return 0 if identical, 1 if different positions, 2 if different content
2519 static int ass_detect_change(ass_renderer_t *priv)
2521 ass_image_t* img, *img2;
2522 int diff;
2524 img = priv->prev_images_root;
2525 img2 = priv->images_root;
2526 diff = 0;
2527 while (img && diff < 2) {
2528 ass_image_t* next, *next2;
2529 next = img->next;
2530 if (img2) {
2531 int d = ass_image_compare(img, img2);
2532 if (d > diff) diff = d;
2533 next2 = img2->next;
2534 } else {
2535 // previous list is shorter
2536 diff = 2;
2537 break;
2539 img = next;
2540 img2 = next2;
2543 // is the previous list longer?
2544 if (img2)
2545 diff = 2;
2547 return diff;
2551 * \brief render a frame
2552 * \param priv library handle
2553 * \param track track
2554 * \param now current video timestamp (ms)
2555 * \param detect_change a value describing how the new images differ from the previous ones will be written here:
2556 * 0 if identical, 1 if different positions, 2 if different content.
2557 * Can be NULL, in that case no detection is performed.
2559 ass_image_t* ass_render_frame(ass_renderer_t *priv, ass_track_t* track, long long now, int* detect_change)
2561 int i, cnt, rc;
2562 event_images_t* last;
2563 ass_image_t** tail;
2565 // init frame
2566 rc = ass_start_frame(priv, track, now);
2567 if (rc != 0)
2568 return 0;
2570 // render events separately
2571 cnt = 0;
2572 for (i = 0; i < track->n_events; ++i) {
2573 ass_event_t* event = track->events + i;
2574 if ( (event->Start <= now) && (now < (event->Start + event->Duration)) ) {
2575 if (cnt >= priv->eimg_size) {
2576 priv->eimg_size += 100;
2577 priv->eimg = realloc(priv->eimg, priv->eimg_size * sizeof(event_images_t));
2579 rc = ass_render_event(event, priv->eimg + cnt);
2580 if (!rc) ++cnt;
2584 // sort by layer
2585 qsort(priv->eimg, cnt, sizeof(event_images_t), cmp_event_layer);
2587 // call fix_collisions for each group of events with the same layer
2588 last = priv->eimg;
2589 for (i = 1; i < cnt; ++i)
2590 if (last->event->Layer != priv->eimg[i].event->Layer) {
2591 fix_collisions(last, priv->eimg + i - last);
2592 last = priv->eimg + i;
2594 if (cnt > 0)
2595 fix_collisions(last, priv->eimg + cnt - last);
2597 // concat lists
2598 tail = &ass_renderer->images_root;
2599 for (i = 0; i < cnt; ++i) {
2600 ass_image_t* cur = priv->eimg[i].imgs;
2601 while (cur) {
2602 *tail = cur;
2603 tail = &cur->next;
2604 cur = cur->next;
2608 if (detect_change)
2609 *detect_change = ass_detect_change(priv);
2611 // free the previous image list
2612 ass_free_images(priv->prev_images_root);
2613 priv->prev_images_root = 0;
2615 return ass_renderer->images_root;