/* * Copyright (C) 2006 Evgeniy Stepanov * Copyright (C) 2009 Grigori Goronzy * * This file is part of libass. * * Permission to use, copy, modify, and distribute this software for any * purpose with or without fee is hereby granted, provided that the above * copyright notice and this permission notice appear in all copies. * * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. */ #ifndef LIBASS_RENDER_H #define LIBASS_RENDER_H #include #include #include FT_FREETYPE_H #include FT_GLYPH_H #include FT_SYNTHESIS_H #ifdef CONFIG_HARFBUZZ #include #endif #include "ass.h" #include "ass_font.h" #include "ass_bitmap.h" #include "ass_cache.h" #include "ass_utils.h" #include "ass_fontselect.h" #include "ass_library.h" #include "ass_drawing.h" #include "ass_bitmap.h" #include "ass_rasterizer.h" #define GLYPH_CACHE_MAX 10000 #define MEGABYTE (1024 * 1024) #define BITMAP_CACHE_MAX_SIZE (128 * MEGABYTE) #define COMPOSITE_CACHE_RATIO 2 #define COMPOSITE_CACHE_MAX_SIZE (BITMAP_CACHE_MAX_SIZE / COMPOSITE_CACHE_RATIO) #define PARSED_FADE (1<<0) #define PARSED_A (1<<1) typedef struct { ASS_Image result; CompositeHashValue *source; unsigned char *buffer; size_t ref_count; } ASS_ImagePriv; typedef struct { int frame_width; int frame_height; int storage_width; // video width before any rescaling int storage_height; // video height before any rescaling double font_size_coeff; // font size multiplier double line_spacing; // additional line spacing (in frame pixels) double line_position; // vertical position for subtitles, 0-100 (0 = no change) int top_margin; // height of top margin. Everything except toptitles is shifted down by top_margin. int bottom_margin; // height of bottom margin. (frame_height - top_margin - bottom_margin) is original video height. int left_margin; int right_margin; int use_margins; // 0 - place all subtitles inside original frame // 1 - use margins for placing toptitles and subtitles double par; // user defined pixel aspect ratio (0 = unset) ASS_Hinting hinting; ASS_ShapingLevel shaper; int selective_style_overrides; // ASS_OVERRIDE_* flags char *default_font; char *default_family; } ASS_Settings; // a rendered event typedef struct { ASS_Image *imgs; int top, height, left, width; int detect_collisions; int shift_direction; ASS_Event *event; } EventImages; typedef enum { EF_NONE = 0, EF_KARAOKE, EF_KARAOKE_KF, EF_KARAOKE_KO } Effect; // describes a combined bitmap typedef struct { FilterDesc filter; uint32_t c[4]; // colors Effect effect_type; int effect_timing; // time duration of current karaoke word // after process_karaoke_effects: distance in pixels from the glyph origin. // part of the glyph to the left of it is displayed in a different color. int first_pos_x; size_t bitmap_count, max_bitmap_count; BitmapRef *bitmaps; int x, y; Bitmap *bm, *bm_o, *bm_s; // glyphs, outline, shadow bitmaps CompositeHashValue *image; } CombinedBitmapInfo; typedef struct { ASS_DVector scale, offset; } ASS_Transform; // describes a glyph // GlyphInfo and TextInfo are used for text centering and word-wrapping operations typedef struct glyph_info { unsigned symbol; unsigned skip; // skip glyph when layouting text ASS_Font *font; int face_index; int glyph_index; #ifdef CONFIG_HARFBUZZ hb_script_t script; #else int script; #endif double font_size; char *drawing_text; int drawing_scale; int drawing_pbo; OutlineHashValue *outline; ASS_Transform transform; ASS_Rect bbox; ASS_Vector pos; ASS_Vector offset; char linebreak; // the first (leading) glyph of some line ? uint32_t c[4]; // colors ASS_Vector advance; // 26.6 ASS_Vector cluster_advance; char effect; // the first (leading) glyph of some effect ? Effect effect_type; int effect_timing; // time duration of current karaoke word // after process_karaoke_effects: distance in pixels from the glyph origin. // part of the glyph to the left of it is displayed in a different color. int effect_skip_timing; // delay after the end of last karaoke word int asc, desc; // font max ascender and descender int be; // blur edges double blur; // gaussian blur double shadow_x; double shadow_y; double frx, fry, frz; // rotation double fax, fay; // text shearing double scale_x, scale_y; // amount of scale_x,y change due to fix_glyph_scaling // scale_fix = before / after double scale_fix; int border_style; double border_x, border_y; double hspacing; int hspacing_scaled; // 26.6 unsigned italic; unsigned bold; int flags; int shape_run_id; ASS_Vector shift; Bitmap *bm, *bm_o; // next glyph in this cluster struct glyph_info *next; } GlyphInfo; typedef struct { double asc, desc; int offset, len; } LineInfo; typedef struct { GlyphInfo *glyphs; int length; LineInfo *lines; int n_lines; CombinedBitmapInfo *combined_bitmaps; unsigned n_bitmaps; double height; int max_glyphs; int max_lines; unsigned max_bitmaps; } TextInfo; // Renderer state. // Values like current font face, color, screen position, clipping and so on are stored here. typedef struct { ASS_Event *event; ASS_Style *style; int parsed_tags; ASS_Font *font; double font_size; int flags; // decoration flags (underline/strike-through) int alignment; // alignment overrides go here; if zero, style value will be used int justify; // justify instructions double frx, fry, frz; double fax, fay; // text shearing enum { EVENT_NORMAL, // "normal" top-, sub- or mid- title EVENT_POSITIONED, // happens after pos(,), margins are ignored EVENT_HSCROLL, // "Banner" transition effect, text_width is unlimited EVENT_VSCROLL // "Scroll up", "Scroll down" transition effects } evt_type; double pos_x, pos_y; // position double org_x, org_y; // origin char have_origin; // origin is explicitly defined; if 0, get_base_point() is used double scale_x, scale_y; double hspacing; // distance between letters, in pixels int border_style; double border_x; // outline width double border_y; uint32_t c[4]; // colors(Primary, Secondary, so on) in RGBA int clip_x0, clip_y0, clip_x1, clip_y1; char clip_mode; // 1 = iclip char detect_collisions; int fade; // alpha from \fad char be; // blur edges double blur; // gaussian blur double shadow_x; double shadow_y; int drawing_scale; // currently reading: regular text if 0, drawing otherwise double pbo; // drawing baseline offset char *clip_drawing_text; int clip_drawing_scale; int clip_drawing_mode; // 0 = regular clip, 1 = inverse clip Effect effect_type; int effect_timing; int effect_skip_timing; enum { SCROLL_LR, // left-to-right SCROLL_RL, SCROLL_TB, // top-to-bottom SCROLL_BT } scroll_direction; // for EVENT_HSCROLL, EVENT_VSCROLL int scroll_shift; // face properties char *family; unsigned bold; unsigned italic; int treat_family_as_pattern; int wrap_style; int font_encoding; // combination of ASS_OVERRIDE_BIT_* flags that apply right now unsigned overrides; // whether to apply font_scale int apply_font_scale; // whether this is assumed to be explicitly positioned int explicit; // used to store RenderContext.style when doing selective style overrides ASS_Style override_style_temp_storage; } RenderContext; typedef struct { Cache *font_cache; Cache *outline_cache; Cache *bitmap_cache; Cache *composite_cache; size_t glyph_max; size_t bitmap_max_size; size_t composite_max_size; } CacheStore; #include "ass_shaper.h" struct ass_renderer { ASS_Library *library; FT_Library ftlibrary; ASS_FontSelector *fontselect; ASS_Settings settings; int render_id; ASS_Shaper *shaper; ASS_Image *images_root; // rendering result is stored here ASS_Image *prev_images_root; EventImages *eimg; // temporary buffer for sorting rendered events int eimg_size; // allocated buffer size // frame-global data int width, height; // screen dimensions int orig_height; // frame height ( = screen height - margins ) int orig_width; // frame width ( = screen width - margins ) int orig_height_nocrop; // frame height ( = screen height - margins + cropheight) int orig_width_nocrop; // frame width ( = screen width - margins + cropwidth) ASS_Track *track; long long time; // frame's timestamp, ms double font_scale; double font_scale_x; // x scale applied to all glyphs to preserve text aspect ratio double border_scale; double blur_scale; RenderContext state; TextInfo text_info; CacheStore cache; const BitmapEngine *engine; RasterizerData rasterizer; ASS_Style user_override_style; }; typedef struct render_priv { int top, height, left, width; int render_id; } RenderPriv; typedef struct { int x0; int y0; int x1; int y1; } Rect; typedef struct { int a, b; // top and height int ha, hb; // left and width } Segment; void reset_render_context(ASS_Renderer *render_priv, ASS_Style *style); void ass_frame_ref(ASS_Image *img); void ass_frame_unref(ASS_Image *img); // XXX: this is actually in ass.c, includes should be fixed later on void ass_lazy_track_init(ASS_Library *lib, ASS_Track *track); #endif /* LIBASS_RENDER_H */