lily/pango-font.cc

   1 /*
   2   This file is part of LilyPond, the GNU music typesetter.
   3
   4   Copyright (C) 2004--2012 Han-Wen Nienhuys <hanwen@xs4all.nl>
   5
   6   LilyPond is free software: you can redistribute it and/or modify
   7   it under the terms of the GNU General Public License as published by
   8   the Free Software Foundation, either version 3 of the License, or
   9   (at your option) any later version.
  10
  11   LilyPond is distributed in the hope that it will be useful,
  12   but WITHOUT ANY WARRANTY; without even the implied warranty of
  13   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14   GNU General Public License for more details.
  15
  16   You should have received a copy of the GNU General Public License
  17   along with LilyPond.  If not, see <http://www.gnu.org/licenses/>.
  18 */
  19
  20 // Necessary for supporting pango_context_new() and
  21 // pango_context_set_font_map() in Pango < 1.22
  22 #define PANGO_ENABLE_BACKEND
  23
  24 #include <pango/pangoft2.h>
  25 #include <freetype/ftxf86.h>
  26
  27 #include <map>
  28 #include <cstdio>
  29
  30 // Ugh.
  31
  32 #include "pango-font.hh"
  33 #include "dimensions.hh"
  34 #include "file-name.hh"
  35 #include "international.hh"
  36 #include "lookup.hh"            // debugging
  37 #include "main.hh"
  38 #include "string-convert.hh"
  39 #include "warn.hh"
  40 #include "all-font-metrics.hh"
  41 #include "program-option.hh"
  42
  43 #if HAVE_PANGO_FT2
  44 #include "stencil.hh"
  45
  46 Pango_font::Pango_font (PangoFT2FontMap *fontmap,
  47                         PangoFontDescription const *description,
  48                         Real output_scale)
  49 {
  50   // This line looks stupid, but if we don't initialize physical_font_tab_ before
  51   // we allocate memory in scm_c_make_hash_table, then that could trigger a garbage
  52   // collection.
  53   physical_font_tab_ = SCM_EOL;
  54   physical_font_tab_ = scm_c_make_hash_table (11);
  55   PangoDirection pango_dir = PANGO_DIRECTION_LTR;
  56   context_ = pango_context_new ();
  57   pango_context_set_font_map (context_, PANGO_FONT_MAP (fontmap));
  58
  59   pango_description_ = pango_font_description_copy (description);
  60   attribute_list_ = pango_attr_list_new ();
  61
  62   // urgh. I don't understand this. Why isn't this 1/(scale *
  63   // resolution * output_scale)
  64   //
  65   //  --hwn
  66   output_scale_ = output_scale;
  67   scale_ = INCH_TO_BP
  68            / (Real (PANGO_SCALE) * Real (PANGO_RESOLUTION) * output_scale);
  69
  70   // ugh. Should make this configurable.
  71   pango_context_set_language (context_, pango_language_from_string ("en_US"));
  72   pango_context_set_base_dir (context_, pango_dir);
  73   pango_context_set_font_description (context_, description);
  74 }
  75
  76 Pango_font::~Pango_font ()
  77 {
  78   pango_font_description_free (pango_description_);
  79   g_object_unref (context_);
  80   pango_attr_list_unref (attribute_list_);
  81 }
  82
  83 void
  84 Pango_font::register_font_file (string filename,
  85                                 string ps_name,
  86                                 int face_index)
  87 {
  88   scm_hash_set_x (physical_font_tab_,
  89                   ly_string2scm (ps_name),
  90                   scm_list_2 (ly_string2scm (filename),
  91                               scm_from_int (face_index)));
  92 }
  93
  94 size_t
  95 Pango_font::name_to_index (string nm) const
  96 {
  97   PangoFcFont *fcfont = PANGO_FC_FONT (pango_context_load_font (context_, pango_description_));
  98   FT_Face face = pango_fc_font_lock_face (fcfont);
  99   char *nm_str = (char *) nm.c_str ();
 100   if (FT_UInt idx = FT_Get_Name_Index (face, nm_str))
 101     {
 102       pango_fc_font_unlock_face (fcfont);
 103       return (size_t) idx;
 104     }
 105
 106   pango_fc_font_unlock_face (fcfont);
 107   return (size_t) - 1;
 108 }
 109
 110 void
 111 Pango_font::derived_mark () const
 112 {
 113   scm_gc_mark (physical_font_tab_);
 114 }
 115
 116 void
 117 get_glyph_index_name (char *s,
 118                       FT_ULong code)
 119 {
 120   sprintf (s, "glyphIndex%lX", code);
 121 }
 122
 123 void
 124 get_unicode_name (char *s,
 125                   FT_ULong code)
 126 {
 127   if (code > 0xFFFF)
 128     sprintf (s, "u%lX", code);
 129   else
 130     sprintf (s, "uni%04lX", code);
 131 }
 132
 133 Box
 134 Pango_font::get_unscaled_indexed_char_dimensions (size_t signed_idx) const
 135 {
 136   PangoFcFont *fcfont = PANGO_FC_FONT (pango_context_load_font (context_, pango_description_));
 137   FT_Face face = pango_fc_font_lock_face (fcfont);
 138   Box b = ly_FT_get_unscaled_indexed_char_dimensions (face, signed_idx);
 139   pango_fc_font_unlock_face (fcfont);
 140   return b;
 141 }
 142
 143 Box
 144 Pango_font::get_scaled_indexed_char_dimensions (size_t signed_idx) const
 145 {
 146   PangoFont *font = pango_context_load_font (context_, pango_description_);
 147   PangoRectangle logical_rect;
 148   PangoRectangle ink_rect;
 149   pango_font_get_glyph_extents (font, signed_idx, &ink_rect, &logical_rect);
 150   Box out (Interval (PANGO_LBEARING (ink_rect),
 151                      PANGO_RBEARING (ink_rect)),
 152            Interval (-PANGO_DESCENT (ink_rect),
 153                      PANGO_ASCENT (ink_rect)));
 154   out.scale (scale_);
 155   return out;
 156 }
 157
 158 Box
 159 Pango_font::get_glyph_outline_bbox (size_t signed_idx) const
 160 {
 161   PangoFcFont *fcfont = PANGO_FC_FONT (pango_context_load_font (context_, pango_description_));
 162   FT_Face face = pango_fc_font_lock_face (fcfont);
 163   Box b = ly_FT_get_glyph_outline_bbox (face, signed_idx);
 164   pango_fc_font_unlock_face (fcfont);
 165   return b;
 166 }
 167
 168 SCM
 169 Pango_font::get_glyph_outline (size_t signed_idx) const
 170 {
 171   PangoFcFont *fcfont = PANGO_FC_FONT (pango_context_load_font (context_, pango_description_));
 172   FT_Face face = pango_fc_font_lock_face (fcfont);
 173   SCM s = ly_FT_get_glyph_outline (face, signed_idx);
 174   pango_fc_font_unlock_face (fcfont);
 175   return s;
 176 }
 177
 178 Stencil
 179 Pango_font::pango_item_string_stencil (PangoGlyphItem const *glyph_item) const
 180 {
 181   const int GLYPH_NAME_LEN = 256;
 182   char glyph_name[GLYPH_NAME_LEN];
 183
 184   PangoAnalysis const *pa = &(glyph_item->item->analysis);
 185   PangoGlyphString *pgs = glyph_item->glyphs;
 186
 187   PangoRectangle logical_rect;
 188   PangoRectangle ink_rect;
 189   pango_glyph_string_extents (pgs, pa->font, &ink_rect, &logical_rect);
 190
 191   PangoFcFont *fcfont = PANGO_FC_FONT (pa->font);
 192   FT_Face ftface = pango_fc_font_lock_face (fcfont);
 193
 194   Box b (Interval (PANGO_LBEARING (logical_rect),
 195                    PANGO_RBEARING (logical_rect)),
 196          Interval (-PANGO_DESCENT (ink_rect),
 197                    PANGO_ASCENT (ink_rect)));
 198
 199   b.scale (scale_);
 200
 201   char const *ps_name_str0 = FT_Get_Postscript_Name (ftface);
 202   FcPattern *fcpat = fcfont->font_pattern;
 203
 204   FcChar8 *file_name_as_ptr = 0;
 205   FcPatternGetString (fcpat, FC_FILE, 0, &file_name_as_ptr);
 206
 207   // due to a bug in FreeType 2.3.7 and earlier we can't use
 208   // ftface->face_index; it is always zero for some font formats,
 209   // in particular TTCs which we are interested in
 210   int face_index = 0;
 211   FcPatternGetInteger (fcpat, FC_INDEX, 0, &face_index);
 212
 213   string file_name;
 214   if (file_name_as_ptr)
 215     // Normalize file name.
 216     file_name = File_name ((char const *)file_name_as_ptr).to_string ();
 217
 218   SCM glyph_exprs = SCM_EOL;
 219   SCM *tail = &glyph_exprs;
 220
 221   Index_to_charcode_map const *cmap = 0;
 222   bool has_glyph_names = ftface->face_flags & FT_FACE_FLAG_GLYPH_NAMES;
 223   if (!has_glyph_names)
 224     cmap = all_fonts_global->get_index_to_charcode_map (file_name, face_index, ftface);
 225
 226   bool is_ttf = string (FT_Get_X11_Font_Format (ftface)) == "TrueType";
 227   bool cid_keyed = false;
 228
 229   for (int i = 0; i < pgs->num_glyphs; i++)
 230     {
 231       PangoGlyphInfo *pgi = pgs->glyphs + i;
 232
 233       PangoGlyph pg = pgi->glyph;
 234       PangoGlyphGeometry ggeo = pgi->geometry;
 235
 236       /*
 237         Zero-width characters are valid Unicode characters,
 238         but glyph lookups need to be skipped.
 239       */
 240       if (!(pg ^ PANGO_GLYPH_EMPTY))
 241         continue;
 242
 243       glyph_name[0] = '\0';
 244       if (has_glyph_names)
 245         {
 246           FT_Error errorcode = FT_Get_Glyph_Name (ftface, pg, glyph_name,
 247                                                   GLYPH_NAME_LEN);
 248           if (errorcode)
 249             programming_error (_f ("FT_Get_Glyph_Name () error: %s",
 250                                    freetype_error_string (errorcode).c_str ()));
 251         }
 252
 253       SCM char_id = SCM_EOL;
 254       if (glyph_name[0] == '\0'
 255           && cmap
 256           && is_ttf
 257           && cmap->find (pg) != cmap->end ())
 258         {
 259           FT_ULong char_code = cmap->find (pg)->second;
 260           get_unicode_name (glyph_name, char_code);
 261         }
 262
 263       if (glyph_name[0] == '\0' && has_glyph_names)
 264         {
 265           programming_error (_f ("Glyph has no name, but font supports glyph naming.\n"
 266                                  "Skipping glyph U+%0X, file %s",
 267                                  pg, file_name.c_str ()));
 268           continue;
 269         }
 270
 271       if (glyph_name == string (".notdef") && is_ttf)
 272         glyph_name[0] = '\0';
 273
 274       if (glyph_name[0] == '\0' && is_ttf)
 275         // Access by glyph index directly.
 276         get_glyph_index_name (glyph_name, pg);
 277
 278       if (glyph_name[0] == '\0')
 279         {
 280           // CID entry
 281           cid_keyed = true;
 282           char_id = scm_from_uint32 (pg);
 283         }
 284       else
 285         char_id = scm_from_locale_string (glyph_name);
 286
 287       PangoRectangle logical_sub_rect;
 288       PangoRectangle ink_sub_rect;
 289
 290       pango_glyph_string_extents_range (pgs, i, i + 1, pa->font, &ink_sub_rect, &logical_sub_rect);
 291       Box b_sub (Interval (PANGO_LBEARING (logical_sub_rect),
 292                            PANGO_RBEARING (logical_sub_rect)),
 293                  Interval (-PANGO_DESCENT (ink_sub_rect),
 294                            PANGO_ASCENT (ink_sub_rect)));
 295
 296       b_sub.scale (scale_);
 297
 298       *tail = scm_cons (scm_list_5 (scm_from_double (b_sub[X_AXIS][RIGHT] - b_sub[X_AXIS][LEFT]),
 299                                     scm_cons (scm_from_double (b_sub[Y_AXIS][DOWN]),
 300                                               scm_from_double (b_sub[Y_AXIS][UP])),
 301                                     scm_from_double (ggeo.x_offset * scale_),
 302                                     scm_from_double (- ggeo.y_offset * scale_),
 303                                     char_id),
 304                         SCM_EOL);
 305       tail = SCM_CDRLOC (*tail);
 306     }
 307   pango_fc_font_unlock_face (fcfont);
 308   pango_glyph_string_free (pgs);
 309   pgs = 0;
 310   PangoFontDescription *descr = pango_font_describe (pa->font);
 311   Real size = pango_font_description_get_size (descr)
 312               / (Real (PANGO_SCALE));
 313
 314   if (!ps_name_str0)
 315     warning (_f ("no PostScript font name for font `%s'", file_name));
 316
 317   string ps_name;
 318   if (!ps_name_str0
 319       && file_name != ""
 320       && (file_name.find (".otf") != NPOS
 321           || file_name.find (".cff") != NPOS))
 322     {
 323       // UGH: kludge a PS name for OTF/CFF fonts.
 324       string name = file_name;
 325       ssize idx = file_name.find (".otf");
 326       if (idx == NPOS)
 327         idx = file_name.find (".cff");
 328
 329       name = name.substr (0, idx);
 330
 331       ssize slash_idx = name.rfind ('/');
 332       if (slash_idx != NPOS)
 333         {
 334           slash_idx++;
 335           name = name.substr (slash_idx,
 336                               name.length () - slash_idx);
 337         }
 338
 339       string initial = name.substr (0, 1);
 340       initial = String_convert::to_upper (initial);
 341       name = name.substr (1, name.length () - 1);
 342       name = String_convert::to_lower (name);
 343       ps_name = initial + name;
 344     }
 345   else if (ps_name_str0)
 346     ps_name = ps_name_str0;
 347
 348   if (ps_name.length ())
 349     {
 350       ((Pango_font *) this)->register_font_file (file_name,
 351                                                  ps_name,
 352                                                  face_index);
 353
 354       SCM expr = scm_list_n (ly_symbol2scm ("glyph-string"),
 355                              self_scm (),
 356                              ly_string2scm (ps_name),
 357                              scm_from_double (size),
 358                              scm_from_bool (cid_keyed),
 359                              ly_quote_scm (glyph_exprs),
 360                              SCM_UNDEFINED);
 361
 362       return Stencil (b, expr);
 363     }
 364
 365   warning (_ ("FreeType face has no PostScript font name"));
 366   return Stencil ();
 367 }
 368
 369 SCM
 370 Pango_font::physical_font_tab () const
 371 {
 372   return physical_font_tab_;
 373 }
 374
 375 extern bool music_strings_to_paths;
 376
 377 Stencil
 378 Pango_font::text_stencil (Output_def * /* state */,
 379                           string str, bool music_string) const
 380 {
 381   /*
 382     The text assigned to a PangoLayout is automatically divided
 383     into sections and reordered according to the Unicode
 384     Bidirectional Algorithm, if necessary.
 385   */
 386   PangoLayout *layout = pango_layout_new (context_);
 387   pango_layout_set_text (layout, str.c_str (), -1);
 388   GSList *lines = pango_layout_get_lines (layout);
 389
 390   Stencil dest;
 391   Real last_x = 0.0;
 392
 393   for (GSList *l = lines; l; l = l->next)
 394     {
 395       PangoLayoutLine *line = (PangoLayoutLine *) l->data;
 396       GSList *layout_runs = line->runs;
 397
 398       for (GSList *p = layout_runs; p; p = p->next)
 399         {
 400           PangoGlyphItem *item = (PangoGlyphItem *) p->data;
 401           Stencil item_stencil = pango_item_string_stencil (item);
 402
 403           item_stencil.translate_axis (last_x, X_AXIS);
 404           last_x = item_stencil.extent (X_AXIS)[RIGHT];
 405
 406 #if 0 // Check extents.
 407           if (!item_stencil.extent_box ()[X_AXIS].is_empty ())
 408             {
 409               Stencil frame = Lookup::frame (item_stencil.extent_box (), 0.1, 0.1);
 410               Box empty;
 411               empty.set_empty ();
 412               Stencil dimless_frame (empty, frame.expr ());
 413               dest.add_stencil (frame);
 414             }
 415 #endif
 416
 417           dest.add_stencil (item_stencil);
 418         }
 419     }
 420
 421   string name = get_output_backend_name ();
 422   string output_mod = "scm output-" + name;
 423   SCM mod = scm_c_resolve_module (output_mod.c_str ());
 424
 425   bool has_utf8_string = false;
 426
 427   if (ly_is_module (mod))
 428     {
 429       SCM utf8_string = ly_module_lookup (mod, ly_symbol2scm ("utf-8-string"));
 430       /*
 431         has_utf8_string should only be true when utf8_string is a
 432         variable that is bound to a *named* procedure, i.e. not a
 433         lambda expression.
 434       */
 435       if (utf8_string != SCM_BOOL_F
 436           && scm_procedure_name (SCM_VARIABLE_REF (utf8_string)) != SCM_BOOL_F)
 437         has_utf8_string = true;
 438     }
 439
 440   bool to_paths = music_strings_to_paths;
 441
 442   /*
 443     Backends with the utf-8-string expression use it when
 444       1) the -dmusic-strings-to-paths option is set
 445          and `str' is not a music string, or
 446       2) the -dmusic-strings-to-paths option is not set.
 447   */
 448   if (has_utf8_string && ((to_paths && !music_string) || !to_paths))
 449     {
 450       // For Pango based backends, we take a shortcut.
 451       SCM exp = scm_list_3 (ly_symbol2scm ("utf-8-string"),
 452                             ly_string2scm (description_string ()),
 453                             ly_string2scm (str));
 454
 455       Box b (Interval (0, 0), Interval (0, 0));
 456       b.unite (dest.extent_box ());
 457       return Stencil (b, exp);
 458     }
 459
 460   return dest;
 461 }
 462
 463 string
 464 Pango_font::description_string () const
 465 {
 466   char *descr_string = pango_font_description_to_string (pango_description_);
 467   string s (descr_string);
 468   g_free (descr_string);
 469   return s;
 470 }
 471
 472 SCM
 473 Pango_font::font_file_name () const
 474 {
 475   return SCM_BOOL_F;
 476 }
 477
 478 #endif // HAVE_PANGO_FT2