lily/open-type-font.cc

   1 /*
   2   This file is part of LilyPond, the GNU music typesetter.
   3
   4   Copyright (C) 2004--2015 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 #include "open-type-font.hh"
  21 #include "freetype.hh"
  22
  23 #ifdef FT_FONT_FORMATS_H
  24 /* FreeType 2.6+ */
  25 #include FT_FONT_FORMATS_H
  26 #else
  27 /* FreeType 2.5.5 and earlier */
  28 #include FT_XFREE86_H
  29 #define FT_Get_Font_Format FT_Get_X11_Font_Format
  30 #endif
  31
  32 #include <cstdio>
  33
  34 using namespace std;
  35
  36 #include FT_TRUETYPE_TABLES_H
  37
  38 #include "dimensions.hh"
  39 #include "international.hh"
  40 #include "modified-font-metric.hh"
  41 #include "warn.hh"
  42
  43 FT_Byte *
  44 load_table (char const *tag_str, FT_Face face, FT_ULong *length)
  45 {
  46   *length = 0;
  47   FT_ULong tag = FT_MAKE_TAG (tag_str[0], tag_str[1], tag_str[2], tag_str[3]);
  48
  49   FT_Error error_code = FT_Load_Sfnt_Table (face, tag, 0, NULL, length);
  50   if (!error_code)
  51     {
  52       FT_Byte *buffer = (FT_Byte *) malloc (*length);
  53       if (buffer == NULL)
  54         error (_f ("cannot allocate %lu bytes", *length));
  55
  56       error_code = FT_Load_Sfnt_Table (face, tag, 0, buffer, length);
  57       if (error_code)
  58         error (_f ("cannot load font table: %s", tag_str));
  59
  60       return buffer;
  61     }
  62   else
  63     programming_error (_f ("FreeType error: %s",
  64                            freetype_error_string (error_code).c_str ()
  65                           ));
  66
  67   return 0;
  68 }
  69
  70 string
  71 Open_type_font::get_otf_table (const string &tag) const
  72 {
  73   return ::get_otf_table (face_, tag);
  74 }
  75
  76 SCM
  77 load_scheme_table (char const *tag_str, FT_Face face)
  78 {
  79   FT_ULong length = 0;
  80   FT_Byte *buffer = load_table (tag_str, face, &length);
  81
  82   SCM tab = SCM_EOL;
  83   if (buffer)
  84     {
  85       string contents ((char const *)buffer, length);
  86       contents = "(quote (" + contents + "))";
  87
  88 #if GUILEV2
  89       tab = scm_eval_string (scm_from_utf8_string (contents.c_str ()));
  90 #else
  91       tab = scm_c_eval_string (contents.c_str ());
  92 #endif
  93       free (buffer);
  94     }
  95   return tab;
  96 }
  97
  98 Open_type_font::~Open_type_font ()
  99 {
 100   FT_Done_Face (face_);
 101 }
 102
 103 /*
 104   UGH fix naming
 105 */
 106 string
 107 get_otf_table (FT_Face face, const string &tag)
 108 {
 109   FT_ULong len;
 110   FT_Byte *tab = load_table (tag.c_str (), face, &len);
 111   string ret ((char const *) tab, len);
 112   free (tab);
 113
 114   return ret;
 115 }
 116
 117 FT_Face
 118 open_ft_face (const string &str, FT_Long idx)
 119 {
 120   FT_Face face;
 121   FT_Error error_code = FT_New_Face (freetype2_library, str.c_str (), idx, &face);
 122
 123   if (error_code == FT_Err_Unknown_File_Format)
 124     error (_f ("unsupported font format: %s", str.c_str ()));
 125   else if (error_code)
 126     error (_f ("error reading font file %s: %s",
 127                str.c_str (),
 128                freetype_error_string (error_code).c_str ()));
 129   return face;
 130 }
 131
 132 string
 133 get_postscript_name (FT_Face face)
 134 {
 135   string face_ps_name;
 136   const char *psname = FT_Get_Postscript_Name (face);
 137   if (psname)
 138     face_ps_name = psname;
 139   else
 140     {
 141       warning (_ ("cannot get postscript name"));
 142       return "";
 143     }
 144
 145   const char *fmt = FT_Get_Font_Format (face);
 146   if (fmt)
 147     {
 148       if (static_cast<string>(fmt) != "CFF")
 149         return face_ps_name;  // For non-CFF font, pass it through.
 150     }
 151   else
 152     {
 153       warning (_f ("cannot get font %s format", face_ps_name.c_str ()));
 154       return face_ps_name;
 155     }
 156
 157   // For OTF and OTC fonts, we use data from the font's 'CFF' table only
 158   // because other tables are not embedded in the output PS file.
 159   string cff_table = get_otf_table (face, "CFF ");
 160
 161   FT_Open_Args args;
 162   args.flags = FT_OPEN_MEMORY;
 163   args.memory_base = static_cast<const FT_Byte*>
 164     (static_cast<const void*>(cff_table.data ()));
 165   args.memory_size = cff_table.size ();
 166
 167   FT_Face cff_face;
 168   // According to OpenType Specification ver 1.7,
 169   // the CFF (derived from OTF and OTC) has only one name.
 170   // So we use zero as the font index.
 171   FT_Error error_code = FT_Open_Face (freetype2_library, &args,
 172                                       0 /* font index */,
 173                                       &cff_face);
 174   if (error_code)
 175     {
 176       warning (_f ("cannot read CFF %s: %s",
 177                    face_ps_name,
 178                    freetype_error_string (error_code).c_str ()));
 179       return face_ps_name;
 180     }
 181
 182   string ret;
 183   const char *cffname = FT_Get_Postscript_Name (cff_face);
 184   if (cffname)
 185     ret = cffname;
 186   else
 187     {
 188       // FreeType 2.6 and 2.6.1 cannot get PS name from pure-CFF.
 189       // (FreeType 2.5.5 and earlier does not have this issue.
 190       //  FreeType 2.6.2+ has this bug fixed.)
 191       // So we need direct parsing of the 'CFF' table, in this case.
 192
 193       debug_output (_f ("Directly parsing 'CFF' table of font %s.",
 194                         face_ps_name.c_str ()));
 195
 196       // See Adobe technote '5176.CFF.pdf', sections 2 and 5-7.
 197       size_t hdrsize = static_cast<unsigned char>(cff_table.at(2));
 198       string::iterator it = cff_table.begin () + hdrsize;
 199
 200       unsigned int name_index_count;
 201       name_index_count = static_cast<unsigned char>(*it++) << 8;
 202       name_index_count |= static_cast<unsigned char>(*it++);
 203
 204       size_t offsize = static_cast<unsigned char>(*it++);
 205
 206       if (name_index_count && 1 <= offsize && offsize <= 4)
 207         {
 208           // We get the first name in the CFF's name index
 209           // because this CFF (derived from OTF and OTC)
 210           // has only one name.
 211           size_t off1 = 0, off2 = 0;
 212           for (size_t t = 0; t < offsize; t++)
 213             off1 = ( off1 << 8 ) | static_cast<unsigned char>(*it++);
 214           if (off1)
 215             {
 216               for (size_t t = 0; t < offsize; t++)
 217                 off2 = ( off2 << 8 ) | static_cast<unsigned char>(*it++);
 218             }
 219           if (off1 && off1 < off2)
 220             {
 221               ret.assign (&cff_table.at(hdrsize + 3
 222                                         + offsize * (name_index_count + 1)
 223                                         + off1 - 1),
 224                           &cff_table.at(hdrsize + 3
 225                                         + offsize * (name_index_count + 1)
 226                                         + off2 - 1));
 227             }
 228         }
 229
 230       if (ret.empty ())
 231         {
 232           warning (_f ("cannot get font %s CFF name", face_ps_name.c_str ()));
 233           ret = face_ps_name;
 234         }
 235     }
 236
 237   debug_output (_f ("Replace font name from %s to %s.",
 238                     face_ps_name.c_str (), ret.c_str ()));
 239
 240   FT_Done_Face (cff_face);
 241
 242   return ret;
 243 }
 244
 245 SCM
 246 Open_type_font::make_otf (const string &str)
 247 {
 248   FT_Face face = open_ft_face (str, 0 /* index */);
 249   Open_type_font *otf = new Open_type_font (face);
 250
 251   return otf->self_scm ();
 252 }
 253
 254 void
 255 Open_type_font::pre_init ()
 256 {
 257   lily_character_table_ = SCM_EOL;
 258   lily_global_table_ = SCM_EOL;
 259   lily_subfonts_ = SCM_EOL;
 260   lily_index_to_bbox_table_ = SCM_EOL;
 261 }
 262
 263 Open_type_font::Open_type_font (FT_Face face)
 264 {
 265   face_ = face;
 266
 267   lily_character_table_ = alist_to_hashq (load_scheme_table ("LILC", face_));
 268   lily_global_table_ = alist_to_hashq (load_scheme_table ("LILY", face_));
 269   lily_subfonts_ = load_scheme_table ("LILF", face_);
 270   index_to_charcode_map_ = make_index_to_charcode_map (face_);
 271
 272   lily_index_to_bbox_table_ = scm_c_make_hash_table (257);
 273
 274   postscript_name_ = get_postscript_name (face_);
 275 }
 276
 277 void
 278 Open_type_font::derived_mark () const
 279 {
 280   scm_gc_mark (lily_character_table_);
 281   scm_gc_mark (lily_global_table_);
 282   scm_gc_mark (lily_subfonts_);
 283   scm_gc_mark (lily_index_to_bbox_table_);
 284 }
 285
 286 Offset
 287 Open_type_font::attachment_point (const string &glyph_name) const
 288 {
 289   SCM sym = ly_symbol2scm (glyph_name.c_str ());
 290   SCM entry = scm_hashq_ref (lily_character_table_, sym, SCM_BOOL_F);
 291
 292   Offset o;
 293   if (scm_is_false (entry))
 294     return o;
 295
 296   SCM char_alist = entry;
 297   SCM att_scm = scm_cdr (scm_assq (ly_symbol2scm ("attachment"), char_alist));
 298
 299   return point_constant * ly_scm2offset (att_scm);
 300 }
 301
 302 Box
 303 Open_type_font::get_indexed_char_dimensions (size_t signed_idx) const
 304 {
 305   if (SCM_HASHTABLE_P (lily_index_to_bbox_table_))
 306     {
 307       SCM box = scm_hashq_ref (lily_index_to_bbox_table_,
 308                                scm_from_unsigned_integer (signed_idx), SCM_BOOL_F);
 309       Box *box_ptr = unsmob<Box> (box);
 310       if (box_ptr)
 311         return *box_ptr;
 312     }
 313
 314   if (SCM_HASHTABLE_P (lily_character_table_))
 315     {
 316       const size_t len = 256;
 317       char name[len];
 318       FT_Error code = FT_Get_Glyph_Name (face_, FT_UInt (signed_idx),
 319                                          name, FT_UInt (len));
 320       if (code)
 321         warning (_f ("FT_Get_Glyph_Name () Freetype error: %s",
 322                      freetype_error_string (code)));
 323
 324       SCM sym = ly_symbol2scm (name);
 325       SCM alist = scm_hashq_ref (lily_character_table_, sym, SCM_BOOL_F);
 326
 327       if (scm_is_true (alist))
 328         {
 329           SCM bbox = scm_cdr (scm_assq (ly_symbol2scm ("bbox"), alist));
 330
 331           Box b;
 332           b[X_AXIS][LEFT] = scm_to_double (scm_car (bbox));
 333           bbox = scm_cdr (bbox);
 334           b[Y_AXIS][LEFT] = scm_to_double (scm_car (bbox));
 335           bbox = scm_cdr (bbox);
 336           b[X_AXIS][RIGHT] = scm_to_double (scm_car (bbox));
 337           bbox = scm_cdr (bbox);
 338           b[Y_AXIS][RIGHT] = scm_to_double (scm_car (bbox));
 339           bbox = scm_cdr (bbox);
 340
 341           b.scale (point_constant);
 342
 343           scm_hashq_set_x (lily_index_to_bbox_table_,
 344                            scm_from_unsigned_integer (signed_idx),
 345                            b.smobbed_copy ());
 346           return b;
 347         }
 348     }
 349
 350   Box b = get_unscaled_indexed_char_dimensions (signed_idx);
 351
 352   b.scale (design_size () / Real (face_->units_per_EM));
 353   return b;
 354 }
 355
 356 Real
 357 Open_type_font::get_units_per_EM () const
 358 {
 359   return face_->units_per_EM;
 360 }
 361
 362 size_t
 363 Open_type_font::name_to_index (string nm) const
 364 {
 365   char *nm_str = (char *) nm.c_str ();
 366   if (FT_UInt idx = FT_Get_Name_Index (face_, nm_str))
 367     return (size_t) idx;
 368
 369   return (size_t) - 1;
 370 }
 371
 372 Box
 373 Open_type_font::get_unscaled_indexed_char_dimensions (size_t signed_idx) const
 374 {
 375   return ly_FT_get_unscaled_indexed_char_dimensions (face_, signed_idx);
 376 }
 377
 378 Box
 379 Open_type_font::get_glyph_outline_bbox (size_t signed_idx) const
 380 {
 381   return ly_FT_get_glyph_outline_bbox (face_, signed_idx);
 382 }
 383
 384 SCM
 385 Open_type_font::get_glyph_outline (size_t signed_idx) const
 386 {
 387   return ly_FT_get_glyph_outline (face_, signed_idx);
 388 }
 389
 390 size_t
 391 Open_type_font::index_to_charcode (size_t i) const
 392 {
 393   map<FT_UInt, FT_ULong>::const_iterator iter;
 394   iter = index_to_charcode_map_.find (FT_UInt (i));
 395
 396   if (iter != index_to_charcode_map_.end ())
 397     return (size_t) iter->second;
 398   else
 399     {
 400       programming_error ("Invalid index for character");
 401       return 0;
 402     }
 403 }
 404
 405 size_t
 406 Open_type_font::count () const
 407 {
 408   return index_to_charcode_map_.size ();
 409 }
 410
 411 Real
 412 Open_type_font::design_size () const
 413 {
 414   SCM entry = scm_hashq_ref (lily_global_table_,
 415                              ly_symbol2scm ("design_size"),
 416
 417                              /*
 418                                Hmm. Design size is arbitrary for
 419                                non-design-size fonts. I vote for 1 -
 420                                which will trip errors more
 421                                quickly. --hwn.
 422                              */
 423                              scm_from_unsigned_integer (1));
 424   return scm_to_double (entry) * Real (point_constant);
 425 }
 426
 427 SCM
 428 Open_type_font::sub_fonts () const
 429 {
 430   return lily_subfonts_;
 431 }
 432
 433 SCM
 434 Open_type_font::get_char_table () const
 435 {
 436   return lily_character_table_;
 437 }
 438
 439 SCM
 440 Open_type_font::get_subfonts () const
 441 {
 442   return lily_subfonts_;
 443 }
 444
 445 SCM
 446 Open_type_font::get_global_table () const
 447 {
 448   return lily_global_table_;
 449 }
 450
 451 string
 452 Open_type_font::font_name () const
 453 {
 454   return postscript_name_;
 455 }
 456
 457 SCM
 458 Open_type_font::glyph_list () const
 459 {
 460   SCM retval = SCM_EOL;
 461   SCM *tail = &retval;
 462
 463   for (int i = 0; i < face_->num_glyphs; i++)
 464     {
 465       const size_t len = 256;
 466       char name[len];
 467       FT_Error code = FT_Get_Glyph_Name (face_, i, name, len);
 468       if (code)
 469         warning (_f ("FT_Get_Glyph_Name () error: %s",
 470                      freetype_error_string (code).c_str ()));
 471
 472       *tail = scm_cons (scm_from_ascii_string (name), SCM_EOL);
 473       tail = SCM_CDRLOC (*tail);
 474     }
 475
 476   return retval;
 477 }