Coverage Report

Created: 2026-05-30 06:20

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/harfbuzz/src/hb-ot-post-table.hh
Line
Count
Source
1
/*
2
 * Copyright © 2016  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
25
 */
26
27
#ifndef HB_OT_POST_TABLE_HH
28
#define HB_OT_POST_TABLE_HH
29
30
#include "hb-open-type.hh"
31
#include "hb-ot-var-mvar-table.hh"
32
33
#define HB_STRING_ARRAY_NAME format1_names
34
#define HB_STRING_ARRAY_LIST "hb-ot-post-macroman.hh"
35
#include "hb-string-array.hh"
36
#undef HB_STRING_ARRAY_LIST
37
#undef HB_STRING_ARRAY_NAME
38
39
/*
40
 * post -- PostScript
41
 * https://docs.microsoft.com/en-us/typography/opentype/spec/post
42
 */
43
#define HB_OT_TAG_post HB_TAG('p','o','s','t')
44
45
46
namespace OT {
47
48
49
struct postV2Tail
50
{
51
  friend struct post;
52
53
  bool sanitize (hb_sanitize_context_t *c) const
54
0
  {
55
0
    TRACE_SANITIZE (this);
56
0
    return_trace (glyphNameIndex.sanitize (c));
57
0
  }
58
59
  template<typename Iterator>
60
  bool serialize (hb_serialize_context_t *c,
61
                  Iterator it,
62
                  const void* _post) const;
63
64
  bool subset (hb_subset_context_t *c) const;
65
66
  protected:
67
  Array16Of<HBUINT16> glyphNameIndex; /* This is not an offset, but is the
68
           * ordinal number of the glyph in 'post'
69
           * string tables. */
70
/*UnsizedArrayOf<HBUINT8>
71
      namesX;*/ /* Glyph names with length bytes [variable]
72
           * (a Pascal string). */
73
74
  public:
75
  DEFINE_SIZE_ARRAY (2, glyphNameIndex);
76
};
77
78
struct post
79
{
80
  static constexpr hb_tag_t tableTag = HB_OT_TAG_post;
81
82
  bool serialize (hb_serialize_context_t *c, bool glyph_names) const
83
0
  {
84
0
    TRACE_SERIALIZE (this);
85
0
    post *post_prime = c->allocate_min<post> ();
86
0
    if (unlikely (!post_prime))  return_trace (false);
87
0
88
0
    hb_memcpy (post_prime, this, post::min_size);
89
0
    if (!glyph_names)
90
0
      return_trace (c->check_assign (post_prime->version.major, 3,
91
0
                                     HB_SERIALIZE_ERROR_INT_OVERFLOW)); // Version 3 does not have any glyph names.
92
0
93
0
    return_trace (true);
94
0
  }
95
96
  bool subset (hb_subset_context_t *c) const
97
0
  {
98
0
    TRACE_SUBSET (this);
99
0
    auto *post_prime = c->serializer->start_embed<post> ();
100
0
101
0
    bool glyph_names = c->plan->flags & HB_SUBSET_FLAGS_GLYPH_NAMES;
102
0
    if (!serialize (c->serializer, glyph_names))
103
0
      return_trace (false);
104
0
105
0
#ifndef HB_NO_VAR
106
0
    if (c->plan->normalized_coords)
107
0
    {
108
0
      auto &MVAR = *c->plan->source->table.MVAR;
109
0
      auto *table = post_prime;
110
0
111
0
      HB_ADD_MVAR_VAR (HB_OT_METRICS_TAG_UNDERLINE_SIZE,   underlineThickness);
112
0
      HB_ADD_MVAR_VAR (HB_OT_METRICS_TAG_UNDERLINE_OFFSET, underlinePosition);
113
0
    }
114
0
#endif
115
0
116
0
    Triple *axis_range;
117
0
    if (c->plan->user_axes_location.has (HB_TAG ('s','l','n','t'), &axis_range))
118
0
    {
119
0
      float italic_angle = hb_max (-90.0, hb_min (axis_range->middle, 90.0));
120
0
      if (post_prime->italicAngle.to_float () != italic_angle)
121
0
        post_prime->italicAngle.set_float (italic_angle);
122
0
    }
123
0
124
0
    if (glyph_names && version.major == 2)
125
0
    {
126
0
      hb_barrier ();
127
0
      return_trace (v2X.subset (c));
128
0
    }
129
0
130
0
    return_trace (true);
131
0
  }
132
133
  struct accelerator_t
134
  {
135
    friend struct postV2Tail;
136
137
    accelerator_t (hb_face_t *face)
138
0
    {
139
0
      table = hb_sanitize_context_t ().reference_table<post> (face);
140
0
      unsigned int table_length = table.get_length ();
141
142
0
      version = table->version.to_int ();
143
0
      if (version != 0x00020000) return;
144
0
      hb_barrier ();
145
146
0
      const postV2Tail &v2 = table->v2X;
147
148
0
      glyphNameIndex = &v2.glyphNameIndex;
149
0
      pool = &StructAfter<uint8_t> (v2.glyphNameIndex);
150
151
0
      const uint8_t *end = (const uint8_t *) (const void *) table + table_length;
152
0
      index_to_offset.alloc (hb_min (face->get_num_glyphs (), table_length / 8));
153
0
      for (const uint8_t *data = pool;
154
0
     index_to_offset.length < 65535 && data < end && data + *data < end;
155
0
     data += 1 + *data)
156
0
  index_to_offset.push (data - pool);
157
0
    }
158
    ~accelerator_t ()
159
0
    {
160
0
      hb_free (gids_sorted_by_name.get_acquire ());
161
0
      table.destroy ();
162
0
    }
163
164
    bool get_glyph_name (hb_codepoint_t glyph,
165
       char *buf, unsigned int buf_len) const
166
0
    {
167
0
      hb_bytes_t s = find_glyph_name (glyph);
168
0
      if (!s.length) return false;
169
0
      if (!buf_len) return true;
170
0
      unsigned int len = hb_min (buf_len - 1, s.length);
171
0
      strncpy (buf, s.arrayZ, len);
172
0
      buf[len] = '\0';
173
0
      return true;
174
0
    }
175
176
    bool get_glyph_from_name (const char *name, int len,
177
            hb_codepoint_t *glyph) const
178
0
    {
179
0
      unsigned int count = get_glyph_count ();
180
0
      if (unlikely (!count)) return false;
181
182
0
      if (len < 0) len = strlen (name);
183
184
0
      if (unlikely (!len)) return false;
185
186
0
    retry:
187
0
      uint16_t *gids = gids_sorted_by_name.get_acquire ();
188
189
0
      if (unlikely (!gids))
190
0
      {
191
0
  gids = (uint16_t *) hb_malloc (count * sizeof (gids[0]));
192
0
  if (unlikely (!gids))
193
0
    return false; /* Anything better?! */
194
195
0
  for (unsigned int i = 0; i < count; i++)
196
0
    gids[i] = i;
197
0
  auto thiz = this;
198
0
  hb_array_t<uint16_t> (gids, count)
199
0
    .qsort ([thiz] (const uint16_t &a, const uint16_t &b) {
200
      /* hb_array_t::cmp has reversed argument order, so
201
       * x.cmp(y) returns sign of (y - x).  Pass (b, a) to
202
       * get standard "negative when a < b" ordering. */
203
0
      return thiz->find_glyph_name (b).cmp (thiz->find_glyph_name (a));
204
0
    });
205
206
0
  if (unlikely (!gids_sorted_by_name.cmpexch (nullptr, gids)))
207
0
  {
208
0
    hb_free (gids);
209
0
    goto retry;
210
0
  }
211
0
      }
212
213
0
      hb_bytes_t st (name, len);
214
0
      auto* gid = hb_bsearch (st, gids, count, sizeof (gids[0]), cmp_key, (void *) this);
215
0
      if (gid)
216
0
      {
217
0
  *glyph = *gid;
218
0
  return true;
219
0
      }
220
221
0
      return false;
222
0
    }
223
224
    hb_blob_ptr_t<post> table;
225
226
    protected:
227
228
    unsigned int get_glyph_count () const
229
0
    {
230
0
      if (version == 0x00010000)
231
0
      {
232
0
        hb_barrier ();
233
0
  return format1_names_length;
234
0
      }
235
236
0
      if (version == 0x00020000)
237
0
      {
238
0
        hb_barrier ();
239
0
  return glyphNameIndex->len;
240
0
      }
241
242
0
      return 0;
243
0
    }
244
245
    static int cmp_key (const void *pk, const void *po, void *arg)
246
0
    {
247
0
      const accelerator_t *thiz = (const accelerator_t *) arg;
248
0
      const hb_bytes_t *key = (const hb_bytes_t *) pk;
249
0
      uint16_t o = * (const uint16_t *) po;
250
0
      return thiz->find_glyph_name (o).cmp (*key);
251
0
    }
252
253
    hb_bytes_t find_glyph_name (hb_codepoint_t glyph) const
254
0
    {
255
0
      if (version == 0x00010000)
256
0
      {
257
0
        hb_barrier ();
258
0
  if (glyph >= format1_names_length)
259
0
    return hb_bytes_t ();
260
261
0
  return format1_names (glyph);
262
0
      }
263
264
0
      if (version != 0x00020000)
265
0
  return hb_bytes_t ();
266
0
      hb_barrier ();
267
268
0
      if (glyph >= glyphNameIndex->len)
269
0
  return hb_bytes_t ();
270
271
0
      unsigned int index = glyphNameIndex->arrayZ[glyph];
272
0
      if (index < format1_names_length)
273
0
  return format1_names (index);
274
0
      index -= format1_names_length;
275
276
0
      if (index >= index_to_offset.length)
277
0
  return hb_bytes_t ();
278
0
      unsigned int offset = index_to_offset[index];
279
280
0
      const uint8_t *data = pool + offset;
281
0
      unsigned int name_length = *data;
282
0
      data++;
283
284
0
      return hb_bytes_t ((const char *) data, name_length);
285
0
    }
286
287
    private:
288
    uint32_t version;
289
    const Array16Of<HBUINT16> *glyphNameIndex = nullptr;
290
    hb_vector_t<uint32_t> index_to_offset;
291
    const uint8_t *pool = nullptr;
292
    mutable hb_atomic_t<uint16_t *> gids_sorted_by_name;
293
  };
294
295
0
  bool has_data () const { return version.to_int (); }
296
297
  bool sanitize (hb_sanitize_context_t *c) const
298
0
  {
299
0
    TRACE_SANITIZE (this);
300
0
    return_trace (c->check_struct (this) &&
301
0
      hb_barrier () &&
302
0
      (version.to_int () == 0x00010000 ||
303
0
       (version.to_int () == 0x00020000 && hb_barrier () && v2X.sanitize (c)) ||
304
0
       version.to_int () == 0x00030000));
305
0
  }
306
307
  public:
308
  FixedVersion<>version;    /* 0x00010000 for version 1.0
309
           * 0x00020000 for version 2.0
310
           * 0x00025000 for version 2.5 (deprecated)
311
           * 0x00030000 for version 3.0 */
312
  F16DOT16  italicAngle;    /* Italic angle in counter-clockwise degrees
313
           * from the vertical. Zero for upright text,
314
           * negative for text that leans to the right
315
           * (forward). */
316
  FWORD   underlinePosition;  /* This is the suggested distance of the top
317
           * of the underline from the baseline
318
           * (negative values indicate below baseline).
319
           * The PostScript definition of this FontInfo
320
           * dictionary key (the y coordinate of the
321
           * center of the stroke) is not used for
322
           * historical reasons. The value of the
323
           * PostScript key may be calculated by
324
           * subtracting half the underlineThickness
325
           * from the value of this field. */
326
  FWORD   underlineThickness; /* Suggested values for the underline
327
             thickness. */
328
  HBUINT32  isFixedPitch;   /* Set to 0 if the font is proportionally
329
           * spaced, non-zero if the font is not
330
           * proportionally spaced (i.e. monospaced). */
331
  HBUINT32  minMemType42;   /* Minimum memory usage when an OpenType font
332
           * is downloaded. */
333
  HBUINT32  maxMemType42;   /* Maximum memory usage when an OpenType font
334
           * is downloaded. */
335
  HBUINT32  minMemType1;    /* Minimum memory usage when an OpenType font
336
           * is downloaded as a Type 1 font. */
337
  HBUINT32  maxMemType1;    /* Maximum memory usage when an OpenType font
338
           * is downloaded as a Type 1 font. */
339
  postV2Tail  v2X;
340
  DEFINE_SIZE_MIN (32);
341
};
342
343
struct post_accelerator_t : post::accelerator_t {
344
0
  post_accelerator_t (hb_face_t *face) : post::accelerator_t (face) {}
345
};
346
347
348
} /* namespace OT */
349
350
351
#endif /* HB_OT_POST_TABLE_HH */