src/hb-ot-font.cc

   1 /*
   2  * Copyright © 2011,2014  Google, Inc.
   3  *
   4  *  This is part of HarfBuzz, a text shaping library.
   5  *
   6  * Permission is hereby granted, without written agreement and without
   7  * license or royalty fees, to use, copy, modify, and distribute this
   8  * software and its documentation for any purpose, provided that the
   9  * above copyright notice and the following two paragraphs appear in
  10  * all copies of this software.
  11  *
  12  * IN NO EVENT SHALL THE COPYRIGHT HOLDER BE LIABLE TO ANY PARTY FOR
  13  * DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES
  14  * ARISING OUT OF THE USE OF THIS SOFTWARE AND ITS DOCUMENTATION, EVEN
  15  * IF THE COPYRIGHT HOLDER HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
  16  * DAMAGE.
  17  *
  18  * THE COPYRIGHT HOLDER SPECIFICALLY DISCLAIMS ANY WARRANTIES, INCLUDING,
  19  * BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
  20  * FITNESS FOR A PARTICULAR PURPOSE.  THE SOFTWARE PROVIDED HEREUNDER IS
  21  * ON AN "AS IS" BASIS, AND THE COPYRIGHT HOLDER HAS NO OBLIGATION TO
  22  * PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
  23  *
  24  * Google Author(s): Behdad Esfahbod, Roozbeh Pournader
  25  */
  26
  27 #include "hb.hh"
  28
  29 #ifndef HB_NO_OT_FONT
  30
  31 #include "hb-ot.h"
  32
  33 #include "hb-font.hh"
  34 #include "hb-machinery.hh"
  35 #include "hb-ot-face.hh"
  36
  37 #include "hb-ot-cmap-table.hh"
  38 #include "hb-ot-glyf-table.hh"
  39 #include "hb-ot-cff1-table.hh"
  40 #include "hb-ot-cff2-table.hh"
  41 #include "hb-ot-hmtx-table.hh"
  42 #include "hb-ot-os2-table.hh"
  43 #include "hb-ot-post-table.hh"
  44 #include "hb-ot-stat-table.hh" // Just so we compile it; unused otherwise.
  45 #include "hb-ot-vorg-table.hh"
  46 #include "hb-ot-color-cbdt-table.hh"
  47 #include "hb-ot-color-sbix-table.hh"
  48
  49
  50 /**
  51  * SECTION:hb-ot-font
  52  * @title: hb-ot-font
  53  * @short_description: OpenType font implementation
  54  * @include: hb-ot.h
  55  *
  56  * Functions for using OpenType fonts with hb_shape().  Note that fonts returned
  57  * by hb_font_create() default to using these functions, so most clients would
  58  * never need to call these functions directly.
  59  **/
  60
  61
  62 static hb_bool_t
  63 hb_ot_get_nominal_glyph (hb_font_t *font HB_UNUSED,
  64                          void *font_data,
  65                          hb_codepoint_t unicode,
  66                          hb_codepoint_t *glyph,
  67                          void *user_data HB_UNUSED)
  68 {
  69   const hb_ot_face_t *ot_face = (const hb_ot_face_t *) font_data;
  70   return ot_face->cmap->get_nominal_glyph (unicode, glyph);
  71 }
  72
  73 static unsigned int
  74 hb_ot_get_nominal_glyphs (hb_font_t *font HB_UNUSED,
  75                           void *font_data,
  76                           unsigned int count,
  77                           const hb_codepoint_t *first_unicode,
  78                           unsigned int unicode_stride,
  79                           hb_codepoint_t *first_glyph,
  80                           unsigned int glyph_stride,
  81                           void *user_data HB_UNUSED)
  82 {
  83   const hb_ot_face_t *ot_face = (const hb_ot_face_t *) font_data;
  84   return ot_face->cmap->get_nominal_glyphs (count,
  85                                             first_unicode, unicode_stride,
  86                                             first_glyph, glyph_stride);
  87 }
  88
  89 static hb_bool_t
  90 hb_ot_get_variation_glyph (hb_font_t *font HB_UNUSED,
  91                            void *font_data,
  92                            hb_codepoint_t unicode,
  93                            hb_codepoint_t variation_selector,
  94                            hb_codepoint_t *glyph,
  95                            void *user_data HB_UNUSED)
  96 {
  97   const hb_ot_face_t *ot_face = (const hb_ot_face_t *) font_data;
  98   return ot_face->cmap->get_variation_glyph (unicode, variation_selector, glyph);
  99 }
 100
 101 static void
 102 hb_ot_get_glyph_h_advances (hb_font_t* font, void* font_data,
 103                             unsigned count,
 104                             const hb_codepoint_t *first_glyph,
 105                             unsigned glyph_stride,
 106                             hb_position_t *first_advance,
 107                             unsigned advance_stride,
 108                             void *user_data HB_UNUSED)
 109 {
 110   const hb_ot_face_t *ot_face = (const hb_ot_face_t *) font_data;
 111   const OT::hmtx_accelerator_t &hmtx = *ot_face->hmtx;
 112
 113   for (unsigned int i = 0; i < count; i++)
 114   {
 115     *first_advance = font->em_scale_x (hmtx.get_advance (*first_glyph, font));
 116     first_glyph = &StructAtOffsetUnaligned<hb_codepoint_t> (first_glyph, glyph_stride);
 117     first_advance = &StructAtOffsetUnaligned<hb_position_t> (first_advance, advance_stride);
 118   }
 119 }
 120
 121 #ifndef HB_NO_VERTICAL
 122 static void
 123 hb_ot_get_glyph_v_advances (hb_font_t* font, void* font_data,
 124                             unsigned count,
 125                             const hb_codepoint_t *first_glyph,
 126                             unsigned glyph_stride,
 127                             hb_position_t *first_advance,
 128                             unsigned advance_stride,
 129                             void *user_data HB_UNUSED)
 130 {
 131   const hb_ot_face_t *ot_face = (const hb_ot_face_t *) font_data;
 132   const OT::vmtx_accelerator_t &vmtx = *ot_face->vmtx;
 133
 134   for (unsigned int i = 0; i < count; i++)
 135   {
 136     *first_advance = font->em_scale_y (-(int) vmtx.get_advance (*first_glyph, font));
 137     first_glyph = &StructAtOffsetUnaligned<hb_codepoint_t> (first_glyph, glyph_stride);
 138     first_advance = &StructAtOffsetUnaligned<hb_position_t> (first_advance, advance_stride);
 139   }
 140 }
 141 #endif
 142
 143 #ifndef HB_NO_VERTICAL
 144 static hb_bool_t
 145 hb_ot_get_glyph_v_origin (hb_font_t *font,
 146                           void *font_data,
 147                           hb_codepoint_t glyph,
 148                           hb_position_t *x,
 149                           hb_position_t *y,
 150                           void *user_data HB_UNUSED)
 151 {
 152   const hb_ot_face_t *ot_face = (const hb_ot_face_t *) font_data;
 153
 154   *x = font->get_glyph_h_advance (glyph) / 2;
 155
 156   const OT::VORG &VORG = *ot_face->VORG;
 157   if (VORG.has_data ())
 158   {
 159     *y = font->em_scale_y (VORG.get_y_origin (glyph));
 160     return true;
 161   }
 162
 163   hb_glyph_extents_t extents = {0};
 164   if (ot_face->glyf->get_extents (font, glyph, &extents))
 165   {
 166     const OT::vmtx_accelerator_t &vmtx = *ot_face->vmtx;
 167     hb_position_t tsb = vmtx.get_side_bearing (font, glyph);
 168     *y = extents.y_bearing + font->em_scale_y (tsb);
 169     return true;
 170   }
 171
 172   hb_font_extents_t font_extents;
 173   font->get_h_extents_with_fallback (&font_extents);
 174   *y = font_extents.ascender;
 175
 176   return true;
 177 }
 178 #endif
 179
 180 static hb_bool_t
 181 hb_ot_get_glyph_extents (hb_font_t *font,
 182                          void *font_data,
 183                          hb_codepoint_t glyph,
 184                          hb_glyph_extents_t *extents,
 185                          void *user_data HB_UNUSED)
 186 {
 187   const hb_ot_face_t *ot_face = (const hb_ot_face_t *) font_data;
 188
 189 #if !defined(HB_NO_OT_FONT_BITMAP) && !defined(HB_NO_COLOR)
 190   if (ot_face->sbix->get_extents (font, glyph, extents)) return true;
 191 #endif
 192   if (ot_face->glyf->get_extents (font, glyph, extents)) return true;
 193 #ifndef HB_NO_OT_FONT_CFF
 194   if (ot_face->cff1->get_extents (font, glyph, extents)) return true;
 195   if (ot_face->cff2->get_extents (font, glyph, extents)) return true;
 196 #endif
 197 #if !defined(HB_NO_OT_FONT_BITMAP) && !defined(HB_NO_COLOR)
 198   if (ot_face->CBDT->get_extents (font, glyph, extents)) return true;
 199 #endif
 200
 201   // TODO Hook up side-bearings variations.
 202   return false;
 203 }
 204
 205 #ifndef HB_NO_OT_FONT_GLYPH_NAMES
 206 static hb_bool_t
 207 hb_ot_get_glyph_name (hb_font_t *font HB_UNUSED,
 208                       void *font_data,
 209                       hb_codepoint_t glyph,
 210                       char *name, unsigned int size,
 211                       void *user_data HB_UNUSED)
 212 {
 213   const hb_ot_face_t *ot_face = (const hb_ot_face_t *) font_data;
 214   if (ot_face->post->get_glyph_name (glyph, name, size)) return true;
 215 #ifndef HB_NO_OT_FONT_CFF
 216   if (ot_face->cff1->get_glyph_name (glyph, name, size)) return true;
 217 #endif
 218   return false;
 219 }
 220 static hb_bool_t
 221 hb_ot_get_glyph_from_name (hb_font_t *font HB_UNUSED,
 222                            void *font_data,
 223                            const char *name, int len,
 224                            hb_codepoint_t *glyph,
 225                            void *user_data HB_UNUSED)
 226 {
 227   const hb_ot_face_t *ot_face = (const hb_ot_face_t *) font_data;
 228   if (ot_face->post->get_glyph_from_name (name, len, glyph)) return true;
 229 #ifndef HB_NO_OT_FONT_CFF
 230     if (ot_face->cff1->get_glyph_from_name (name, len, glyph)) return true;
 231 #endif
 232   return false;
 233 }
 234 #endif
 235
 236 static hb_bool_t
 237 hb_ot_get_font_h_extents (hb_font_t *font,
 238                           void *font_data HB_UNUSED,
 239                           hb_font_extents_t *metrics,
 240                           void *user_data HB_UNUSED)
 241 {
 242   return _hb_ot_metrics_get_position_common (font, HB_OT_METRICS_TAG_HORIZONTAL_ASCENDER, &metrics->ascender) &&
 243          _hb_ot_metrics_get_position_common (font, HB_OT_METRICS_TAG_HORIZONTAL_DESCENDER, &metrics->descender) &&
 244          _hb_ot_metrics_get_position_common (font, HB_OT_METRICS_TAG_HORIZONTAL_LINE_GAP, &metrics->line_gap);
 245 }
 246
 247 #ifndef HB_NO_VERTICAL
 248 static hb_bool_t
 249 hb_ot_get_font_v_extents (hb_font_t *font,
 250                           void *font_data HB_UNUSED,
 251                           hb_font_extents_t *metrics,
 252                           void *user_data HB_UNUSED)
 253 {
 254   return _hb_ot_metrics_get_position_common (font, HB_OT_METRICS_TAG_VERTICAL_ASCENDER, &metrics->ascender) &&
 255          _hb_ot_metrics_get_position_common (font, HB_OT_METRICS_TAG_VERTICAL_DESCENDER, &metrics->descender) &&
 256          _hb_ot_metrics_get_position_common (font, HB_OT_METRICS_TAG_VERTICAL_LINE_GAP, &metrics->line_gap);
 257 }
 258 #endif
 259
 260 static inline void free_static_ot_funcs ();
 261
 262 static struct hb_ot_font_funcs_lazy_loader_t : hb_font_funcs_lazy_loader_t<hb_ot_font_funcs_lazy_loader_t>
 263 {
 264   static hb_font_funcs_t *create ()
 265   {
 266     hb_font_funcs_t *funcs = hb_font_funcs_create ();
 267
 268     hb_font_funcs_set_nominal_glyph_func (funcs, hb_ot_get_nominal_glyph, nullptr, nullptr);
 269     hb_font_funcs_set_nominal_glyphs_func (funcs, hb_ot_get_nominal_glyphs, nullptr, nullptr);
 270     hb_font_funcs_set_variation_glyph_func (funcs, hb_ot_get_variation_glyph, nullptr, nullptr);
 271
 272     hb_font_funcs_set_font_h_extents_func (funcs, hb_ot_get_font_h_extents, nullptr, nullptr);
 273     hb_font_funcs_set_glyph_h_advances_func (funcs, hb_ot_get_glyph_h_advances, nullptr, nullptr);
 274     //hb_font_funcs_set_glyph_h_origin_func (funcs, hb_ot_get_glyph_h_origin, nullptr, nullptr);
 275
 276 #ifndef HB_NO_VERTICAL
 277     hb_font_funcs_set_font_v_extents_func (funcs, hb_ot_get_font_v_extents, nullptr, nullptr);
 278     hb_font_funcs_set_glyph_v_advances_func (funcs, hb_ot_get_glyph_v_advances, nullptr, nullptr);
 279     hb_font_funcs_set_glyph_v_origin_func (funcs, hb_ot_get_glyph_v_origin, nullptr, nullptr);
 280 #endif
 281
 282     hb_font_funcs_set_glyph_extents_func (funcs, hb_ot_get_glyph_extents, nullptr, nullptr);
 283     //hb_font_funcs_set_glyph_contour_point_func (funcs, hb_ot_get_glyph_contour_point, nullptr, nullptr);
 284
 285 #ifndef HB_NO_OT_FONT_GLYPH_NAMES
 286     hb_font_funcs_set_glyph_name_func (funcs, hb_ot_get_glyph_name, nullptr, nullptr);
 287     hb_font_funcs_set_glyph_from_name_func (funcs, hb_ot_get_glyph_from_name, nullptr, nullptr);
 288 #endif
 289
 290     hb_font_funcs_make_immutable (funcs);
 291
 292     hb_atexit (free_static_ot_funcs);
 293
 294     return funcs;
 295   }
 296 } static_ot_funcs;
 297
 298 static inline
 299 void free_static_ot_funcs ()
 300 {
 301   static_ot_funcs.free_instance ();
 302 }
 303
 304 static hb_font_funcs_t *
 305 _hb_ot_get_font_funcs ()
 306 {
 307   return static_ot_funcs.get_unconst ();
 308 }
 309
 310
 311 /**
 312  * hb_ot_font_set_funcs:
 313  * @font: #hb_font_t to work upon
 314  *
 315  * Sets the font functions to use when working with @font.
 316  *
 317  * Since: 0.9.28
 318  **/
 319 void
 320 hb_ot_font_set_funcs (hb_font_t *font)
 321 {
 322   hb_font_set_funcs (font,
 323                      _hb_ot_get_font_funcs (),
 324                      &font->face->table,
 325                      nullptr);
 326 }
 327
 328 #ifndef HB_NO_VAR
 329 int
 330 _glyf_get_side_bearing_var (hb_font_t *font, hb_codepoint_t glyph, bool is_vertical)
 331 {
 332   return font->face->table.glyf->get_side_bearing_var (font, glyph, is_vertical);
 333 }
 334
 335 unsigned
 336 _glyf_get_advance_var (hb_font_t *font, hb_codepoint_t glyph, bool is_vertical)
 337 {
 338   return font->face->table.glyf->get_advance_var (font, glyph, is_vertical);
 339 }
 340 #endif
 341
 342
 343 #endif