include/vlc_text_style.h

   1 /*****************************************************************************
   2  * vlc_text_style.h: text_style_t definition and helpers.
   3  *****************************************************************************
   4  * Copyright (C) 1999-2010 VLC authors and VideoLAN
   5  * $Id$
   6  *
   7  * Authors: Derk-Jan Hartman <hartman _AT_ videolan _DOT_ org>
   8  *          basOS G <noxelia 4t gmail , com>
   9  *
  10  * This program is free software; you can redistribute it and/or modify it
  11  * under the terms of the GNU Lesser General Public License as published by
  12  * the Free Software Foundation; either version 2.1 of the License, or
  13  * (at your option) any later version.
  14  *
  15  * This program is distributed in the hope that it will be useful,
  16  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  17  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  18  * GNU Lesser General Public License for more details.
  19  *
  20  * You should have received a copy of the GNU Lesser General Public License
  21  * along with this program; if not, write to the Free Software Foundation,
  22  * Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
  23  *****************************************************************************/
  24
  25 #ifndef VLC_TEXT_STYLE_H
  26 #define VLC_TEXT_STYLE_H 1
  27
  28 #ifdef __cplusplus
  29 extern "C" {
  30 #endif
  31
  32 /**
  33  * Text style
  34  *
  35  * A text style is used to specify the formatting of text.
  36  * A font renderer can use the supplied information to render the
  37  * text specified.
  38  */
  39 typedef struct
  40 {
  41     /* Family font names */
  42     char *     psz_fontname;      /**< The name of the font */
  43     char *     psz_monofontname;  /**< The name of the mono font */
  44
  45     uint16_t   i_features;        /**< Feature flags (means non default) */
  46     uint16_t   i_style_flags;     /**< Formatting style flags */
  47
  48     /* Font style */
  49     float      f_font_relsize;    /**< The font size in video height % */
  50     int        i_font_size;       /**< The font size in pixels */
  51     int        i_font_color;      /**< The color of the text 0xRRGGBB
  52                                        (native endianness) */
  53     uint8_t    i_font_alpha;      /**< The transparency of the text.*/
  54     int        i_spacing;         /**< The spaceing between glyphs in pixels */
  55
  56     /* Outline */
  57     int        i_outline_color;   /**< The color of the outline 0xRRGGBB */
  58     uint8_t    i_outline_alpha;   /**< The transparency of the outline */
  59     int        i_outline_width;   /**< The width of the outline in pixels */
  60
  61     /* Shadow */
  62     int        i_shadow_color;    /**< The color of the shadow 0xRRGGBB */
  63     uint8_t    i_shadow_alpha;    /**< The transparency of the shadow. */
  64     int        i_shadow_width;    /**< The width of the shadow in pixels */
  65
  66     /* Background (and karaoke) */
  67     int        i_background_color;/**< The color of the background 0xRRGGBB */
  68     uint8_t    i_background_alpha;/**< The transparency of the background */
  69     int        i_karaoke_background_color;/**< Background color for karaoke 0xRRGGBB */
  70     uint8_t    i_karaoke_background_alpha;/**< The transparency of the karaoke bg */
  71
  72     /* Line breaking */
  73     enum
  74     {
  75         STYLE_WRAP_DEFAULT = 0,   /**< Breaks on whitespace or fallback on char */
  76         STYLE_WRAP_CHAR,          /**< Breaks at character level only */
  77         STYLE_WRAP_NONE,          /**< No line breaks (except explicit ones) */
  78     } e_wrapinfo;
  79 } text_style_t;
  80
  81 #define STYLE_ALPHA_OPAQUE      0xFF
  82 #define STYLE_ALPHA_TRANSPARENT 0x00
  83
  84 /* Features flags for \ref i_features */
  85 #define STYLE_NO_DEFAULTS               0x0
  86 #define STYLE_FULLY_SET                 0xFFFF
  87 #define STYLE_HAS_FONT_COLOR            (1 << 0)
  88 #define STYLE_HAS_FONT_ALPHA            (1 << 1)
  89 #define STYLE_HAS_FLAGS                 (1 << 2)
  90 #define STYLE_HAS_OUTLINE_COLOR         (1 << 3)
  91 #define STYLE_HAS_OUTLINE_ALPHA         (1 << 4)
  92 #define STYLE_HAS_SHADOW_COLOR          (1 << 5)
  93 #define STYLE_HAS_SHADOW_ALPHA          (1 << 6)
  94 #define STYLE_HAS_BACKGROUND_COLOR      (1 << 7)
  95 #define STYLE_HAS_BACKGROUND_ALPHA      (1 << 8)
  96 #define STYLE_HAS_K_BACKGROUND_COLOR    (1 << 9)
  97 #define STYLE_HAS_K_BACKGROUND_ALPHA    (1 << 10)
  98 #define STYLE_HAS_WRAP_INFO             (1 << 11)
  99
 100 /* Style flags for \ref text_style_t */
 101 #define STYLE_BOLD              (1 << 0)
 102 #define STYLE_ITALIC            (1 << 1)
 103 #define STYLE_OUTLINE           (1 << 2)
 104 #define STYLE_SHADOW            (1 << 3)
 105 #define STYLE_BACKGROUND        (1 << 4)
 106 #define STYLE_UNDERLINE         (1 << 5)
 107 #define STYLE_STRIKEOUT         (1 << 6)
 108 #define STYLE_HALFWIDTH         (1 << 7)
 109 #define STYLE_MONOSPACED        (1 << 8)
 110 #define STYLE_DOUBLEWIDTH       (1 << 9)
 111 #define STYLE_BLINK_FOREGROUND  (1 << 10)
 112 #define STYLE_BLINK_BACKGROUND  (1 << 11)
 113
 114 #define STYLE_DEFAULT_FONT_SIZE 20
 115 #define STYLE_DEFAULT_REL_FONT_SIZE 6.25
 116
 117
 118 typedef struct text_segment_t text_segment_t;
 119 typedef struct text_segment_ruby_t text_segment_ruby_t;
 120
 121 /**
 122  * Text segment ruby for subtitles
 123  * Each ruby has an anchor to the segment char.
 124  */
 125 struct text_segment_ruby_t
 126 {
 127     char *psz_base;
 128     char *psz_rt;
 129     text_segment_ruby_t *p_next;
 130 };
 131
 132 /**
 133  * Text segment for subtitles
 134  *
 135  * This structure is used to store a formatted text, with mixed styles
 136  * Every segment is comprised of one text and a unique style
 137  *
 138  * On style change, a new segment is created with the next part of text
 139  * and the new style, and chained to the list
 140  *
 141  * Create with text_segment_New and clean the chain with
 142  * text_segment_ChainDelete
 143  */
 144 struct text_segment_t {
 145     char *psz_text;                   /**< text string of the segment */
 146     text_style_t *style;              /**< style applied to this segment */
 147     text_segment_t *p_next;           /**< next segment */
 148     text_segment_ruby_t *p_ruby;      /**< ruby descriptions */
 149 };
 150
 151 /**
 152  * Create a default text style
 153  */
 154 VLC_API text_style_t * text_style_New( void );
 155
 156 /**
 157  * Create a text style
 158  *
 159  * Give STYLE_NO_DEFAULTS as the argument if you want only the zero-filled
 160  * object. Give STYLE_FULLY_SET (or anything other than STYLE_NO_DEFAULTS)
 161  * if you want an object with sensible defaults. (The value is not stored,
 162  * the only effect is to determine whether to return a zero-filled or
 163  * sensible-defaults-filled object).
 164  */
 165 VLC_API text_style_t * text_style_Create( int );
 166
 167 /**
 168  * Copy a text style into another
 169  */
 170 VLC_API text_style_t * text_style_Copy( text_style_t *, const text_style_t * );
 171
 172 /**
 173  * Duplicate a text style
 174  */
 175 VLC_API text_style_t * text_style_Duplicate( const text_style_t * );
 176
 177 /**
 178  * Merge two styles using non default values
 179  *
 180  * Set b_override to true if you also want to overwrite non-defaults
 181  */
 182 VLC_API void text_style_Merge( text_style_t *, const text_style_t *, bool b_override );
 183
 184 /**
 185  * Delete a text style created by text_style_New or text_style_Duplicate
 186  */
 187 VLC_API void text_style_Delete( text_style_t * );
 188
 189 /**
 190  * This function will create a new text segment.
 191  *
 192  * You should use text_segment_ChainDelete to destroy it, to clean all
 193  * the linked segments, or text_segment_Delete to free a specic one
 194  *
 195  * This duplicates the string passed as argument
 196  */
 197 VLC_API text_segment_t *text_segment_New( const char * );
 198
 199 /**
 200  * This function will create a new text segment and duplicates the style passed as argument
 201  *
 202  * You should use text_segment_ChainDelete to destroy it, to clean all
 203  * the linked segments, or text_segment_Delete to free a specic one
 204  *
 205  * This doesn't initialize the text.
 206  */
 207 VLC_API text_segment_t *text_segment_NewInheritStyle( const text_style_t* p_style );
 208
 209 /**
 210  * Delete a text segment and its content.
 211  *
 212  * This assumes the segment is not part of a chain
 213  */
 214 VLC_API void text_segment_Delete( text_segment_t * );
 215
 216 /**
 217  * This function will destroy a list of text segments allocated
 218  * by text_segment_New.
 219  *
 220  * You may pass it NULL.
 221  */
 222 VLC_API void text_segment_ChainDelete( text_segment_t * );
 223
 224 /**
 225  * This function will copy a text_segment and its chain into a new one
 226  *
 227  * You may give it NULL, but it will return NULL.
 228  */
 229 VLC_API text_segment_t * text_segment_Copy( text_segment_t * );
 230
 231 /**
 232  * This function will create a ruby section for a text_segment
 233  *
 234  */
 235 VLC_API text_segment_ruby_t *text_segment_ruby_New( const char *psz_base,
 236                                                     const char *psz_rt );
 237
 238 /**
 239  * Deletes a ruby sections chain
 240  */
 241 VLC_API void text_segment_ruby_ChainDelete( text_segment_ruby_t *p_ruby );
 242
 243 /**
 244  * This function creates a text segment from a ruby section,
 245  * and creates fallback string.
 246  */
 247 VLC_API text_segment_t *text_segment_FromRuby( text_segment_ruby_t *p_ruby );
 248
 249 static const struct {
 250     const char *psz_name;
 251     uint32_t   i_value;
 252 } p_html_colors[] = {
 253     /* Official html colors */
 254     { "Aqua",    0x00FFFF },
 255     { "Black",   0x000000 },
 256     { "Blue",    0x0000FF },
 257     { "Fuchsia", 0xFF00FF },
 258     { "Gray",    0x808080 },
 259     { "Green",   0x008000 },
 260     { "Lime",    0x00FF00 },
 261     { "Maroon",  0x800000 },
 262     { "Navy",    0x000080 },
 263     { "Olive",   0x808000 },
 264     { "Purple",  0x800080 },
 265     { "Red",     0xFF0000 },
 266     { "Silver",  0xC0C0C0 },
 267     { "Teal",    0x008080 },
 268     { "White",   0xFFFFFF },
 269     { "Yellow",  0xFFFF00 },
 270
 271     /* Common ones */
 272     { "AliceBlue", 0xF0F8FF },
 273     { "AntiqueWhite", 0xFAEBD7 },
 274     { "Aqua", 0x00FFFF },
 275     { "Aquamarine", 0x7FFFD4 },
 276     { "Azure", 0xF0FFFF },
 277     { "Beige", 0xF5F5DC },
 278     { "Bisque", 0xFFE4C4 },
 279     { "Black", 0x000000 },
 280     { "BlanchedAlmond", 0xFFEBCD },
 281     { "Blue", 0x0000FF },
 282     { "BlueViolet", 0x8A2BE2 },
 283     { "Brown", 0xA52A2A },
 284     { "BurlyWood", 0xDEB887 },
 285     { "CadetBlue", 0x5F9EA0 },
 286     { "Chartreuse", 0x7FFF00 },
 287     { "Chocolate", 0xD2691E },
 288     { "Coral", 0xFF7F50 },
 289     { "CornflowerBlue", 0x6495ED },
 290     { "Cornsilk", 0xFFF8DC },
 291     { "Crimson", 0xDC143C },
 292     { "Cyan", 0x00FFFF },
 293     { "DarkBlue", 0x00008B },
 294     { "DarkCyan", 0x008B8B },
 295     { "DarkGoldenRod", 0xB8860B },
 296     { "DarkGray", 0xA9A9A9 },
 297     { "DarkGrey", 0xA9A9A9 },
 298     { "DarkGreen", 0x006400 },
 299     { "DarkKhaki", 0xBDB76B },
 300     { "DarkMagenta", 0x8B008B },
 301     { "DarkOliveGreen", 0x556B2F },
 302     { "Darkorange", 0xFF8C00 },
 303     { "DarkOrchid", 0x9932CC },
 304     { "DarkRed", 0x8B0000 },
 305     { "DarkSalmon", 0xE9967A },
 306     { "DarkSeaGreen", 0x8FBC8F },
 307     { "DarkSlateBlue", 0x483D8B },
 308     { "DarkSlateGray", 0x2F4F4F },
 309     { "DarkSlateGrey", 0x2F4F4F },
 310     { "DarkTurquoise", 0x00CED1 },
 311     { "DarkViolet", 0x9400D3 },
 312     { "DeepPink", 0xFF1493 },
 313     { "DeepSkyBlue", 0x00BFFF },
 314     { "DimGray", 0x696969 },
 315     { "DimGrey", 0x696969 },
 316     { "DodgerBlue", 0x1E90FF },
 317     { "FireBrick", 0xB22222 },
 318     { "FloralWhite", 0xFFFAF0 },
 319     { "ForestGreen", 0x228B22 },
 320     { "Fuchsia", 0xFF00FF },
 321     { "Gainsboro", 0xDCDCDC },
 322     { "GhostWhite", 0xF8F8FF },
 323     { "Gold", 0xFFD700 },
 324     { "GoldenRod", 0xDAA520 },
 325     { "Gray", 0x808080 },
 326     { "Grey", 0x808080 },
 327     { "Green", 0x008000 },
 328     { "GreenYellow", 0xADFF2F },
 329     { "HoneyDew", 0xF0FFF0 },
 330     { "HotPink", 0xFF69B4 },
 331     { "IndianRed", 0xCD5C5C },
 332     { "Indigo", 0x4B0082 },
 333     { "Ivory", 0xFFFFF0 },
 334     { "Khaki", 0xF0E68C },
 335     { "Lavender", 0xE6E6FA },
 336     { "LavenderBlush", 0xFFF0F5 },
 337     { "LawnGreen", 0x7CFC00 },
 338     { "LemonChiffon", 0xFFFACD },
 339     { "LightBlue", 0xADD8E6 },
 340     { "LightCoral", 0xF08080 },
 341     { "LightCyan", 0xE0FFFF },
 342     { "LightGoldenRodYellow", 0xFAFAD2 },
 343     { "LightGray", 0xD3D3D3 },
 344     { "LightGrey", 0xD3D3D3 },
 345     { "LightGreen", 0x90EE90 },
 346     { "LightPink", 0xFFB6C1 },
 347     { "LightSalmon", 0xFFA07A },
 348     { "LightSeaGreen", 0x20B2AA },
 349     { "LightSkyBlue", 0x87CEFA },
 350     { "LightSlateGray", 0x778899 },
 351     { "LightSlateGrey", 0x778899 },
 352     { "LightSteelBlue", 0xB0C4DE },
 353     { "LightYellow", 0xFFFFE0 },
 354     { "Lime", 0x00FF00 },
 355     { "LimeGreen", 0x32CD32 },
 356     { "Linen", 0xFAF0E6 },
 357     { "Magenta", 0xFF00FF },
 358     { "Maroon", 0x800000 },
 359     { "MediumAquaMarine", 0x66CDAA },
 360     { "MediumBlue", 0x0000CD },
 361     { "MediumOrchid", 0xBA55D3 },
 362     { "MediumPurple", 0x9370D8 },
 363     { "MediumSeaGreen", 0x3CB371 },
 364     { "MediumSlateBlue", 0x7B68EE },
 365     { "MediumSpringGreen", 0x00FA9A },
 366     { "MediumTurquoise", 0x48D1CC },
 367     { "MediumVioletRed", 0xC71585 },
 368     { "MidnightBlue", 0x191970 },
 369     { "MintCream", 0xF5FFFA },
 370     { "MistyRose", 0xFFE4E1 },
 371     { "Moccasin", 0xFFE4B5 },
 372     { "NavajoWhite", 0xFFDEAD },
 373     { "Navy", 0x000080 },
 374     { "OldLace", 0xFDF5E6 },
 375     { "Olive", 0x808000 },
 376     { "OliveDrab", 0x6B8E23 },
 377     { "Orange", 0xFFA500 },
 378     { "OrangeRed", 0xFF4500 },
 379     { "Orchid", 0xDA70D6 },
 380     { "PaleGoldenRod", 0xEEE8AA },
 381     { "PaleGreen", 0x98FB98 },
 382     { "PaleTurquoise", 0xAFEEEE },
 383     { "PaleVioletRed", 0xD87093 },
 384     { "PapayaWhip", 0xFFEFD5 },
 385     { "PeachPuff", 0xFFDAB9 },
 386     { "Peru", 0xCD853F },
 387     { "Pink", 0xFFC0CB },
 388     { "Plum", 0xDDA0DD },
 389     { "PowderBlue", 0xB0E0E6 },
 390     { "Purple", 0x800080 },
 391     { "RebeccaPurple", 0x663399 },
 392     { "Red", 0xFF0000 },
 393     { "RosyBrown", 0xBC8F8F },
 394     { "RoyalBlue", 0x4169E1 },
 395     { "SaddleBrown", 0x8B4513 },
 396     { "Salmon", 0xFA8072 },
 397     { "SandyBrown", 0xF4A460 },
 398     { "SeaGreen", 0x2E8B57 },
 399     { "SeaShell", 0xFFF5EE },
 400     { "Sienna", 0xA0522D },
 401     { "Silver", 0xC0C0C0 },
 402     { "SkyBlue", 0x87CEEB },
 403     { "SlateBlue", 0x6A5ACD },
 404     { "SlateGray", 0x708090 },
 405     { "SlateGrey", 0x708090 },
 406     { "Snow", 0xFFFAFA },
 407     { "SpringGreen", 0x00FF7F },
 408     { "SteelBlue", 0x4682B4 },
 409     { "Tan", 0xD2B48C },
 410     { "Teal", 0x008080 },
 411     { "Thistle", 0xD8BFD8 },
 412     { "Tomato", 0xFF6347 },
 413     { "Turquoise", 0x40E0D0 },
 414     { "Violet", 0xEE82EE },
 415     { "Wheat", 0xF5DEB3 },
 416     { "White", 0xFFFFFF },
 417     { "WhiteSmoke", 0xF5F5F5 },
 418     { "Yellow", 0xFFFF00 },
 419     { "YellowGreen", 0x9ACD32 },
 420
 421     { NULL, 0 }
 422 };
 423
 424 /**
 425  * Returns an integer representation of an HTML color.
 426  *
 427  * @param psz_value An HTML color, which can be either:
 428  *  - A standard HTML color (red, cyan, ...) as defined in p_html_colors
 429  *  - An hexadecimal color, of the form [#][AA]RRGGBB
 430  * @param ok If non-null, true will be stored in this pointer to signal
 431  *           a successful conversion
 432  */
 433 VLC_API unsigned int vlc_html_color( const char *psz_value, bool* ok );
 434
 435 #ifdef __cplusplus
 436 }
 437 #endif
 438
 439 #endif /* VLC_TEXT_STYLE_H */
 440