2 * Copyright (C) 2006 Evgeniy Stepanov <eugeni.stepanov@gmail.com>
3 * Copyright (C) 2009 Grigori Goronzy <greg@geekmind.org>
5 * This file is part of libass.
7 * Permission to use, copy, modify, and distribute this software for any
8 * purpose with or without fee is hereby granted, provided that the above
9 * copyright notice and this permission notice appear in all copies.
11 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
12 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
13 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
14 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
15 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
16 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
17 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
20 #ifndef LIBASS_RENDER_H
21 #define LIBASS_RENDER_H
25 #include FT_FREETYPE_H
28 #include FT_SYNTHESIS_H
32 #include "ass_bitmap.h"
33 #include "ass_cache.h"
34 #include "ass_utils.h"
35 #include "ass_fontconfig.h"
36 #include "ass_library.h"
37 #include "ass_drawing.h"
39 #define GLYPH_CACHE_MAX 1000
40 #define BITMAP_CACHE_MAX_SIZE 30 * 1048576
42 #define PARSED_FADE (1<<0)
43 #define PARSED_A (1<<1)
57 typedef struct free_list
{
59 struct free_list
*next
;
65 double font_size_coeff
; // font size multiplier
66 double line_spacing
; // additional line spacing (in frame pixels)
67 int top_margin
; // height of top margin. Everything except toptitles is shifted down by top_margin.
68 int bottom_margin
; // height of bottom margin. (frame_height - top_margin - bottom_margin) is original video height.
71 int use_margins
; // 0 - place all subtitles inside original frame
72 // 1 - use margins for placing toptitles and subtitles
73 double aspect
; // frame aspect ratio, d_width / d_height.
74 double storage_aspect
; // pixel ratio of the source image
84 int top
, height
, left
, width
;
85 int detect_collisions
;
98 // GlyphInfo and TextInfo are used for text centering and word-wrapping operations
101 unsigned skip
; // skip glyph when layouting text
104 Bitmap
*bm
; // glyph bitmap
105 Bitmap
*bm_o
; // outline bitmap
106 Bitmap
*bm_s
; // shadow bitmap
109 char linebreak
; // the first (leading) glyph of some line ?
110 uint32_t c
[4]; // colors
111 FT_Vector advance
; // 26.6
113 int effect_timing
; // time duration of current karaoke word
114 // after process_karaoke_effects: distance in pixels from the glyph origin.
115 // part of the glyph to the left of it is displayed in a different color.
116 int effect_skip_timing
; // delay after the end of last karaoke word
117 int asc
, desc
; // font max ascender and descender
118 int be
; // blur edges
119 double blur
; // gaussian blur
122 double frx
, fry
, frz
; // rotation
123 double fax
, fay
; // text shearing
125 BitmapHashKey hash_key
;
143 // Values like current font face, color, screen position, clipping and so on are stored here.
152 int flags
; // decoration flags (underline/strike-through)
155 int alignment
; // alignment overrides go here; if zero, style value will be used
156 double frx
, fry
, frz
;
157 double fax
, fay
; // text shearing
159 EVENT_NORMAL
, // "normal" top-, sub- or mid- title
160 EVENT_POSITIONED
, // happens after pos(,), margins are ignored
161 EVENT_HSCROLL
, // "Banner" transition effect, text_width is unlimited
162 EVENT_VSCROLL
// "Scroll up", "Scroll down" transition effects
164 double pos_x
, pos_y
; // position
165 double org_x
, org_y
; // origin
166 char have_origin
; // origin is explicitly defined; if 0, get_base_point() is used
167 double scale_x
, scale_y
;
168 double hspacing
; // distance between letters, in pixels
169 double border_x
; // outline width
171 uint32_t c
[4]; // colors(Primary, Secondary, so on) in RGBA
172 int clip_x0
, clip_y0
, clip_x1
, clip_y1
;
173 char clip_mode
; // 1 = iclip
174 char detect_collisions
;
175 uint32_t fade
; // alpha from \fad
176 char be
; // blur edges
177 double blur
; // gaussian blur
180 int drawing_mode
; // not implemented; when != 0 text is discarded, except for style override tags
181 ASS_Drawing
*drawing
; // current drawing
182 ASS_Drawing
*clip_drawing
; // clip vector
183 int clip_drawing_mode
; // 0 = regular clip, 1 = inverse clip
187 int effect_skip_timing
;
190 SCROLL_LR
, // left-to-right
192 SCROLL_TB
, // top-to-bottom
194 } scroll_direction
; // for EVENT_HSCROLL, EVENT_VSCROLL
201 int treat_family_as_pattern
;
209 Cache
*composite_cache
;
211 size_t bitmap_max_size
;
214 struct ass_renderer
{
215 ASS_Library
*library
;
216 FT_Library ftlibrary
;
217 FCInstance
*fontconfig_priv
;
218 ASS_Settings settings
;
220 ASS_SynthPriv
*synth_priv
;
222 ASS_Image
*images_root
; // rendering result is stored here
223 ASS_Image
*prev_images_root
;
225 EventImages
*eimg
; // temporary buffer for sorting rendered events
226 int eimg_size
; // allocated buffer size
229 int width
, height
; // screen dimensions
230 int orig_height
; // frame height ( = screen height - margins )
231 int orig_width
; // frame width ( = screen width - margins )
232 int orig_height_nocrop
; // frame height ( = screen height - margins + cropheight)
233 int orig_width_nocrop
; // frame width ( = screen width - margins + cropwidth)
235 long long time
; // frame's timestamp, ms
237 double font_scale_x
; // x scale applied to all glyphs to preserve text aspect ratio
248 typedef struct render_priv
{
249 int top
, height
, left
, width
;
261 int a
, b
; // top and height
262 int ha
, hb
; // left and width
265 void reset_render_context(ASS_Renderer
*render_priv
);
266 void ass_free_images(ASS_Image
*img
);
268 // XXX: this is actually in ass.c, includes should be fixed later on
269 void ass_lazy_track_init(ASS_Library
*lib
, ASS_Track
*track
);
271 #endif /* LIBASS_RENDER_H */